簡(jiǎn)介本資源是一套基于STM32F10x系列微控制器的嵌入式綜合實(shí)踐項(xiàng)目面向嵌入式初學(xué)者與課程設(shè)計(jì)者解決溫濕度數(shù)據(jù)采集與本地可視化顯示的核心需求。項(xiàng)目完整實(shí)現(xiàn)DHT11/DHT22傳感器數(shù)據(jù)讀取、STM32 ADC或GPIO單總線驅(qū)動(dòng)、7腳SH1106 OLEDI2C/SPI接口動(dòng)態(tài)刷新顯示等功能覆蓋硬件連接、外設(shè)配置GPIO/ADC/I2C/USART/TIM、固件庫(kù)調(diào)用及Keil uVision5工程構(gòu)建全流程。壓縮包共141個(gè)文件含37個(gè)頭文件h、34個(gè)源碼文件c——涵蓋STM32標(biāo)準(zhǔn)外設(shè)庫(kù)如stm32f10x_adc.c、stm32f10x_i2c.c、OLED驅(qū)動(dòng)、傳感器通信協(xié)議解析及主應(yīng)用邏輯另有編譯中間文件o/d/crf、調(diào)試配置dbgconf、工程配置uvprojx/uvoptx及自動(dòng)化腳本keilkilll.bat結(jié)構(gòu)清晰便于理解工程組織與編譯機(jī)制。已有3195人學(xué)習(xí)下載提供可直接編譯運(yùn)行的完整代碼框架、README使用說(shuō)明及典型硬件連接參考助讀者快速掌握傳感器MCU顯示終端的協(xié)同開(kāi)發(fā)能力。1. 項(xiàng)目概述一個(gè)經(jīng)典的嵌入式入門實(shí)戰(zhàn)如果你剛開(kāi)始接觸STM32或者想找一個(gè)能串聯(lián)起GPIO、I2C通信、傳感器數(shù)據(jù)采集和顯示的綜合小項(xiàng)目來(lái)練手那么這個(gè)“STM32 溫濕度傳感器 OLED顯示”的組合絕對(duì)是你的不二之選。它不像點(diǎn)個(gè)LED燈那么簡(jiǎn)單也不至于復(fù)雜到讓人望而卻步正好卡在能讓你充分動(dòng)手、又能看到直觀成果的那個(gè)甜點(diǎn)上。簡(jiǎn)單來(lái)說(shuō)這個(gè)項(xiàng)目的核心就是讓STM32微控制器讀取溫濕度傳感器比如常見(jiàn)的DHT11的數(shù)據(jù)然后通過(guò)一個(gè)0.96寸的7腳OLED屏幕把這些數(shù)據(jù)實(shí)時(shí)、美觀地顯示出來(lái)。整個(gè)過(guò)程涉及了硬件引腳連接、通信協(xié)議驅(qū)動(dòng)I2C或SPI取決于你的OLED模塊、傳感器數(shù)據(jù)協(xié)議解析以及最終的屏幕繪圖邏輯。完成它你不僅能獲得一個(gè)可以放在桌頭顯示環(huán)境溫濕度的小玩意兒更重要的是你能系統(tǒng)地走一遍嵌入式開(kāi)發(fā)中“感知-處理-顯示”的完整鏈路這對(duì)理解任何更復(fù)雜的物聯(lián)網(wǎng)IoT設(shè)備都大有裨益。我之所以推薦這個(gè)項(xiàng)目是因?yàn)樗囊胤浅５湫鸵粋€(gè)主控STM32一個(gè)傳感器輸入一個(gè)人機(jī)交互輸出。市面上大量的開(kāi)發(fā)板教程和開(kāi)源庫(kù)都支持這些模塊意味著你踩坑時(shí)能找到豐富的解決方案。接下來(lái)我會(huì)基于最常見(jiàn)的硬件組合STM32F103C8T6核心板、DHT11、SSD1306驅(qū)動(dòng)的0.96寸OLED和HAL庫(kù)帶你從硬件連接到軟件實(shí)現(xiàn)完整地走一遍流程并分享那些教程里通常不會(huì)細(xì)說(shuō)的“坑點(diǎn)”和調(diào)試技巧。2. 硬件選型與核心思路解析2.1 為什么是這些硬件STM32F103C8T6Blue Pill核心板這是性價(jià)比之王也是STM32生態(tài)中資源最豐富的一款。它基于ARM Cortex-M3內(nèi)核擁有足夠的GPIO、定時(shí)器和通信接口USART、I2C、SPI來(lái)完成我們這個(gè)項(xiàng)目。其HAL庫(kù)和標(biāo)準(zhǔn)庫(kù)資料浩如煙海社區(qū)支持極好非常適合學(xué)習(xí)和原型開(kāi)發(fā)。DHT11溫濕度傳感器這是一個(gè)單總線1-Wire數(shù)字傳感器。選擇它主要是因?yàn)槠浜?jiǎn)單、廉價(jià)且足夠用于室內(nèi)環(huán)境監(jiān)測(cè)。它直接輸出數(shù)字信號(hào)省去了STM32內(nèi)部ADC模數(shù)轉(zhuǎn)換器的配置對(duì)于初學(xué)者更友好。不過(guò)要注意它的精度濕度±5%RH溫度±2℃和響應(yīng)速度對(duì)于高要求場(chǎng)合可能不夠但對(duì)于學(xué)習(xí)項(xiàng)目完全足夠。0.96寸OLEDSSD1306驅(qū)動(dòng)7腳OLED是“有機(jī)發(fā)光二極管”的簡(jiǎn)稱。這種屏幕自發(fā)光對(duì)比度高顯示黑色時(shí)幾乎不耗電視覺(jué)效果好。7腳模塊通常支持I2C和SPI兩種通信模式通過(guò)模塊背面的電阻焊接選擇。I2C只需2根數(shù)據(jù)線SCL SDA節(jié)省IO口SPI速度更快。對(duì)于顯示溫濕度這種刷新率要求不高的場(chǎng)景I2C是更簡(jiǎn)單、更通用的選擇也是本項(xiàng)目的推薦方式。2.2 整體通信架構(gòu)設(shè)計(jì)項(xiàng)目的核心是通信協(xié)議。STM32作為大腦需要與兩個(gè)外設(shè)“對(duì)話”。與DHT11的“單線對(duì)話”DHT11采用單總線協(xié)議。這意味著數(shù)據(jù)發(fā)送和接收都通過(guò)同一根數(shù)據(jù)線DQ依靠嚴(yán)格的高低壓電平持續(xù)時(shí)間來(lái)區(qū)分?jǐn)?shù)據(jù)位0或1和通信階段開(kāi)始信號(hào)、響應(yīng)信號(hào)。這要求STM32必須能夠精確地控制引腳輸出高低電平并更精確地讀取輸入電平的持續(xù)時(shí)間。通常我們會(huì)用一個(gè)通用GPIO引腳并配合微秒級(jí)延時(shí)函數(shù)來(lái)實(shí)現(xiàn)時(shí)序模擬。因?yàn)闀r(shí)序要求嚴(yán)格微秒級(jí)直接使用HAL庫(kù)的HAL_Delay()毫秒級(jí)是不行的需要自己實(shí)現(xiàn)或使用定時(shí)器。與OLED的“I2C對(duì)話”我們選擇I2C模式驅(qū)動(dòng)OLED。I2C是一種同步、串行、多主從的通信總線只需要兩根線串行時(shí)鐘線SCL和串行數(shù)據(jù)線SDA。STM32作為主機(jī)MasterOLED屏幕上的SSD1306驅(qū)動(dòng)芯片作為從機(jī)Slave。STM32通過(guò)I2C總線向SSD1306發(fā)送命令和數(shù)據(jù)控制其點(diǎn)亮哪些像素。HAL庫(kù)提供了完善的I2C發(fā)送/接收函數(shù)我們只需要關(guān)注如何組織這些命令和數(shù)據(jù)來(lái)顯示我們想要的字符或圖形。注意在連接硬件前務(wù)必確認(rèn)你的OLED模塊是I2C模式。檢查模塊背面是否有標(biāo)識(shí)或電阻焊點(diǎn)。通常將電阻焊接到標(biāo)有“I2C”的焊盤上或者斷開(kāi)“CS”引腳如果是SPI的片選信號(hào)的連接即可設(shè)置為I2C模式。2.3 硬件連接清單與原理下面是最簡(jiǎn)潔的接線表。假設(shè)使用STM32F103C8T6的默認(rèn)引腳功能STM32引腳連接至功能說(shuō)明備注3.3VOLED VCC, DHT11 VCC電源正極務(wù)必接3.3V接5V可能燒毀OLEDGNDOLED GND, DHT11 GND電源地共地至關(guān)重要PB6OLED SCLI2C1時(shí)鐘線需在CubeMX中配置為I2C1_SCLPB7OLED SDAI2C1數(shù)據(jù)線需在CubeMX中配置為I2C1_SDAPA1DHT11 DATA單總線數(shù)據(jù)線可任選一個(gè)GPIO需配置為上拉輸入/推挽輸出接線原理與避坑指南電源OLED和DHT11都工作于3.3V。千萬(wàn)不要將OLED的VCC接到開(kāi)發(fā)板的5V引腳上極大概率會(huì)損壞屏幕。上拉電阻I2C總線SCL和SDA需要上拉電阻通常4.7kΩ或10kΩ到3.3V以確?？偩€空閑時(shí)為高電平。好消息是很多OLED模塊已經(jīng)內(nèi)置了這些上拉電阻。如果你的模塊沒(méi)有或者通信不穩(wěn)定需要在STM32的PB6和PB7引腳上分別外接上拉電阻到3.3V。DHT11數(shù)據(jù)線DHT11的數(shù)據(jù)線DQ在空閑時(shí)需要保持高電平。雖然STM32的GPIO可以配置為內(nèi)部上拉但為了信號(hào)穩(wěn)定建議在PA1和3.3V之間外接一個(gè)4.7kΩ~10kΩ的上拉電阻。這是很多初學(xué)者忽略導(dǎo)致讀取失敗的原因。3. 軟件工程搭建與驅(qū)動(dòng)層實(shí)現(xiàn)3.1 使用STM32CubeMX進(jìn)行基礎(chǔ)配置STM32CubeMX是ST官方提供的圖形化配置工具能極大簡(jiǎn)化引腳、時(shí)鐘和外設(shè)的初始化工作。創(chuàng)建項(xiàng)目與選型打開(kāi)CubeMX選擇STM32F103C8Tx創(chuàng)建工程。系統(tǒng)核心SYS在“SYS”選項(xiàng)卡中將“Debug”改為“Serial Wire”。這非常重要否則燒錄一次程序后SWD調(diào)試接口可能被禁用導(dǎo)致無(wú)法再次下載程序。時(shí)鐘RCC在“RCC”選項(xiàng)卡中將高速外部時(shí)鐘HSE設(shè)置為“Crystal/Ceramic Resonator”。我們的核心板通常搭載了8MHz的外部晶振。時(shí)鐘樹(shù)配置進(jìn)入“Clock Configuration”標(biāo)簽頁(yè)。將輸入頻率設(shè)為8MHz然后通過(guò)PLL倍頻將系統(tǒng)時(shí)鐘SYSCLK設(shè)置為72MHz。這是F103系列在3.3V下的典型最高工作頻率性能足夠。GPIO配置找到PA1將其設(shè)置為“GPIO_Output”。我們先將其用作輸出發(fā)送開(kāi)始信號(hào)給DHT11。實(shí)際上PA1需要在輸出和輸入模式間動(dòng)態(tài)切換。這部分更精細(xì)的控制我們留在代碼中實(shí)現(xiàn)這里先設(shè)為輸出。I2C配置找到I2C1將模式設(shè)置為“I2C”。將PB6和PB7自動(dòng)映射為I2C1_SCL和I2C1_SDA。在參數(shù)設(shè)置中I2C速度模式選擇“Standard Mode”100kHz即可。對(duì)于OLED顯示這個(gè)速度綽綽有余。生成代碼在“Project Manager”中設(shè)置好工程名稱、路徑、IDE如MDK-ARM V5然后生成代碼。CubeMX會(huì)生成一個(gè)完整的Keil工程或其他IDE工程其中main.c、i2c.c、gpio.c等文件的初始化代碼都已就緒。3.2 實(shí)現(xiàn)微秒級(jí)延時(shí)函數(shù)由于DHT11的時(shí)序要求精確到微秒級(jí)別而HAL庫(kù)的HAL_Delay()是基于系統(tǒng)滴答定時(shí)器Systick的毫秒級(jí)延時(shí)我們需要一個(gè)更精確的延時(shí)。通常有兩種方法方法一使用定時(shí)器精準(zhǔn)但占用硬件資源配置一個(gè)基本定時(shí)器如TIM2使其每1微秒產(chǎn)生一次更新中斷或計(jì)數(shù)。但為了一個(gè)延時(shí)函數(shù)占用一個(gè)定時(shí)器對(duì)于簡(jiǎn)單項(xiàng)目有些浪費(fèi)。方法二使用空指令循環(huán)NOP進(jìn)行近似延時(shí)簡(jiǎn)單常用這是更常見(jiàn)的做法。通過(guò)分析在72MHz系統(tǒng)時(shí)鐘下執(zhí)行一條空指令__NOP()所需的時(shí)間約1/72MHz ≈ 13.9納秒我們可以編寫(xiě)一個(gè)循環(huán)來(lái)“消耗”時(shí)間。// 在 main.c 或 自定義的 delay.c 文件中 /** * brief 微秒級(jí)延時(shí)函數(shù)近似值 * param us: 需要延時(shí)的微秒數(shù) * note 基于72MHz系統(tǒng)時(shí)鐘通過(guò)循環(huán)空指令實(shí)現(xiàn)。不同優(yōu)化等級(jí)會(huì)影響精度僅適用于時(shí)序要求不極端嚴(yán)格的場(chǎng)合如DHT11。 */ void delay_us(uint32_t us) { // 此參數(shù)需要根據(jù)實(shí)際芯片主頻進(jìn)行校準(zhǔn) // 72MHz下粗略經(jīng)驗(yàn)值循環(huán)一次約消耗 0.125us (8個(gè)NOP/us) // 因此 us * 8 作為循環(huán)次數(shù)。你需要通過(guò)示波器或邏輯分析儀精確校準(zhǔn)這個(gè)系數(shù)。 uint32_t delay us * 8; while(delay--) { __NOP(); // 執(zhí)行一條空操作指令 } }實(shí)操心得這個(gè)delay_us函數(shù)的參數(shù)us * 8中的8是一個(gè)經(jīng)驗(yàn)系數(shù)它會(huì)因編譯器優(yōu)化等級(jí)-O0, -O1, -O2的不同而產(chǎn)生巨大差異。最靠譜的校準(zhǔn)方法是寫(xiě)一段代碼讓一個(gè)GPIO引腳每隔100us翻轉(zhuǎn)一次然后用邏輯分析儀或示波器測(cè)量實(shí)際周期反過(guò)來(lái)調(diào)整這個(gè)系數(shù)。對(duì)于DHT11誤差在幾十微秒內(nèi)通常可以接受。3.3 編寫(xiě)DHT11單總線驅(qū)動(dòng)DHT11的通信流程分為三步主機(jī)STM32發(fā)送開(kāi)始信號(hào) - DHT11響應(yīng) - DHT11發(fā)送40位數(shù)據(jù)。我們需要一個(gè)GPIO引腳在輸出模式發(fā)送開(kāi)始信號(hào)和輸入模式讀取響應(yīng)和數(shù)據(jù)之間切換。// dht11.h #ifndef __DHT11_H #define __DHT11_H #include main.h // 定義DHT11數(shù)據(jù)線連接的GPIO端口和引腳 #define DHT11_GPIO_PORT GPIOA #define DHT11_GPIO_PIN GPIO_PIN_1 // 函數(shù)聲明 void DHT11_GPIO_Init(void); uint8_t DHT11_Read_Data(uint8_t *temperature, uint8_t *humidity); #endif// dht11.c #include dht11.h #include delay.h // 包含你自己實(shí)現(xiàn)的 delay_us 函數(shù) extern TIM_HandleTypeDef htim2; // 如果你用定時(shí)器實(shí)現(xiàn)延時(shí)需要聲明 /** * brief 設(shè)置DHT11數(shù)據(jù)線引腳為輸出模式推挽輸出 */ static void DHT11_GPIO_SetOutput(void) { GPIO_InitTypeDef GPIO_InitStruct {0}; GPIO_InitStruct.Pin DHT11_GPIO_PIN; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; // 推挽輸出 GPIO_InitStruct.Pull GPIO_NOPULL; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(DHT11_GPIO_PORT, GPIO_InitStruct); } /** * brief 設(shè)置DHT11數(shù)據(jù)線引腳為輸入模式上拉輸入 */ static void DHT11_GPIO_SetInput(void) { GPIO_InitTypeDef GPIO_InitStruct {0}; GPIO_InitStruct.Pin DHT11_GPIO_PIN; GPIO_InitStruct.Mode GPIO_MODE_INPUT; // 輸入模式 GPIO_InitStruct.Pull GPIO_PULLUP; // 內(nèi)部上拉替代外部電阻 HAL_GPIO_Init(DHT11_GPIO_PORT, GPIO_InitStruct); } /** * brief 主機(jī)發(fā)送開(kāi)始信號(hào) * 拉低至少18ms然后拉高20-40us等待DHT11響應(yīng)。 */ static void DHT11_Start(void) { DHT11_GPIO_SetOutput(); HAL_GPIO_WritePin(DHT11_GPIO_PORT, DHT11_GPIO_PIN, GPIO_PIN_RESET); // 拉低 delay_us(18000); // 拉低18ms DHT11手冊(cè)要求至少18ms HAL_GPIO_WritePin(DHT11_GPIO_PORT, DHT11_GPIO_PIN, GPIO_PIN_SET); // 拉高 delay_us(30); // 拉高20-40us DHT11_GPIO_SetInput(); // 切換為輸入模式準(zhǔn)備讀取響應(yīng) } /** * brief 等待DHT11的響應(yīng)信號(hào) * retval 0: 響應(yīng)成功 1: 響應(yīng)超時(shí)失敗 */ static uint8_t DHT11_Wait_Response(void) { uint32_t timeout 10000; // 超時(shí)計(jì)數(shù)器防止死循環(huán) // 等待DHT11將總線拉低響應(yīng)信號(hào)開(kāi)始 while(HAL_GPIO_ReadPin(DHT11_GPIO_PORT, DHT11_GPIO_PIN) GPIO_PIN_SET) { if(--timeout 0) return 1; delay_us(1); } timeout 10000; // 等待DHT11拉低結(jié)束約80us while(HAL_GPIO_ReadPin(DHT11_GPIO_PORT, DHT11_GPIO_PIN) GPIO_PIN_RESET) { if(--timeout 0) return 1; delay_us(1); } timeout 10000; // 等待DHT11拉高結(jié)束約80us while(HAL_GPIO_ReadPin(DHT11_GPIO_PORT, DHT11_GPIO_PIN) GPIO_PIN_SET) { if(--timeout 0) return 1; delay_us(1); } return 0; // 響應(yīng)成功 } /** * brief 從單總線上讀取一個(gè)比特bit * retval 讀取到的比特值0或1 * note DHT11發(fā)送0拉低50us后拉高26-28us * DHT11發(fā)送1拉低50us后拉高70us * 通過(guò)判斷高電平持續(xù)時(shí)間來(lái)區(qū)分0和1。 */ static uint8_t DHT11_Read_Bit(void) { uint32_t timeout 10000; uint8_t bitval 0; // 等待低電平開(kāi)始每個(gè)比特都以50us低電平開(kāi)始 while(HAL_GPIO_ReadPin(DHT11_GPIO_PORT, DHT11_GPIO_PIN) GPIO_PIN_SET) { if(--timeout 0) return 0xFF; // 錯(cuò)誤 delay_us(1); } delay_us(40); // 跳過(guò)開(kāi)始的50us低電平等待到高電平階段 // 檢測(cè)高電平持續(xù)時(shí)間 if(HAL_GPIO_ReadPin(DHT11_GPIO_PORT, DHT11_GPIO_PIN) GPIO_PIN_SET) { // 如果是高電平延時(shí)30us后再檢測(cè) delay_us(30); // 如果30us后還是高電平說(shuō)明高電平持續(xù)時(shí)間長(zhǎng)是比特1 if(HAL_GPIO_ReadPin(DHT11_GPIO_PORT, DHT11_GPIO_PIN) GPIO_PIN_SET) bitval 1; else bitval 0; // 否則是比特0 } // 等待這個(gè)比特的高電平結(jié)束 while(HAL_GPIO_ReadPin(DHT11_GPIO_PORT, DHT11_GPIO_PIN) GPIO_PIN_SET) { delay_us(1); } return bitval; } /** * brief 從單總線上讀取一個(gè)字節(jié)byte * retval 讀取到的字節(jié)數(shù)據(jù) */ static uint8_t DHT11_Read_Byte(void) { uint8_t i, data 0; for(i0; i8; i) { data 1; // 左移一位為新的比特騰出位置 data | DHT11_Read_Bit(); // 讀取比特并拼接到data上 } return data; } /** * brief 讀取DHT11的溫濕度數(shù)據(jù)主函數(shù) * param temperature: 指向存儲(chǔ)溫度值的變量整數(shù)部分單位℃ * param humidity: 指向存儲(chǔ)濕度值的變量整數(shù)部分單位%RH * retval 0: 讀取成功 1: 讀取失敗校驗(yàn)和錯(cuò)誤或超時(shí) */ uint8_t DHT11_Read_Data(uint8_t *temperature, uint8_t *humidity) { uint8_t buf[5] {0}; uint8_t i, checksum; DHT11_Start(); if(DHT11_Wait_Response() ! 0) return 1; // 響應(yīng)失敗 // 連續(xù)讀取5個(gè)字節(jié)濕度整數(shù)、濕度小數(shù)、溫度整數(shù)、溫度小數(shù)、校驗(yàn)和 for(i0; i5; i) { buf[i] DHT11_Read_Byte(); } // 切換回輸出模式釋放總線拉高 DHT11_GPIO_SetOutput(); HAL_GPIO_WritePin(DHT11_GPIO_PORT, DHT11_GPIO_PIN, GPIO_PIN_SET); // 計(jì)算校驗(yàn)和前四個(gè)字節(jié)相加的低8位 checksum buf[0] buf[1] buf[2] buf[3]; if(checksum ! buf[4]) return 1; // 校驗(yàn)和錯(cuò)誤 // DHT11小數(shù)部分通常為0我們只取整數(shù)部分 *humidity buf[0]; *temperature buf[2]; return 0; // 讀取成功 }關(guān)鍵點(diǎn)解析與避坑模式切換DHT11_GPIO_SetOutput和DHT11_GPIO_SetInput是關(guān)鍵。必須在發(fā)送開(kāi)始信號(hào)前設(shè)為輸出在等待響應(yīng)和讀取數(shù)據(jù)前設(shè)為輸入。時(shí)序精度delay_us的準(zhǔn)確性直接影響讀取成功率。如果讀取經(jīng)常失敗第一個(gè)要懷疑的就是延時(shí)函數(shù)。超時(shí)處理DHT11_Wait_Response和DHT11_Read_Bit函數(shù)中的while循環(huán)都加入了超時(shí)判斷timeout。這是極其重要的防卡死機(jī)制。沒(méi)有它一旦DHT11損壞或接觸不良程序就會(huì)永遠(yuǎn)卡在等待循環(huán)里。校驗(yàn)和DHT11發(fā)送的第5個(gè)字節(jié)是前4個(gè)字節(jié)的和。每次讀取后必須驗(yàn)證這是判斷數(shù)據(jù)是否被干擾或讀取過(guò)程是否出錯(cuò)的重要依據(jù)。3.4 編寫(xiě)OLEDSSD1306I2C驅(qū)動(dòng)OLED驅(qū)動(dòng)本質(zhì)上就是通過(guò)I2C總線向SSD1306芯片發(fā)送兩類東西命令控制屏幕開(kāi)關(guān)、對(duì)比度、掃描方式等和數(shù)據(jù)要顯示的像素點(diǎn)陣信息。SSD1306的I2C地址通常是0x78寫(xiě)地址或0x7A讀地址很少用。發(fā)送一幀數(shù)據(jù)的格式是[I2C地址字節(jié)] [控制字節(jié)] [數(shù)據(jù)字節(jié)1] [數(shù)據(jù)字節(jié)2] ...。其中控制字節(jié)決定了后續(xù)字節(jié)是命令還是數(shù)據(jù)。// oled.h #ifndef __OLED_H #define __OLED_H #include main.h #include i2c.h // 使用HAL I2C函數(shù) #define OLED_I2C_ADDR 0x78 // SSD1306的I2C寫(xiě)地址 #define OLED_WIDTH 128 #define OLED_HEIGHT 64 // 函數(shù)聲明 void OLED_Init(void); void OLED_Clear(void); void OLED_ShowChar(uint8_t x, uint8_t y, char chr, uint8_t size); void OLED_ShowString(uint8_t x, uint8_t y, char *str, uint8_t size); void OLED_ShowNum(uint8_t x, uint8_t y, uint32_t num, uint8_t len, uint8_t size); void OLED_Refresh(void); // 刷新整個(gè)顯存到屏幕 #endif// oled.c #include oled.h #include font.h // 需要包含字庫(kù)數(shù)組例如ASCII字符的8x16點(diǎn)陣 // OLED顯存共128*64/8 1024字節(jié)。每一位代表一個(gè)像素點(diǎn)1亮0滅。 static uint8_t OLED_GRAM[128][8]; // 二維數(shù)組方便按頁(yè)8像素高為一頁(yè)操作 /** * brief 通過(guò)I2C向OLED發(fā)送一個(gè)命令 * param cmd: 要發(fā)送的命令字節(jié) */ static void OLED_Write_Cmd(uint8_t cmd) { uint8_t buf[2] {0x00, cmd}; // 控制字節(jié)0x00表示后續(xù)是命令 HAL_I2C_Master_Transmit(hi2c1, OLED_I2C_ADDR, buf, 2, 100); } /** * brief 通過(guò)I2C向OLED發(fā)送數(shù)據(jù) * param data: 要發(fā)送的數(shù)據(jù)字節(jié)數(shù)組 * param len: 數(shù)據(jù)長(zhǎng)度 */ static void OLED_Write_Data(uint8_t *data, uint16_t len) { // 方法先發(fā)送一個(gè)控制字節(jié)0x40然后連續(xù)發(fā)送數(shù)據(jù) HAL_I2C_Mem_Write(hi2c1, OLED_I2C_ADDR, 0x40, I2C_MEMADD_SIZE_8BIT, data, len, 100); } /** * brief OLED初始化序列 * 按照SSD1306數(shù)據(jù)手冊(cè)的推薦初始化流程設(shè)置顯示開(kāi)關(guān)、對(duì)比度、掃描方向等。 */ void OLED_Init(void) { HAL_Delay(100); // 上電后等待OLED穩(wěn)定 OLED_Write_Cmd(0xAE); // 關(guān)閉顯示 OLED_Write_Cmd(0xD5); // 設(shè)置顯示時(shí)鐘分頻比/振蕩器頻率 OLED_Write_Cmd(0x80); OLED_Write_Cmd(0xA8); // 設(shè)置多路復(fù)用率 (64-1) OLED_Write_Cmd(0x3F); OLED_Write_Cmd(0xD3); // 設(shè)置顯示偏移 OLED_Write_Cmd(0x00); OLED_Write_Cmd(0x40); // 設(shè)置顯示起始行 OLED_Write_Cmd(0x8D); // 電荷泵設(shè)置 OLED_Write_Cmd(0x14); // 開(kāi)啟電荷泵 OLED_Write_Cmd(0x20); // 設(shè)置內(nèi)存地址模式 OLED_Write_Cmd(0x00); // 水平地址模式 OLED_Write_Cmd(0xA1); // 段重映射設(shè)置 (0xA1左右反置0xA0正常) OLED_Write_Cmd(0xC8); // 掃描方向設(shè)置 (0xC8上下反置0xC0正常) OLED_Write_Cmd(0xDA); // 設(shè)置COM引腳硬件配置 OLED_Write_Cmd(0x12); OLED_Write_Cmd(0x81); // 設(shè)置對(duì)比度控制 OLED_Write_Cmd(0xCF); OLED_Write_Cmd(0xD9); // 設(shè)置預(yù)充電周期 OLED_Write_Cmd(0xF1); OLED_Write_Cmd(0xDB); // 設(shè)置VCOMH電壓倍率 OLED_Write_Cmd(0x40); OLED_Write_Cmd(0xA4); // 設(shè)置整個(gè)顯示開(kāi)啟/關(guān)閉 OLED_Write_Cmd(0xA6); // 設(shè)置正常/反色顯示 (A6正常A7反色) OLED_Write_Cmd(0xAF); // 開(kāi)啟顯示 OLED_Clear(); // 清屏 OLED_Refresh(); // 將清空后的顯存刷新到屏幕 } /** * brief 清空OLED顯存將所有像素點(diǎn)置0 */ void OLED_Clear(void) { uint8_t i, j; for(i0; i128; i) for(j0; j8; j) OLED_GRAM[i][j] 0x00; } /** * brief 設(shè)置光標(biāo)位置像素級(jí) * param x: 列坐標(biāo)范圍0~127 * param y: 頁(yè)坐標(biāo)每頁(yè)8行范圍0~7 */ static void OLED_Set_Pos(uint8_t x, uint8_t y) { OLED_Write_Cmd(0xB0 y); // 設(shè)置頁(yè)地址 OLED_Write_Cmd(((x 0xF0) 4) | 0x10); // 設(shè)置列地址高4位 OLED_Write_Cmd(x 0x0F); // 設(shè)置列地址低4位 } /** * brief 將顯存OLED_GRAM的內(nèi)容全部刷新到OLED屏幕 */ void OLED_Refresh(void) { uint8_t i, j; for(j0; j8; j) // 遍歷8頁(yè) { OLED_Set_Pos(0, j); // 設(shè)置到第j頁(yè)第0列 OLED_Write_Data(OLED_GRAM[0] j * 128, 128); // 發(fā)送該頁(yè)的128字節(jié)數(shù)據(jù) } } /** * brief 在指定位置顯示一個(gè)ASCII字符 * param x: 起始列 (0~127) * param y: 起始頁(yè) (0~7每頁(yè)8行) * param chr: 要顯示的字符 * param size: 字體大小 (1: 8x16, 2: 16x32需要對(duì)應(yīng)字庫(kù)) */ void OLED_ShowChar(uint8_t x, uint8_t y, char chr, uint8_t size) { uint8_t i, j, temp; uint8_t *pfont; // 指向字庫(kù)數(shù)據(jù)的指針 // 根據(jù)字符和字體大小從字庫(kù)數(shù)組中獲取點(diǎn)陣數(shù)據(jù)首地址 // 假設(shè)字庫(kù)數(shù)組名為 Font8x16每個(gè)字符16字節(jié) if(size 1) { pfont (uint8_t*)Font8x16[(chr - ) * 16]; // ASCII字庫(kù)從空格開(kāi)始 for(i0; i16; i) // 字符高度16像素 { temp pfont[i]; for(j0; j8; j) // 字符寬度8像素 { if(temp 0x80) // 判斷最高位是否為1 OLED_GRAM[x j][y i/8] | (1 (i%8)); // 置1點(diǎn)亮像素 else OLED_GRAM[x j][y i/8] ~(1 (i%8)); // 置0熄滅像素 temp 1; } } } // 可以擴(kuò)展其他字體大小... } /** * brief 在指定位置顯示字符串 */ void OLED_ShowString(uint8_t x, uint8_t y, char *str, uint8_t size) { while(*str ! \0) { OLED_ShowChar(x, y, *str, size); x 8; // 8x16字體每個(gè)字符占8列 str; if(x 120) // 換行判斷 { x 0; y; } } } /** * brief 在指定位置顯示數(shù)字 */ void OLED_ShowNum(uint8_t x, uint8_t y, uint32_t num, uint8_t len, uint8_t size) { char str[12]; sprintf(str, %*lu, len, num); // 格式化數(shù)字為固定長(zhǎng)度字符串 OLED_ShowString(x, y, str, size); }驅(qū)動(dòng)層核心邏輯顯存GRAM我們?cè)赟TM32的內(nèi)存中開(kāi)辟一個(gè)二維數(shù)組OLED_GRAM[128][8]用來(lái)模擬OLED屏幕的顯存。這個(gè)數(shù)組的每一個(gè)bit對(duì)應(yīng)屏幕上的一個(gè)像素點(diǎn)。我們所有畫(huà)點(diǎn)、畫(huà)線、顯示字符的操作都是先修改這個(gè)數(shù)組。局部刷新 vs 全局刷新OLED_ShowChar等函數(shù)只修改OLED_GRAM并不立即發(fā)送給OLED。只有調(diào)用OLED_Refresh()時(shí)才會(huì)將整個(gè)OLED_GRAM通過(guò)I2C發(fā)送到屏幕。這種方式避免了頻繁的I2C通信提高了效率。在溫濕度顯示中我們可以每秒調(diào)用一次OLED_Refresh來(lái)更新數(shù)據(jù)。字庫(kù)你需要一個(gè)font.h文件里面包含字模數(shù)組。例如Font8x16[]它是一個(gè)二維數(shù)組存儲(chǔ)了從空格開(kāi)始的所有ASCII字符的8x16點(diǎn)陣數(shù)據(jù)。你可以用PCtoLCD2002等取模軟件生成。4. 應(yīng)用層邏輯整合與主程序?qū)崿F(xiàn)驅(qū)動(dòng)層完成后應(yīng)用層邏輯就變得非常清晰了。我們只需要在主循環(huán)中定期讀取傳感器數(shù)據(jù)然后格式化并顯示到OLED上。4.1 主程序流程圖與邏輯初始化系統(tǒng)時(shí)鐘、GPIO、I2C、OLED、DHT11GPIO。清屏并顯示初始界面例如顯示“Temp:”和“Humi:”的標(biāo)簽。進(jìn)入主循環(huán)延時(shí)為了避免頻繁讀取導(dǎo)致DHT11發(fā)熱或響應(yīng)不及時(shí)每次讀取間隔至少2秒。使用HAL_Delay(2000)。讀取數(shù)據(jù)調(diào)用DHT11_Read_Data(temp, humi)。錯(cuò)誤處理如果返回值為1失敗可以在OLED上顯示“Error”或保留上一次數(shù)據(jù)。更新顯示將讀取到的temp和humi整數(shù)轉(zhuǎn)換成字符串調(diào)用OLED_ShowNum或OLED_ShowString函數(shù)在指定位置刷新數(shù)值。刷新屏幕調(diào)用OLED_Refresh()將更新后的顯存發(fā)送到OLED。4.2 主函數(shù)代碼示例// main.c #include main.h #include i2c.h #include gpio.h #include dht11.h #include oled.h I2C_HandleTypeDef hi2c1; int main(void) { uint8_t temperature 0; uint8_t humidity 0; uint8_t dht11_status 0; char disp_str[20]; HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_I2C1_Init(); // 初始化外設(shè) OLED_Init(); DHT11_GPIO_Init(); // 初始化DHT11的GPIO設(shè)置為輸出模式并拉高 // 顯示靜態(tài)標(biāo)題 OLED_Clear(); OLED_ShowString(0, 0, STM32 DHT11 Demo, 1); OLED_ShowString(0, 2, Temp:, 1); // 第2頁(yè)行16-31像素顯示 OLED_ShowString(0, 4, Humi:, 1); // 第4頁(yè)行32-47像素顯示 OLED_Refresh(); while (1) { HAL_Delay(2000); // 每2秒讀取一次 dht11_status DHT11_Read_Data(temperature, humidity); if(dht11_status 0) { // 讀取成功更新溫度顯示 sprintf(disp_str, %d C, temperature); OLED_ShowString(40, 2, disp_str, 1); // 在“Temp:”后面顯示 // 更新濕度顯示 sprintf(disp_str, %d %%, humidity); // %% 表示一個(gè)%字符 OLED_ShowString(40, 4, disp_str, 1); // 在屏幕底部顯示狀態(tài) OLED_ShowString(0, 6, Status: OK , 1); } else { // 讀取失敗 OLED_ShowString(0, 6, Status: ERROR, 1); // 可以選擇不清除之前的溫濕度數(shù)據(jù) } // 刷新整個(gè)屏幕將GRAM數(shù)據(jù)發(fā)送到OLED OLED_Refresh(); } }4.3 顯示效果優(yōu)化與擴(kuò)展基礎(chǔ)的數(shù)值顯示可能有些單調(diào)我們可以進(jìn)行一些優(yōu)化添加小數(shù)顯示DHT11雖然小數(shù)位通常是0但我們可以預(yù)留位置?；蛘呤褂肈HT22AM2302傳感器它直接輸出帶一位小數(shù)的數(shù)據(jù)。繪制圖標(biāo)在“Temp:”和“Humi:”文字前可以繪制一個(gè)溫度計(jì)和小水滴的圖標(biāo)增加美觀度。這需要你事先制作好圖標(biāo)的點(diǎn)陣數(shù)組取模。顯示歷史曲線利用OLED的128x64像素可以繪制一個(gè)簡(jiǎn)單的溫濕度歷史曲線圖。在GRAM中開(kāi)辟一個(gè)區(qū)域作為曲線繪制區(qū)每次讀取新數(shù)據(jù)后將舊數(shù)據(jù)點(diǎn)向左移動(dòng)并在最右側(cè)繪制新的數(shù)據(jù)點(diǎn)。添加單位如上述代碼所示顯示“C”和“%”符號(hào)。低功耗優(yōu)化如果不要求實(shí)時(shí)顯示可以讓STM32進(jìn)入休眠模式Stop Mode定時(shí)喚醒讀取傳感器并刷新屏幕可以極大降低功耗。5. 調(diào)試技巧與常見(jiàn)問(wèn)題排查實(shí)錄即使按照步驟操作第一次成功也往往伴隨著一些調(diào)試過(guò)程。以下是幾個(gè)最常見(jiàn)的“坑”和解決方法。5.1 DHT11讀取始終失敗這是最常見(jiàn)的問(wèn)題癥狀是DHT11_Read_Data總是返回1超時(shí)或校驗(yàn)和錯(cuò)誤。檢查1電源和接線電壓確保DHT11和OLED的VCC接的是3.3V不是5V。上拉電阻DHT11的數(shù)據(jù)線DQ必須接一個(gè)4.7kΩ - 10kΩ的上拉電阻到3.3V。STM32的內(nèi)部上拉電阻約40kΩ可能強(qiáng)度不夠?qū)е赂唠娖讲环€(wěn)定。共地確保STM32、DHT11、OLED三者的GND引腳連接在一起。檢查2延時(shí)函數(shù)精度這是頭號(hào)嫌疑犯。用邏輯分析儀或示波器檢查DHT11_Start()函數(shù)中產(chǎn)生的開(kāi)始信號(hào)低電平18ms高電平30us是否準(zhǔn)確。如果沒(méi)有儀器可以嘗試調(diào)整delay_us函數(shù)中的系數(shù)。將us * 8改為us * 6或us * 10試試。不同主頻和優(yōu)化等級(jí)下這個(gè)系數(shù)差異很大。嘗試關(guān)閉編譯器的優(yōu)化在Keil中設(shè)置為-O0看看是否能成功。如果關(guān)閉優(yōu)化后成功說(shuō)明就是延時(shí)精度問(wèn)題。檢查3GPIO模式切換時(shí)序在DHT11_Start()函數(shù)末尾切換到輸入模式后是否立即進(jìn)入了等待響應(yīng)的循環(huán)中間不應(yīng)有大的延時(shí)。確保在讀取完數(shù)據(jù)后將GPIO設(shè)置回輸出模式并拉高釋放總線。檢查4傳感器本身DHT11是3.3V器件但有些模塊兼容5V。如果接5V數(shù)據(jù)線輸出高電平可能是5V長(zhǎng)時(shí)間可能損壞STM32的3.3V GPIO。建議始終在3.3V下工作。換個(gè)新的DHT11試試。5.2 OLED屏幕不亮或顯示亂碼檢查1電源和I2C地址電源再次確認(rèn)VCC接3.3V。I2C地址嘗試將OLED_I2C_ADDR從0x78改為0x7A。有些模塊的地址可能是0x7A。上拉電阻如果屏幕完全無(wú)反應(yīng)檢查SCL和SDA線上是否有上拉電阻4.7kΩ到3.3V。如果沒(méi)有請(qǐng)加上。檢查2初始化序列OLED初始化命令序列很長(zhǎng)且順序有要求。確保OLED_Init()函數(shù)中的命令一個(gè)不少且0xAE關(guān)顯示在開(kāi)頭0xAF開(kāi)顯示在最后。初始化后務(wù)必調(diào)用OLED_Clear()和OLED_Refresh()。檢查3I2C通信在OLED_Write_Cmd和OLED_Write_Data函數(shù)中檢查HAL_I2C_Master_Transmit的返回值。如果不是HAL_OK說(shuō)明I2C通信失敗。用邏輯分析儀連接SCL和SDA看初始化階段是否有波形產(chǎn)生。如果沒(méi)有檢查CubeMX中I2C的配置是否正確引腳是否被其他功能占用。檢查4顯存與刷新顯示亂碼通常是GRAM數(shù)據(jù)錯(cuò)誤或刷新位置不對(duì)。確保OLED_GRAM數(shù)組大小正確定義為[128][8]。在OLED_Refresh()函數(shù)中OLED_Set_Pos(0, j)和OLED_Write_Data(OLED_GRAM[0] j * 128, 128)這兩行是關(guān)鍵它確保了將GRAM中每一頁(yè)的128字節(jié)數(shù)據(jù)發(fā)送到屏幕對(duì)應(yīng)的頁(yè)地址。5.3 顯示內(nèi)容錯(cuò)位或重疊坐標(biāo)計(jì)算OLED的坐標(biāo)體系是以“頁(yè)”為單位。一頁(yè)是8行像素。OLED_ShowChar(x, y, chr, size)中的y是頁(yè)坐標(biāo)0~7x是列坐標(biāo)0~127。字庫(kù)匹配你使用的Font8x16字庫(kù)必須是8像素寬、16像素高的。如果你顯示函數(shù)里按8x16處理但字庫(kù)數(shù)據(jù)是6x8的肯定會(huì)亂。刷新前未清除舊內(nèi)容如果你在同一個(gè)位置顯示變化的數(shù)字如從“25”變成“26”新數(shù)字“26”只有2個(gè)字符如果上次的“25”也是2個(gè)字符那沒(méi)問(wèn)題。但如果從“9”變成“10”新內(nèi)容“10”會(huì)覆蓋掉“9”和它后面一個(gè)字符的位置。如果后面那個(gè)位置原本有內(nèi)容比如單位“C”就會(huì)被覆蓋。解決方法有兩種1) 在顯示新數(shù)字前先用空格覆蓋舊數(shù)字的整個(gè)區(qū)域2) 每次更新都重繪整個(gè)顯示區(qū)域清屏再畫(huà)雖然效率低但簡(jiǎn)單可靠。5.4 項(xiàng)目穩(wěn)定性與抗干擾建議增加軟件濾波對(duì)于溫濕度數(shù)據(jù)可以連續(xù)讀取3-5次然后取中值或平均值能有效濾除偶然的跳動(dòng)。完善錯(cuò)誤處理主循環(huán)中如果DHT11連續(xù)多次讀取失敗可以嘗試重新初始化其GPIO或者讓系統(tǒng)軟復(fù)位。使用看門狗啟用STM32的獨(dú)立看門狗IWDG防止程序跑飛。在主循環(huán)中定期“喂狗”。如果因DHT11時(shí)序卡死等原因?qū)е鲁绦蛩姥h(huán)看門狗會(huì)復(fù)位系統(tǒng)。電源去耦在STM32的3.3V和GND之間靠近芯片引腳處并聯(lián)一個(gè)100nF和一個(gè)10uF的電容可以有效濾除電源噪聲提高系統(tǒng)穩(wěn)定性。通過(guò)以上步驟你應(yīng)該能夠成功搭建并運(yùn)行這個(gè)STM32溫濕度監(jiān)測(cè)顯示系統(tǒng)。這個(gè)項(xiàng)目雖然小但“麻雀雖小五臟俱全”它涵蓋的硬件接口、通信協(xié)議、驅(qū)動(dòng)編寫(xiě)和系統(tǒng)整合思想是嵌入式開(kāi)發(fā)中最核心的部分。掌握了它你就為后續(xù)學(xué)習(xí)更復(fù)雜的傳感器、顯示屏、無(wú)線通信等打下了堅(jiān)實(shí)的基礎(chǔ)。本文還有配套的精品資源點(diǎn)擊獲取