简介本资源是一套基于STM32F10x系列微控制器的嵌入式综合实践项目面向嵌入式初学者与课程设计者解决温湿度数据采集与本地可视化显示的核心需求。项目完整实现DHT11/DHT22传感器数据读取、STM32 GPIO与ADC外设配置、7脚SH1106 OLEDI²C/SPI接口驱动及实时数据显示功能覆盖硬件连接、协议解析、屏幕刷新等典型开发环节。压缩包共141个文件含37个头文件.h、34个源码文件.c、17个编译中间文件.d/.o/.crf及Keil工程配置文件.uvprojx/.uvoptx、调试配置.dbgconf、固件库STM32F10x_FWLib和自动化脚本keilkilll.bat总大小3.31MB。已有3195人学习下载提供结构清晰的模块化目录HARDWARE/CORE/SYSTEM/USER等配套README说明与完整可编译工程开箱即用便于理解外设协同逻辑、掌握Keil uVision5开发全流程并快速复现调试。1. 项目概述一个经典的嵌入式入门实战如果你刚开始接触STM32想找一个能串联起GPIO、I2C、传感器和显示的综合项目那“STM32驱动温湿度传感器并在OLED上显示”几乎是教科书式的选择。我当年入门时做的第一个完整项目就是这个它麻雀虽小五脏俱全能让你快速建立起对嵌入式系统数据采集、处理和显示的直观认识。这个项目的核心目标很明确让一块STM32微控制器读取DHT11这类温湿度传感器的数据然后通过I2C或SPI协议将实时数据刷新到一块0.96英寸的7脚OLED屏幕上。别看它简单里面涉及的技术点非常典型GPIO的输入输出配置、单总线或I2C的通信时序、OLED的驱动与字库显示、主循环的任务调度。完成这个项目你不仅能点亮屏幕、读到数据更重要的是能理解嵌入式开发中“初始化-采集-处理-显示”这一基本工作流。无论是后续做智能家居的温湿度监控节点还是作为更复杂环境监测系统的一部分这都是一个坚实可靠的起点。接下来我会基于最常见的硬件组合STM32F103C8T6核心板、DHT11、SSD1306驱动的0.96寸OLED来拆解整个过程并分享那些教程里通常不会细说的实操细节和避坑经验。2. 硬件选型与电路连接解析2.1 核心控制器STM32F103C8T6为何是首选在众多STM32型号中F103C8T6俗称“蓝桥杯”或“最小系统板”能成为入门神器的原因有几个。首先是资源足够72MHz主频、64KB Flash、20KB RAM驱动传感器和OLED绰绰有余。其次是生态完善无论是标准库、HAL库还是LL库资料和例程都极其丰富社区里你遇到的几乎所有问题都能找到答案。最后是成本与易用性核心板价格低廉引脚全部引出方便用杜邦线连接非常适合学习和原型验证。注意虽然F103系列已不是最新但其庞大的用户基础和成熟度对于初学者而言意味着更低的入门门槛和更少的“玄学”问题。当你熟悉了它的开发流程后再迁移到其他系列如F4、H7或使用CubeMX配置会顺畅得多。2.2 传感器DHT11的优缺点与通信要点DHT11是一款经典的温湿度复合传感器采用单总线通信。它的优点是接口简单仅需一个GPIO口、成本极低、有现成的库。但缺点也很明显精度一般湿度±5%RH温度±2℃、响应速度慢每次读取间隔不得小于2秒。它的通信时序是学习的重点。单总线协议要求MCU先拉低总线至少18ms作为起始信号然后释放并等待传感器响应。传感器会拉低80us作为应答然后拉高80us随后开始输出40位数据16位湿度整数16位湿度小数16位温度整数16位温度小数8位校验和。每一位数据都以50us的低电平开始高电平的持续时间决定数据是026-28us还是170us。在代码实现时必须严格遵循此时序并且关中断或使用高精度延时来确保时序准确。// 示例读取DHT11一位数据的代码片段需根据实际时钟配置调整延时 uint8_t DHT11_Read_Bit(void) { while(DHT11_IO_IN() 0); // 等待50us低电平结束 Delay_us(40); // 延时40us后采样 if(DHT11_IO_IN() 1) { while(DHT11_IO_IN() 1); // 等待高电平结束 return 1; } else { return 0; } }2.3 显示模块7脚0.96寸OLEDSSD1306详解市面上最常见的0.96寸OLED模块其驱动芯片多为SSD1306支持I2C或SPI通信。7脚模块通常指I2C接口VCC, GND, SCL, SDA, RES, DC, CS其中CS脚在I2C模式下可以接高电平或悬空。I2C接口只需要两根线SCL, SDA节省IO口是初学者的首选。SSD1306本身不带字库所有显示内容包括字符、汉字、图片都需要以点阵数据的形式发送。这意味着你需要自己准备字模。通常我们会使用PCtoLCD2002这类取模软件生成对应字体和大小的字模数组存储在MCU的Flash中。显示一个字符本质上是向OLED的GDDRAM图形显示数据RAM的特定位置写入一组点阵数据。2.4 电路连接图与供电注意事项连接非常简单电源将STM32的3.3V和GND分别连接到DHT11和OLED的VCC和GND。务必确保是3.3VDHT11和多数OLED模块虽然标称支持3.3V-5V但为了与STM32的IO电平匹配避免损坏统一使用3.3V供电最安全。DHT11数据线通常为中间引脚接STM32的任一GPIO口例如PA0。上拉电阻4.7K-10K模块内部通常已集成无需外接。OLEDSCL接STM32的PB6I2C1_SCL或PB10I2C2_SCL。SDA接STM32的PB7I2C1_SDA或PB11I2C2_SDA。RES复位接一个GPIO如PB0用于硬件复位。DC数据/命令在I2C模式下固定为低电平接地或根据驱动库要求连接。CS片选在I2C模式下接高电平VCC或悬空。实操心得焊接或使用杜邦线时务必先断开电源。上电后如果OLED不亮首先检查电源和GND是否接反或接触不良。如果白屏可能是I2C地址不对通常为0x78或0x7A或初始化序列有误。3. 软件开发环境搭建与工程配置3.1 开发工具链选择Keil、VS Code还是其他对于STM32F1系列Keil MDKARMCC编译器依然是很多教程和比赛的首选因为它与STM32的兼容性最好调试工具ST-Link, J-Link支持完善。如果你习惯Keil可以直接使用。但我个人更推荐使用VS Code ARM GCC OpenOCD的组合。理由如下首先完全免费没有代码大小限制。其次VS Code的编辑体验、代码提示和插件生态远胜于Keil。最后这套工具链更贴近现代开发流程便于使用Git进行版本管理。配置过程虽然稍显复杂但一劳永逸。配置核心步骤安装VS Code。安装“C/C”和“Cortex-Debug”插件。下载并安装ARM GNU Toolchaingcc-arm-none-eabi。下载并安装OpenOCD用于调试和下载。使用STM32CubeMX生成基于Makefile的工程代码指定Toolchain为“Makefile”。在VS Code中配置c_cpp_properties.json包含头文件路径、tasks.json构建任务和launch.json调试配置。3.2 使用STM32CubeMX进行图形化引脚与时钟配置CubeMX是ST官方的神器能极大降低初始化工作的复杂度。新建工程选择MCU型号STM32F103C8Tx。时钟配置RCC在“Pinout Configuration”标签页找到“RCC”。将“High Speed Clock (HSE)”设置为“Crystal/Ceramic Resonator”。这样我们就能使用外部8MHz晶振通过PLL倍频到72MHz系统时钟。配置I2C在左侧“Connectivity”中选择I2C1。将PB6和PB7的复用功能自动配置为I2C1_SCL和I2C1_SDA。在右侧的“Parameter Settings”中I2C模式保持“I2C”时钟速度可以设为“Standard Mode (100kHz)”这个速度对OLED足够稳定。配置DHT11的GPIO在左侧“System Core”中选择GPIO。点击PA0将其设置为“GPIO_Output”初始化为高电平。实际上DHT11的数据线需要双向操作但在CubeMX中我们通常先设为输出在代码中再动态切换输入输出模式。配置OLED的RESET引脚找一个空闲的GPIO如PB0设置为“GPIO_Output”。生成代码在“Project Manager”标签页设置项目名称、路径选择“Toolchain / IDE”为“Makefile”。然后点击“GENERATE CODE”。3.3 关键驱动库的移植与适配CubeMX生成的代码包含了HAL库和基本的GPIO、I2C初始化代码。我们还需要手动添加OLED和DHT11的驱动文件。OLED驱动SSD1306网上有大量开源驱动如“中景园电子”的例程。你需要将oled.c和oled.h、font.h字库文件复制到你的工程Src和Inc文件夹。在oled.c中需要根据你的连接修改I2C端口和地址并实现基于HAL库的I2C_WriteByte函数。// 在oled.c中的修改示例 #define OLED_I2C_PORT hi2c1 // 与CubeMX配置的I2C句柄一致 #define OLED_ADDRESS 0x78 // I2C器件地址左移一位后为0x78 void I2C_WriteByte(uint8_t addr, uint8_t data) { HAL_I2C_Master_Transmit(OLED_I2C_PORT, OLED_ADDRESS, data, 1, 100); }DHT11驱动同样需要dht11.c和dht11.h。核心是实现精确的微秒级延时函数Delay_us并编写严格遵循时序的读取函数。注意HAL库的HAL_Delay()是毫秒级不适用于此。你需要用系统滴答定时器SysTick或通用定时器TIM来实现微秒延时。// 一种基于SysTick的微秒延时实现系统时钟72MHz时 void Delay_us(uint32_t nus) { uint32_t ticks; uint32_t told, tnow, tcnt 0; uint32_t reload SysTick-LOAD; ticks nus * (SystemCoreClock / 1000000); // 计算需要的节拍数 told SysTick-VAL; // 刚进入时的计数器值 while(1) { tnow SysTick-VAL; if(tnow ! told) { if(tnow told) tcnt told - tnow; else tcnt reload - tnow told; told tnow; if(tcnt ticks) break; // 时间超过/等于要延迟的时间,则退出. } } }4. 核心代码实现与逻辑剖析4.1 主程序框架与任务调度设计对于这样一个简单的系统我们通常采用**超级循环Super Loop**架构。在主while(1)循环中以固定的时间间隔如2秒执行数据采集和显示更新。为了避免HAL_Delay导致的CPU空转阻塞更优雅的做法是使用状态机或者基于系统滴答定时器的非阻塞延时。int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_I2C1_Init(); OLED_Init(); // OLED初始化 DHT11_Init(); // DHT11初始化主要是GPIO模式设置 OLED_Clear(); // 清屏 OLED_ShowString(0, 0, Temp:, 16); // 第0行第0列开始显示“Temp:”16号字体 OLED_ShowString(0, 2, Humi:, 16); // 第2行 uint32_t last_read_time 0; const uint32_t read_interval 2000; // 读取间隔2000ms while (1) { uint32_t current_time HAL_GetTick(); // 获取系统运行毫秒数 // 非阻塞延时每2秒读取一次 if(current_time - last_read_time read_interval) { last_read_time current_time; if(DHT11_Read_Data(temperature, humidity) DHT11_OK) { // 读取成功更新显示缓冲区 char temp_str[10], humi_str[10]; sprintf(temp_str, %d.%d C, temperature/10, temperature%10); sprintf(humi_str, %d.%d %%, humidity/10, humidity%10); OLED_ShowString(40, 0, temp_str, 16); // 在“Temp:”后面显示数值 OLED_ShowString(40, 2, humi_str, 16); OLED_Refresh(); // 将缓冲区内容刷新到OLED屏幕 } else { // 读取失败显示错误信息 OLED_ShowString(40, 0, Err , 16); OLED_ShowString(40, 2, Err , 16); OLED_Refresh(); } } // 此处可以添加其他低优先级任务 } }4.2 DHT11数据读取的稳健性实现DHT11的通信对时序极其敏感。一个健壮的读取函数必须包含超时判断和校验和验证。uint8_t DHT11_Read_Data(int16_t *temp, int16_t *humi) { uint8_t buf[5] {0}; uint8_t i, j; // 1. 主机拉低至少18ms DHT11_IO_OUT(); DHT11_DQ_OUT(0); HAL_Delay(20); // 拉低20ms DHT11_DQ_OUT(1); Delay_us(30); // 主机拉高20-40us // 2. 切换为输入模式等待传感器响应 DHT11_IO_IN(); // 等待传感器拉低80us (超时判断) if(DHT11_Wait_For(0, 100) ERROR) return ERROR; // 等待传感器拉高80us if(DHT11_Wait_For(1, 100) ERROR) return ERROR; // 3. 读取40位数据 for(i0; i5; i) { for(j0; j8; j) { // 等待50us低电平结束 if(DHT11_Wait_For(0, 100) ERROR) return ERROR; Delay_us(40); // 延时40us后采样高电平 buf[i] 1; if(DHT11_Read_Pin() 1) { buf[i] | 1; // 等待高电平结束 if(DHT11_Wait_For(1, 100) ERROR) return ERROR; } } } // 4. 校验和验证 if(buf[0] buf[1] buf[2] buf[3] buf[4]) { *humi (buf[0]8) | buf[1]; // 湿度整数部分小数部分 *temp (buf[2]8) | buf[3]; // 温度整数部分小数部分 return SUCCESS; } return ERROR; }4.3 OLED显示驱动的优化技巧直接刷屏全屏数据效率低且可能导致闪烁。通用的优化方法是使用显示缓冲区Frame Buffer。开辟缓冲区在内存中定义一个数组uint8_t OLED_GRAM[128][8]对于128x64分辨率的屏幕每页8行共8页。这个数组对应屏幕上的每一个像素点。所有绘图操作在缓冲区进行OLED_DrawPoint,OLED_ShowChar,OLED_ShowString等函数只修改OLED_GRAM数组中的相应位。局部刷新当需要更新屏幕时比较新旧缓冲区或者标记脏矩形区域只将变化的部分通过I2C发送到OLED。对于本项目的温湿度显示我们可以只刷新显示数字的区域而不是整个屏幕。定时刷新在主循环中以固定的频率如10Hz调用OLED_Refresh()函数将缓冲区的全部或局部内容更新到屏幕。这比每次数据变化都刷新更平滑。此外字库的选择也影响显示效果和Flash占用。如果只显示英文和数字一个8x16的ASCII字库只需要不到1KB空间。如果需要显示中文则需要根据常用汉字范围提取字模这会占用大量空间需要权衡。5. 系统调试与性能优化实战5.1 硬件调试示波器与逻辑分析仪的使用当程序下载后屏幕不显示或数据读取一直失败时光靠代码排查可能效率低下。这时硬件调试工具就至关重要。万用表首先检查所有电源引脚是否为稳定的3.3VGND是否连通。示波器这是分析DHT11时序的终极武器。将探头接到DHT11的数据引脚触发模式设为单次下降沿触发。然后让MCU发起一次读取。你可以清晰地看到起始信号、应答信号以及后续40位数据的高低电平宽度。通过测量高电平的持续时间可以准确判断MCU读取的数据是0还是1从而验证你的延时函数是否精确。逻辑分析仪如Saleae对于I2C通信调试更方便。连接SCL和SDA设置好协议解码器I2C可以直观地看到I2C的起始信号、地址、读写位、数据字节和ACK/NACK快速定位是地址错误、数据错误还是应答失败。5.2 软件调试printf重定向与调试信息输出在代码关键位置添加调试信息是快速定位问题的好方法。将printf函数重定向到串口USART就可以在PC端的串口助手如Putty、XCOM上看到打印信息。// 重定向printf到串口以USART1为例 #include stdio.h int _write(int file, char *ptr, int len) { HAL_UART_Transmit(huart1, (uint8_t*)ptr, len, 1000); return len; } // 在main函数初始化后可以这样打印 printf(System Start Up!\r\n); printf(DHT11 Read Result: %d, Temp:%d, Humi:%d\r\n, ret, temperature, humidity);5.3 低功耗设计与稳定性提升虽然本项目对功耗不敏感但了解低功耗设计是有益的。外设管理在不读取DHT11时可以将连接DHT11的GPIO设置为高阻输入或输出低减少功耗。对于OLEDSSD1306芯片本身有睡眠命令可以在不显示时将其进入睡眠模式以省电。MCU低功耗模式在超级循环的while(1)中如果每次循环间隔很长可以让MCU进入睡眠模式Sleep或Stop模式等待中断或定时器唤醒。这需要配置一个基础定时器如RTC或低功耗定时器来周期性唤醒MCU进行数据采集。电源去耦在STM32的电源引脚附近放置一个0.1uF和一个10uF的电容可以有效滤除高频和低频噪声提高系统稳定性尤其是在使用杜邦线连接的长距离布线时尤为重要。软件看门狗启用独立看门狗IWDG防止程序跑飞。在while(1)循环中定期“喂狗”。如果因为DHT11读取超时等原因导致程序卡死看门狗会复位系统使其自动恢复。6. 项目扩展与进阶思路完成基础功能后这个项目可以作为一个平台进行多方向扩展提升其复杂度和实用性。6.1 功能扩展添加按键与界面交互增加1-2个按键可以实现简单的菜单交互。例如按键1切换显示内容如当前温湿度、历史最高/最低温度、平均湿度等。按键2进入设置模式调整数据刷新频率、温湿度报警阈值等。 这需要你设计一个简单的状态机来管理不同的显示页面和操作模式并学习如何消抖处理按键输入。6.2 通信扩展接入物联网与数据上传让数据“活”起来是嵌入式系统的一大魅力。蓝牙HC-05/06通过串口连接蓝牙模块将温湿度数据发送到手机APP实现无线监测。你需要在手机端开发一个简单的APP可以用App Inventor或Android Studio来接收和显示数据。Wi-FiESP-01S这是一个性价比极高的方案。将ESP-01S作为协处理器通过AT指令与STM32的串口通信。STM32负责采集数据然后通过串口发送给ESP-01S由ESP-01S连接Wi-Fi并将数据上传到云平台如阿里云、OneNET、Blinker或者你自己的服务器。这样你就可以在任何有网络的地方查看数据。NB-IoT对于需要广域覆盖、低功耗的户外环境监测可以接入NB-IoT模块如BC26直接将数据发送到云端。6.3 算法增强数据滤波与简单预测原始的传感器数据可能存在毛刺。可以引入简单的软件算法提升数据质量。滑动平均滤波维护一个固定长度的数据队列每次新数据到来时去掉最旧的数据加入新数据然后计算队列中所有数据的平均值作为输出。这能有效平滑随机波动。#define FILTER_LEN 5 int16_t temp_buffer[FILTER_LEN] {0}; uint8_t buffer_index 0; int16_t Moving_Average_Filter(int16_t new_value) { temp_buffer[buffer_index] new_value; buffer_index (buffer_index 1) % FILTER_LEN; int32_t sum 0; for(int i0; iFILTER_LEN; i) { sum temp_buffer[i]; } return (int16_t)(sum / FILTER_LEN); }一阶滞后滤波低通滤波Y(n) α * X(n) (1-α) * Y(n-1)。其中α是滤波系数0α1X(n)是新采样值Y(n-1)是上次滤波输出。α越小滤波越平滑但响应越慢。这种方法计算量小适合MCU。越限报警设置温度和湿度的合理上下限。当数据连续多次防止误报超过阈值时可以在OLED上显示警告图标或者控制一个LED闪烁、蜂鸣器鸣叫。6.4 工程化考量代码模块化与可移植性当你开始扩展功能时一个清晰的代码结构至关重要。模块化设计将不同功能的代码放在独立的.c/.h文件对中。例如bsp_dht11.c/.h: 硬件抽象层封装所有DHT11操作。bsp_oled.c/.h: 封装OLED驱动和基本绘图函数。bsp_i2c.c/.h: 如果有多处I2C设备可以抽象出统一的I2C读写接口。app_sensor.c/.h: 应用层负责调度数据采集、处理逻辑。app_display.c/.h: 应用层负责管理显示内容和界面。使用硬件抽象层HAL在驱动层如bsp_dht11.c中通过宏定义或函数指针来调用底层的GPIO读写、延时函数。这样当你更换MCU平台比如从STM32换成GD32时只需要修改底层适配函数而上层的应用逻辑代码几乎不用动。配置文件使用一个config.h头文件来集中管理所有硬件相关的宏定义如引脚定义、I2C地址、屏幕尺寸、滤波参数等。修改硬件连接时只需改这一个文件。从读取一个传感器到驱动一块屏幕再到考虑滤波、通信和架构这个简单的温湿度显示项目就像一颗种子能生长出嵌入式开发的许多核心技能树。它教会你的远不止是调用几个库函数而是如何让冰冷的硬件按照你的逻辑思考和工作。本文还有配套的精品资源点击获取