簡(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)并開放簡(jiǎn)潔API開發(fā)者只需調(diào)用dwin_init、dwin_draw_pixel、dwin_print_string等接口即可完成顯示控制無需糾結(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í)通過閱讀源碼還可掌握迪文屏SPI/UART串口通信的參數(shù)配置及GPIO連接方法為后續(xù)性能優(yōu)化和低功耗設(shè)計(jì)提供參考。目前已有831人學(xué)習(xí)下載適合嵌入式開發(fā)者快速上手。1. 迪文串口TFT屏通用驅(qū)動(dòng)從改三次串口解析到一套代碼通吃前兩年做一個(gè)產(chǎn)線設(shè)備儀表項(xiàng)目主控從某51單片機(jī)換到STM32又因?yàn)樾酒?yīng)問題換到國(guó)產(chǎn)GD32每次換主控顯示部分的串口解析都要從頭改一遍。屏幕始終沒換都是迪文DWIN的串口TFT但每版代碼里拼幀、拆幀、等返回的邏輯都和業(yè)務(wù)混在一起越改越不敢動(dòng)。后來我把這塊屏的通信單獨(dú)抽成一套通用驅(qū)動(dòng)傳輸層只收發(fā)字節(jié)協(xié)議層只解析幀應(yīng)用層只寫業(yè)務(wù)。換主控時(shí)只改兩個(gè)端口函數(shù)頁(yè)面和變量地址一行不用動(dòng)。如果你正在做工業(yè)HMI、儀器儀表、設(shè)備面板被迪文屏的DGUS協(xié)議、變量字節(jié)序和返回幀解析折磨過這套驅(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)什么樣”“收到幀之后干什么”這三件事有沒有被拆開。我見過比較多反例是直接把屏幕通信寫在業(yè)務(wù)里測(cè)溫函數(shù)里拼一個(gè)數(shù)組塞給串口按鍵回調(diào)里再寫一段解析。頁(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ì)的底線。順帶說一句回調(diào)不能放到串口中斷里直接執(zhí)行。因?yàn)榛卣{(diào)里一旦出現(xiàn)耗時(shí)操作比如寫日志、翻轉(zhuǎn)繼電器中斷響應(yīng)時(shí)間就會(huì)被拖長(zhǎng)后續(xù)字節(jié)跟著丟。所以整個(gè)驅(qū)動(dòng)的原則是中斷只入FIFO業(yè)務(wù)回調(diào)全部放到 dwin_poll 里執(zhí)行。這么做還有個(gè)衍生好處將來接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)開關(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ì)保證中斷里沒有耗時(shí)邏輯也不丟字節(jié)。dwin_proto.c 是這個(gè)驅(qū)動(dòng)最核心的文件。它負(fù)責(zé)把“寫變量、讀變量、寫文本、跳頁(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ù)說明dwin_init初始化協(xié)議棧、清空回調(diào)表和FIFO無dwin_poll主循環(huán)周期調(diào)用處理FIFO中的字節(jié)無dwin_write_uint16向變量地址寫1到N個(gè)字起始地址、數(shù)據(jù)指針、字?jǐn)?shù)dwin_read_uint16向屏幕發(fā)出讀變量請(qǐng)求起始地址、字?jǐn)?shù)dwin_set_text給文本控件寫入字符串地址、字符串、長(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)的變量地址寫一個(gè)字屏幕自動(dòng)刷新。dwin_set_text 適合給標(biāo)簽控件寫單位或狀態(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)歷了什么以寫一個(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é)解析完整幀解析出來之后按指令號(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 開頭的幀和新版以 5A A5 開頭的幀。兩者都是“幀頭長(zhǎng)度指令變量地址數(shù)據(jù)校驗(yàn)”的結(jié)構(gòu)但長(zhǎng)度字段包含的范圍不同校驗(yàn)方式也可能不同。驅(qū)動(dòng)通過編譯期宏選擇幀模式/* 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è)完整的寫變量幀是這樣字段字節(jié)數(shù)說明0x5A 0xA52幀頭長(zhǎng)度2從指令字節(jié)到數(shù)據(jù)末尾的字節(jié)數(shù)小端指令10x82寫變量、0x83讀變量、0x84寫文本地址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è)和代碼沒統(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)度從指令開始算上面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)度字段理解不一致問題幾乎都出在這三個(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; }這里需要特別說明 ST_WAIT_CMD 和 ST_WAIT_DATA 的區(qū)別。ST_WAIT_CMD 只收一個(gè)字節(jié)也就是指令碼ST_WAIT_DATA 則繼續(xù)收剩余的幀體字節(jié)包括地址和數(shù)據(jù)。當(dāng) idx 累加到等于 len 時(shí)說明一幀完整到達(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é)如果屏幕有超過60字節(jié)數(shù)據(jù)的返回幀記得把數(shù)組加大否則會(huì)越界覆蓋。3.4 超時(shí)復(fù)位給狀態(tài)機(jī)一條后悔藥狀態(tài)機(jī)雖然能自動(dòng)找回幀頭但有一種情況很讓人抓狂屏幕回幀還沒收完線纜抖了一下從此后續(xù)所有字節(jié)都錯(cuò)位。所以我加了一個(gè)接收超時(shí)機(jī)制。dwin_poll 每次被調(diào)用時(shí)會(huì)順便檢查當(dāng)前幀是否太久沒有新字節(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é)問題線纜質(zhì)量不好時(shí)明明引腳沒接錯(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)心幀是怎么收上來的。比如屏幕上的按鍵控件在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é)無數(shù)據(jù)返回0 */ uint32_t dwin_port_get_tick_ms(void); /* 毫秒時(shí)間戳 */以STM32為例串口初始化用USART1115200波特率8位數(shù)據(jù)、無校驗(yàn)、一位停止位。發(fā)送函數(shù)就是循環(huán)寫發(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)里這樣寫#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 的值通過串口寫到0x1000地址屏幕上的數(shù)據(jù)變量顯示控件讀到新值后刷新顯示。如果0x1000被當(dāng)成字節(jié)地址而不是字地址顯示就會(huì)錯(cuò)亂因?yàn)镈GUS的變量地址是字地址一個(gè)地址對(duì)應(yīng)兩個(gè)字節(jié)。跑通這一步證明通信鏈路沒問題。接下來再試讀變量、寫文本、處理按鍵上報(bào)就水到渠成。注意主循環(huán)里不能沒有 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ì)通過后再把這套格式用到驅(qū)動(dòng)配置里。很多人跳過了這個(gè)驗(yàn)證步驟直接拿驅(qū)動(dòng)代碼燒進(jìn)去然后花兩小時(shí)懷疑是波特率還是電平問題其實(shí)問題只是長(zhǎng)度字段差了一個(gè)字節(jié)。4.4 運(yùn)行配置參數(shù)一覽配置項(xiàng)推薦值說明波特率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è)常見的誤解是波特率越高越好。其實(shí)屏幕DGUS在處理某些長(zhǎng)數(shù)據(jù)時(shí)發(fā)送間隔比波特率更影響穩(wěn)定性。波特率拉到921600看上去很酷但批量寫變量時(shí)丟幀概率明顯上升因?yàn)槠聊欢私馕鏊俣雀簧?。工控?chǎng)景我一般穩(wěn)定在115200幀間隔留夠比硬上高頻更可靠。5. 避坑指南串口屏調(diào)試中的高頻踩坑記錄5.1 屏幕上電白屏串口收發(fā)毫無反應(yīng)現(xiàn)象程序燒進(jìn)去屏幕白屏或停在開機(jī)頁(yè)串口助手發(fā)任何指令都不回顯。原因最常見的是波特率不一致。屏幕內(nèi)部OS和DGUS配置里的波特率與主控串口初始化不一致有的固件默認(rèn)9600有的默認(rèn)115200還有一部分屏在上電時(shí)必須先收到正確的幀頭才開放通信。解決先用串口助手從9600到921600逐個(gè)波特率發(fā)送讀版本指令看哪個(gè)波特率能收到返回幀。確認(rèn)后再改 dwin_config.h 里的波特率配置并把屏幕端配置一并改到一致。如果是新屏可以在DGUS軟件里檢查工程和OS的波特率設(shè)置。5.2 顯示正常但批量寫變量時(shí)偶爾丟數(shù)現(xiàn)象單獨(dú)寫一個(gè)變量沒問題一次性寫十幾個(gè)變量總有一兩個(gè)變量沒有被刷新。原因連續(xù)的幀間隔太短屏幕DGUS解析來不及處理。串口發(fā)送雖然是流式的但屏幕端需要時(shí)間把收到的幀解析、寫變量、刷新顯示尤其圖庫(kù)較大的頁(yè)面處理耗時(shí)更長(zhǎng)。解決驅(qū)動(dòng)里在每幀發(fā)送之間加2到5ms延時(shí)并且把相鄰地址的寫入合并成一次寫多個(gè)字。迪文屏的變量地址是連續(xù)的0x1000到0x1007這8個(gè)地址可以一次幀寫8個(gè)16位字網(wǎng)絡(luò)開銷小很多也比分幀發(fā)送穩(wěn)定。我在驅(qū)動(dòng)里封裝了按地址段批量寫的接口遇到需要整塊刷新的儀表盤數(shù)據(jù)時(shí)切到批量寫。5.3 讀回來的變量值和屏上看到的不一致現(xiàn)象屏幕上顯示125驅(qū)動(dòng)讀回來的數(shù)值卻是32000或者錯(cuò)開2個(gè)字節(jié)。原因DGUS變量地址是16位字地址讀一個(gè)變量返回一個(gè)字兩字節(jié)高字節(jié)在前。如果驅(qū)動(dòng)按字節(jié)去解析比如把返回的兩個(gè)字節(jié)當(dāng)成兩個(gè)8位數(shù)據(jù)就會(huì)錯(cuò)位。另一個(gè)常見原因是地址計(jì)算錯(cuò)誤0x1000到0x1002差兩個(gè)地址實(shí)際上是兩個(gè)字中間隔4個(gè)字節(jié)。解決讀變量時(shí)明確按字來申請(qǐng)數(shù)據(jù)解析統(tǒng)一用 uint16_t 數(shù)組高位在前。我在驅(qū)動(dòng)里讀變量回調(diào)用的是 uint16_t 指針不提供按字節(jié)解析的接口從源頭避免這個(gè)錯(cuò)誤。另外DGUS工程里變量地址通常從0x1000往上分配建議在項(xiàng)目文檔里建一張變量地址分配表不然過兩周就忘了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ī)沒有超時(shí)復(fù)位就一直卡在等數(shù)據(jù)的錯(cuò)誤狀態(tài)后續(xù)任何幀都跟不上。解決驅(qū)動(dòng)里增加接收超時(shí)復(fù)位就是前面 dwin_poll 里那段邏輯超過5ms沒有新字節(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ù)。原因最常見的是調(diào)試時(shí)自發(fā)自收。USB轉(zhuǎn)TTL的TXD和RXD接反或者把主控的TX接到了調(diào)試串口上導(dǎo)致主控自己發(fā)送的字節(jié)被DMA收進(jìn)來。DMA方式和中斷方式的區(qū)別在于中斷模式會(huì)過濾掉一部分自發(fā)字節(jié)而DMA會(huì)把所有字節(jié)都收進(jìn)緩沖區(qū)問題暴露得更明顯。解決先確認(rèn)物理接線三線共地DMA調(diào)試階段在接收路徑上加一個(gè)環(huán)回抑制發(fā)送期間關(guān)閉接收方向發(fā)送完成后恢復(fù)。如果屏幕和主控電平不匹配也會(huì)出現(xiàn)類似現(xiàn)象這時(shí)需要加電平轉(zhuǎn)換電路而不是調(diào)大波特率。6. 二次開發(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ū)里寫導(dǎo)致幀頭和數(shù)據(jù)錯(cuò)開。我的做法是對(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)二次開發(fā)每次改完協(xié)議層我都先做回環(huán)測(cè)試不接屏幕把主控的TXD直接接到自己的RXD自發(fā)自收一幀驗(yàn)證組裝和解析能對(duì)上。這一步能分辨問題是出在驅(qū)動(dòng)還是屏幕上。回環(huán)通過后再接屏幕跑一遍變量讀寫和全部回調(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)擊獲取