簡(jiǎn)介面向AVR平臺(tái)的迪文DWIN串口TFT屏通用驅(qū)動(dòng)程序以標(biāo)準(zhǔn)C語(yǔ)言實(shí)現(xiàn)具備良好的可讀性與可移植性配套兩個(gè)文件dwin-display.c負(fù)責(zé)屏幕初始化、點(diǎn)線矩形圓繪制及文本顯示等核心功能dwin-display.h則定義屏幕尺寸、顏色深度等配置結(jié)構(gòu)并開(kāi)放簡(jiǎn)潔API開(kāi)發(fā)者只需調(diào)用dwin_init、dwin_draw_pixel、dwin_print_string等接口即可完成顯示控制無(wú)需糾結(jié)底層時(shí)序。壓縮包采用rar格式共2個(gè)文件1個(gè)h、1個(gè)c整體僅3KB體量極小、便于直接嵌入AVR工程。該驅(qū)動(dòng)兼容多種迪文屏型號(hào)與分辨率能適配工業(yè)控制、智能家居、物聯(lián)網(wǎng)等場(chǎng)景同時(shí)通過(guò)閱讀源碼還可掌握迪文屏SPI/UART串口通信的參數(shù)配置及GPIO連接方法為后續(xù)性能優(yōu)化和低功耗設(shè)計(jì)提供參考。目前已有831人學(xué)習(xí)下載適合嵌入式開(kāi)發(fā)者快速上手。1. 迪文串口TFT屏通用驅(qū)動(dòng)從改三次串口解析到一套代碼通吃前兩年做一個(gè)產(chǎn)線設(shè)備儀表項(xiàng)目主控從某51單片機(jī)換到STM32又因?yàn)樾酒?yīng)問(wèn)題換到國(guó)產(chǎn)GD32每次換主控顯示部分的串口解析都要從頭改一遍。屏幕始終沒(méi)換都是迪文DWIN的串口TFT但每版代碼里拼幀、拆幀、等返回的邏輯都和業(yè)務(wù)混在一起越改越不敢動(dòng)。后來(lái)我把這塊屏的通信單獨(dú)抽成一套通用驅(qū)動(dòng)傳輸層只收發(fā)字節(jié)協(xié)議層只解析幀應(yīng)用層只寫(xiě)業(yè)務(wù)。換主控時(shí)只改兩個(gè)端口函數(shù)頁(yè)面和變量地址一行不用動(dòng)。如果你正在做工業(yè)HMI、儀器儀表、設(shè)備面板被迪文屏的DGUS協(xié)議、變量字節(jié)序和返回幀解析折磨過(guò)這套驅(qū)動(dòng)和它的拆分思路可以直接抄走。2. 架構(gòu)與目錄設(shè)計(jì)把驅(qū)動(dòng)拆成傳輸、協(xié)議、應(yīng)用三層2.1 為什么必須分三層迪文屏本質(zhì)上是帶DGUS操作系統(tǒng)的顯示終端。屏幕內(nèi)部的串口接收、幀校驗(yàn)、字庫(kù)和FLASH存儲(chǔ)全部封裝在屏里主控能控制的只有串口上的一幀一幀字節(jié)。所以驅(qū)動(dòng)能不能復(fù)用取決于“發(fā)字節(jié)”“幀長(zhǎng)什么樣”“收到幀之后干什么”這三件事有沒(méi)有被拆開(kāi)。我見(jiàn)過(guò)比較多反例是直接把屏幕通信寫(xiě)在業(yè)務(wù)里測(cè)溫函數(shù)里拼一個(gè)數(shù)組塞給串口按鍵回調(diào)里再寫(xiě)一段解析。頁(yè)面一多全局?jǐn)?shù)組和臨時(shí)標(biāo)志位纏在一起排查一個(gè)亂碼要打好幾個(gè)斷點(diǎn)。分層之后驅(qū)動(dòng)和MCU外設(shè)解耦也和應(yīng)用業(yè)務(wù)解耦這是整個(gè)驅(qū)動(dòng)設(shè)計(jì)的底線。順帶說(shuō)一句回調(diào)不能放到串口中斷里直接執(zhí)行。因?yàn)榛卣{(diào)里一旦出現(xiàn)耗時(shí)操作比如寫(xiě)日志、翻轉(zhuǎn)繼電器中斷響應(yīng)時(shí)間就會(huì)被拖長(zhǎng)后續(xù)字節(jié)跟著丟。所以整個(gè)驅(qū)動(dòng)的原則是中斷只入FIFO業(yè)務(wù)回調(diào)全部放到 dwin_poll 里執(zhí)行。這么做還有個(gè)衍生好處將來(lái)接RTOS時(shí)可以把 dwin_poll 單獨(dú)放一個(gè)任務(wù)用戶不用關(guān)心臨界區(qū)。2.2 目錄結(jié)構(gòu)與模塊定位驅(qū)動(dòng)源碼內(nèi)部是這樣組織的dwin_drv/ ├── dwin_config.h // 幀格式、波特率、校驗(yàn)開(kāi)關(guān)、超時(shí)參數(shù) ├── dwin_port.h // 移植層接口聲明 ├── dwin_port.c // 串口收發(fā)、毫秒時(shí)間戳換平臺(tái)只改這里 ├── dwin_fifo.c // 環(huán)形緩沖區(qū)串口中斷到解析器的中轉(zhuǎn) ├── dwin_proto.c // 幀組裝、幀解析狀態(tài)機(jī)、校驗(yàn) ├── dwin_core.c // 對(duì)外API、回調(diào)表、事件分發(fā) └── demo/ ├── demo_stm32_uart.c └── demo_rtos_thread.cdwin_config.h 是整個(gè)驅(qū)動(dòng)的參數(shù)總閘。幀模式舊版AA幀還是新版5A A5幀、是否啟用校驗(yàn)、波特率、接收空閑超時(shí)時(shí)間都放在這里調(diào)屏幕型號(hào)時(shí)第一件事就是改這個(gè)頭文件。dwin_fifo.c 是典型的環(huán)形緩沖區(qū)串口中斷只做一步操作把字節(jié)壓進(jìn)FIFO主循環(huán)里的 dwin_poll() 再?gòu)腇IFO取字節(jié)喂給狀態(tài)機(jī)。這個(gè)設(shè)計(jì)保證中斷里沒(méi)有耗時(shí)邏輯也不丟字節(jié)。dwin_proto.c 是這個(gè)驅(qū)動(dòng)最核心的文件。它負(fù)責(zé)把“寫(xiě)變量、讀變量、寫(xiě)文本、跳頁(yè)”請(qǐng)求拼成符合屏幕協(xié)議的一幀同時(shí)把屏幕返回的原始字節(jié)流還原成帶指令號(hào)、地址、數(shù)據(jù)的數(shù)據(jù)包。dwin_core.c 站在更上層對(duì)外暴露簡(jiǎn)潔的API比如 dwin_write_uint16(0x1000, val, 1)內(nèi)部先查配置再調(diào)協(xié)議層拼幀最后經(jīng)端口層發(fā)出去。這樣換屏幕型號(hào)時(shí)應(yīng)用層調(diào)用的接口可以完全不變。2.3 對(duì)外接口設(shè)計(jì)6個(gè)函數(shù)覆蓋90%場(chǎng)景dwin_core 對(duì)外提供的核心API如下表函數(shù)作用關(guān)鍵參數(shù)說(shuō)明dwin_init初始化協(xié)議棧、清空回調(diào)表和FIFO無(wú)dwin_poll主循環(huán)周期調(diào)用處理FIFO中的字節(jié)無(wú)dwin_write_uint16向變量地址寫(xiě)1到N個(gè)字起始地址、數(shù)據(jù)指針、字?jǐn)?shù)dwin_read_uint16向屏幕發(fā)出讀變量請(qǐng)求起始地址、字?jǐn)?shù)dwin_set_text給文本控件寫(xiě)入字符串地址、字符串、長(zhǎng)度dwin_register_callback注冊(cè)返回幀與按鍵上報(bào)回調(diào)事件類型、回調(diào)函數(shù)指針dwin_write_uint16 是使用頻率最高的函數(shù)。溫度、速度、計(jì)數(shù)值這類數(shù)據(jù)在DGUS工程里綁定到一個(gè)整數(shù)數(shù)據(jù)變量顯示控件驅(qū)動(dòng)往對(duì)應(yīng)的變量地址寫(xiě)一個(gè)字屏幕自動(dòng)刷新。dwin_set_text 適合給標(biāo)簽控件寫(xiě)單位或狀態(tài)文字它內(nèi)部會(huì)把字符串放到幀數(shù)據(jù)區(qū)。這里要多留一個(gè)心眼中文字符串必須按屏幕燒錄時(shí)的編碼一般是GB2312發(fā)送否則顯示亂碼。dwin_read_uint16 是異步的發(fā)出請(qǐng)求之后不能立刻拿到結(jié)果數(shù)據(jù)要等屏幕返回幀到了、回調(diào)被觸發(fā)后才能拿到。這個(gè)異步語(yǔ)義很多第一次接觸的人會(huì)踩坑所以驅(qū)動(dòng)里專門做了回調(diào)注冊(cè)機(jī)制。2.4 數(shù)據(jù)流向一次dwin_write_uint16調(diào)用經(jīng)歷了什么以寫(xiě)一個(gè)變量為例完整鏈路是應(yīng)用層拿到數(shù)值 val125調(diào)用 dwin_write_uint16(0x1000, val, 1)dwin_core 把 125 拆成兩個(gè)字節(jié)高位 0x00 在前、低位 0x7D 在后dwin_proto 的幀組裝函數(shù)把這個(gè)數(shù)據(jù)連同指令碼 0x82、地址 0x1000 拼成一幀最后 dwin_port_send 把整幀發(fā)給屏幕。由于串口是流式的所以高位先發(fā)。接收方向是異步的。屏幕收到讀變量請(qǐng)求后返回一幀包含變量值的數(shù)據(jù)串口中斷把字節(jié)塞進(jìn)FIFO主循環(huán)調(diào)用 dwin_poll 時(shí)逐字節(jié)解析完整幀解析出來(lái)之后按指令號(hào)匹配回調(diào)。所以 dwin_poll 必須被周期性調(diào)用這一點(diǎn)恰恰是移植時(shí)最容易被忽略的只在初始化時(shí)調(diào)一次接收永遠(yuǎn)不會(huì)觸發(fā)。在RTOS環(huán)境下dwin_poll 適合放在一個(gè)獨(dú)立線程里循環(huán)調(diào)用用戶回調(diào)也在該線程執(zhí)行不會(huì)阻塞中斷也不會(huì)和業(yè)務(wù)線程搶串口。3. 核心模塊拆解幀組裝、狀態(tài)機(jī)解析與回調(diào)分發(fā)3.1 幀格式新舊兩套協(xié)議并存迪文屏協(xié)議在不同固件版本間差異不小驅(qū)動(dòng)里遇到最多的是兩種舊版以 0xAA 開(kāi)頭的幀和新版以 5A A5 開(kāi)頭的幀。兩者都是“幀頭長(zhǎng)度指令變量地址數(shù)據(jù)校驗(yàn)”的結(jié)構(gòu)但長(zhǎng)度字段包含的范圍不同校驗(yàn)方式也可能不同。驅(qū)動(dòng)通過(guò)編譯期宏選擇幀模式/* dwin_config.h */ #define DWIN_FRAME_MODE_NEW 1 /* 1: 5A A5幀; 0: 舊版AA幀 */ #define DWIN_FRAME_LEN_INCLUDE_CMD 1 /* 長(zhǎng)度字段是否包含指令本身 */ #define DWIN_FRAME_TAIL_SUM 1 /* 幀尾是否附帶求和校驗(yàn) */先看 5A A5 模式的幀結(jié)構(gòu)一個(gè)完整的寫(xiě)變量幀是這樣字段字節(jié)數(shù)說(shuō)明0x5A 0xA52幀頭長(zhǎng)度2從指令字節(jié)到數(shù)據(jù)末尾的字節(jié)數(shù)小端指令10x82寫(xiě)變量、0x83讀變量、0x84寫(xiě)文本地址2DGUS變量地址高字節(jié)在前數(shù)據(jù)N實(shí)際數(shù)據(jù)校驗(yàn)1對(duì)指令、地址、數(shù)據(jù)求和取低字節(jié)需要提醒的是具體型號(hào)的固件對(duì)長(zhǎng)度字段的含法、校驗(yàn)形式可能有差異。拿到屏之后要先看它隨附的DGUS協(xié)議手冊(cè)再?zèng)Q定 DWIN_FRAME_LEN_INCLUDE_CMD 置1還是置0。這個(gè)配置對(duì)不上時(shí)通常就是手冊(cè)和代碼沒(méi)統(tǒng)一。3.2 發(fā)送端可變長(zhǎng)幀組裝函數(shù)幀組裝函數(shù)是發(fā)送側(cè)的核心。它把指令、地址、數(shù)據(jù)三個(gè)部分拼成完整幀并自動(dòng)處理長(zhǎng)度字段和校驗(yàn)。uint16_t dwin_build_frame(uint8_t *buf, uint8_t cmd, uint16_t addr, const uint8_t *data, uint16_t data_len) { uint16_t i 0; #if DWIN_FRAME_MODE_NEW buf[i] 0x5A; /* 幀頭 */ buf[i] 0xA5; #else buf[i] 0xAA; #endif uint16_t len 0; len 1; /* 指令占1字節(jié) */ len 2; /* 地址占2字節(jié) */ len data_len; /* 數(shù)據(jù)區(qū) */ if (DWIN_FRAME_LEN_INCLUDE_CMD) { /* 長(zhǎng)度從指令開(kāi)始算上面len已經(jīng)包含指令 */ } else { len - 1; /* 長(zhǎng)度不包含指令 */ } len DWIN_FRAME_TAIL_SUM ? 1 : 0; /* 校驗(yàn)字節(jié)計(jì)入長(zhǎng)度 */ #if DWIN_FRAME_MODE_NEW buf[i] len 0xFF; /* 長(zhǎng)度低字節(jié)在前 */ buf[i] (len 8) 0xFF; #else buf[i] len 0xFF; /* 舊版按單字節(jié)長(zhǎng)度處理 */ #endif buf[i] cmd; /* 指令 */ buf[i] addr 8; /* 地址高字節(jié) */ buf[i] addr 0xFF; /* 地址低字節(jié) */ uint8_t sum cmd (uint8_t)(addr 8) (uint8_t)(addr 0xFF); for (uint16_t j 0; j data_len; j) { sum data[j]; buf[i] data[j]; } if (DWIN_FRAME_TAIL_SUM) { buf[i] sum; /* 求和校驗(yàn) */ } return i; /* 返回整幀長(zhǎng)度 */ }這段代碼最需要注意的地方是長(zhǎng)度字段的計(jì)算。它把指令、地址、數(shù)據(jù)三部分相加再根據(jù)宏決定是否去掉指令字節(jié)、是否加上校驗(yàn)字節(jié)。如果你在實(shí)測(cè)中發(fā)現(xiàn)屏幕對(duì)長(zhǎng)度字段理解不一致問(wèn)題幾乎都出在這三個(gè)宏的組合上。數(shù)據(jù)區(qū)按順序拷貝后校驗(yàn)字節(jié)使用最樸素的求和取低字節(jié)如果屏幕手冊(cè)要求CRC只需把這一段替換成CRC函數(shù)。3.3 接收端狀態(tài)機(jī)拆幀而不是等完整中斷接收側(cè)我習(xí)慣用一個(gè)輕量狀態(tài)機(jī)而不是在串口中斷里攢數(shù)組。狀態(tài)機(jī)的優(yōu)勢(shì)是隨時(shí)可以從噪聲中重新同步到幀頭不需要額外空閑定時(shí)器去判斷“一幀結(jié)束了”。typedef enum { ST_WAIT_5A 0, ST_WAIT_A5, ST_WAIT_LEN_L, ST_WAIT_LEN_H, ST_WAIT_CMD, ST_WAIT_DATA } dwin_parse_state_t; typedef struct { dwin_parse_state_t state; uint16_t len; /* 幀體總長(zhǎng)度含指令與數(shù)據(jù) */ uint16_t idx; /* 已接收字節(jié)數(shù) */ uint8_t buf[64]; /* 幀體緩沖 */ uint8_t cmd; uint32_t last_byte_tick; /* 上次收到字節(jié)的時(shí)間戳 */ } dwin_parser_t;解析函數(shù)逐字節(jié)輸入每收到一個(gè)字節(jié)驅(qū)動(dòng)狀態(tài)機(jī)往前步進(jìn)uint8_t dwin_parse_fsm(dwin_parser_t *p, uint8_t ch) { switch (p-state) { case ST_WAIT_5A: if (ch 0x5A) p-state ST_WAIT_A5; break; case ST_WAIT_A5: p-state (ch 0xA5) ? ST_WAIT_LEN_L : ST_WAIT_5A; break; case ST_WAIT_LEN_L: p-len ch; p-state ST_WAIT_LEN_H; break; case ST_WAIT_LEN_H: p-len | (uint16_t)ch 8; p-idx 0; p-state ST_WAIT_CMD; break; case ST_WAIT_CMD: p-cmd ch; p-buf[p-idx] ch; p-state ST_WAIT_DATA; break; case ST_WAIT_DATA: p-buf[p-idx] ch; if (p-idx p-len) { /* 收滿整個(gè)幀體 */ p-state ST_WAIT_5A; return 1; } break; default: p-state ST_WAIT_5A; break; } return 0; }這里需要特別說(shuō)明 ST_WAIT_CMD 和 ST_WAIT_DATA 的區(qū)別。ST_WAIT_CMD 只收一個(gè)字節(jié)也就是指令碼ST_WAIT_DATA 則繼續(xù)收剩余的幀體字節(jié)包括地址和數(shù)據(jù)。當(dāng) idx 累加到等于 len 時(shí)說(shuō)明一幀完整到達(dá)此時(shí)返回1dwin_poll 會(huì)把幀體交給回調(diào)分發(fā)函數(shù)。如果中途插入噪聲字節(jié)狀態(tài)機(jī)會(huì)回到 ST_WAIT_5A 重新找?guī)^不會(huì)把錯(cuò)位數(shù)據(jù)當(dāng)成有效幀。注意幀體緩沖 buf 默認(rèn)64字節(jié)如果屏幕有超過(guò)60字節(jié)數(shù)據(jù)的返回幀記得把數(shù)組加大否則會(huì)越界覆蓋。3.4 超時(shí)復(fù)位給狀態(tài)機(jī)一條后悔藥狀態(tài)機(jī)雖然能自動(dòng)找回幀頭但有一種情況很讓人抓狂屏幕回幀還沒(méi)收完線纜抖了一下從此后續(xù)所有字節(jié)都錯(cuò)位。所以我加了一個(gè)接收超時(shí)機(jī)制。dwin_poll 每次被調(diào)用時(shí)會(huì)順便檢查當(dāng)前幀是否太久沒(méi)有新字節(jié)到達(dá)超時(shí)就強(qiáng)制復(fù)位。void dwin_poll(void) { dwin_parser_t *p g_parser; uint32_t now dwin_port_get_tick_ms(); if (now - p-last_byte_tick DWIN_RX_TIMEOUT_MS) { p-state ST_WAIT_5A; /* 超時(shí)狀態(tài)機(jī)回到等幀頭 */ p-idx 0; } while (!dwin_fifo_is_empty(g_fifo)) { uint8_t ch dwin_fifo_pop(g_fifo); p-last_byte_tick dwin_port_get_tick_ms(); if (dwin_parse_fsm(p, ch)) { dwin_dispatch(p); } } }超時(shí)時(shí)間我一般設(shè)5ms因?yàn)槠聊辉?15200波特率下發(fā)送幾十字節(jié)的返回幀耗時(shí)都在1ms以內(nèi)5ms足夠?qū)捲Ｓ植粫?huì)讓噪聲長(zhǎng)時(shí)間影響狀態(tài)機(jī)。移植到不同平臺(tái)時(shí)dwin_port_get_tick_ms 是唯一需要新增的時(shí)間函數(shù)很多MCU的SysTick就能提供。這個(gè)“超時(shí)復(fù)位”解決的是串口屏項(xiàng)目里非常典型的玄學(xué)問(wèn)題線纜質(zhì)量不好時(shí)明明引腳沒(méi)接錯(cuò)程序卻間歇性收不到回調(diào)。3.5 回調(diào)分發(fā)把幀體翻譯成業(yè)務(wù)語(yǔ)義完整幀進(jìn)入 dispatch 后還需要從協(xié)議層視角翻譯成業(yè)務(wù)事件。驅(qū)動(dòng)維護(hù)一張回調(diào)表調(diào)用方可以針對(duì)不同事件注冊(cè)處理函數(shù)typedef struct { uint8_t cmd; uint16_t addr; uint8_t *data; uint16_t len; } dwin_pkt_t; typedef void (*dwin_callback_t)(const dwin_pkt_t *pkt); static dwin_callback_t s_cb_table[8]; void dwin_register_callback(dwin_evt_id_t evt, dwin_callback_t cb) { if (evt 8) s_cb_table[evt] cb; } static void dwin_dispatch(dwin_parser_t *p) { dwin_pkt_t pkt; pkt.cmd p-buf[0]; pkt.addr (uint16_t)((p-buf[1] 8) | p-buf[2]); pkt.data p-buf[3]; pkt.len p-len - 3; /* 從總長(zhǎng)度中去掉指令和地址 */ if (pkt.cmd DWIN_CMD_READ_ANSWER s_cb_table[DWIN_EVT_READ]) { s_cb_table[DWIN_EVT_READ](pkt); } }調(diào)用方使用時(shí)只需要關(guān)心“某個(gè)事件到了我該做什么”而不用關(guān)心幀是怎么收上來(lái)的。比如屏幕上的按鍵控件在DGUS工程里配置好上報(bào)功能后按下時(shí)屏幕會(huì)主動(dòng)回一幀驅(qū)動(dòng)解析出地址和值觸發(fā) DWIN_EVT_KEY 回調(diào)應(yīng)用層在回調(diào)里判斷地址屬于哪個(gè)按鍵再執(zhí)行對(duì)應(yīng)邏輯。4. 運(yùn)行指南從移植到點(diǎn)亮第一塊屏4.1 移植層只改兩個(gè)半函數(shù)驅(qū)動(dòng)把和硬件相關(guān)的部分收攏在 dwin_port.c 里換平臺(tái)時(shí)只需要實(shí)現(xiàn)四個(gè)簡(jiǎn)單函數(shù)初始化、發(fā)送字節(jié)數(shù)組、接收一個(gè)字節(jié)、獲取tick。/* dwin_port.h */ void dwin_port_init(uint32_t baud); void dwin_port_send(uint8_t *buf, uint16_t len); uint8_t dwin_port_get_char(void); /* 從FIFO取一個(gè)字節(jié)無(wú)數(shù)據(jù)返回0 */ uint32_t dwin_port_get_tick_ms(void); /* 毫秒時(shí)間戳 */以STM32為例串口初始化用USART1115200波特率8位數(shù)據(jù)、無(wú)校驗(yàn)、一位停止位。發(fā)送函數(shù)就是循環(huán)寫(xiě)發(fā)送寄存器void dwin_port_send(uint8_t *buf, uint16_t len) { for (uint16_t i 0; i len; i) { while (!LL_USART_IsActiveFlag_TXE(USART1)); LL_USART_TransmitData8(USART1, buf[i]); } }接收方向不是輪詢要走中斷。串口中斷里只做一件事把收到的字節(jié)壓進(jìn)FIFOvoid USART1_IRQHandler(void) { if (LL_USART_IsActiveFlag_RXNE(USART1)) { uint8_t ch LL_USART_ReceiveData8(USART1); dwin_port_on_rx_byte(ch); /* 內(nèi)部就是 fifo_push */ } }dwin_port_get_char 則從同一個(gè)FIFO取字節(jié)。連接屏幕時(shí)三根線必須共地屏幕TXD接MCU的RXRXD接MCU的TX如果屏幕是5V邏輯而MCU是3.3V需要電平轉(zhuǎn)換否則長(zhǎng)時(shí)間運(yùn)行可能出現(xiàn)隨機(jī)錯(cuò)誤幀。這個(gè)細(xì)節(jié)在項(xiàng)目現(xiàn)場(chǎng)踩了不止一次。注意屏幕供電別和主控共用帶強(qiáng)干擾的電源電機(jī)啟停時(shí)屏幕容易重啟串口也會(huì)跟著丟數(shù)據(jù)。4.2 最小跑通讓屏幕顯示一個(gè)每秒變化的數(shù)驅(qū)動(dòng)移植完成后最小可運(yùn)行工程非常短。前提是你在DGUS軟件里建好工程把某個(gè)數(shù)據(jù)變量顯示控件綁定到變量地址 0x1000并把工程下載到屏幕。然后主循環(huán)里這樣寫(xiě)#include dwin_drv.h int main(void) { dwin_port_init(115200); dwin_init(); uint16_t counter 0; while (1) { counter; dwin_write_uint16(0x1000, counter, 1); dwin_poll(); hal_delay_ms(1000); } }這段代碼干的活就是每秒把 counter 的值通過(guò)串口寫(xiě)到0x1000地址屏幕上的數(shù)據(jù)變量顯示控件讀到新值后刷新顯示。如果0x1000被當(dāng)成字節(jié)地址而不是字地址顯示就會(huì)錯(cuò)亂因?yàn)镈GUS的變量地址是字地址一個(gè)地址對(duì)應(yīng)兩個(gè)字節(jié)。跑通這一步證明通信鏈路沒(méi)問(wèn)題。接下來(lái)再試讀變量、寫(xiě)文本、處理按鍵上報(bào)就水到渠成。注意主循環(huán)里不能沒(méi)有 dwin_poll()否則接收方向的按鍵上報(bào)和讀變量返回永遠(yuǎn)不處理。4.3 先離線驗(yàn)證再上驅(qū)動(dòng)代碼每次拿到一塊新屏我建議先別直接燒驅(qū)動(dòng)先用USB轉(zhuǎn)TTL加串口助手在PC上把屏幕的協(xié)議摸清楚。操作步驟是USB轉(zhuǎn)TTL的TXD接屏幕RXDRXD接屏幕TXD共地串口助手選HEX發(fā)送波特率先設(shè)115200手動(dòng)發(fā)一條讀版本號(hào)指令觀察返回幀內(nèi)容。讀版本號(hào)指令一般是 0x80 或 0x81不同固件定義不同。完全可以在串口助手先輸入5A A5 04 80 00 00 00 01如果這條指令格式正確屏幕會(huì)回一幀包含固件版本的報(bào)文。這里的幀長(zhǎng)度和校驗(yàn)要和屏幕手冊(cè)逐字節(jié)核對(duì)核對(duì)通過(guò)后再把這套格式用到驅(qū)動(dòng)配置里。很多人跳過(guò)了這個(gè)驗(yàn)證步驟直接拿驅(qū)動(dòng)代碼燒進(jìn)去然后花兩小時(shí)懷疑是波特率還是電平問(wèn)題其實(shí)問(wèn)題只是長(zhǎng)度字段差了一個(gè)字節(jié)。4.4 運(yùn)行配置參數(shù)一覽配置項(xiàng)推薦值說(shuō)明波特率115200或屏幕實(shí)際設(shè)置屏幕上的OS參數(shù)也要一致DWIN_FRAME_MODE_NEW按屏固件選新版固件用1DWIN_RX_TIMEOUT_MS5空閑超時(shí)狀態(tài)機(jī)復(fù)位用FIFO大小128字節(jié)大于最長(zhǎng)返回幀校驗(yàn)方式求和或按手冊(cè)改不匹配時(shí)幀會(huì)被解析成噪聲還有一個(gè)常見(jiàn)的誤解是波特率越高越好。其實(shí)屏幕DGUS在處理某些長(zhǎng)數(shù)據(jù)時(shí)發(fā)送間隔比波特率更影響穩(wěn)定性。波特率拉到921600看上去很酷但批量寫(xiě)變量時(shí)丟幀概率明顯上升因?yàn)槠聊欢私馕鏊俣雀簧稀９た貓?chǎng)景我一般穩(wěn)定在115200幀間隔留夠比硬上高頻更可靠。5. 避坑指南串口屏調(diào)試中的高頻踩坑記錄5.1 屏幕上電白屏串口收發(fā)毫無(wú)反應(yīng)現(xiàn)象程序燒進(jìn)去屏幕白屏或停在開(kāi)機(jī)頁(yè)串口助手發(fā)任何指令都不回顯。原因最常見(jiàn)的是波特率不一致。屏幕內(nèi)部OS和DGUS配置里的波特率與主控串口初始化不一致有的固件默認(rèn)9600有的默認(rèn)115200還有一部分屏在上電時(shí)必須先收到正確的幀頭才開(kāi)放通信。解決先用串口助手從9600到921600逐個(gè)波特率發(fā)送讀版本指令看哪個(gè)波特率能收到返回幀。確認(rèn)后再改 dwin_config.h 里的波特率配置并把屏幕端配置一并改到一致。如果是新屏可以在DGUS軟件里檢查工程和OS的波特率設(shè)置。5.2 顯示正常但批量寫(xiě)變量時(shí)偶爾丟數(shù)現(xiàn)象單獨(dú)寫(xiě)一個(gè)變量沒(méi)問(wèn)題一次性寫(xiě)十幾個(gè)變量總有一兩個(gè)變量沒(méi)有被刷新。原因連續(xù)的幀間隔太短屏幕DGUS解析來(lái)不及處理。串口發(fā)送雖然是流式的但屏幕端需要時(shí)間把收到的幀解析、寫(xiě)變量、刷新顯示尤其圖庫(kù)較大的頁(yè)面處理耗時(shí)更長(zhǎng)。解決驅(qū)動(dòng)里在每幀發(fā)送之間加2到5ms延時(shí)并且把相鄰地址的寫(xiě)入合并成一次寫(xiě)多個(gè)字。迪文屏的變量地址是連續(xù)的0x1000到0x1007這8個(gè)地址可以一次幀寫(xiě)8個(gè)16位字網(wǎng)絡(luò)開(kāi)銷小很多也比分幀發(fā)送穩(wěn)定。我在驅(qū)動(dòng)里封裝了按地址段批量寫(xiě)的接口遇到需要整塊刷新的儀表盤(pán)數(shù)據(jù)時(shí)切到批量寫(xiě)。5.3 讀回來(lái)的變量值和屏上看到的不一致現(xiàn)象屏幕上顯示125驅(qū)動(dòng)讀回來(lái)的數(shù)值卻是32000或者錯(cuò)開(kāi)2個(gè)字節(jié)。原因DGUS變量地址是16位字地址讀一個(gè)變量返回一個(gè)字兩字節(jié)高字節(jié)在前。如果驅(qū)動(dòng)按字節(jié)去解析比如把返回的兩個(gè)字節(jié)當(dāng)成兩個(gè)8位數(shù)據(jù)就會(huì)錯(cuò)位。另一個(gè)常見(jiàn)原因是地址計(jì)算錯(cuò)誤0x1000到0x1002差兩個(gè)地址實(shí)際上是兩個(gè)字中間隔4個(gè)字節(jié)。解決讀變量時(shí)明確按字來(lái)申請(qǐng)數(shù)據(jù)解析統(tǒng)一用 uint16_t 數(shù)組高位在前。我在驅(qū)動(dòng)里讀變量回調(diào)用的是 uint16_t 指針不提供按字節(jié)解析的接口從源頭避免這個(gè)錯(cuò)誤。另外DGUS工程里變量地址通常從0x1000往上分配建議在項(xiàng)目文檔里建一張變量地址分配表不然過(guò)兩周就忘了0x1000是哪一路溫度。5.4 狀態(tài)機(jī)被干擾幀卡住回調(diào)忽然不再觸發(fā)現(xiàn)象系統(tǒng)運(yùn)行幾小時(shí)后按鍵回調(diào)徹底不響應(yīng)重新上電又好了。原因串口線或電源質(zhì)量差導(dǎo)致某個(gè)噪聲字節(jié)破壞了正在解析的半幀。狀態(tài)機(jī)沒(méi)有超時(shí)復(fù)位就一直卡在等數(shù)據(jù)的錯(cuò)誤狀態(tài)后續(xù)任何幀都跟不上。解決驅(qū)動(dòng)里增加接收超時(shí)復(fù)位就是前面 dwin_poll 里那段邏輯超過(guò)5ms沒(méi)有新字節(jié)強(qiáng)制回到等幀頭狀態(tài)。這個(gè)功能一定要在量產(chǎn)版本里保留否則現(xiàn)場(chǎng)電源波動(dòng)一次機(jī)器就得斷電重啟這是工業(yè)環(huán)境里最典型的玄學(xué)故障之一。5.5 用DMA接收數(shù)據(jù)錯(cuò)亂中斷逐字節(jié)模式卻正?，F(xiàn)象把串口接收改成DMA加空閑中斷后返回幀偶爾順序錯(cuò)亂甚至出現(xiàn)幀頭被誤判成數(shù)據(jù)。原因最常見(jiàn)的是調(diào)試時(shí)自發(fā)自收。USB轉(zhuǎn)TTL的TXD和RXD接反或者把主控的TX接到了調(diào)試串口上導(dǎo)致主控自己發(fā)送的字節(jié)被DMA收進(jìn)來(lái)。DMA方式和中斷方式的區(qū)別在于中斷模式會(huì)過(guò)濾掉一部分自發(fā)字節(jié)而DMA會(huì)把所有字節(jié)都收進(jìn)緩沖區(qū)問(wèn)題暴露得更明顯。解決先確認(rèn)物理接線三線共地DMA調(diào)試階段在接收路徑上加一個(gè)環(huán)回抑制發(fā)送期間關(guān)閉接收方向發(fā)送完成后恢復(fù)。如果屏幕和主控電平不匹配也會(huì)出現(xiàn)類似現(xiàn)象這時(shí)需要加電平轉(zhuǎn)換電路而不是調(diào)大波特率。6. 二次開(kāi)發(fā)從通用驅(qū)動(dòng)長(zhǎng)出自己的業(yè)務(wù)專屬驅(qū)動(dòng)6.1 擴(kuò)展指令映射表驅(qū)動(dòng)把指令號(hào)和業(yè)務(wù)語(yǔ)義解耦之后新增屏幕功能只需要擴(kuò)展一張指令映射表和一個(gè)分發(fā)分支。我習(xí)慣把屏幕所有可用指令集中定義在一張表里typedef struct { uint8_t cmd; const char *name; } dwin_cmd_map_t; static const dwin_cmd_map_t s_cmd_map[] { { 0x82, write_var }, { 0x83, read_var }, { 0x84, write_text }, { 0x90, jump_page }, { 0x00, NULL } };增加新功能時(shí)比如要支持屏幕固件里的曲線數(shù)據(jù)上傳只需要在表里加一條{ 0x91, upload_curve }然后在 dispatch 里加一個(gè)路由分支。好處是新人接手時(shí)掃一眼這張表就能知道驅(qū)動(dòng)支持哪些操作不用翻代碼。6.2 把驅(qū)動(dòng)搬進(jìn)RTOS線程如果項(xiàng)目里用FreeRTOSdwin_poll 可以放進(jìn)一個(gè)獨(dú)立線程接收中斷仍然只負(fù)責(zé)字節(jié)進(jìn)FIFOvoid dwin_task(void *arg) { for (;;) { dwin_poll(); osDelay(1); } }發(fā)送路徑需要保護(hù)。驅(qū)動(dòng)內(nèi)部組裝幀用的是靜態(tài)緩沖跨線程調(diào)用時(shí)兩個(gè)線程可能同時(shí)往緩沖區(qū)里寫(xiě)導(dǎo)致幀頭和數(shù)據(jù)錯(cuò)開(kāi)。我的做法是對(duì) dwin_send 加一個(gè)互斥鎖把“組裝加發(fā)送”作為一個(gè)臨界區(qū)。接收側(cè)不受影響因?yàn)镕IFO是單生產(chǎn)者單消費(fèi)者模型中斷是唯一生產(chǎn)者dwin_poll 是唯一消費(fèi)者。6.3 驗(yàn)證方法先回環(huán)后聯(lián)調(diào)二次開(kāi)發(fā)每次改完協(xié)議層我都先做回環(huán)測(cè)試不接屏幕把主控的TXD直接接到自己的RXD自發(fā)自收一幀驗(yàn)證組裝和解析能對(duì)上。這一步能分辨問(wèn)題是出在驅(qū)動(dòng)還是屏幕上?；丨h(huán)通過(guò)后再接屏幕跑一遍變量讀寫(xiě)和全部回調(diào)。從那以后我每換一個(gè)屏型號(hào)第一件事永遠(yuǎn)是串口助手手動(dòng)發(fā)讀版本指令確認(rèn)幀格式再動(dòng)驅(qū)動(dòng)代碼這套流程幫我省掉的調(diào)試時(shí)間遠(yuǎn)比想象中多。希望這些拆分和調(diào)試習(xí)慣能幫到你。本文還有配套的精品資源點(diǎn)擊獲取