時(shí)調(diào)試面板：從接線到排障全指南)
用 OLED 給 STM32 做實(shí)時(shí)調(diào)試面板這個(gè)想法其實(shí)是從一次調(diào)試線夠不著的現(xiàn)場(chǎng)冒出來(lái)的。當(dāng)時(shí)我在調(diào)一臺(tái)裝進(jìn)亞克力殼子里的環(huán)境監(jiān)測(cè)設(shè)備串口線塞不進(jìn)去邏輯分析儀又太大板子上的狀態(tài)全靠一個(gè) LED 閃來(lái)閃去根本分不清是光照傳感器飄了還是 MQ-2 誤報(bào)。后來(lái)我直接在 0.96 寸 OLED 上做了一個(gè)實(shí)時(shí)調(diào)試面板把溫濕度、光照、傳感器狀態(tài)、錯(cuò)誤計(jì)數(shù)全部就地顯示整個(gè)調(diào)試體驗(yàn)直接變了個(gè)樣。這篇文章就圍繞這塊小屏幕展開(kāi)從硬件接線到驅(qū)動(dòng)移植從面板布局到刷新策略再到花屏、白屏、死機(jī)這些實(shí)測(cè)坑完整帶你走一遍調(diào)試面板的搭建過(guò)程。無(wú)論你是剛學(xué) STM32 的入門者還是正在做畢設(shè)、搞環(huán)境監(jiān)測(cè)、做智能小車的老手這套方案基本都能直接抄作業(yè)。1. 做調(diào)試面板之前的真實(shí)需求串口日志在哪些場(chǎng)景會(huì)失靈很多人的第一反應(yīng)是要調(diào)試為什么不打串口日志確實(shí)串口 printf 是最普及的調(diào)試手段Keil 的仿真器也能看變量?？赡阋坏┌寻遄訌淖烂媾驳秸鎸?shí)設(shè)備里問(wèn)題就來(lái)了。1.1 串口調(diào)試的三個(gè)無(wú)力場(chǎng)景第一類是物理夠不著。小車跑起來(lái)之后你不可能拖著一根串口線跟著跑設(shè)備裝進(jìn)外殼之后調(diào)試口被擋在內(nèi)部魚缸控制器泡在水族箱旁邊插拔線纜還得挪動(dòng)整個(gè)裝置。這類場(chǎng)景里串口助手從隨時(shí)可看變成了偶爾能接一下。第二類是數(shù)據(jù)不夠直觀。串口打印的是一堆數(shù)字流你得在腦子里想象某個(gè)變量隨時(shí)間的變化曲線。比如 PID 輸出每秒打印 20 行會(huì)上翻得飛快你根本看不出趨勢(shì)。LED 指示呢只能表達(dá)正常/異常二值狀態(tài)多幾個(gè)狀態(tài)就亂了。第三類是現(xiàn)場(chǎng)沒(méi)有上位機(jī)。去客戶現(xiàn)場(chǎng)、或者帶去戶外測(cè)試時(shí)筆記本不一定帶就算帶了串口線也未必匹配更不要說(shuō)車?yán)?、野外這些環(huán)境。1.2 為什么 OLED 是實(shí)時(shí)調(diào)試面板的合理答案OLED 模塊的特點(diǎn)是便宜、體積小、功耗低、接口少。市面上最常見(jiàn)的 0.96 寸四針 I2C 模塊四根線就能掛到 STM32 上顯示 128×64 像素足夠支撐一個(gè)現(xiàn)場(chǎng)狀態(tài)面板。它不像 LCD1602 那樣受視角限制也不像 TFT 彩屏那樣占引腳、占內(nèi)存。最關(guān)鍵的一點(diǎn)是OLED 顯示的是就地信息——板子在哪里信息就在哪里不依賴任何外部設(shè)施。我見(jiàn)過(guò)有人給 STM32 掛一個(gè) 7 寸 HDMI 屏幕做調(diào)試界面殺雞用牛刀而且 7 寸屏的初始化、顯存開(kāi)銷、繪制時(shí)間都遠(yuǎn)超一個(gè)調(diào)試面板的需求。OLED 面板的核心價(jià)值不是顯示好多信息而是在你不需要上位機(jī)和調(diào)試器的時(shí)候把關(guān)鍵變量直接擺在你眼前。1.3 這套方案適合誰(shuí)正在用標(biāo)準(zhǔn)庫(kù)或者 HAL 庫(kù)寫 STM32 項(xiàng)目的人手里恰好有或者準(zhǔn)備買一塊 0.96 寸 SSD1306 模塊想把調(diào)試體驗(yàn)從盲調(diào)升級(jí)成可視化這篇文章就是為你準(zhǔn)備的。前置知識(shí)不需要太多了解 I2C 的基本讀寫、知道 GPIO 怎么配置其他我盡量講得細(xì)致一點(diǎn)。2. 硬件準(zhǔn)備0.96 寸四針 OLED 與 STM32 的接線其實(shí)暗藏兩個(gè)坑硬件連接是這個(gè)項(xiàng)目里最簡(jiǎn)單的部分但簡(jiǎn)單不代表沒(méi)坑。我見(jiàn)過(guò)不少人卡在模塊不亮上回頭一看不是代碼問(wèn)題而是引腳沖突或者供電不對(duì)。2.1 四針 I2C 模塊與七針 SPI 模塊怎么選市面上 0.96 寸的 OLED 模塊有兩種主流接口四針 I2C 和七針 SPI。做調(diào)試面板我強(qiáng)烈建議選四針 I2C 版本。原因很直接只需要 SCL 和 SDA 兩根信號(hào)線剩下的 VCC 和 GND 接電源就行給其他外設(shè)留出更多引腳。而七針 SPI 版本雖然刷新速度更快但除了時(shí)鐘和數(shù)據(jù)線還要接 CS、DC、RES 三個(gè)控制引腳對(duì)調(diào)試面板這種信息量不大的場(chǎng)景來(lái)說(shuō)純屬浪費(fèi)引腳資源。有一種四針模塊可能是 I2C也可能是 SPI買的時(shí)候要看清型號(hào)。SSD1306 主控的 I2C 四針模塊一般會(huì)印著 SCL、SDA 兩個(gè)絲印如果印著 SCK、MOSI那就是 SPI。別買錯(cuò)了不然程序怎么調(diào)都不亮。2.2 引腳分配與接線實(shí)操我以 STM32F103C8T6 最小系統(tǒng)板為例。I2C1 的默認(rèn)引腳是 PB6(SCL) 和 PB7(SDA)HAL 庫(kù)配置里選 Alternate Function Open-Drain 模式即可。如果你用的是其他型號(hào)比如 F407 或者 G4 系列只要確認(rèn)對(duì)應(yīng)的 I2C 引腳就好邏輯完全一致。接線表如下OLED 模塊引腳連接到 STM32說(shuō)明VCC3.3V注意大多數(shù) 0.96 寸模塊是 3.3V 供電GNDGND共地必須可靠SCLPB6I2C1 時(shí)鐘線板上一般有上拉SDAPB7I2C1 數(shù)據(jù)線這里有一個(gè)實(shí)操細(xì)節(jié)很多模塊的 I2C 地址是 0x3C也有部分廠家做成 0x3D。驅(qū)動(dòng)代碼里如果發(fā)現(xiàn)初始化后白屏第一件事不是翻代碼而是確認(rèn)模塊背面的地址電阻或者用 I2C 掃描程序確認(rèn)當(dāng)前地址。這個(gè)問(wèn)題我在后面的排障章節(jié)會(huì)專門展開(kāi)。2.3 供電與上拉電阻的兩個(gè)隱藏細(xì)節(jié)第一個(gè)坑是供電電壓。0.96 寸模塊雖然很多標(biāo)注支持 3.3V/5V但它的核心 SSD1306 是 3.3V 器件。如果你的開(kāi)發(fā)板有 3.3V 引腳就盡量接 3.3V別圖省事接 5V時(shí)間長(zhǎng)了模塊上的穩(wěn)壓電路發(fā)熱花屏概率會(huì)明顯變大。個(gè)別無(wú)穩(wěn)壓的模塊接 5V 后直接燒壞。第二個(gè)坑是 I2C 上拉電阻。大部分現(xiàn)成模塊上已經(jīng)板載了 4.7k 上拉電阻直接接線即可。但如果你買的是那種裸屏或者自己打板的擴(kuò)展板可能沒(méi)有上拉這時(shí) SCL、SDA 必須外接兩個(gè) 4.7k 電阻到 3.3V否則總線拉不上去OLED 完全不工作。怎么判斷用萬(wàn)用表量 SCL 對(duì) GND 的電阻數(shù)值在 3k~7k 之間通常說(shuō)明有上拉。3. 驅(qū)動(dòng)層怎么選手寫 SSD1306 底層還是直接用 U8G2我的建議是先手寫一次驅(qū)動(dòng) OLED 核心就是通過(guò) I2C 往 SSD1306 芯片寫命令和數(shù)據(jù)。有人喜歡直接用開(kāi)源的 U8G2 庫(kù)字體豐富、畫線畫框方便有人喜歡用商家附帶的 SSD1306 驅(qū)動(dòng)文件。我的建議是如果你打算長(zhǎng)期做 STM32 項(xiàng)目至少手寫移植一次底層驅(qū)動(dòng)搞明白原理后再?zèng)Q定要不要換庫(kù)。因?yàn)檎{(diào)試面板的核心就是顯示顯示驅(qū)動(dòng)的可控性直接影響后續(xù)所有功能。3.1 為什么推薦先手寫一次底層驅(qū)動(dòng)商家附帶的驅(qū)動(dòng)代碼質(zhì)量參差不齊有的依賴標(biāo)準(zhǔn)庫(kù)有的用了阻塞延時(shí)還有的把 1KB 顯存整個(gè)塞進(jìn)內(nèi)存。你在自己的項(xiàng)目里集成時(shí)一旦遇到花屏、刷新卡頓根本不知道是驅(qū)動(dòng)問(wèn)題還是邏輯問(wèn)題。手寫底層就不一樣了I2C 發(fā)送命令、發(fā)送數(shù)據(jù)、屏幕初始化、刷新顯存每一條你都清楚后續(xù)排障就有底氣。而且手寫 SSD1306 底層并不復(fù)雜滿打滿算也就 5 個(gè)函數(shù)寫命令、寫數(shù)據(jù)、初始化、清屏、刷新。真正核心的是寫命令和寫數(shù)據(jù)兩個(gè)其他都是基于它們的組合。3.2 HAL 庫(kù)下最簡(jiǎn) I2C 讀寫實(shí)現(xiàn)在 HAL 庫(kù)里I2C 發(fā)送數(shù)據(jù)有兩種方式阻塞式HAL_I2C_Master_Transmit和中斷/DMA 方式。調(diào)試面板初期用阻塞式就夠。關(guān)鍵點(diǎn)是 SSD1306 在 I2C 通信時(shí)第一個(gè)字節(jié)固定是控制字節(jié)0x00表示后續(xù)是命令0x40表示后續(xù)是數(shù)據(jù)。寫命令函數(shù)如下void OLED_WriteCmd(uint8_t cmd) { uint8_t buf[2]; buf[0] 0x00; // 控制字節(jié)命令 buf[1] cmd; HAL_I2C_Master_Transmit(hi2c1, OLED_ADDR, buf, 2, 100); }寫數(shù)據(jù)函數(shù)如下void OLED_WriteData(uint8_t *data, uint16_t len) { uint8_t *buf malloc(len 1); buf[0] 0x40; // 控制字節(jié)數(shù)據(jù) memcpy(buf 1, data, len); HAL_I2C_Master_Transmit(hi2c1, OLED_ADDR, buf, len 1, 100); free(buf); }上面的代碼為了清晰用了 malloc實(shí)際嵌入式項(xiàng)目里更推薦直接準(zhǔn)備一塊 buffer把控制字節(jié)填在頭部避免動(dòng)態(tài)分配帶來(lái)的不確定性。如果一次要發(fā)送的數(shù)據(jù)比較多也可以把控制字節(jié)單獨(dú)作為第一包發(fā)送但性能會(huì)差一些。初始化序列網(wǎng)上很多核心是打開(kāi) OLED 電源、設(shè)置對(duì)比度、解除睡眠、開(kāi)啟顯示。我不建議直接復(fù)制一整段長(zhǎng)達(dá) 30 條的命令序列而是自己精簡(jiǎn)成下面這份OLED_WriteCmd(0xAE); // 關(guān)閉顯示 OLED_WriteCmd(0xAF); // 開(kāi)啟顯示 OLED_WriteCmd(0x8D); // 電荷泵 OLED_WriteCmd(0x14); // 開(kāi)啟電荷泵 OLED_WriteCmd(0x20); // 設(shè)置內(nèi)存尋址模式 OLED_WriteCmd(0x02); // 頁(yè)尋址模式 OLED_WriteCmd(0x81); // 設(shè)置對(duì)比度 OLED_WriteCmd(0xCF); // 對(duì)比度值 OLED_WriteCmd(0xA8); // 設(shè)置 multiplex OLED_WriteCmd(0x3F); // 64 行 OLED_WriteCmd(0xD3); // 顯示偏移 OLED_WriteCmd(0x00); // 偏移 0 OLED_WriteCmd(0x40); // 起始行 OLED_WriteCmd(0xA1); // 段重映射 OLED_WriteCmd(0xC8); // COM 掃描方向 OLED_WriteCmd(0xDA); // COM 引腳配置 OLED_WriteCmd(0x12); OLED_WriteCmd(0xD5); // 時(shí)鐘分頻 OLED_WriteCmd(0x80); OLED_WriteCmd(0xA4); // 關(guān)閉全局顯示這些命令未必每個(gè)都必須但按這個(gè)順序初始化基本都能成功。如果你用別人的驅(qū)動(dòng)包遇到白屏有時(shí)候就是初始化序列少了某個(gè)關(guān)鍵命令。3.3 SSD1306 的顯存機(jī)制與刷新原理SSD1306 內(nèi)置 1KB GDDRAM對(duì)應(yīng) 128×64 像素每 8 個(gè)像素點(diǎn)縱向排成一列字節(jié)。也就是說(shuō)屏幕被分成 8 頁(yè)每頁(yè) 128 字節(jié)每字節(jié)表示這一列中的 8 個(gè)像素的亮滅狀態(tài)。知道這個(gè)機(jī)制有什么用非常重要。當(dāng)你向 SSD1306 寫數(shù)據(jù)時(shí)它內(nèi)部有一個(gè)當(dāng)前頁(yè)地址和當(dāng)前列地址你寫的數(shù)據(jù)會(huì)落到這些位置上。如果不懂頁(yè)尋址你很容易寫出文字上下顛倒或者刷新一半花屏的問(wèn)題。最簡(jiǎn)單的字符顯示方式是按頁(yè)構(gòu)造字形數(shù)據(jù)把 8×16 字模劈成兩半上半頁(yè) 8 字節(jié)、下半頁(yè) 8 字節(jié)分別寫到兩頁(yè)。這也是為什么驅(qū)動(dòng)函數(shù)里要專門有OLED_SetCursor函數(shù)來(lái)切換頁(yè)和列地址。很多人誤以為刷新就是把整個(gè)屏幕的數(shù)據(jù)通過(guò) I2C 全量發(fā)過(guò)去。理論上確實(shí)是這樣但全量刷新 1KB 顯存需要傳輸 1KB 數(shù)據(jù)在 100kHz I2C 下大概要 100ms這還不算地址設(shè)置命令。如果無(wú)腦每秒刷幾十幀總線直接占死而且肉眼可見(jiàn)地閃爍。后面我會(huì)講怎么用局部刷新緩解這個(gè)問(wèn)題。3.4 用 U8G2 快速做儀表盤值不值如果你已經(jīng)熟練掌握了手寫驅(qū)動(dòng)想做得更花哨一點(diǎn)U8G2 是很好的選擇。它內(nèi)置大量字庫(kù)支持畫線、畫圓、畫矩形、畫進(jìn)度條做出來(lái)的面板會(huì)比純字符好看得多。但 U8G2 在 STM32 上的問(wèn)題是內(nèi)存和 Flash 占用偏高一個(gè)包含多個(gè)字體的庫(kù)編譯下來(lái)能到幾十 KB對(duì) Flash 小的芯片比較吃力。方案優(yōu)勢(shì)劣勢(shì)適合場(chǎng)景手寫 SSD1306 驅(qū)動(dòng)占用小、可控性高、依賴少字模和繪圖函數(shù)要自己維護(hù)調(diào)試面板、小型環(huán)境監(jiān)測(cè)U8G2字體豐富、畫圖方便、社區(qū)活躍Flash/RAM 占用高、移植稍重做儀表盤、曲線、復(fù)雜 UI我的實(shí)際體會(huì)是調(diào)試面板這種信息密度不高的界面手寫驅(qū)動(dòng)完全夠用甚至更清爽。真到了需要畫曲線、做波形顯示那一步再引入 U8G2 也不遲。4. 面板信息布局128×64 這塊屏幕要把像素花在刀刃上OLED 面板的難點(diǎn)不在于把數(shù)據(jù)顯示出來(lái)而在于 128×64 只有 8 行 16 像素高度的空間信息一多就堆成亂碼。我在實(shí)際項(xiàng)目中總結(jié)了一套布局方法標(biāo)題欄、數(shù)據(jù)區(qū)、狀態(tài)欄三區(qū)分工每區(qū)只顯示最核心的信息。4.1 128×64 能擺下多少信息16 像素高度的字模通常對(duì)應(yīng) 4 行64 像素高每行 16 像素最多 4 行8 像素高度的字?？梢苑?8 行但清晰度差一些。我的習(xí)慣是標(biāo)題欄用 16 像素高字體數(shù)據(jù)區(qū)用 16 像素高字體狀態(tài)欄用 16 像素高字體一共 3 個(gè)區(qū)剛好放下 4 行。如果有一屏超長(zhǎng)信息寧可翻頁(yè)也不要硬擠否則視覺(jué)上會(huì)非常累。實(shí)際上 4 行數(shù)據(jù)對(duì)調(diào)試面板來(lái)說(shuō)完全夠用。比如環(huán)境監(jiān)測(cè)項(xiàng)目── 環(huán)境監(jiān)測(cè) ── TEMP: 26.5C HUMI: 58.2% LUX : 1234 ALM : OK每一行就一個(gè)數(shù)據(jù)。做 PID 調(diào)試時(shí)我常放目標(biāo)值、反饋值、輸出值、PWM 占空比四行。這種布局的好處是掃一眼就能讀到關(guān)鍵數(shù)字而不是在一大段文本里找數(shù)字。4.2 一個(gè)環(huán)境監(jiān)測(cè)面板的布局示例下面是一個(gè)結(jié)合 DHT11、BH1750 和 MQ-2 傳感器的面板示例。注意我用了一個(gè)OLED_ClearLine函數(shù)來(lái)只清除某一行而不是清全屏。這樣做的意義在于避免整屏閃爍數(shù)據(jù)變化時(shí)只有那一行在重畫。void Draw_EnvPanel(void) { OLED_SetCursor(0, 0); OLED_ShowString(ENV MONITOR); OLED_SetCursor(0, 2); OLED_ShowString(T:); OLED_ShowNum(temp_x100, 16, 2); // 溫度值放大100倍顯示避免小數(shù)點(diǎn)運(yùn)算 OLED_SetCursor(0, 3); OLED_ShowString(H:); OLED_ShowNum(humi_x100, 16, 2); }這里有一個(gè)很多人會(huì)忽略的細(xì)節(jié)把小數(shù)放大成整數(shù)來(lái)顯示。比如溫度 26.53℃單片機(jī)直接處理浮點(diǎn)會(huì)比較吃力習(xí)慣做法是temp_x100 (uint16_t)(temp * 100)顯示時(shí)手動(dòng)加小數(shù)點(diǎn)。這樣既省了浮點(diǎn)運(yùn)算又能精確顯示兩位小數(shù)。4.3 用按鍵翻頁(yè)管理更多調(diào)試數(shù)據(jù)面板再智能一屏也就 4 行。我的方案是給面板配上按鍵翻頁(yè)最常見(jiàn)的是接一個(gè) GPIO 按鍵每按一次切換一頁(yè)。頁(yè)面表可以設(shè)計(jì)成結(jié)構(gòu)體數(shù)組typedef struct { void (*draw)(void); // 繪制函數(shù) char *title; // 頁(yè)面標(biāo)題 } PanelPage;主循環(huán)里檢測(cè)按鍵事件頁(yè)索引加一取模然后調(diào)用對(duì)應(yīng)draw函數(shù)。這個(gè)結(jié)構(gòu)擴(kuò)展性很好加一個(gè)傳感器、加一個(gè)調(diào)試頁(yè)面只需要在數(shù)組里多注冊(cè)一個(gè)繪制函數(shù)。配合 OLED 的低刷新率翻頁(yè)時(shí)有一種換了一屏的爽快感非常適合調(diào)試狀態(tài)比較多的項(xiàng)目。不過(guò)按鍵翻頁(yè)有一個(gè)坑普通的機(jī)械按鍵在中斷里直接改頁(yè)索引容易產(chǎn)生抖動(dòng)導(dǎo)致的跳頁(yè)。我的做法是按鍵掃描放在主循環(huán)用 20ms 消抖檢測(cè)到按下并釋放的完整事件才切換頁(yè)面。這也是熱詞里stm32按鍵模塊電路設(shè)計(jì)經(jīng)常被問(wèn)到的原因之一——很多人把按鍵消抖放在中斷里結(jié)果一按跳兩頁(yè)。5. 刷新策略實(shí)時(shí)和閃爍之間的平衡光有一直刷屏是不夠的調(diào)通驅(qū)動(dòng)后很多人會(huì)興奮地把主循環(huán)寫成while(1) { OLED_RefreshFull(); }結(jié)果屏幕瘋狂閃爍、I2C 總線被占滿、主邏輯卡頓。這是實(shí)時(shí)面板最常見(jiàn)的問(wèn)題刷新策略不對(duì)。5.1 為什么無(wú)腦全屏刷新不行全屏刷新要傳 1KB 數(shù)據(jù)再加上設(shè)置命令一次完整刷新在 100kHz I2C 下輕松超過(guò) 100ms。如果你的主循環(huán)里還做傳感器采樣、PID 計(jì)算、按鍵檢測(cè)這些任務(wù)全被 I2C 阻塞拖住。更要命的是人眼對(duì) 30Hz 以上的閃爍才不敏感而 I2C 全屏刷新很難做到這個(gè)幀率所以整體觀感就是屏幕一直在抖。我第一次做面板時(shí)也踩了這個(gè)坑。當(dāng)時(shí)采樣頻率是 20Hz靠HAL_GetTick控制但每次采樣后都強(qiáng)制全屏刷新結(jié)果傳感器數(shù)據(jù)沒(méi)變屏卻在空轉(zhuǎn)還拖慢了控制周期。后來(lái)我意識(shí)到調(diào)試面板并不需要實(shí)時(shí)到每毫秒都在刷真正需要的只是你看到數(shù)字變化的時(shí)候數(shù)字是可信的這個(gè)頻率 10Hz 都?jí)蛄恕?.2 局部臟矩形刷新與幀率控制正確的做法是只在數(shù)據(jù)變化時(shí)刷新對(duì)應(yīng)區(qū)域。SSD1306 支持按頁(yè)設(shè)置起始列地址所以我寫了一套簡(jiǎn)單的局部刷新接口void OLED_UpdateLine(uint8_t page, uint8_t *buf) { OLED_WriteCmd(0xB0 page); // 設(shè)置頁(yè)地址 OLED_WriteCmd(0x00 (2 0x0F)); // 設(shè)置列地址低4位 OLED_WriteCmd(0x10 (2 4)); // 設(shè)置列地址高4位 OLED_WriteData(buf, 128); // 寫這一整頁(yè)的顯存數(shù)據(jù) }有了這個(gè)函數(shù)我在更新溫度時(shí)只重畫第 2 行對(duì)應(yīng)的頁(yè)緩存再更新方向。做一個(gè)簡(jiǎn)單的幀率控制用HAL_GetTick記錄上次刷新時(shí)間數(shù)據(jù)區(qū)域每 100ms 刷一次動(dòng)態(tài)參數(shù)比如狀態(tài)燈每 200ms 刷一次。這樣即使傳感器數(shù)據(jù)變快也不會(huì)疲于奔命。這里有個(gè)實(shí)操技巧OLED_UpdateLine結(jié)合屏幕緩沖數(shù)組使用。我自己維護(hù)一個(gè) 128×64/8 1024 字節(jié)的數(shù)組oled_buf[]所有繪制函數(shù)先在 buffer 里改像素然后再把 buffer 對(duì)應(yīng)區(qū)域傳給屏幕。這樣避免了每次寫屏幕都要重新組織 I2C 包的麻煩也方便做臟矩形只有 buffer 里發(fā)生變化的那幾行才真正通過(guò) I2C 發(fā)送出去。5.3 DMA 后臺(tái)刷新與 I2C 時(shí)鐘的取舍如果面板信息量大局部刷新還不夠可以上 DMA。HAL 庫(kù)的 I2C DMA 發(fā)送函數(shù)HAL_I2C_Master_Transmit_DMA可以讓 CPU 在 I2C 搬運(yùn)數(shù)據(jù)的間隙繼續(xù)跑邏輯。我實(shí)測(cè)過(guò)在 400kHz I2C 下 DMA 模式傳送 1KB 數(shù)據(jù)只需要 20ms 左右CPU 基本不等待。代價(jià)是實(shí)現(xiàn)復(fù)雜度上去了要處理 I2C 事件回調(diào)、保證 buffer 在 DMA 傳輸期間不被改動(dòng)否則會(huì)出現(xiàn)撕裂畫面。I2C 時(shí)鐘的取舍也需要實(shí)測(cè)。STM32 默認(rèn) I2C 時(shí)鐘是 100kHz 標(biāo)準(zhǔn)模式可以提高到 400kHz 快速模式。很多模塊在 400kHz 下沒(méi)問(wèn)題但個(gè)別老模塊或者走線太長(zhǎng)的場(chǎng)景速率提高后反而開(kāi)始花屏或者丟數(shù)據(jù)。我的建議是先跑 100kHz 確認(rèn)穩(wěn)定再用 400kHz 做對(duì)比如果顯示出現(xiàn)亂碼就降回 100kHz。調(diào)試面板對(duì)刷新率要求不高100kHz 完全夠用。我自己的選擇是大部分項(xiàng)目用局部刷新 100kHz I2C只有做音頻頻譜那種需要高頻動(dòng)畫的面板時(shí)才考慮 DMA 400kHz。記住一點(diǎn)調(diào)試面板的價(jià)值在信息的可信度和可讀性不在畫面的流暢度。6. 花屏、白屏、卡死實(shí)測(cè)中避不開(kāi)的四個(gè)坑和完整排查鏈路這一章我想集中聊排障因?yàn)?OLED 面板的故障現(xiàn)象非常迷惑人白屏、花屏、部分行不顯示、初始化卡死每個(gè)坑都能讓你懷疑人生。我把我自己和網(wǎng)友常遇到的問(wèn)題整理成一套排查鏈路。6.1 白屏優(yōu)先檢查地址而不是驅(qū)動(dòng)代碼模塊上電后整個(gè)屏幕點(diǎn)亮但全白或者完全不亮很多人第一反應(yīng)是初始化序列錯(cuò)了。其實(shí)更常見(jiàn)的罪魁禍?zhǔn)资?I2C 地址不對(duì)。0.96 寸 SSD1306 模塊的 I2C 地址通常是 0x3C但有些模塊是 0x3D。排查時(shí)不要瞎猜用一段 I2C 掃描代碼直接探測(cè)。HAL 庫(kù)里可以循環(huán)調(diào)用HAL_I2C_IsDeviceReady(hi2c1, addr, 1, 100)把所有可能的地址掃一遍看返回 OK 的是哪個(gè)。掃描結(jié)果比任何資料都可靠。白屏的第二個(gè)原因是接線問(wèn)題尤其是 GND 沒(méi)共地。STM32 和 OLED 模塊必須共地否則 I2C 電平參考不一致通信會(huì)間歇性失敗有時(shí)現(xiàn)象就是白屏。第三個(gè)原因是 3.3V 供電不足如果開(kāi)發(fā)板同時(shí)帶多個(gè)外設(shè)建議用萬(wàn)用表量一下 OLED 的 VCC 引腳低于 3.0V 就該考慮外接穩(wěn)壓。6.2 花屏多半不是屏幕的問(wèn)題而是總線時(shí)序被打斷花屏的典型表現(xiàn)是屏幕能顯示但內(nèi)容出現(xiàn)隨機(jī)橫條、字符錯(cuò)亂、有時(shí)候正常有時(shí)候亂碼。很多初學(xué)者懷疑模塊壞了其實(shí) SSD1306 很耐操通常不是硬件問(wèn)題。花屏最常見(jiàn)的根因是在 I2C 傳輸過(guò)程中更高優(yōu)先級(jí)的中斷打斷了傳輸。比如你的代碼里用了定時(shí)器中斷采樣傳感器中斷里又修改了 OLED 的 buffer 或者發(fā)出新的 I2C 請(qǐng)求兩個(gè) I2C 操作交織在一起SSD1306 內(nèi)部狀態(tài)機(jī)就亂了。解決辦法有三個(gè)方向一是避免在中斷里直接操作 OLED只在主循環(huán)刷新二是給 I2C 傳輸加臨界區(qū)保護(hù)比如__disable_irq()和__enable_irq()包裹發(fā)送過(guò)程三是用 DMA 傳輸減輕 CPU 在傳輸期間被中斷打擾的概率?；ㄆ恋牡诙€(gè)常見(jiàn)原因是模塊供電瞬時(shí)跌落。OLED 刷新時(shí)電流脈沖比較明顯如果 VCC 走線太長(zhǎng)或者杜邦線老化屏幕會(huì)出現(xiàn)偶發(fā)花屏。換短線、加個(gè) 100uF 電解電容在 VCC 和 GND 之間往往能解決。還有一種花屏其實(shí)是地址設(shè)置混亂比如頁(yè)尋址模式下你寫數(shù)據(jù)超出了一頁(yè)范圍沒(méi)有自動(dòng)換頁(yè)后續(xù)數(shù)據(jù)就寫到了亂七八糟的位置。這種情況多出現(xiàn)在自己寫的底層驅(qū)動(dòng)里注意先設(shè)置頁(yè)地址和列地址再發(fā)送該行數(shù)據(jù)。6.3 初始化卡死SysTick 和延時(shí)函數(shù)還有下載器沖突熱詞里反復(fù)出現(xiàn)stm32延時(shí)函數(shù)delay卡死這事在 OLED 初始化里也常發(fā)生。很多商家驅(qū)動(dòng)用delay_ms()來(lái)做時(shí)序如果這個(gè)延時(shí)函數(shù)依賴 SysTick而 SysTick 又被調(diào)試器或者其他代碼占用初始化就會(huì)卡在某個(gè)while等待上。排查思路很簡(jiǎn)單先單獨(dú)跑一個(gè)LED 閃燈 OLED 初始化的最小工程確認(rèn)延時(shí)函數(shù)和 OLED 初始化本身沒(méi)問(wèn)題再集成到業(yè)務(wù)代碼里。如果最小工程正常、大工程卡死那問(wèn)題多半出在某個(gè)中斷把 SysTick 搶占了或者某處代碼把 SysTick 優(yōu)先級(jí)改壞了。另外推薦一個(gè)更穩(wěn)的做法OLED 初始化時(shí)把延時(shí)改成HAL_Delay()HAL 庫(kù)的HAL_Delay是基于 SysTick 的只要配置好就能用。如果項(xiàng)目里有其他延時(shí)函數(shù)確保不要同時(shí)操作 SysTick 的計(jì)數(shù)寄存器否則相互覆蓋會(huì)讓 delay 卡死。6.4 JTAG 引腳復(fù)用惹的禍這個(gè)坑在 STM32 上特別典型。PB3、PB4、PA15 默認(rèn)是 JTAG 引腳如果你為了省引腳把 OLED 的 SCL/SDA 或者按鍵接到了這些腳上程序下載后 OLED 可能完全沒(méi)有反應(yīng)。因?yàn)閺?fù)位之后 JTAG 還占用著這些引腳的特殊功能GPIO 配置根本沒(méi)生效I2C 信號(hào)出不來(lái)。解決辦法有兩種一是在初始化最前面調(diào)用GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);標(biāo)準(zhǔn)庫(kù)寫法把 JTAG 關(guān)掉、只保留 SWD如果是 HAL 庫(kù)可以在SystemInit后直接操作 AFIO 重映射寄存器。二更簡(jiǎn)單換引腳。OLED 的 SCL/SDA 用 PB6/PB7 或者 PB8/PB9避開(kāi)這些默認(rèn)調(diào)試引腳一勞永逸。還有個(gè)關(guān)聯(lián)坑代碼里禁用了 JTAG 后Keil 的 ST-Link 還走 SWD 接口一般沒(méi)事但如果你用了 J-Link 的 JTAG 下載模式關(guān)閉 JTAG 后可能就下載不進(jìn)去了。真碰上這種情況先按住芯片復(fù)位鍵再點(diǎn)下載有些環(huán)境能救回來(lái)實(shí)在不行用串口 ISP 擦除。7. 把調(diào)試面板做成調(diào)試控制臺(tái)日志、報(bào)警、錯(cuò)誤碼定格等驅(qū)動(dòng)穩(wěn)定、布局合理之后OLED 面板就可以往控制臺(tái)的方向進(jìn)化而不只是幾個(gè)數(shù)字的展示。7.1 滾動(dòng)日志頁(yè)和串口日志一樣翻頁(yè)看歷史OLED 的 4 行空間做滾動(dòng)日志是可行的。我維護(hù)一個(gè)環(huán)形緩沖區(qū)每行存一個(gè)日志字符串屏幕顯示最后 4 行。新日志到來(lái)時(shí)緩沖區(qū)追加一行并重繪整個(gè)日志頁(yè)。按下翻頁(yè)鍵可以看更早的歷史。打印函數(shù)仿照 printf 做一個(gè)帶可變參數(shù)的LogLine(const char *fmt, ...)底層用vsnprintf格式化到緩沖區(qū)再調(diào)用 OLED 繪制函數(shù)。這套機(jī)制在設(shè)備故障復(fù)現(xiàn)時(shí)非常好用——當(dāng)設(shè)備已經(jīng)在現(xiàn)場(chǎng)跑起來(lái)不接串口也能靠屏幕回憶剛才發(fā)生了什么。不過(guò)要提醒一點(diǎn)OLED 不適合高頻日志一秒鐘刷十幾行文字會(huì)非常閃。我的經(jīng)驗(yàn)是只記錄狀態(tài)變化級(jí)別的日志正常周期性數(shù)據(jù)不打印這樣才能保證問(wèn)題出現(xiàn)時(shí)能看到邊界信息。7.2 傳感器閾值報(bào)警與錯(cuò)誤碼定格結(jié)合環(huán)境監(jiān)測(cè)里的 DHT11、BH1750、MQ-2面板可以做成報(bào)警屏當(dāng)某個(gè)參數(shù)超限對(duì)應(yīng)行進(jìn)入閃爍或者反白狀態(tài)。更實(shí)用的做法是錯(cuò)誤碼定格——程序檢測(cè)到嚴(yán)重錯(cuò)誤時(shí)把錯(cuò)誤代碼和現(xiàn)場(chǎng)參數(shù)凍結(jié)在屏幕上同時(shí)停止刷新讓 OLED 保持呼吸燈式慢閃。這樣即使沒(méi)有上位機(jī)現(xiàn)場(chǎng)工程師也能用手機(jī)拍一張屏幕照片回去定位問(wèn)題。我做過(guò)一個(gè)溫控項(xiàng)目面板上專門有一行顯示ERROR: 0x03之類的狀態(tài)。當(dāng)溫度傳感器無(wú)響應(yīng)時(shí)錯(cuò)誤碼會(huì)從 0x00 變成 0x03并且后臺(tái)停止 PID 輸出。調(diào)試的時(shí)候不用再翻代碼猜錯(cuò)誤直接看屏幕就能知道是采樣超時(shí)還是傳感器斷線。7.3 與更多項(xiàng)目場(chǎng)景的聯(lián)動(dòng)擴(kuò)展這塊面板的思路完全可以擴(kuò)展到其他 STM32 項(xiàng)目里。超聲波測(cè)距項(xiàng)目可以用來(lái)顯示當(dāng)前距離和閾值智能臺(tái)燈項(xiàng)目可以用來(lái)顯示環(huán)境光和 PWM 占空比兩輪差速小車可以實(shí)時(shí)顯示左右輪編碼器計(jì)數(shù)和目標(biāo)速度魚缸控制器可以顯示溫度、水位和加熱器狀態(tài)。只要你的項(xiàng)目需要脫機(jī)看狀態(tài)這套 OLED 面板結(jié)構(gòu)就能直接復(fù)用到下一個(gè)項(xiàng)目里。我自己的習(xí)慣是做一個(gè)debug_panel.c模塊把繪制、頁(yè)面注冊(cè)、按鍵翻頁(yè)都封裝好新項(xiàng)目只需要改數(shù)據(jù)和繪制函數(shù)。這樣積累幾套項(xiàng)目之后做調(diào)試面板從半天壓縮到半小時(shí)剩下就是調(diào)布局和配色的事了。最后再分享一個(gè)我實(shí)際用下來(lái)很順手的小技巧把面板設(shè)計(jì)成上電先顯示版本號(hào)和編譯時(shí)間。這樣做的好處是現(xiàn)場(chǎng)看到一臺(tái)設(shè)備一眼就知道跑的是哪版固件配合錯(cuò)誤碼定格很多玄學(xué)故障都能快速定位到固件版本差異上。調(diào)試面板這件事說(shuō)到底不是炫技而是讓自己在脫機(jī)環(huán)境下也能保持對(duì)設(shè)備的掌控感。 用OLED給STM32打造實(shí)時(shí)調(diào)試面板：從接線到排障全指南
用 OLED 給 STM32 做實(shí)時(shí)調(diào)試面板這個(gè)想法其實(shí)是從一次調(diào)試線夠不著的現(xiàn)場(chǎng)冒出來(lái)的。當(dāng)時(shí)我在調(diào)一臺(tái)裝進(jìn)亞克力殼子里的環(huán)境監(jiān)測(cè)設(shè)備串口線塞不進(jìn)去邏輯分析儀又太大板子上的狀態(tài)全靠一個(gè) LED 閃來(lái)閃去根本分不清是光照傳感器飄了還是 MQ-2 誤報(bào)。后來(lái)我直接在 0.96 寸 OLED 上做了一個(gè)實(shí)時(shí)調(diào)試面板把溫濕度、光照、傳感器狀態(tài)、錯(cuò)誤計(jì)數(shù)全部就地顯示整個(gè)調(diào)試體驗(yàn)直接變了個(gè)樣。這篇文章就圍繞這塊小屏幕展開(kāi)從硬件接線到驅(qū)動(dòng)移植從面板布局到刷新策略再到花屏、白屏、死機(jī)這些實(shí)測(cè)坑完整帶你走一遍調(diào)試面板的搭建過(guò)程。無(wú)論你是剛學(xué) STM32 的入門者還是正在做畢設(shè)、搞環(huán)境監(jiān)測(cè)、做智能小車的老手這套方案基本都能直接抄作業(yè)。1. 做調(diào)試面板之前的真實(shí)需求串口日志在哪些場(chǎng)景會(huì)失靈很多人的第一反應(yīng)是要調(diào)試為什么不打串口日志確實(shí)串口 printf 是最普及的調(diào)試手段Keil 的仿真器也能看變量?？赡阋坏┌寻遄訌淖烂媾驳秸鎸?shí)設(shè)備里問(wèn)題就來(lái)了。1.1 串口調(diào)試的三個(gè)無(wú)力場(chǎng)景第一類是物理夠不著。小車跑起來(lái)之后你不可能拖著一根串口線跟著跑設(shè)備裝進(jìn)外殼之后調(diào)試口被擋在內(nèi)部魚缸控制器泡在水族箱旁邊插拔線纜還得挪動(dòng)整個(gè)裝置。這類場(chǎng)景里串口助手從隨時(shí)可看變成了偶爾能接一下。第二類是數(shù)據(jù)不夠直觀。串口打印的是一堆數(shù)字流你得在腦子里想象某個(gè)變量隨時(shí)間的變化曲線。比如 PID 輸出每秒打印 20 行會(huì)上翻得飛快你根本看不出趨勢(shì)。LED 指示呢只能表達(dá)正常/異常二值狀態(tài)多幾個(gè)狀態(tài)就亂了。第三類是現(xiàn)場(chǎng)沒(méi)有上位機(jī)。去客戶現(xiàn)場(chǎng)、或者帶去戶外測(cè)試時(shí)筆記本不一定帶就算帶了串口線也未必匹配更不要說(shuō)車?yán)?、野外這些環(huán)境。1.2 為什么 OLED 是實(shí)時(shí)調(diào)試面板的合理答案OLED 模塊的特點(diǎn)是便宜、體積小、功耗低、接口少。市面上最常見(jiàn)的 0.96 寸四針 I2C 模塊四根線就能掛到 STM32 上顯示 128×64 像素足夠支撐一個(gè)現(xiàn)場(chǎng)狀態(tài)面板。它不像 LCD1602 那樣受視角限制也不像 TFT 彩屏那樣占引腳、占內(nèi)存。最關(guān)鍵的一點(diǎn)是OLED 顯示的是就地信息——板子在哪里信息就在哪里不依賴任何外部設(shè)施。我見(jiàn)過(guò)有人給 STM32 掛一個(gè) 7 寸 HDMI 屏幕做調(diào)試界面殺雞用牛刀而且 7 寸屏的初始化、顯存開(kāi)銷、繪制時(shí)間都遠(yuǎn)超一個(gè)調(diào)試面板的需求。OLED 面板的核心價(jià)值不是顯示好多信息而是在你不需要上位機(jī)和調(diào)試器的時(shí)候把關(guān)鍵變量直接擺在你眼前。1.3 這套方案適合誰(shuí)正在用標(biāo)準(zhǔn)庫(kù)或者 HAL 庫(kù)寫 STM32 項(xiàng)目的人手里恰好有或者準(zhǔn)備買一塊 0.96 寸 SSD1306 模塊想把調(diào)試體驗(yàn)從盲調(diào)升級(jí)成可視化這篇文章就是為你準(zhǔn)備的。前置知識(shí)不需要太多了解 I2C 的基本讀寫、知道 GPIO 怎么配置其他我盡量講得細(xì)致一點(diǎn)。2. 硬件準(zhǔn)備0.96 寸四針 OLED 與 STM32 的接線其實(shí)暗藏兩個(gè)坑硬件連接是這個(gè)項(xiàng)目里最簡(jiǎn)單的部分但簡(jiǎn)單不代表沒(méi)坑。我見(jiàn)過(guò)不少人卡在模塊不亮上回頭一看不是代碼問(wèn)題而是引腳沖突或者供電不對(duì)。2.1 四針 I2C 模塊與七針 SPI 模塊怎么選市面上 0.96 寸的 OLED 模塊有兩種主流接口四針 I2C 和七針 SPI。做調(diào)試面板我強(qiáng)烈建議選四針 I2C 版本。原因很直接只需要 SCL 和 SDA 兩根信號(hào)線剩下的 VCC 和 GND 接電源就行給其他外設(shè)留出更多引腳。而七針 SPI 版本雖然刷新速度更快但除了時(shí)鐘和數(shù)據(jù)線還要接 CS、DC、RES 三個(gè)控制引腳對(duì)調(diào)試面板這種信息量不大的場(chǎng)景來(lái)說(shuō)純屬浪費(fèi)引腳資源。有一種四針模塊可能是 I2C也可能是 SPI買的時(shí)候要看清型號(hào)。SSD1306 主控的 I2C 四針模塊一般會(huì)印著 SCL、SDA 兩個(gè)絲印如果印著 SCK、MOSI那就是 SPI。別買錯(cuò)了不然程序怎么調(diào)都不亮。2.2 引腳分配與接線實(shí)操我以 STM32F103C8T6 最小系統(tǒng)板為例。I2C1 的默認(rèn)引腳是 PB6(SCL) 和 PB7(SDA)HAL 庫(kù)配置里選 Alternate Function Open-Drain 模式即可。如果你用的是其他型號(hào)比如 F407 或者 G4 系列只要確認(rèn)對(duì)應(yīng)的 I2C 引腳就好邏輯完全一致。接線表如下OLED 模塊引腳連接到 STM32說(shuō)明VCC3.3V注意大多數(shù) 0.96 寸模塊是 3.3V 供電GNDGND共地必須可靠SCLPB6I2C1 時(shí)鐘線板上一般有上拉SDAPB7I2C1 數(shù)據(jù)線這里有一個(gè)實(shí)操細(xì)節(jié)很多模塊的 I2C 地址是 0x3C也有部分廠家做成 0x3D。驅(qū)動(dòng)代碼里如果發(fā)現(xiàn)初始化后白屏第一件事不是翻代碼而是確認(rèn)模塊背面的地址電阻或者用 I2C 掃描程序確認(rèn)當(dāng)前地址。這個(gè)問(wèn)題我在后面的排障章節(jié)會(huì)專門展開(kāi)。2.3 供電與上拉電阻的兩個(gè)隱藏細(xì)節(jié)第一個(gè)坑是供電電壓。0.96 寸模塊雖然很多標(biāo)注支持 3.3V/5V但它的核心 SSD1306 是 3.3V 器件。如果你的開(kāi)發(fā)板有 3.3V 引腳就盡量接 3.3V別圖省事接 5V時(shí)間長(zhǎng)了模塊上的穩(wěn)壓電路發(fā)熱花屏概率會(huì)明顯變大。個(gè)別無(wú)穩(wěn)壓的模塊接 5V 后直接燒壞。第二個(gè)坑是 I2C 上拉電阻。大部分現(xiàn)成模塊上已經(jīng)板載了 4.7k 上拉電阻直接接線即可。但如果你買的是那種裸屏或者自己打板的擴(kuò)展板可能沒(méi)有上拉這時(shí) SCL、SDA 必須外接兩個(gè) 4.7k 電阻到 3.3V否則總線拉不上去OLED 完全不工作。怎么判斷用萬(wàn)用表量 SCL 對(duì) GND 的電阻數(shù)值在 3k~7k 之間通常說(shuō)明有上拉。3. 驅(qū)動(dòng)層怎么選手寫 SSD1306 底層還是直接用 U8G2我的建議是先手寫一次驅(qū)動(dòng) OLED 核心就是通過(guò) I2C 往 SSD1306 芯片寫命令和數(shù)據(jù)。有人喜歡直接用開(kāi)源的 U8G2 庫(kù)字體豐富、畫線畫框方便有人喜歡用商家附帶的 SSD1306 驅(qū)動(dòng)文件。我的建議是如果你打算長(zhǎng)期做 STM32 項(xiàng)目至少手寫移植一次底層驅(qū)動(dòng)搞明白原理后再?zèng)Q定要不要換庫(kù)。因?yàn)檎{(diào)試面板的核心就是顯示顯示驅(qū)動(dòng)的可控性直接影響后續(xù)所有功能。3.1 為什么推薦先手寫一次底層驅(qū)動(dòng)商家附帶的驅(qū)動(dòng)代碼質(zhì)量參差不齊有的依賴標(biāo)準(zhǔn)庫(kù)有的用了阻塞延時(shí)還有的把 1KB 顯存整個(gè)塞進(jìn)內(nèi)存。你在自己的項(xiàng)目里集成時(shí)一旦遇到花屏、刷新卡頓根本不知道是驅(qū)動(dòng)問(wèn)題還是邏輯問(wèn)題。手寫底層就不一樣了I2C 發(fā)送命令、發(fā)送數(shù)據(jù)、屏幕初始化、刷新顯存每一條你都清楚后續(xù)排障就有底氣。而且手寫 SSD1306 底層并不復(fù)雜滿打滿算也就 5 個(gè)函數(shù)寫命令、寫數(shù)據(jù)、初始化、清屏、刷新。真正核心的是寫命令和寫數(shù)據(jù)兩個(gè)其他都是基于它們的組合。3.2 HAL 庫(kù)下最簡(jiǎn) I2C 讀寫實(shí)現(xiàn)在 HAL 庫(kù)里I2C 發(fā)送數(shù)據(jù)有兩種方式阻塞式HAL_I2C_Master_Transmit和中斷/DMA 方式。調(diào)試面板初期用阻塞式就夠。關(guān)鍵點(diǎn)是 SSD1306 在 I2C 通信時(shí)第一個(gè)字節(jié)固定是控制字節(jié)0x00表示后續(xù)是命令0x40表示后續(xù)是數(shù)據(jù)。寫命令函數(shù)如下void OLED_WriteCmd(uint8_t cmd) { uint8_t buf[2]; buf[0] 0x00; // 控制字節(jié)命令 buf[1] cmd; HAL_I2C_Master_Transmit(hi2c1, OLED_ADDR, buf, 2, 100); }寫數(shù)據(jù)函數(shù)如下void OLED_WriteData(uint8_t *data, uint16_t len) { uint8_t *buf malloc(len 1); buf[0] 0x40; // 控制字節(jié)數(shù)據(jù) memcpy(buf 1, data, len); HAL_I2C_Master_Transmit(hi2c1, OLED_ADDR, buf, len 1, 100); free(buf); }上面的代碼為了清晰用了 malloc實(shí)際嵌入式項(xiàng)目里更推薦直接準(zhǔn)備一塊 buffer把控制字節(jié)填在頭部避免動(dòng)態(tài)分配帶來(lái)的不確定性。如果一次要發(fā)送的數(shù)據(jù)比較多也可以把控制字節(jié)單獨(dú)作為第一包發(fā)送但性能會(huì)差一些。初始化序列網(wǎng)上很多核心是打開(kāi) OLED 電源、設(shè)置對(duì)比度、解除睡眠、開(kāi)啟顯示。我不建議直接復(fù)制一整段長(zhǎng)達(dá) 30 條的命令序列而是自己精簡(jiǎn)成下面這份OLED_WriteCmd(0xAE); // 關(guān)閉顯示 OLED_WriteCmd(0xAF); // 開(kāi)啟顯示 OLED_WriteCmd(0x8D); // 電荷泵 OLED_WriteCmd(0x14); // 開(kāi)啟電荷泵 OLED_WriteCmd(0x20); // 設(shè)置內(nèi)存尋址模式 OLED_WriteCmd(0x02); // 頁(yè)尋址模式 OLED_WriteCmd(0x81); // 設(shè)置對(duì)比度 OLED_WriteCmd(0xCF); // 對(duì)比度值 OLED_WriteCmd(0xA8); // 設(shè)置 multiplex OLED_WriteCmd(0x3F); // 64 行 OLED_WriteCmd(0xD3); // 顯示偏移 OLED_WriteCmd(0x00); // 偏移 0 OLED_WriteCmd(0x40); // 起始行 OLED_WriteCmd(0xA1); // 段重映射 OLED_WriteCmd(0xC8); // COM 掃描方向 OLED_WriteCmd(0xDA); // COM 引腳配置 OLED_WriteCmd(0x12); OLED_WriteCmd(0xD5); // 時(shí)鐘分頻 OLED_WriteCmd(0x80); OLED_WriteCmd(0xA4); // 關(guān)閉全局顯示這些命令未必每個(gè)都必須但按這個(gè)順序初始化基本都能成功。如果你用別人的驅(qū)動(dòng)包遇到白屏有時(shí)候就是初始化序列少了某個(gè)關(guān)鍵命令。3.3 SSD1306 的顯存機(jī)制與刷新原理SSD1306 內(nèi)置 1KB GDDRAM對(duì)應(yīng) 128×64 像素每 8 個(gè)像素點(diǎn)縱向排成一列字節(jié)。也就是說(shuō)屏幕被分成 8 頁(yè)每頁(yè) 128 字節(jié)每字節(jié)表示這一列中的 8 個(gè)像素的亮滅狀態(tài)。知道這個(gè)機(jī)制有什么用非常重要。當(dāng)你向 SSD1306 寫數(shù)據(jù)時(shí)它內(nèi)部有一個(gè)當(dāng)前頁(yè)地址和當(dāng)前列地址你寫的數(shù)據(jù)會(huì)落到這些位置上。如果不懂頁(yè)尋址你很容易寫出文字上下顛倒或者刷新一半花屏的問(wèn)題。最簡(jiǎn)單的字符顯示方式是按頁(yè)構(gòu)造字形數(shù)據(jù)把 8×16 字模劈成兩半上半頁(yè) 8 字節(jié)、下半頁(yè) 8 字節(jié)分別寫到兩頁(yè)。這也是為什么驅(qū)動(dòng)函數(shù)里要專門有OLED_SetCursor函數(shù)來(lái)切換頁(yè)和列地址。很多人誤以為刷新就是把整個(gè)屏幕的數(shù)據(jù)通過(guò) I2C 全量發(fā)過(guò)去。理論上確實(shí)是這樣但全量刷新 1KB 顯存需要傳輸 1KB 數(shù)據(jù)在 100kHz I2C 下大概要 100ms這還不算地址設(shè)置命令。如果無(wú)腦每秒刷幾十幀總線直接占死而且肉眼可見(jiàn)地閃爍。后面我會(huì)講怎么用局部刷新緩解這個(gè)問(wèn)題。3.4 用 U8G2 快速做儀表盤值不值如果你已經(jīng)熟練掌握了手寫驅(qū)動(dòng)想做得更花哨一點(diǎn)U8G2 是很好的選擇。它內(nèi)置大量字庫(kù)支持畫線、畫圓、畫矩形、畫進(jìn)度條做出來(lái)的面板會(huì)比純字符好看得多。但 U8G2 在 STM32 上的問(wèn)題是內(nèi)存和 Flash 占用偏高一個(gè)包含多個(gè)字體的庫(kù)編譯下來(lái)能到幾十 KB對(duì) Flash 小的芯片比較吃力。方案優(yōu)勢(shì)劣勢(shì)適合場(chǎng)景手寫 SSD1306 驅(qū)動(dòng)占用小、可控性高、依賴少字模和繪圖函數(shù)要自己維護(hù)調(diào)試面板、小型環(huán)境監(jiān)測(cè)U8G2字體豐富、畫圖方便、社區(qū)活躍Flash/RAM 占用高、移植稍重做儀表盤、曲線、復(fù)雜 UI我的實(shí)際體會(huì)是調(diào)試面板這種信息密度不高的界面手寫驅(qū)動(dòng)完全夠用甚至更清爽。真到了需要畫曲線、做波形顯示那一步再引入 U8G2 也不遲。4. 面板信息布局128×64 這塊屏幕要把像素花在刀刃上OLED 面板的難點(diǎn)不在于把數(shù)據(jù)顯示出來(lái)而在于 128×64 只有 8 行 16 像素高度的空間信息一多就堆成亂碼。我在實(shí)際項(xiàng)目中總結(jié)了一套布局方法標(biāo)題欄、數(shù)據(jù)區(qū)、狀態(tài)欄三區(qū)分工每區(qū)只顯示最核心的信息。4.1 128×64 能擺下多少信息16 像素高度的字模通常對(duì)應(yīng) 4 行64 像素高每行 16 像素最多 4 行8 像素高度的字?？梢苑?8 行但清晰度差一些。我的習(xí)慣是標(biāo)題欄用 16 像素高字體數(shù)據(jù)區(qū)用 16 像素高字體狀態(tài)欄用 16 像素高字體一共 3 個(gè)區(qū)剛好放下 4 行。如果有一屏超長(zhǎng)信息寧可翻頁(yè)也不要硬擠否則視覺(jué)上會(huì)非常累。實(shí)際上 4 行數(shù)據(jù)對(duì)調(diào)試面板來(lái)說(shuō)完全夠用。比如環(huán)境監(jiān)測(cè)項(xiàng)目── 環(huán)境監(jiān)測(cè) ── TEMP: 26.5C HUMI: 58.2% LUX : 1234 ALM : OK每一行就一個(gè)數(shù)據(jù)。做 PID 調(diào)試時(shí)我常放目標(biāo)值、反饋值、輸出值、PWM 占空比四行。這種布局的好處是掃一眼就能讀到關(guān)鍵數(shù)字而不是在一大段文本里找數(shù)字。4.2 一個(gè)環(huán)境監(jiān)測(cè)面板的布局示例下面是一個(gè)結(jié)合 DHT11、BH1750 和 MQ-2 傳感器的面板示例。注意我用了一個(gè)OLED_ClearLine函數(shù)來(lái)只清除某一行而不是清全屏。這樣做的意義在于避免整屏閃爍數(shù)據(jù)變化時(shí)只有那一行在重畫。void Draw_EnvPanel(void) { OLED_SetCursor(0, 0); OLED_ShowString(ENV MONITOR); OLED_SetCursor(0, 2); OLED_ShowString(T:); OLED_ShowNum(temp_x100, 16, 2); // 溫度值放大100倍顯示避免小數(shù)點(diǎn)運(yùn)算 OLED_SetCursor(0, 3); OLED_ShowString(H:); OLED_ShowNum(humi_x100, 16, 2); }這里有一個(gè)很多人會(huì)忽略的細(xì)節(jié)把小數(shù)放大成整數(shù)來(lái)顯示。比如溫度 26.53℃單片機(jī)直接處理浮點(diǎn)會(huì)比較吃力習(xí)慣做法是temp_x100 (uint16_t)(temp * 100)顯示時(shí)手動(dòng)加小數(shù)點(diǎn)。這樣既省了浮點(diǎn)運(yùn)算又能精確顯示兩位小數(shù)。4.3 用按鍵翻頁(yè)管理更多調(diào)試數(shù)據(jù)面板再智能一屏也就 4 行。我的方案是給面板配上按鍵翻頁(yè)最常見(jiàn)的是接一個(gè) GPIO 按鍵每按一次切換一頁(yè)。頁(yè)面表可以設(shè)計(jì)成結(jié)構(gòu)體數(shù)組typedef struct { void (*draw)(void); // 繪制函數(shù) char *title; // 頁(yè)面標(biāo)題 } PanelPage;主循環(huán)里檢測(cè)按鍵事件頁(yè)索引加一取模然后調(diào)用對(duì)應(yīng)draw函數(shù)。這個(gè)結(jié)構(gòu)擴(kuò)展性很好加一個(gè)傳感器、加一個(gè)調(diào)試頁(yè)面只需要在數(shù)組里多注冊(cè)一個(gè)繪制函數(shù)。配合 OLED 的低刷新率翻頁(yè)時(shí)有一種換了一屏的爽快感非常適合調(diào)試狀態(tài)比較多的項(xiàng)目。不過(guò)按鍵翻頁(yè)有一個(gè)坑普通的機(jī)械按鍵在中斷里直接改頁(yè)索引容易產(chǎn)生抖動(dòng)導(dǎo)致的跳頁(yè)。我的做法是按鍵掃描放在主循環(huán)用 20ms 消抖檢測(cè)到按下并釋放的完整事件才切換頁(yè)面。這也是熱詞里stm32按鍵模塊電路設(shè)計(jì)經(jīng)常被問(wèn)到的原因之一——很多人把按鍵消抖放在中斷里結(jié)果一按跳兩頁(yè)。5. 刷新策略實(shí)時(shí)和閃爍之間的平衡光有一直刷屏是不夠的調(diào)通驅(qū)動(dòng)后很多人會(huì)興奮地把主循環(huán)寫成while(1) { OLED_RefreshFull(); }結(jié)果屏幕瘋狂閃爍、I2C 總線被占滿、主邏輯卡頓。這是實(shí)時(shí)面板最常見(jiàn)的問(wèn)題刷新策略不對(duì)。5.1 為什么無(wú)腦全屏刷新不行全屏刷新要傳 1KB 數(shù)據(jù)再加上設(shè)置命令一次完整刷新在 100kHz I2C 下輕松超過(guò) 100ms。如果你的主循環(huán)里還做傳感器采樣、PID 計(jì)算、按鍵檢測(cè)這些任務(wù)全被 I2C 阻塞拖住。更要命的是人眼對(duì) 30Hz 以上的閃爍才不敏感而 I2C 全屏刷新很難做到這個(gè)幀率所以整體觀感就是屏幕一直在抖。我第一次做面板時(shí)也踩了這個(gè)坑。當(dāng)時(shí)采樣頻率是 20Hz靠HAL_GetTick控制但每次采樣后都強(qiáng)制全屏刷新結(jié)果傳感器數(shù)據(jù)沒(méi)變屏卻在空轉(zhuǎn)還拖慢了控制周期。后來(lái)我意識(shí)到調(diào)試面板并不需要實(shí)時(shí)到每毫秒都在刷真正需要的只是你看到數(shù)字變化的時(shí)候數(shù)字是可信的這個(gè)頻率 10Hz 都?jí)蛄恕?.2 局部臟矩形刷新與幀率控制正確的做法是只在數(shù)據(jù)變化時(shí)刷新對(duì)應(yīng)區(qū)域。SSD1306 支持按頁(yè)設(shè)置起始列地址所以我寫了一套簡(jiǎn)單的局部刷新接口void OLED_UpdateLine(uint8_t page, uint8_t *buf) { OLED_WriteCmd(0xB0 page); // 設(shè)置頁(yè)地址 OLED_WriteCmd(0x00 (2 0x0F)); // 設(shè)置列地址低4位 OLED_WriteCmd(0x10 (2 4)); // 設(shè)置列地址高4位 OLED_WriteData(buf, 128); // 寫這一整頁(yè)的顯存數(shù)據(jù) }有了這個(gè)函數(shù)我在更新溫度時(shí)只重畫第 2 行對(duì)應(yīng)的頁(yè)緩存再更新方向。做一個(gè)簡(jiǎn)單的幀率控制用HAL_GetTick記錄上次刷新時(shí)間數(shù)據(jù)區(qū)域每 100ms 刷一次動(dòng)態(tài)參數(shù)比如狀態(tài)燈每 200ms 刷一次。這樣即使傳感器數(shù)據(jù)變快也不會(huì)疲于奔命。這里有個(gè)實(shí)操技巧OLED_UpdateLine結(jié)合屏幕緩沖數(shù)組使用。我自己維護(hù)一個(gè) 128×64/8 1024 字節(jié)的數(shù)組oled_buf[]所有繪制函數(shù)先在 buffer 里改像素然后再把 buffer 對(duì)應(yīng)區(qū)域傳給屏幕。這樣避免了每次寫屏幕都要重新組織 I2C 包的麻煩也方便做臟矩形只有 buffer 里發(fā)生變化的那幾行才真正通過(guò) I2C 發(fā)送出去。5.3 DMA 后臺(tái)刷新與 I2C 時(shí)鐘的取舍如果面板信息量大局部刷新還不夠可以上 DMA。HAL 庫(kù)的 I2C DMA 發(fā)送函數(shù)HAL_I2C_Master_Transmit_DMA可以讓 CPU 在 I2C 搬運(yùn)數(shù)據(jù)的間隙繼續(xù)跑邏輯。我實(shí)測(cè)過(guò)在 400kHz I2C 下 DMA 模式傳送 1KB 數(shù)據(jù)只需要 20ms 左右CPU 基本不等待。代價(jià)是實(shí)現(xiàn)復(fù)雜度上去了要處理 I2C 事件回調(diào)、保證 buffer 在 DMA 傳輸期間不被改動(dòng)否則會(huì)出現(xiàn)撕裂畫面。I2C 時(shí)鐘的取舍也需要實(shí)測(cè)。STM32 默認(rèn) I2C 時(shí)鐘是 100kHz 標(biāo)準(zhǔn)模式可以提高到 400kHz 快速模式。很多模塊在 400kHz 下沒(méi)問(wèn)題但個(gè)別老模塊或者走線太長(zhǎng)的場(chǎng)景速率提高后反而開(kāi)始花屏或者丟數(shù)據(jù)。我的建議是先跑 100kHz 確認(rèn)穩(wěn)定再用 400kHz 做對(duì)比如果顯示出現(xiàn)亂碼就降回 100kHz。調(diào)試面板對(duì)刷新率要求不高100kHz 完全夠用。我自己的選擇是大部分項(xiàng)目用局部刷新 100kHz I2C只有做音頻頻譜那種需要高頻動(dòng)畫的面板時(shí)才考慮 DMA 400kHz。記住一點(diǎn)調(diào)試面板的價(jià)值在信息的可信度和可讀性不在畫面的流暢度。6. 花屏、白屏、卡死實(shí)測(cè)中避不開(kāi)的四個(gè)坑和完整排查鏈路這一章我想集中聊排障因?yàn)?OLED 面板的故障現(xiàn)象非常迷惑人白屏、花屏、部分行不顯示、初始化卡死每個(gè)坑都能讓你懷疑人生。我把我自己和網(wǎng)友常遇到的問(wèn)題整理成一套排查鏈路。6.1 白屏優(yōu)先檢查地址而不是驅(qū)動(dòng)代碼模塊上電后整個(gè)屏幕點(diǎn)亮但全白或者完全不亮很多人第一反應(yīng)是初始化序列錯(cuò)了。其實(shí)更常見(jiàn)的罪魁禍?zhǔn)资?I2C 地址不對(duì)。0.96 寸 SSD1306 模塊的 I2C 地址通常是 0x3C但有些模塊是 0x3D。排查時(shí)不要瞎猜用一段 I2C 掃描代碼直接探測(cè)。HAL 庫(kù)里可以循環(huán)調(diào)用HAL_I2C_IsDeviceReady(hi2c1, addr, 1, 100)把所有可能的地址掃一遍看返回 OK 的是哪個(gè)。掃描結(jié)果比任何資料都可靠。白屏的第二個(gè)原因是接線問(wèn)題尤其是 GND 沒(méi)共地。STM32 和 OLED 模塊必須共地否則 I2C 電平參考不一致通信會(huì)間歇性失敗有時(shí)現(xiàn)象就是白屏。第三個(gè)原因是 3.3V 供電不足如果開(kāi)發(fā)板同時(shí)帶多個(gè)外設(shè)建議用萬(wàn)用表量一下 OLED 的 VCC 引腳低于 3.0V 就該考慮外接穩(wěn)壓。6.2 花屏多半不是屏幕的問(wèn)題而是總線時(shí)序被打斷花屏的典型表現(xiàn)是屏幕能顯示但內(nèi)容出現(xiàn)隨機(jī)橫條、字符錯(cuò)亂、有時(shí)候正常有時(shí)候亂碼。很多初學(xué)者懷疑模塊壞了其實(shí) SSD1306 很耐操通常不是硬件問(wèn)題。花屏最常見(jiàn)的根因是在 I2C 傳輸過(guò)程中更高優(yōu)先級(jí)的中斷打斷了傳輸。比如你的代碼里用了定時(shí)器中斷采樣傳感器中斷里又修改了 OLED 的 buffer 或者發(fā)出新的 I2C 請(qǐng)求兩個(gè) I2C 操作交織在一起SSD1306 內(nèi)部狀態(tài)機(jī)就亂了。解決辦法有三個(gè)方向一是避免在中斷里直接操作 OLED只在主循環(huán)刷新二是給 I2C 傳輸加臨界區(qū)保護(hù)比如__disable_irq()和__enable_irq()包裹發(fā)送過(guò)程三是用 DMA 傳輸減輕 CPU 在傳輸期間被中斷打擾的概率?；ㄆ恋牡诙€(gè)常見(jiàn)原因是模塊供電瞬時(shí)跌落。OLED 刷新時(shí)電流脈沖比較明顯如果 VCC 走線太長(zhǎng)或者杜邦線老化屏幕會(huì)出現(xiàn)偶發(fā)花屏。換短線、加個(gè) 100uF 電解電容在 VCC 和 GND 之間往往能解決。還有一種花屏其實(shí)是地址設(shè)置混亂比如頁(yè)尋址模式下你寫數(shù)據(jù)超出了一頁(yè)范圍沒(méi)有自動(dòng)換頁(yè)后續(xù)數(shù)據(jù)就寫到了亂七八糟的位置。這種情況多出現(xiàn)在自己寫的底層驅(qū)動(dòng)里注意先設(shè)置頁(yè)地址和列地址再發(fā)送該行數(shù)據(jù)。6.3 初始化卡死SysTick 和延時(shí)函數(shù)還有下載器沖突熱詞里反復(fù)出現(xiàn)stm32延時(shí)函數(shù)delay卡死這事在 OLED 初始化里也常發(fā)生。很多商家驅(qū)動(dòng)用delay_ms()來(lái)做時(shí)序如果這個(gè)延時(shí)函數(shù)依賴 SysTick而 SysTick 又被調(diào)試器或者其他代碼占用初始化就會(huì)卡在某個(gè)while等待上。排查思路很簡(jiǎn)單先單獨(dú)跑一個(gè)LED 閃燈 OLED 初始化的最小工程確認(rèn)延時(shí)函數(shù)和 OLED 初始化本身沒(méi)問(wèn)題再集成到業(yè)務(wù)代碼里。如果最小工程正常、大工程卡死那問(wèn)題多半出在某個(gè)中斷把 SysTick 搶占了或者某處代碼把 SysTick 優(yōu)先級(jí)改壞了。另外推薦一個(gè)更穩(wěn)的做法OLED 初始化時(shí)把延時(shí)改成HAL_Delay()HAL 庫(kù)的HAL_Delay是基于 SysTick 的只要配置好就能用。如果項(xiàng)目里有其他延時(shí)函數(shù)確保不要同時(shí)操作 SysTick 的計(jì)數(shù)寄存器否則相互覆蓋會(huì)讓 delay 卡死。6.4 JTAG 引腳復(fù)用惹的禍這個(gè)坑在 STM32 上特別典型。PB3、PB4、PA15 默認(rèn)是 JTAG 引腳如果你為了省引腳把 OLED 的 SCL/SDA 或者按鍵接到了這些腳上程序下載后 OLED 可能完全沒(méi)有反應(yīng)。因?yàn)閺?fù)位之后 JTAG 還占用著這些引腳的特殊功能GPIO 配置根本沒(méi)生效I2C 信號(hào)出不來(lái)。解決辦法有兩種一是在初始化最前面調(diào)用GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);標(biāo)準(zhǔn)庫(kù)寫法把 JTAG 關(guān)掉、只保留 SWD如果是 HAL 庫(kù)可以在SystemInit后直接操作 AFIO 重映射寄存器。二更簡(jiǎn)單換引腳。OLED 的 SCL/SDA 用 PB6/PB7 或者 PB8/PB9避開(kāi)這些默認(rèn)調(diào)試引腳一勞永逸。還有個(gè)關(guān)聯(lián)坑代碼里禁用了 JTAG 后Keil 的 ST-Link 還走 SWD 接口一般沒(méi)事但如果你用了 J-Link 的 JTAG 下載模式關(guān)閉 JTAG 后可能就下載不進(jìn)去了。真碰上這種情況先按住芯片復(fù)位鍵再點(diǎn)下載有些環(huán)境能救回來(lái)實(shí)在不行用串口 ISP 擦除。7. 把調(diào)試面板做成調(diào)試控制臺(tái)日志、報(bào)警、錯(cuò)誤碼定格等驅(qū)動(dòng)穩(wěn)定、布局合理之后OLED 面板就可以往控制臺(tái)的方向進(jìn)化而不只是幾個(gè)數(shù)字的展示。7.1 滾動(dòng)日志頁(yè)和串口日志一樣翻頁(yè)看歷史OLED 的 4 行空間做滾動(dòng)日志是可行的。我維護(hù)一個(gè)環(huán)形緩沖區(qū)每行存一個(gè)日志字符串屏幕顯示最后 4 行。新日志到來(lái)時(shí)緩沖區(qū)追加一行并重繪整個(gè)日志頁(yè)。按下翻頁(yè)鍵可以看更早的歷史。打印函數(shù)仿照 printf 做一個(gè)帶可變參數(shù)的LogLine(const char *fmt, ...)底層用vsnprintf格式化到緩沖區(qū)再調(diào)用 OLED 繪制函數(shù)。這套機(jī)制在設(shè)備故障復(fù)現(xiàn)時(shí)非常好用——當(dāng)設(shè)備已經(jīng)在現(xiàn)場(chǎng)跑起來(lái)不接串口也能靠屏幕回憶剛才發(fā)生了什么。不過(guò)要提醒一點(diǎn)OLED 不適合高頻日志一秒鐘刷十幾行文字會(huì)非常閃。我的經(jīng)驗(yàn)是只記錄狀態(tài)變化級(jí)別的日志正常周期性數(shù)據(jù)不打印這樣才能保證問(wèn)題出現(xiàn)時(shí)能看到邊界信息。7.2 傳感器閾值報(bào)警與錯(cuò)誤碼定格結(jié)合環(huán)境監(jiān)測(cè)里的 DHT11、BH1750、MQ-2面板可以做成報(bào)警屏當(dāng)某個(gè)參數(shù)超限對(duì)應(yīng)行進(jìn)入閃爍或者反白狀態(tài)。更實(shí)用的做法是錯(cuò)誤碼定格——程序檢測(cè)到嚴(yán)重錯(cuò)誤時(shí)把錯(cuò)誤代碼和現(xiàn)場(chǎng)參數(shù)凍結(jié)在屏幕上同時(shí)停止刷新讓 OLED 保持呼吸燈式慢閃。這樣即使沒(méi)有上位機(jī)現(xiàn)場(chǎng)工程師也能用手機(jī)拍一張屏幕照片回去定位問(wèn)題。我做過(guò)一個(gè)溫控項(xiàng)目面板上專門有一行顯示ERROR: 0x03之類的狀態(tài)。當(dāng)溫度傳感器無(wú)響應(yīng)時(shí)錯(cuò)誤碼會(huì)從 0x00 變成 0x03并且后臺(tái)停止 PID 輸出。調(diào)試的時(shí)候不用再翻代碼猜錯(cuò)誤直接看屏幕就能知道是采樣超時(shí)還是傳感器斷線。7.3 與更多項(xiàng)目場(chǎng)景的聯(lián)動(dòng)擴(kuò)展這塊面板的思路完全可以擴(kuò)展到其他 STM32 項(xiàng)目里。超聲波測(cè)距項(xiàng)目可以用來(lái)顯示當(dāng)前距離和閾值智能臺(tái)燈項(xiàng)目可以用來(lái)顯示環(huán)境光和 PWM 占空比兩輪差速小車可以實(shí)時(shí)顯示左右輪編碼器計(jì)數(shù)和目標(biāo)速度魚缸控制器可以顯示溫度、水位和加熱器狀態(tài)。只要你的項(xiàng)目需要脫機(jī)看狀態(tài)這套 OLED 面板結(jié)構(gòu)就能直接復(fù)用到下一個(gè)項(xiàng)目里。我自己的習(xí)慣是做一個(gè)debug_panel.c模塊把繪制、頁(yè)面注冊(cè)、按鍵翻頁(yè)都封裝好新項(xiàng)目只需要改數(shù)據(jù)和繪制函數(shù)。這樣積累幾套項(xiàng)目之后做調(diào)試面板從半天壓縮到半小時(shí)剩下就是調(diào)布局和配色的事了。最后再分享一個(gè)我實(shí)際用下來(lái)很順手的小技巧把面板設(shè)計(jì)成上電先顯示版本號(hào)和編譯時(shí)間。這樣做的好處是現(xiàn)場(chǎng)看到一臺(tái)設(shè)備一眼就知道跑的是哪版固件配合錯(cuò)誤碼定格很多玄學(xué)故障都能快速定位到固件版本差異上。調(diào)試面板這件事說(shuō)到底不是炫技而是讓自己在脫機(jī)環(huán)境下也能保持對(duì)設(shè)備的掌控感。