簡介這是一套面向STM32入門學(xué)習(xí)與嵌入式課程設(shè)計(jì)的溫濕度實(shí)時(shí)監(jiān)測工程。以STM32F103C8為主控通過DHT11傳感器采集環(huán)境溫濕度并驅(qū)動(dòng)OLED屏完成數(shù)據(jù)展示搭配Keil uVision5開發(fā)環(huán)境源碼組織清晰適合用來理解GPIO、定時(shí)器延時(shí)、單總線通信及OLED顯示驅(qū)動(dòng)等基礎(chǔ)外設(shè)的協(xié)作流程既可作為智慧農(nóng)業(yè)、小型氣象站、家居環(huán)境監(jiān)測等場景的原型也適合初學(xué)者由零開始跟進(jìn)一個(gè)完整的小型顯示項(xiàng)目。壓縮包共75個(gè)文件以C源碼與頭文件為主體包含硬件驅(qū)動(dòng)、標(biāo)準(zhǔn)外設(shè)庫、啟動(dòng)文件、Keil工程配置及輔助清理腳本整體僅306KB目錄按Hardware、System、User、Library等功能模塊劃分可快速定位DHT11與OLED驅(qū)動(dòng)、延時(shí)函數(shù)和main主邏輯便于二次開發(fā)與移植。目前已有7934人學(xué)習(xí)下載無論是完成課程設(shè)計(jì)還是積累STM32嵌入式項(xiàng)目經(jīng)驗(yàn)都是一份輕量而完整的參考資料。 自己買過DHT11模塊照著網(wǎng)上代碼抄了一遍結(jié)果屏幕亂碼、溫度不更新、傳感器讀數(shù)卡死——最后查出來是I2C地址搞錯(cuò)了、DHT11時(shí)序不滿足、OLED復(fù)位腳沒拉高。這幾乎是每個(gè)STM32新手都會(huì)踩的三連坑。所以當(dāng)看到“基于STM32的溫濕度傳感器OLED屏顯示項(xiàng)目文件壓縮包”這個(gè)壓縮包的名字時(shí)我第一反應(yīng)是這玩意兒要是里面代碼能直接編譯通過、連上硬件就能跑那真的省掉一大半的排查時(shí)間。但光能用還不夠如果不懂背后原理換個(gè)引腳、換個(gè)芯片型號(hào)項(xiàng)目又得從頭折騰。這篇文章我就以這個(gè)壓縮包項(xiàng)目為線索把從硬件選型、環(huán)境搭建、DHT11驅(qū)動(dòng)時(shí)序、OLED取模顯示到工程管理踩過的坑一條龍講清楚。適合剛?cè)腴TSTM32、想做一個(gè)完整小項(xiàng)目的同學(xué)也適合那些手上有板子但不知道從哪兒下手的自學(xué)者。1. 項(xiàng)目整體思路與硬件選型1.1 為什么是STM32DHT11OLED這個(gè)組合很多新手一上來就想搞復(fù)雜的比如加WiFi、上云、搞APP控制。但坦白說能把手頭這塊STM32F103C8T6用明白把傳感器數(shù)據(jù)采集準(zhǔn)確、把屏幕顯示調(diào)通這個(gè)基本功比什么都重要。這個(gè)項(xiàng)目的核心鏈路很簡單STM32通過GPIO讀取DHT11的溫濕度數(shù)據(jù)然后通過I2C接口把數(shù)據(jù)發(fā)送給OLED屏幕顯示出來。這個(gè)組合經(jīng)典到什么程度呢江科大、正點(diǎn)原子、野火幾乎所有STM32開發(fā)板的例程里都有這個(gè)Demo。原因有三DHT11便宜、易買、單總線協(xié)議邏輯簡單適合理解時(shí)序概念。OLED通常是0.96寸SSD1306控制器功耗低、顯示清晰、I2C接口只占兩根線接線方便。STM32F103C8T6性能和外設(shè)足夠幾十塊錢一塊板子壞了不心疼。所以哪怕你以后要去做更復(fù)雜的項(xiàng)目比如智能家居中控、小型氣象站、大棚環(huán)境監(jiān)測這套框架都能直接復(fù)用只需要把DHT11換成DHT22、SHT30或者把OLED換成TFT彩屏而已。1.2 溫濕度傳感器的選型差異DHT11、DHT22、SHT30、485工業(yè)傳感器很多人看到熱搜詞里有“恒智微鑫485溫濕度傳感器原理圖”會(huì)疑惑為什么我的項(xiàng)目用了DHT11還要扯485工業(yè)傳感器因?yàn)檫@是兩種完全不同的應(yīng)用場景。DHT11是消費(fèi)級(jí)、低成本、單總線數(shù)字傳感器精度是±2℃和±5%RH測量范圍0-50℃、20-90%RH適合室內(nèi)環(huán)境、桌面小玩意、課程設(shè)計(jì)。它的優(yōu)勢就一個(gè)字便宜幾塊錢一個(gè)。DHT22也叫AM2302精度高一些是±0.5℃和±2%RH測量范圍也更寬-40~80℃但價(jià)格翻好幾倍。SHT30是I2C接口的傳感器精度更高、穩(wěn)定性更好而且不用自己寫單總線時(shí)序直接用I2C讀寄存器就行。缺點(diǎn)是價(jià)格更高。至于485輸出的工業(yè)傳感器那一般是24V供電、RS485總線傳輸、Modbus協(xié)議用在工廠、機(jī)房、糧庫這種長距離、多節(jié)點(diǎn)、強(qiáng)干擾的場合。一塊錢和一百塊錢的傳感器應(yīng)用場景完全不同。我這個(gè)壓縮包項(xiàng)目用的DHT11核心價(jià)值在于讓你理解時(shí)序和協(xié)議而不是追求精度。1.3 OLED屏的選型I2C還是SPI0.96寸還是1.3寸OLED這塊0.96寸的SSD1306是最常見的有I2C接口和SPI接口兩個(gè)版本。我強(qiáng)烈建議新手選I2C版本因?yàn)橹唤?根線VCC、GND、SCL、SDA代碼也好寫。SPI版本雖然刷新速度快但要多接好幾根線而且SPI時(shí)序比I2C復(fù)雜一些對(duì)新手不友好。這里插一句熱搜詞里提到的“oled屏的像素點(diǎn)由幾層組成”這個(gè)問題。其實(shí)這個(gè)問題挺有意思的OLED屏幕的像素點(diǎn)從物理結(jié)構(gòu)來說主要是基板、陽極ITO透明導(dǎo)電層、有機(jī)發(fā)光層空穴傳輸層、發(fā)光層、電子傳輸層這幾層有機(jī)薄膜、陰極金屬反射層加上封裝層。不過從單片機(jī)驅(qū)動(dòng)角度來說你只需要關(guān)心屏幕的分辨率和顏色就行了。0.96寸OLED是128x64像素單色每個(gè)像素只能亮或不亮通過SSD1306控制器的GRAM來控制。你往GRAM里寫1這個(gè)像素就亮寫0就滅。屏幕刷新時(shí)控制器會(huì)自動(dòng)把GRAM映射到物理像素上這個(gè)映射關(guān)系、掃描方向是可以通過命令配置的不同的庫實(shí)現(xiàn)可能會(huì)因此出現(xiàn)鏡像、反色之類的差異。2. 開發(fā)環(huán)境準(zhǔn)備與工程搭建2.1 CubeMX配置引腳分配與時(shí)鐘樹拿到這個(gè)壓縮包項(xiàng)目第一步不是打開代碼看而是確認(rèn)你的開發(fā)板是不是STM32F103C8T6以及代碼里引腳配置是否和你手上的板子一致。我用STM32CubeMX重新生成一份工程這是最穩(wěn)妥的路徑。打開STM32CubeMX芯片選擇STM32F103C8Tx然后按下面的方式配置RCCHSE選擇Crystal/Ceramic Resonator外部晶振這個(gè)是8MHz無源晶振常用的配置方式。SYSDebug選擇Serial Wire這一步非常關(guān)鍵不然你燒錄一次程序之后第二次就連接不上芯片了因?yàn)槟J(rèn)的JTAG引腳被程序占用了SWD也被關(guān)了。這就是為什么熱搜詞里有“stm32禁用jtag”踩過坑的都懂。I2C1選擇I2C默認(rèn)PB6是SCL、PB7是SDA。GPIODHT11數(shù)據(jù)腳我一般接PA0配置為Output Push Pull速度Low就行。讀時(shí)序時(shí)再手動(dòng)切換為輸入模式。如果使用開漏輸出外部上拉也可以但DHT11的時(shí)序要求比較嚴(yán)格用推挽輸出切換輸入方向這個(gè)方式更可控。USART1可選用于調(diào)試打印接PA9TX和PA10RX。時(shí)鐘樹要注意STM32F103系列最高主頻72MHz一般我們?cè)贑lock Configuration里把PLL倍頻調(diào)到x9系統(tǒng)時(shí)鐘選PLLCLK最終得到72MHz。我見過有人直接在CubeMX里默認(rèn)配置就跑了結(jié)果系統(tǒng)時(shí)鐘才8MHz直接用HSII2C通信速率不對(duì)OLED顯示就會(huì)出問題。有一點(diǎn)要特別說明I2C的速率配置為100KHzStandard Mode就行OLED的SSD1306控制器雖然支持400KHzFast Mode但實(shí)際走線、上拉電阻和代碼實(shí)現(xiàn)都可能影響穩(wěn)定性。我調(diào)試的時(shí)候遇到過100KHz穩(wěn)定、400KHz偶發(fā)亂碼的情況后來干脆統(tǒng)一用100KHz。這個(gè)項(xiàng)目顯示內(nèi)容不多100KHz完全夠用。2.2 KEIL5工程配置與Pack安裝CubeMX生成代碼后用KEIL5打開MDK-ARM目錄下的工程文件。但在這之前你要確認(rèn)KEIL5的Pack裝了沒有。很多新手上來就打開工程然后報(bào)一堆“device not found”或者“cannot open source file xxx.h”大部分原因就是Pack沒裝好。STM32F103C8T6對(duì)應(yīng)的是Keil.STM32F1xx_DFP這個(gè)Pack。打開KEIL的Pack Installer搜索STM32F1xx安裝對(duì)應(yīng)版本就行。這個(gè)Pack里面包含了芯片的SVD描述文件、Flash算法、啟動(dòng)文件沒有它KEIL根本不知道你要燒錄的芯片是什么。編譯前還有幾個(gè)設(shè)置我要提醒一下C/C選項(xiàng)卡里Define一欄加上USE_HAL_DRIVER,STM32F103C8Tx這是CubeMX生成代碼的標(biāo)配如果你用的是現(xiàn)成工程看看有沒有漏掉。勾選Use MicroLIB這樣可以省不少Flash空間因?yàn)闃?biāo)準(zhǔn)的C庫printf會(huì)引入很多浮點(diǎn)格式化代碼MicroLIB是精簡版對(duì)單片機(jī)完全夠用。Debug選項(xiàng)卡里選擇ST-Link Debugger或者其他你手上的下載器比如DAP-Link然后在Settings里確認(rèn)能識(shí)別到芯片ID。如果你看到的是“No Target Connected”或者“Cannot access Target”先檢查接線SWDIO、SWCLK、GND三根線必須接對(duì)VCC也要接但不要接下載器的目標(biāo)供電除非你確定板子沒有獨(dú)立供電。還有一個(gè)常見坑下載器質(zhì)量不好或線太長導(dǎo)致SWD時(shí)鐘頻率太高連不上把Flash Download里的下載速度調(diào)到100kHz甚至10kHz試試。2.3 工程文件結(jié)構(gòu)拆解打開這個(gè)壓縮包項(xiàng)目我猜里面大概有這幾個(gè)文件夾Core包含main.c、stm32f1xx_it.c、system_stm32f1xx.cDriversSTM32官方HAL庫的源碼和頭文件HAL_LIB或Middlewares一些額外的庫文件BSP或User我們自己寫的DHT11驅(qū)動(dòng)、OLED驅(qū)動(dòng)MDK-ARMKEIL工程文件這種分層思路是對(duì)的HAL庫是ST官方的不要?jiǎng)覤SP層是板級(jí)支持包每個(gè)外設(shè)一個(gè)文件User層是主邏輯。如果你拿到手的壓縮包沒有這種結(jié)構(gòu)也沒關(guān)系只要main.c是完整的你完全可以自己把DHT11和OLED的驅(qū)動(dòng)文件整理出來這也是我下面要重點(diǎn)講的。3. 核心實(shí)現(xiàn)拆解DHT11驅(qū)動(dòng)與OLED顯示3.1 DHT11單總線時(shí)序從波形到代碼DHT11的通信協(xié)議叫單總線1-Wire一根線既做電源又做數(shù)據(jù)嚴(yán)格說是數(shù)據(jù)線電源是獨(dú)立的核心邏輯就是靠不同長度的低電平脈沖來表示0和1。完整的一次通信流程是這樣主機(jī)STM32先把數(shù)據(jù)線拉低至少18ms然后釋放拉高DHT11檢測到這個(gè)起始信號(hào)后會(huì)先拉低80us再拉高80us作為響應(yīng)信號(hào)緊接著發(fā)送40bit的數(shù)據(jù)8bit濕度整數(shù)部分、8bit濕度小數(shù)部分、8bit溫度整數(shù)部分、8bit溫度小數(shù)部分、8bit校驗(yàn)和。40bit的數(shù)據(jù)里面每一位的編碼規(guī)則是先拉低50us然后拉高拉高持續(xù)26~28us表示0拉高持續(xù)70us表示1。注意這個(gè)時(shí)序不是絕對(duì)的DHT11的手冊(cè)上給的是范圍值不同的批次的傳感器可能會(huì)有細(xì)微差別。所以讀時(shí)序的代碼里一般會(huì)有超時(shí)判斷防止死等。下面這段代碼是我整理過的DHT11讀取邏輯使用HAL庫的微秒延時(shí)函數(shù)// 注意需要自己實(shí)現(xiàn)微秒延時(shí)HAL_Delay只支持毫秒 static void DHT11_Delay_US(uint16_t us) { // 使用DWT計(jì)數(shù)器實(shí)現(xiàn)精確延時(shí)或者用SysTick重載 DWT_Delay_Init(); DWT_Delay_US(us); } uint8_t DHT11_Read_Data(uint8_t *humidity, uint8_t *temperature) { uint8_t buf[5] {0}; uint8_t i, j, temp 0; // 主機(jī)拉低起始信號(hào)至少18ms GPIO_Set_Pin(DHT11_PIN, 0); HAL_Delay(20); // 釋放總線拉高等待DHT11響應(yīng) GPIO_Set_Pin(DHT11_PIN, 1); DHT11_Delay_US(30); // 切換為輸入模式讀取數(shù)據(jù) GPIO_Set_Mode_Input(DHT11_PIN); // 等待低電平響應(yīng)信號(hào)80us低80us高 // 超時(shí)保護(hù)防止死循環(huán) uint16_t timeout 10000; while (GPIO_Read_Pin(DHT11_PIN) 1) { if (--timeout 0) return 1; // 超時(shí)傳感器未響應(yīng) } timeout 10000; while (GPIO_Read_Pin(DHT11_PIN) 0) { if (--timeout 0) return 1; } timeout 10000; while (GPIO_Read_Pin(DHT11_PIN) 1) { if (--timeout 0) return 1; } // 讀取40bit數(shù)據(jù) for (j 0; j 5; j) { for (i 0; i 8; i) { timeout 10000; while (GPIO_Read_Pin(DHT11_PIN) 0) { if (--timeout 0) return 1; } DHT11_Delay_US(40); // 40us后采樣 if (GPIO_Read_Pin(DHT11_PIN) 1) { temp | 0x01; // 高電平持續(xù)較久說明是1 } while (GPIO_Read_Pin(DHT11_PIN) 1) { if (--timeout 0) return 1; } if (i 7) temp 1; } buf[j] temp; temp 0; } // 校驗(yàn) if ((buf[0] buf[1] buf[2] buf[3]) buf[4]) { *humidity buf[0]; *temperature buf[2]; return 0; } return 2; // 校驗(yàn)失敗 }這里最關(guān)鍵的是那個(gè)DHT11_Delay_US(40)在第28~30us的時(shí)候采樣電平如果你延時(shí)不準(zhǔn)確、偏長讀出來的數(shù)據(jù)會(huì)全部是錯(cuò)誤的。這也是為什么我強(qiáng)調(diào)要用DWT或者SysTick做微秒延時(shí)而不是靠空循環(huán)?？昭h(huán)在不同優(yōu)化等級(jí)下時(shí)間變化很大Debug模式下能跑通Release模式下就掛了。另外每次讀取完DHT11之后建議間隔1秒以上再讀下一次DHT11手冊(cè)上寫的最高采樣頻率是1Hz也就是每秒最多一次。你如果在一個(gè)while循環(huán)里連續(xù)讀取中間不加延時(shí)傳感器會(huì)反應(yīng)不過來讀到的數(shù)據(jù)永遠(yuǎn)是舊的或者直接超時(shí)。3.2 SSD1306 OLED驅(qū)動(dòng)I2C通信與初始化序列OLED用的SSD1306控制器支持6800/8080并行接口、SPI、I2C三種方式我們用的是I2C。SSD1306的I2C地址一般是0x3C如果你的模塊是0x3D多半是因?yàn)榈刂芬_SA0被拉高了。這個(gè)地址在初始化代碼里寫死如果你發(fā)現(xiàn)屏幕沒反應(yīng)先查地址不要急著改代碼。I2C通信的流程是主機(jī)發(fā)送起始信號(hào)→發(fā)送設(shè)備地址寫位0x78或0x7A→發(fā)送控制字節(jié)0x00表示后續(xù)是命令0x40表示后續(xù)是數(shù)據(jù)→發(fā)送命令或數(shù)據(jù)。SSD1306初始化是一長串命令序列設(shè)置顯示關(guān)閉、電荷泵開啟、對(duì)比度、掃描方向、行地址模式等。這里我強(qiáng)烈建議用現(xiàn)成的、驗(yàn)證過的初始化序列不要自己改除非你仔細(xì)讀過SSD1306的數(shù)據(jù)手冊(cè)。下面是常用的一段uint8_t oled_init_cmds[] { 0xAE, // 關(guān)閉顯示 0x20, 0x00, // 設(shè)置內(nèi)存尋址模式為水平尋址 0xB0, // 設(shè)置頁地址第0頁 0xC8, // 設(shè)置掃描方向從右上到左下和常見屏幕方向一致 0x00, 0x10, // 設(shè)置列地址低/高四位 0x40, // 設(shè)置顯示起始行 0x81, 0x7F, // 設(shè)置對(duì)比度 0xA1, // 設(shè)置段重映射避免鏡像 0xA6, // 正常顯示非反色 0xA8, 0x3F, // 設(shè)置多路復(fù)用比 0xD3, 0x00, // 設(shè)置顯示偏移 0xD5, 0x80, // 設(shè)置時(shí)鐘分頻 0xD9, 0xF1, // 設(shè)置預(yù)充電周期 0xDA, 0x12, // 設(shè)置引腳配置 0xDB, 0x40, // 設(shè)置VCOMH 0x8D, 0x14, // 開啟電荷泵 0xAF, // 開啟顯示 };有些初始化序列里如果有0xA1段重映射而你的屏幕又是鏡像的那就改成0xA0試試。同理掃描方向0xC8和0xC0互為鏡像。OLED這行就是個(gè)靠命令調(diào)鏡像的事情別懷疑芯片壞了。I2C讀寫用HAL庫的HAL_I2C_Mem_Write就很方便因?yàn)樗茏詣?dòng)處理設(shè)備地址、寄存器地址這里就是控制字節(jié)和數(shù)據(jù)緩沖區(qū)。寫一個(gè)命令void OLED_Write_Cmd(uint8_t cmd) { HAL_I2C_Mem_Write(hi2c1, OLED_ADDR, 0x00, I2C_MEMADD_SIZE_8BIT, cmd, 1, 100); } void OLED_Write_Data(uint8_t data) { HAL_I2C_Mem_Write(hi2c1, OLED_ADDR, 0x40, I2C_MEMADD_SIZE_8BIT, data, 1, 100); }這里有個(gè)小坑HAL_I2C_Mem_Write的第二個(gè)參數(shù)是設(shè)備地址SSD1306的7位地址是0x3C但HAL庫內(nèi)部會(huì)在發(fā)送時(shí)自動(dòng)左移一位并拼接讀寫位所以你傳的就是0x3C不用自己移位成0x78。我見過有人在代碼里寫0x78結(jié)果I2C總線上的地址變成了0xF0屏幕完全不響應(yīng)。3.3 OLED漢字取模與顯示邏輯OLED顯示漢字和字符的本質(zhì)是往GRAM里填像素?cái)?shù)據(jù)。128x64分辨率一列8個(gè)像素為一個(gè)字節(jié)16x16的漢字就是32字節(jié)數(shù)據(jù)。取模工具我用的是PCtoLCD2002設(shè)置如下取模方式陰碼點(diǎn)陣內(nèi)為1表示點(diǎn)亮逐行式取模每行16個(gè)點(diǎn)共16行取出來的效果是0x00,0x00,0xFC,0x04, ...這種代碼可以直接定義成const數(shù)組節(jié)省RAM。顯示時(shí)要注意SSD1306在頁尋址模式下一次可以從某個(gè)頁page的某列開始連續(xù)寫數(shù)據(jù)。頁地址范圍是0~7每頁8行像素所以64行像素被分成8頁。你往某個(gè)頁寫一個(gè)字節(jié)這個(gè)字節(jié)的8個(gè)bit就代表該頁這8行對(duì)應(yīng)列的亮滅。這在顯示16x16漢字時(shí)需要跨兩個(gè)頁寫數(shù)據(jù)上半部分16行像素位于第0頁和第1頁從page p開始寫兩輪每輪16字節(jié)。顯示函數(shù)的核心邏輯大概這樣void OLED_Show_CN(uint8_t x, uint8_t page, const uint8_t *font_data) { // 先寫漢字上半部分前16字節(jié) OLED_Set_Cursor(x, page); for (uint8_t i 0; i 16; i) { OLED_Write_Data(font_data[i]); } // 再寫下半部分后16字節(jié) OLED_Set_Cursor(x, page 1); for (uint8_t i 16; i 32; i) { OLED_Write_Data(font_data[i]); } }這里有個(gè)注意點(diǎn)漢字庫通常是16x16像素但“溫”、“濕”、“度”這些字有些筆畫比較復(fù)雜取模出來效果可能差強(qiáng)人意。如果顯示效果不好可以把取模的字號(hào)改成16x16標(biāo)準(zhǔn)或者換成12x12的字體減少空間占用。還有一個(gè)很實(shí)用的技巧顯示變量。DHT11讀出來的是整數(shù)比如濕度45%、溫度25度。我們可以在OLED上顯示“Temp: 25 C”和“Hum: 45 %”。但注意DHT11的精度整數(shù)顯示就夠了。如果你想顯示小數(shù)做浮點(diǎn)格式化會(huì)很消耗Flash和RAM建議整數(shù)和小數(shù)分開算比如25.3度就分別取25和3手動(dòng)拼字符。3.4 main.c主循環(huán)邏輯設(shè)計(jì)主程序邏輯非常簡單但有一些細(xì)節(jié)值得講究。我的main函數(shù)里外設(shè)初始化完成后主循環(huán)大概是這樣int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_I2C1_Init(); MX_USART1_UART_Init(); OLED_Init(); OLED_Clear(); OLED_Show_String(16, 0, Temp:, 16); OLED_Show_String(16, 2, Hum:, 16); uint8_t hum, temp; char buf[20]; while (1) { if (DHT11_Read_Data(hum, temp) 0) { // 成功讀取更新顯示 sprintf(buf, %d C, temp); OLED_Show_String(64, 0, buf, 16); // 顯示溫度 sprintf(buf, %d %%, hum); OLED_Show_String(64, 2, buf, 16); // 顯示濕度 } else { // 讀取失敗可以顯示錯(cuò)誤標(biāo)記 OLED_Show_String(0, 7, DHT11 ERR, 8); } HAL_Delay(1000); // 每秒讀一次 } }這里有個(gè)細(xì)節(jié)每一輪更新前不用清屏因?yàn)槟阋碌膮^(qū)域只是數(shù)字部分而且數(shù)字是用固定位置寫上去的。如果數(shù)字從“25”變成“5”之前十位的“2”如果不擦掉顯示就成了“52”。最簡單的辦法是每次先在這個(gè)區(qū)域填充空白字符比如寫三個(gè)空格再寫新數(shù)據(jù)。還有一點(diǎn)OLED_Init之后要做一次OLED_Clear不然上電屏幕可能是花屏因?yàn)镚RAM里的初始數(shù)據(jù)是不確定的。4. 常見問題與排查技巧實(shí)錄4.1 I2C通信異常的排查思路I2C通信異常是最讓人頭痛的問題因?yàn)榭雌饋泶a沒錯(cuò)、接線沒錯(cuò)但就是沒反應(yīng)。我總結(jié)了幾個(gè)排查方向按優(yōu)先級(jí)排列查硬件接線SCL和SDA有沒有接反VCC和GND有沒有接對(duì)OLED模塊的VCC雖然標(biāo)稱3.3V~5V都能工作但STM32的I2C引腳是3.3V電平所以最好統(tǒng)一用3.3V供電。如果你把OLED的VCC接到了5V而SCL/SDA是3.3V的IO口長期運(yùn)行還是有風(fēng)險(xiǎn)的。查I2C地址前面已經(jīng)提過0x3C和0x3D的問題。你可以在初始化OLED之前用HAL_I2C_IsDeviceReady檢測一下設(shè)備是否在線if (HAL_I2C_IsDeviceReady(hi2c1, 0x3C, 5, 100) ! HAL_OK) { // 設(shè)備未響應(yīng)這里可以點(diǎn)一個(gè)LED提示 }查外部上拉電阻STM32的I2C引腳是開漏輸出必須要有外部上拉電阻才能輸出高電平。大多數(shù)開發(fā)板和OLED模塊上已經(jīng)帶了4.7k或10k上拉電阻但如果你的OLED是那種裸屏模塊或者你用了杜邦線外接沒有上拉電阻I2C通信是絕對(duì)不工作的。查I2C速率如果通信不穩(wěn)定把速率從400KHz降到100KHz試試。這個(gè)問題在長線連接時(shí)特別明顯杜邦線一長寄生電容就會(huì)影響信號(hào)邊沿速率越高越容易出錯(cuò)。4.2 DHT11讀取失敗和數(shù)據(jù)恒為0的調(diào)試方法DHT11讀取失敗最常見的三個(gè)原因引腳配置不對(duì)、微秒延時(shí)不準(zhǔn)、總線競爭多個(gè)設(shè)備共用引腳。調(diào)試方法有一個(gè)很好用的用邏輯分析儀抓波形沒有邏輯分析儀也可以用printf打印每個(gè)階段的電平狀態(tài)。我分享一段調(diào)試思路把DHT11數(shù)據(jù)引腳配置為輸入模式后在主循環(huán)里只打印引腳電平的翻轉(zhuǎn)時(shí)間。如果你看到的是大約20ms低電平→80us低→80us高→數(shù)據(jù)段說明時(shí)序基本正常。如果你看到引腳一直高電平說明傳感器沒供電或者數(shù)據(jù)線沒接對(duì)。如果一上電就是低電平可能是傳感器壞了或者數(shù)據(jù)線短路到地。數(shù)據(jù)恒為0還有一個(gè)可能性讀取成功后你打印的是buf[0]和buf[2]但實(shí)際接收的濕度值是整數(shù)部分buf[0]如果你看錯(cuò)位了把buf[1]小數(shù)部分當(dāng)成濕度打印那確實(shí)經(jīng)常是0因?yàn)镈HT11的濕度小數(shù)部分大多數(shù)時(shí)候就是0。關(guān)于微秒延時(shí)我再補(bǔ)充一下DWT的實(shí)現(xiàn)。DWTData Watchpoint and Trace是Cortex-M3內(nèi)核里的一個(gè)調(diào)試組件它的CYCCNT寄存器可以計(jì)數(shù)CPU周期。通過它實(shí)現(xiàn)微秒延時(shí)非常精準(zhǔn)而且不受優(yōu)化等級(jí)影響void DWT_Delay_Init(void) { CoreDebug-DEMCR | CoreDebug_DEMCR_TRCENA_Msk; DWT-CYCCNT 0; DWT-CTRL | DWT_CTRL_CYCCNTENA_Msk; } void DWT_Delay_US(uint32_t us) { uint32_t start DWT-CYCCNT; uint32_t ticks us * (SystemCoreClock / 1000000); while ((DWT-CYCCNT - start) ticks); }這個(gè)方案比SysTick更省事因?yàn)镾ysTick可能被HAL庫的HAL_Delay占用。4.3 OLED顯示亂碼、花屏和鏡像問題OLED顯示亂碼的排查如果屏幕上全是雪花點(diǎn)或者滿屏亮塊大概率是初始化序列不對(duì)或者GRAM寫入方式不匹配。檢查一下你是不是用了SPI接口的OLED但代碼是按I2C寫的——這兩種接口的屏長得幾乎一樣容易拿錯(cuò)模塊。如果字符顯示出來是上下左右顛倒的那基本就是段重映射和掃描方向的問題。把初始化序列里的0xA1改成0xA00xC8改成0xC0排列組合試一遍就能找到正著的方向。如果字符顯示正常但位置不對(duì)比如從中間開始顯示看看頁地址和列地址的設(shè)置。OLED_Set_Cursor這個(gè)函數(shù)必須同時(shí)設(shè)頁地址和列地址有些人只設(shè)了列地址沒設(shè)頁地址所有內(nèi)容都寫在第一頁上就會(huì)重疊成一坨。花屏還有一個(gè)特殊原因I2C通信本身沒問題但OLED的電源電壓不穩(wěn)。OLED的電荷泵開啟后電流會(huì)增大如果你用的是電腦USB口供電電壓可能被拉低導(dǎo)致屏閃或者花屏。換獨(dú)立5V/3.3V電源或者在電源引腳旁邊加一個(gè)10uF的電解電容和一個(gè)100nF的瓷片電容能緩解這個(gè)問題。4.4 STM32燒錄失敗SWD連不上和JTAG禁用問題燒錄失敗這個(gè)坑我必須單獨(dú)說因?yàn)樗Ｒ娏?。有兩種典型情況第一種第一次燒錄沒問題燒完之后第二次就報(bào)“No target connected”。這種基本都是程序里配置了GPIO把PA13/PA14/PA15/PB3/PB4這些調(diào)試腳給重新定義了或者把SWD功能關(guān)了。CubeMX里在SYS選項(xiàng)卡設(shè)置Debug為Serial Wire這樣SWD引腳就不會(huì)被重映射下載器還能連上。如果已經(jīng)連不上了解決辦法是把BOOT0引腳拉高重新上電讓芯片進(jìn)入ISP模式這時(shí)候SWD是恢復(fù)的擦除一下Flash再重新下載。第二種下載器本身驅(qū)動(dòng)有問題。ST-Link/V2在Win10/Win11上有時(shí)會(huì)因?yàn)轵?qū)動(dòng)沖突導(dǎo)致電腦識(shí)別不到。解決辦法是在ST官方工具STM32CubeProgrammer里重新安裝驅(qū)動(dòng)。如果你用的是盜版ST-Link或者那種9塊9的DAP-Link固件不穩(wěn)定的情況更多建議先換一根數(shù)據(jù)線試試——沒錯(cuò)數(shù)據(jù)線問題導(dǎo)致下載失敗的案例我見過不止一次。我在實(shí)際使用中最推薦下載方式的是ST-Link UtilitySTM32 ST-LINK Utility它可以直接擦除、編程、校驗(yàn)整個(gè)Flash對(duì)于排查程序運(yùn)行異常非常有用。程序跑飛了、芯片鎖死了用它一鍵全片擦除干干凈凈。4.5 這個(gè)壓縮包項(xiàng)目的可擴(kuò)展方向把這個(gè)基礎(chǔ)項(xiàng)目吃透之后后續(xù)擴(kuò)展的空間很大這里列幾個(gè)我實(shí)際做過的方向換成DHT22或者SHT30傳感器只需要改驅(qū)動(dòng)層顯示層完全不用動(dòng)。增加歷史溫度曲線顯示OLED刷新改成局部刷新每秒畫出溫度變化的像素點(diǎn)就能做一個(gè)微型趨勢圖。增加按鍵切換到不同顯示頁面比如一頁顯示溫濕度一頁顯示最大值最小值。把串口打印加上通過USART把數(shù)據(jù)發(fā)到電腦的串口助手方便調(diào)試和分析。加一個(gè)ESP8266或者ESP32模塊通過串口把溫濕度數(shù)據(jù)傳到云端——這就是智能家居的雛形了。把OLED換成1.3寸的I2C OLEDSH1106驅(qū)動(dòng)代碼大部分可以復(fù)用只要改初始化序列和窗口設(shè)置函數(shù)就行。從底層驅(qū)動(dòng)的角度你可以深入研究一下CubeMX的HAL庫源碼看看I2C的狀態(tài)機(jī)是怎么實(shí)現(xiàn)的、DMA模式怎么處理、中斷回調(diào)里能不能觸發(fā)數(shù)據(jù)讀取。這些內(nèi)容才是從一個(gè)抄代碼的新手變成能獨(dú)立做項(xiàng)目的人的分水嶺。5. 最后想說的話這個(gè)壓縮包項(xiàng)目說大不大說小也不小。它沒有用到復(fù)雜的外設(shè)沒有RTOS沒有復(fù)雜的算法但它把嵌入式開發(fā)最基本的幾個(gè)環(huán)節(jié)全部串起來了芯片配置、GPIO操作、外設(shè)通信協(xié)議、時(shí)序控制、顯示驅(qū)動(dòng)、以及最重要的——排查問題的思路。我的建議是拿到任何項(xiàng)目壓縮包不要急著燒錄看效果先用CubeMX打開工程文件或者自己重建一份把每一行代碼都過一遍搞清楚時(shí)鐘怎么配的、引腳怎么選的、I2C速率設(shè)了多少、DHT11時(shí)序怎么實(shí)現(xiàn)的、OLED初始化序列里每一條命令干嘛用的。全部搞清楚之后再燒錄到板子上。這樣就算出問題你也知道往哪兒查。如果你在調(diào)試過程中遇到和我當(dāng)年一樣的坑——OLED不亮、DHT11讀不出來、燒錄第二次就失敗——?dú)g迎回來對(duì)照這篇文章一條條排查。實(shí)在解決不了可以看看板子型號(hào)、引腳接線、報(bào)錯(cuò)信息這三個(gè)信息很多時(shí)候問題就藏在最基礎(chǔ)的細(xì)節(jié)里。本文還有配套的精品資源點(diǎn)擊獲取