簡(jiǎn)介基于HAL庫(kù)的STM32 OLED驅(qū)動(dòng)開(kāi)發(fā)資料面向嵌入式初學(xué)者以及需要快速為項(xiàng)目接入信息顯示模塊的開(kāi)發(fā)者。資料以STM32單片機(jī)為主控圍繞OLED驅(qū)動(dòng)開(kāi)發(fā)的完整流程展開(kāi)從GPIO推挽輸出模式設(shè)置、I2C或SPI通信外設(shè)初始化和復(fù)用功能配置到SSD1306等OLED控制器的上電初始化序列再到畫點(diǎn)、畫線、字符顯示與屏幕刷新等基礎(chǔ)圖形操作并給出了通信異常時(shí)的處理思路。配套內(nèi)容為zip壓縮包體積僅30KB由3個(gè)文件組成Word文檔格式的圖文教程用于講解原理與步驟C語(yǔ)言源代碼文件提供可直接調(diào)用的驅(qū)動(dòng)接口實(shí)現(xiàn)頭文件則完成相關(guān)聲明和配置宏便于快速集成或二次開(kāi)發(fā)。資料目前已有909人學(xué)習(xí)下載能夠幫助讀者大幅節(jié)省查閱數(shù)據(jù)手冊(cè)和反復(fù)調(diào)試的時(shí)間。通過(guò)閱讀文檔中的分步說(shuō)明再結(jié)合源碼注釋即便是零基礎(chǔ)的初學(xué)者也能理解硬件抽象層庫(kù)的封裝思想并迅速將OLED驅(qū)動(dòng)移植到自己的STM32工程中適合用于智能家居控制面板、實(shí)驗(yàn)室儀器顯示、畢設(shè)課題或產(chǎn)品原型等多個(gè)場(chǎng)景的顯示部分開(kāi)發(fā)。 做單片機(jī)開(kāi)發(fā)這幾年OLED屏是我項(xiàng)目里用得最多的顯示外設(shè)沒(méi)有之一。0.96寸的I2C小屏幾塊錢一片往主控上一掛就能看傳感器數(shù)據(jù)、跑菜單、畫柱狀圖而HAL庫(kù)的出現(xiàn)讓整套驅(qū)動(dòng)的編寫門檻又降了一截——不用再對(duì)著寄存器手冊(cè)逐位配置大部分邏輯在CubeMX里勾選就能生成。這篇文章就圍繞“基于HAL庫(kù)的OLED驅(qū)動(dòng)”完整梳理我從協(xié)議原理到代碼落地的全過(guò)程包括I2C/SPI接口怎么選、初始化序列每一條在干什么、字符和數(shù)字怎么顯示以及白屏花屏這類經(jīng)典問(wèn)題的排查思路。適合剛接觸STM32想點(diǎn)亮第一塊屏幕的新手也適合從標(biāo)準(zhǔn)庫(kù)遷移到HAL庫(kù)、想系統(tǒng)重構(gòu)顯示驅(qū)動(dòng)的朋友。1. 項(xiàng)目概述與方案選型1.1 為什么選HAL庫(kù)而不選寄存器或標(biāo)準(zhǔn)庫(kù)先說(shuō)結(jié)論寫OLED驅(qū)動(dòng)HAL庫(kù)是性價(jià)比最高的選擇。OLED這類外設(shè)的特點(diǎn)是“寄存器多、操作瑣碎”初始化序列動(dòng)輒十幾二十條命令如果用寄存器操作每條命令都要翻數(shù)據(jù)手冊(cè)查位定義然后對(duì)著寄存器地址一位一位寫。標(biāo)準(zhǔn)庫(kù)比寄存器好一些但它的封裝粒度停留在“外設(shè)級(jí)”I2C的起始、發(fā)送、停止這些時(shí)序還是要自己拼代碼量和心智負(fù)擔(dān)都不小。HAL庫(kù)把I2C通信封裝成了幾個(gè)高層接口比如HAL_I2C_Mem_Write一次調(diào)用就把“發(fā)從機(jī)地址、發(fā)內(nèi)存地址、發(fā)數(shù)據(jù)、收ACK”整套時(shí)序全部完成。對(duì)OLED這種純寫操作、幾乎不讀的屏幕來(lái)說(shuō)HAL庫(kù)的抽象正好卡在“夠用”和“省事”之間。我手上有幾個(gè)從標(biāo)準(zhǔn)庫(kù)遷過(guò)來(lái)的老項(xiàng)目遷移后I2C相關(guān)代碼量大概砍掉了四成而且出問(wèn)題的概率明顯降低因?yàn)榈讓訒r(shí)序是ST官方維護(hù)好的不用自己反復(fù)調(diào)試。當(dāng)然寄存器操作并非一無(wú)是處在時(shí)間敏感的場(chǎng)景下比如I2C時(shí)鐘頻率需要跑滿400kHz以上或者需要用GPIO模擬時(shí)序驅(qū)動(dòng)非標(biāo)準(zhǔn)接口屏直接操作寄存器更可控。但這類需求在常規(guī)項(xiàng)目中占比很小絕大多數(shù)人遇到的情況是手頭一個(gè)STM32F103C8T6屏幕上電不亮先把驅(qū)動(dòng)跑通再說(shuō)。這種情況下HAL庫(kù)就是最快的路。1.2 I2C接口和SPI接口怎么選OLED屏常見(jiàn)接口就兩種I2C和SPI。不少模塊把兩種接口都引出來(lái)了通過(guò)電阻選擇選哪個(gè)取決于你的項(xiàng)目場(chǎng)景。I2C的優(yōu)點(diǎn)是接線少SDA、SCL兩根線加電源就完事整個(gè)總線上還能再掛DHT11、BMP280之類的傳感器缺點(diǎn)是速度上限低標(biāo)準(zhǔn)模式100kHz快速模式400kHz刷新一幀128x64的圖片大概需要十幾毫秒顯示文字和簡(jiǎn)單圖形完全夠用但跑動(dòng)畫或視頻流就吃力了。SPI接口需要額外占用DC數(shù)據(jù)/命令選擇、RES復(fù)位、CS片選三根線接線多一根但速度可以到MHz級(jí)別刷新率是I2C的幾十倍。如果你想做動(dòng)態(tài)波形、簡(jiǎn)易示波器或者動(dòng)畫界面SPI是更合理的方案。我個(gè)人的習(xí)慣是靜態(tài)信息顯示傳感器數(shù)值、狀態(tài)文字優(yōu)先用I2C代碼量小、穩(wěn)定需要頻繁刷新圖像或?qū)视幸髸r(shí)選SPI。下面這張表是我實(shí)際對(duì)比過(guò)兩種接口之后總結(jié)的對(duì)比項(xiàng)I2CSPI接線數(shù)量2根SDA/SCL5-6根SCLK/MOSI/DC/RES/CS刷新一幀128x64約10-20ms約1-2ms可掛載其他器件可以一條總線多設(shè)備獨(dú)占性較強(qiáng)代碼復(fù)雜度低中適用場(chǎng)景文本、儀表、低功耗動(dòng)畫、高速刷新、圖形界面這篇文章后續(xù)的代碼示例以I2C接口為主因?yàn)楦采w面最廣。SPI的驅(qū)動(dòng)邏輯類似只是把I2C寫函數(shù)換成SPI寫函數(shù)初始化序列完全一致。2. OLED顯示原理與關(guān)鍵硬件細(xì)節(jié)2.1 SSD1306控制器的顯示機(jī)制市面上一塊0.96寸的OLED屏核心控制器絕大多數(shù)是SSD1306內(nèi)部自帶1KB大小的顯存對(duì)應(yīng)128x64像素。計(jì)算一下128列 x 64行 8192個(gè)bit除以8就是1024字節(jié)正好1KB。這塊顯存和屏幕像素之間存在固定的映射關(guān)系控制器會(huì)不斷掃描顯存并刷新到屏幕上只要顯存里的數(shù)據(jù)不變畫面就保持不變不需要外部MCU反復(fù)重發(fā)數(shù)據(jù)。SSD1306的顯存采用了“頁(yè)”的組織方式64行被分成8頁(yè)每頁(yè)8行。例如Page0對(duì)應(yīng)第0到7行Page1對(duì)應(yīng)第8到15行。寫入數(shù)據(jù)時(shí)先告訴控制器列地址0到127和頁(yè)地址0到7然后連續(xù)寫入一個(gè)字節(jié)這個(gè)字節(jié)的8個(gè)bit會(huì)縱向排列最高位對(duì)應(yīng)頁(yè)內(nèi)第一行。初次接觸的人容易在這里犯迷糊OLED的行方向是垂直的一個(gè)字節(jié)不是水平排列的8個(gè)點(diǎn)而是垂直的一列8個(gè)點(diǎn)。理解了這一點(diǎn)后面寫繪制像素的函數(shù)就不會(huì)出錯(cuò)。2.2 OLED像素點(diǎn)的組成結(jié)構(gòu)OLED屏幕和LCD最大的區(qū)別在于自發(fā)光。LCD需要背光源透過(guò)液晶層成像而OLED每個(gè)像素本身就是一個(gè)微型發(fā)光單元。搜索熱詞里有“oled屏的像素點(diǎn)由幾層組成”這里展開(kāi)說(shuō)說(shuō)。一個(gè)OLED像素從結(jié)構(gòu)上看可以簡(jiǎn)單理解為“三明治”頂層和底層分別是金屬陰極和透明陽(yáng)極ITO負(fù)責(zé)注入電子和空穴中間是空穴注入層、空穴傳輸層、發(fā)光層有機(jī)材料、電子傳輸層、電子注入層等有機(jī)薄膜結(jié)構(gòu)電子和空穴在發(fā)光層復(fù)合后釋放能量激發(fā)有機(jī)材料發(fā)光不同材料發(fā)出不同顏色的光這也是OLED“燒屏”問(wèn)題的根源有機(jī)發(fā)光材料長(zhǎng)時(shí)間點(diǎn)亮?xí)饾u老化亮度衰減程度不一致于是殘留殘影。驅(qū)動(dòng)OLED時(shí)雖然沒(méi)有直接辦法延緩材料老化但可以通過(guò)降低對(duì)比度0x81命令和避免長(zhǎng)時(shí)間高亮度顯示固定畫面來(lái)間接保護(hù)屏幕。這個(gè)知識(shí)點(diǎn)雖然不直接寫在驅(qū)動(dòng)代碼里但理解它有助于你判斷屏幕上的異?，F(xiàn)象到底是電路問(wèn)題還是屏本身老化。2.3 I2C寫時(shí)序到底在做什么I2C協(xié)議本身不復(fù)雜起始條件SCL高電平期間SDA拉低、發(fā)送7位從機(jī)地址加讀寫位、等待ACK、發(fā)送數(shù)據(jù)、停止條件SCL高電平期間SDA拉高。OLED模塊的I2C地址通常是0x787位地址0x3C左移一位或0x7A0x3D左移一位取決于模塊上地址電阻的配置。STM32的HAL庫(kù)在調(diào)用時(shí)雖然函數(shù)參數(shù)傳遞的是8位地址但底層會(huì)自動(dòng)處理讀寫位所以直接寫0x78 1容易出錯(cuò)正確做法是寫成0x78或根據(jù)實(shí)際情況做移位后面代碼部分我會(huì)展示安全寫法。OLED的I2C通信和普通傳感器有個(gè)關(guān)鍵區(qū)別每次傳輸都要多一個(gè)“控制字節(jié)”?？刂谱止?jié)是0x00時(shí)后面跟的是命令是0x40時(shí)后面跟的是顯示數(shù)據(jù)。這個(gè)設(shè)計(jì)意味著向OLED寫一個(gè)字節(jié)實(shí)際I2C總線上要發(fā)送“從機(jī)地址 控制字節(jié) 數(shù)據(jù)字節(jié)”三段信息。HAL庫(kù)的HAL_I2C_Mem_Write函數(shù)天然適配這種結(jié)構(gòu)其中MemAddress參數(shù)就對(duì)應(yīng)控制字節(jié)非常巧妙。3. 從CubeMX配置到寄存器級(jí)初始化3.1 CubeMX中的I2C參數(shù)怎么填用CubeMX生成工程是最省事的路徑。以STM32F103C8T6為例在Pinout視圖中把PB6和PB7分別配置為I2C1_SCL和I2C1_SDA然后打開(kāi)I2C1的參數(shù)配置界面。這里有三個(gè)參數(shù)值得注意Clock Speed設(shè)置為100000100kHz或400000400kHz建議先用100kHz跑通排查問(wèn)題時(shí)更從容Duty Cycle快速模式才有意義選2:1即可Own Address、Addressing ModeOLED是從機(jī)主機(jī)的Own Address隨便填個(gè)不沖突的值就行還有一件事容易被忽略I2C引腳必須配上拉電阻。STM32內(nèi)部雖然可以開(kāi)啟上拉但驅(qū)動(dòng)能力有限模塊上通常已經(jīng)有4.7k歐的上拉電阻所以大多數(shù)時(shí)候可以不額外配內(nèi)部上拉。如果用的是自己畫的板子且模塊上沒(méi)有上拉一定要在SDA和SCL上加4.7k歐電阻到VCC否則波形上升沿會(huì)變得很鈍輕則通信不穩(wěn)定重則完全無(wú)法通信。如果你喜歡手工創(chuàng)建工程而不依賴CubeMX也不難初始化RCC時(shí)鐘然后調(diào)用HAL_I2C_Init步驟上比CubeMX多敲幾行代碼但原理一樣。關(guān)鍵是別忘了使能I2C時(shí)鐘和GPIO時(shí)鐘這兩個(gè)時(shí)鐘沒(méi)開(kāi)后面所有操作都會(huì)無(wú)效。3.2 初始化序列的逐條解讀SSD1306上電后需要發(fā)送一串初始化命令才能進(jìn)入正常顯示狀態(tài)。這條序列網(wǎng)上有很多版本但核心命令是一致的。我在項(xiàng)目中常用的初始化序列如下uint8_t init_cmds[] { 0xAE, // 關(guān)閉顯示 0xD5, 0x80, // 設(shè)置顯示時(shí)鐘分頻/振蕩器頻率 0xA8, 0x3F, // 設(shè)置多路復(fù)用率64行 0xD3, 0x00, // 設(shè)置顯示偏移為0 0x40, // 設(shè)置顯示起始行為0 0x8D, 0x14, // 開(kāi)啟充電泵關(guān)鍵 0x20, 0x00, // 設(shè)置內(nèi)存尋址模式為水平尋址 0xA1, // 段重映射左右鏡像控制 0xC8, // COM掃描方向上下翻轉(zhuǎn)控制 0xDA, 0x12, // COM引腳硬件配置 0x81, 0xCF, // 設(shè)置對(duì)比度 0xD9, 0xF1, // 設(shè)置預(yù)充電周期 0xDB, 0x40, // 設(shè)置VCOMH電平 0xA4, // 關(guān)閉全局顯示 0xA6, // 設(shè)置正常顯示非反顯 0xAF // 打開(kāi)顯示 };這份序列里的每條命令都有明確作用但有兩條命令尤其關(guān)鍵0xAE/0xAF控制顯示開(kāi)關(guān)上電后關(guān)閉顯示是防止初始化過(guò)程中出現(xiàn)雪花點(diǎn)0x8D, 0x14開(kāi)啟充電泵則關(guān)系到屏幕供電如果漏掉這一條很多模塊上電后是白屏而且這個(gè)現(xiàn)象非常典型——測(cè)量電源電壓正常邏輯分析儀看I2C波形也正常但屏幕就是不亮。0xA1和0xC8這兩條是鏡像相關(guān)的不同廠商的模塊走線差異會(huì)導(dǎo)致畫面左右或上下翻轉(zhuǎn)如果你遇到畫面鏡面反轉(zhuǎn)把這兩條命令改成0xA0和0xC0即可。這個(gè)細(xì)節(jié)在網(wǎng)上一堆“抄來(lái)抄去”的代碼里經(jīng)常被忽略導(dǎo)致半塊屏幕顯示異常而開(kāi)發(fā)者一頭霧水。3.3 封裝底層讀寫接口配置好I2C后寫驅(qū)動(dòng)只需要封裝兩個(gè)核心函數(shù)寫命令和寫數(shù)據(jù)?；贖AL庫(kù)的HAL_I2C_Mem_Write代碼如下#define OLED_ADDR 0x78 // 注意這里直接寫模塊的8位地址 void OLED_WriteCmd(uint8_t cmd) { HAL_I2C_Mem_Write(hi2c1, OLED_ADDR, 0x00, I2C_MEMADD_SIZE_8BIT, cmd, 1, 100); } void OLED_WriteData(uint8_t data) { HAL_I2C_Mem_Write(hi2c1, OLED_ADDR, 0x40, I2C_MEMADD_SIZE_8BIT, data, 1, 100); }函數(shù)的第三個(gè)參數(shù)就是前面提到的控制字節(jié)寫命令傳0x00寫數(shù)據(jù)傳0x40。I2C_MEMADD_SIZE_8BIT表示控制字節(jié)是8位最后一個(gè)參數(shù)100是超時(shí)時(shí)間單位毫秒。這里有一點(diǎn)要提醒OLED_ADDR的值不要機(jī)械地寫成0x78 1。HAL庫(kù)的HAL_I2C_Mem_Write在內(nèi)部會(huì)把傳入的地址左移一位再拼上讀寫位如果你在外面先左移再傳入就相當(dāng)于地址左移了兩次設(shè)備地址會(huì)變成0xF0總線上永遠(yuǎn)找不到從機(jī)。這個(gè)我自己踩過(guò)一次排查了大半天才發(fā)現(xiàn)是地址重復(fù)移位。模塊是0x3C還是0x3D直接查原理圖或者模塊背面絲印多數(shù)模塊會(huì)把地址寫出來(lái)。4. 顯示功能庫(kù)的編寫思路4.1 建立顯示緩沖區(qū)寫完整驅(qū)動(dòng)時(shí)我強(qiáng)烈建議在MCU內(nèi)存中開(kāi)辟一塊1KB的緩沖區(qū)來(lái)模擬SSD1306的顯存uint8_t oled_buffer[8][128]; // [頁(yè)][列]所有繪制操作畫點(diǎn)、畫線、顯示字符、顯示圖片都先修改這塊緩沖區(qū)需要刷新時(shí)再把緩沖區(qū)整體推送到屏幕調(diào)用一次HAL_I2C_Mem_Write把1024字節(jié)發(fā)過(guò)去即可。這么做的原因是直接操作屏幕顯存會(huì)導(dǎo)致畫面閃爍和撕裂。比如顯示一個(gè)字符串如果不經(jīng)過(guò)緩沖區(qū)一個(gè)字一個(gè)字地往屏幕寫屏幕更新就會(huì)有明顯的“從左往右刷”的拖影而緩沖區(qū)相當(dāng)于一個(gè)“草稿紙”先畫完再一次性上屏視覺(jué)上就是干凈利落的整體刷新。緩沖區(qū)帶來(lái)的另一個(gè)好處是簡(jiǎn)化了像素坐標(biāo)運(yùn)算。你只需要寫一套“在緩沖區(qū)里畫點(diǎn)”的函數(shù)然后任意復(fù)雜圖形矩形、圓形、柱狀圖甚至中文都能基于這個(gè)函數(shù)構(gòu)造。刷新時(shí)用下面這個(gè)函數(shù)整幀發(fā)送void OLED_Refresh(void) { for (uint8_t page 0; page 8; page) { OLED_WriteCmd(0xB0 page); // 設(shè)置頁(yè)地址 OLED_WriteCmd(0x00); // 設(shè)置列地址低4位 OLED_WriteCmd(0x10); // 設(shè)置列地址高4位 HAL_I2C_Mem_Write(hi2c1, OLED_ADDR, 0x40, I2C_MEMADD_SIZE_8BIT, oled_buffer[page][0], 128, 100); } }如果內(nèi)存受限比如一些8位單片機(jī)只有幾百字節(jié)RAM可以不用全屏緩沖直接邊畫邊寫顯存但要接受畫面有輕微閃爍。1KB的RAM開(kāi)銷對(duì)STM32來(lái)說(shuō)幾乎沒(méi)有壓力F103C8T6有20KB RAM用掉1KB完全無(wú)所謂。4.2 字符和數(shù)字的顯示方式字符顯示依賴“字?！睌?shù)據(jù)。一個(gè)5x8像素的ASCII字符需要8個(gè)字節(jié)每字節(jié)8位取5位有效比如字母“A”的字模可能是{0x00, 0x3E, 0x51, 0x49, 0x45, 0x3E, 0x00, 0x00}。這類數(shù)據(jù)可以直接用取模軟件生成比如PCtoLCD2002設(shè)置取模方式為“縱向取?！薄ⅰ白止?jié)倒序”即可。生成后保存成一個(gè)數(shù)組顯示時(shí)按下標(biāo)取出逐字節(jié)寫入緩沖區(qū)。數(shù)字顯示在傳感器項(xiàng)目中尤其重要。一個(gè)常見(jiàn)的需求是顯示DHT11的溫濕度值格式類似“Temp: 25.6C”。這里一定要養(yǎng)成“先把數(shù)值格式化到字符串再顯示字符串”的習(xí)慣不要直接顯示float避免寫入緩沖區(qū)時(shí)的類型陷阱。具體做法char str[16]; snprintf(str, sizeof(str), T:%d.%d C, (int)(temp), (int)(temp * 10) % 10); OLED_ShowString(0, 2, str);注意snprintf在STM32的默認(rèn)C庫(kù)下可能會(huì)引入較大代碼體積用了之后Flash占用會(huì)漲好幾KB。如果Flash緊張可以用整數(shù)拆分加手動(dòng)拼接的方式來(lái)替代比如把整數(shù)部分和小數(shù)部分分別轉(zhuǎn)成字符再拼進(jìn)顯示緩沖區(qū)。這也是很多輕量級(jí)驅(qū)動(dòng)庫(kù)不依賴printf系列函數(shù)的原因。4.3 動(dòng)態(tài)刷新與局部更新屏幕滾動(dòng)顯示數(shù)值是嵌入式項(xiàng)目的基本操作但很多人寫動(dòng)態(tài)刷新時(shí)會(huì)犯一個(gè)錯(cuò)誤每次刷新整屏導(dǎo)致畫面閃爍、時(shí)序緊張。正確的思路是“只更新變化區(qū)域”。SSD1306的頁(yè)尋址模式和行列地址機(jī)制天然支持局部更新你只需要把某一行或某一小矩形區(qū)域?qū)?yīng)的緩沖區(qū)片段發(fā)送給屏幕即可。舉個(gè)例子如果只要刷新屏幕右上角的一行數(shù)字可以只設(shè)置對(duì)應(yīng)的頁(yè)地址和列地址然后發(fā)送那一行的數(shù)據(jù)就不需要整屏重發(fā)。這樣既減少了I2C總線的數(shù)據(jù)量也避免了整屏閃爍。在中斷里刷新時(shí)尤其要注意不要在定時(shí)器中斷回調(diào)里做整屏的HAL_I2C_Mem_Write因?yàn)樽枞絀2C傳輸可能占用幾毫秒打斷了主循環(huán)里的其他任務(wù)。更好的做法是用一個(gè)標(biāo)志位通知主循環(huán)“該刷新了”由主循環(huán)執(zhí)行刷新或者使用DMAI2C實(shí)現(xiàn)非阻塞傳輸。5. 實(shí)戰(zhàn)中踩過(guò)的坑與排查方法5.1 白屏的經(jīng)典原因屏幕完全白屏這是新手遇到最多的問(wèn)題排查方向按出現(xiàn)概率排序如下I2C地址不對(duì)。模塊地址是0x3C還是0x3D對(duì)照原理圖確認(rèn)。用邏輯分析儀抓包時(shí)如果總線上完全沒(méi)有ACK回包基本就可以確定是地址問(wèn)題充電泵未開(kāi)啟。初始化序列里少了0x8D, 0x14屏幕供電不足表現(xiàn)就是白屏。這一步是初始化代碼里最常被刪掉的關(guān)鍵命令上電延時(shí)不夠。很多模塊上電后需要幾十毫秒穩(wěn)定時(shí)間主控初始化I2C后立刻發(fā)命令模塊還沒(méi)準(zhǔn)備好第一條命令就丟失了。建議上電后先HAL_Delay(100)再開(kāi)始初始化SDA和SCL接反或者沒(méi)共地。這看似低級(jí)錯(cuò)誤但在杜邦線亂搭的情況下經(jīng)常發(fā)生排查時(shí)我一般先用邏輯分析儀或示波器抓I2C波形看起始條件、地址、ACK位是否正常。沒(méi)有邏輯分析儀的話可以用一個(gè)笨辦法用I2C掃描程序逐個(gè)地址回讀看哪些地址有ACK響應(yīng)能快速確認(rèn)設(shè)備地址和接線是否正常。5.2 花屏、殘影和亂碼花屏通常意味著數(shù)據(jù)已通但內(nèi)容錯(cuò)亂。最常見(jiàn)的原因是控制字節(jié)用錯(cuò)了該發(fā)命令的時(shí)候發(fā)了數(shù)據(jù)或者反之。比如清屏命令操作成了0x40控制字節(jié)屏幕就反而顯現(xiàn)出內(nèi)存中的隨機(jī)數(shù)據(jù)。其次是初始化序列不完整或順序不對(duì)尤其是0x20內(nèi)存尋址模式?jīng)]有設(shè)置成水平尋址導(dǎo)致寫入的地址自動(dòng)遞增方式不符合預(yù)期顯示內(nèi)容錯(cuò)位。殘影問(wèn)題一般出現(xiàn)在顯示內(nèi)容頻繁變化的區(qū)域。SSD1306沒(méi)有真正的“擦除”機(jī)制屏幕顯示的是顯存內(nèi)容的持續(xù)映射你寫了什么它就顯示什么。所以要清除一塊區(qū)域必須向那片區(qū)域?qū)懭?x00黑色而不是“發(fā)一個(gè)清屏命令”。很多人在顯示動(dòng)態(tài)數(shù)字時(shí)只寫新數(shù)字不擦舊數(shù)字結(jié)果屏幕上疊著一堆半透明殘影本質(zhì)就是沒(méi)做填充清除。我習(xí)慣在寫字符前先調(diào)用OLED_ShowString內(nèi)部自帶的背景填充邏輯或單獨(dú)寫一個(gè)清行函數(shù)把對(duì)應(yīng)頁(yè)、對(duì)應(yīng)行區(qū)域全部填0徹底避免這個(gè)問(wèn)題。亂碼還有一種情況是字模取模方向不對(duì)。很多取模軟件默認(rèn)“橫向取?！倍鳲LED是“縱向取?！眱烧呋煊镁蜁?huì)導(dǎo)致字符東倒西歪。解決方法是固定使用一種取模方向在代碼里用宏或注釋記錄下取模參數(shù)換電腦換工程時(shí)不丟。5.3 I2C死鎖與總線搶占I2C總線死鎖是個(gè)非常經(jīng)典且難查的問(wèn)題表現(xiàn)為程序運(yùn)行一段時(shí)間后屏幕停止更新或者首次上電就卡住。原因是I2C的SCL和SDA兩條線如果在某個(gè)電平狀態(tài)下被打斷比如正在傳輸時(shí)MCU復(fù)位總線上可能殘留一個(gè)未完成的傳輸狀態(tài)導(dǎo)致后續(xù)通信永遠(yuǎn)等不到ACK。處理辦法有兩個(gè)層面。第一寫一個(gè)總線復(fù)位函數(shù)檢測(cè)到SDA一直為低時(shí)手動(dòng)翻轉(zhuǎn)SCL最多9個(gè)周期讓從機(jī)釋放總線再發(fā)一個(gè)停止條件。第二很多引腳上電默認(rèn)是浮空輸入建議在初始化后把I2C引腳配置為開(kāi)漏輸出加上拉或者在CubeMX里開(kāi)啟內(nèi)部上拉減小總線異常的概率。另一個(gè)容易忽略的點(diǎn)是DHT11等單總線傳感器如果它和OLED掛在同一條I2C總線或者相鄰GPIO上DHT11的時(shí)序是嚴(yán)格且獨(dú)占的在DHT11讀時(shí)序期間不能有任何I2C中斷插入否則會(huì)導(dǎo)致DHT11數(shù)據(jù)錯(cuò)誤甚至把I2C總線的電平狀態(tài)搞亂。STM32的HAL庫(kù)雖然有超時(shí)機(jī)制但默認(rèn)超時(shí)時(shí)間設(shè)置不當(dāng)總線卡住時(shí)主循環(huán)會(huì)被阻塞很久。如果遇到“屏幕不亮但程序沒(méi)死”的情況優(yōu)先檢查I2C的HAL_I2C_GetError返回值在調(diào)試模式下打個(gè)斷點(diǎn)看錯(cuò)誤碼比瞎猜效率高得多?，F(xiàn)象大概率原因排查方法白屏地址錯(cuò)誤/充電泵未開(kāi)/供電不足抓波形、檢查初始化序列花屏控制字節(jié)用錯(cuò)/取模方向不對(duì)對(duì)比命令和數(shù)據(jù)字節(jié)亂碼取模方式不一致固定縱向取模殘影未擦除舊內(nèi)容先填充0x00再寫字卡死總線死鎖/超時(shí)設(shè)置太小總線復(fù)位、增大超時(shí)5.4 關(guān)于中斷回調(diào)的注意事項(xiàng)在HAL庫(kù)生態(tài)里不少人會(huì)把OLED刷新放進(jìn)定時(shí)器中斷回調(diào)和DHT11讀時(shí)序、串口空閑中斷混在一起結(jié)果越用越糟。我的建議是OLED刷新這件事永遠(yuǎn)不要放進(jìn)任何中斷回調(diào)里做阻塞式傳輸。定時(shí)器中斷里只放一個(gè)標(biāo)志位主循環(huán)檢測(cè)到標(biāo)志位后再調(diào)用OLED_Refresh。如果必須用DMAI2C非阻塞傳輸也要用信號(hào)量或標(biāo)志位告訴主循環(huán)傳輸已完成避免下一次刷新啟動(dòng)在前一次還沒(méi)結(jié)束時(shí)就沖上去。這個(gè)原則同樣適用于串口空閑中斷里接收數(shù)據(jù)、再通過(guò)OLED顯示的復(fù)合場(chǎng)景——中斷里收數(shù)據(jù)可以但顯示動(dòng)作必須拿回主循環(huán)執(zhí)行。6. 再說(shuō)點(diǎn)進(jìn)階的擴(kuò)展思路驅(qū)動(dòng)跑通之后很多項(xiàng)目會(huì)繼續(xù)往上疊功能這里分享幾個(gè)我實(shí)測(cè)過(guò)、方向明確的做法。雙屏驅(qū)動(dòng)是個(gè)常見(jiàn)需求。SSD1306的設(shè)備地址可以通過(guò)模塊上的電阻切換成0x3C或0x3D兩塊屏設(shè)置成不同地址后掛在同一條I2C總線上驅(qū)動(dòng)函數(shù)只需把地址作為參數(shù)傳入代碼里加一層“當(dāng)前屏”的上下文管理就能在任意一塊屏上分別顯示不同內(nèi)容。這在做小型儀表盤時(shí)非常實(shí)用。DMA刷新是我推薦優(yōu)先嘗試的優(yōu)化方向。把緩沖區(qū)數(shù)據(jù)通過(guò)HAL_I2C_Mem_Write_DMA發(fā)送主循環(huán)就可以騰出來(lái)處理其他任務(wù)刷新率也能明顯提升。要注意的是DMA傳輸期間緩沖區(qū)內(nèi)容不能被修改否則會(huì)出撕裂畫面所以刷新前可以先拷貝到一塊臨時(shí)緩沖區(qū)或者用雙緩沖輪流切換。如果以后要移植到ESP32上跑MicroPython驅(qū)動(dòng)邏輯同樣有效——MicroPython的SSD1306庫(kù)底層原理就是本文講的這套機(jī)制I2C地址、控制字節(jié)、頁(yè)尋址、緩沖區(qū)刷新?lián)Q的是語(yǔ)言外殼內(nèi)核完全一樣。理解和掌握了這套底層邏輯以后無(wú)論換芯片、換開(kāi)發(fā)框架還是換屏幕型號(hào)比如換成SH1106控制器地址和命令基本兼容都能很快上手。另外如果項(xiàng)目跑FreeRTOSOLED的I2C總線可以被多個(gè)任務(wù)共享這時(shí)一定要給驅(qū)動(dòng)加互斥鎖Mutex。兩個(gè)任務(wù)同時(shí)寫I2C會(huì)導(dǎo)致總線數(shù)據(jù)交錯(cuò)屏幕花掉是小事嚴(yán)重的會(huì)把總線狀態(tài)搞亂。加鎖的代價(jià)是幾行代碼換來(lái)的是多任務(wù)環(huán)境下徹底安心。最后分享一個(gè)小經(jīng)驗(yàn)驅(qū)動(dòng)代碼里盡量把屏幕尺寸、I2C地址、引腳號(hào)等易變參數(shù)做成宏定義放在文件頭部統(tǒng)一管理。我做過(guò)的項(xiàng)目里屏幕規(guī)格從0.96寸換到1.3寸或者把I2C1換到I2C2都只需要改幾個(gè)宏而不必動(dòng)驅(qū)動(dòng)函數(shù)本體。這種“配置與邏輯分離”的做法在后期維護(hù)時(shí)能省下大量時(shí)間去排查“明明代碼沒(méi)錯(cuò)但為什么不顯示”這類問(wèn)題。本文還有配套的精品資源點(diǎn)擊獲取