STM32CubeMX与HAL库实战：5分钟构建DHT11温湿度监测系统（OLED显示版）
1. 项目概述与环境搭建
在物联网和智能硬件开发领域，温湿度监测是最基础却最实用的功能之一。使用STM32CubeMX配合HAL库，我们可以快速搭建一个完整的温湿度监测系统。这个项目将使用DHT11传感器采集环境数据，并通过OLED屏幕实时显示，整个过程仅需5分钟配置即可完成核心框架。
硬件准备清单：
- STM32F103C8T6开发板（Blue Pill）
- DHT11温湿度传感器
- 0.96寸OLED显示屏（I2C接口）
- 杜邦线若干
- USB转TTL模块（可选，用于调试）
提示：DHT11采用单总线协议，仅需一个GPIO引脚；OLED通常使用I2C接口，需连接SCL和SDA两条线。
2. STM32CubeMX工程配置
2.1 时钟与系统配置
- 打开STM32CubeMX，新建工程选择对应型号
- 在RCC配置中启用外部高速时钟（HSE）
- 在SYS中配置调试接口为Serial Wire
// 自动生成的时钟配置代码（部分） SystemClock_Config(); HAL_Init();2.2 GPIO与通信接口配置
| 外设 | 配置项 | 参数 |
|---|---|---|
| DHT11 | GPIO模式 | 开漏输出 |
| I2C1 | 速度模式 | 标准模式(100kHz) |
| OLED | I2C地址 | 0x78(默认) |
关键配置步骤：
- 为DHT11选择一个GPIO（如PB5），配置为输出模式
- 启用I2C1外设，保持默认参数
- 生成工程时勾选"Generate peripheral initialization as a pair of .c/.h files"
3. DHT11驱动实现
3.1 单总线协议解析
DHT11的通信时序包含三个关键阶段：
- 主机启动信号（至少18ms低电平）
- 传感器响应信号（80us低电平+80us高电平）
- 数据传输阶段（每个bit以50us低电平开始）
// DHT11读取函数示例 uint8_t DHT11_Read(void) { uint8_t data = 0; DHT11_GPIO_Init(OUTPUT); HAL_GPIO_WritePin(DHT11_GPIO_Port, DHT11_Pin, GPIO_PIN_RESET); HAL_Delay(20); // 保持低电平至少18ms HAL_GPIO_WritePin(DHT11_GPIO_Port, DHT11_Pin, GPIO_PIN_SET); DHT11_GPIO_Init(INPUT); // 等待传感器响应 while(HAL_GPIO_ReadPin(DHT11_GPIO_Port, DHT11_Pin) == GPIO_PIN_SET); while(HAL_GPIO_ReadPin(DHT11_GPIO_Port, DHT11_Pin) == GPIO_PIN_RESET); while(HAL_GPIO_ReadPin(DHT11_GPIO_Port, DHT11_Pin) == GPIO_PIN_SET); // 读取40位数据 for(int i=0; i<8; i++) { while(HAL_GPIO_ReadPin(DHT11_GPIO_Port, DHT11_Pin) == GPIO_PIN_RESET); delay_us(40); if(HAL_GPIO_ReadPin(DHT11_GPIO_Port, DHT11_Pin)) { data |= (1 << (7-i)); while(HAL_GPIO_ReadPin(DHT11_GPIO_Port, DHT11_Pin) == GPIO_PIN_SET); } } return data; }3.2 数据校验与处理
DHT11传输的5字节数据格式：
- 湿度整数部分
- 湿度小数部分（DHT11固定为0）
- 温度整数部分
- 温度小数部分（DHT11固定为0）
- 校验和（前4字节和）
注意：实际项目中建议添加超时机制，防止程序卡死在等待状态。
4. OLED显示驱动
4.1 I2C通信基础
OLED显示通常采用SSD1306驱动芯片，通过I2C接口通信。HAL库提供了简洁的API：
// OLED写命令函数 void OLED_WriteCmd(uint8_t cmd) { HAL_I2C_Mem_Write(&hi2c1, 0x78, 0x00, I2C_MEMADD_SIZE_8BIT, &cmd, 1, 100); } // OLED写数据函数 void OLED_WriteData(uint8_t data) { HAL_I2C_Mem_Write(&hi2c1, 0x78, 0x40, I2C_MEMADD_SIZE_8BIT, &data, 1, 100); }4.2 显示优化技巧
- 页面寻址模式：将屏幕分为8页，每页8行像素
- 双缓冲技术：先写入内存再整体刷新，避免闪烁
- 自定义字体：使用取模软件生成特定大小的字体
// 显示字符串函数示例 void OLED_ShowString(uint8_t x, uint8_t y, char *str) { while(*str) { OLED_ShowChar(x, y, *str++); x += 8; if(x > 120) { x = 0; y += 2; } } }5. 系统集成与优化
5.1 主程序逻辑设计
graph TD A[系统初始化] --> B[OLED初始化] B --> C[DHT11初始化] C --> D[读取温湿度] D --> E[数据格式化] E --> F[OLED显示] F --> D5.2 性能优化建议
- 低功耗模式：在两次采集间隔进入STOP模式
- 数据滤波：采用滑动平均算法处理传感器数据
- 异常处理：添加传感器断线检测机制
// 主循环示例 while(1) { if(DHT11_ReadData(&temp, &humi) == DHT11_OK) { sprintf(buffer, "Temp:%dC", temp); OLED_ShowString(0, 0, buffer); sprintf(buffer, "Humi:%d%%", humi); OLED_ShowString(0, 2, buffer); } HAL_Delay(2000); HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI); }6. 常见问题解决
问题1：DHT11无响应
- 检查接线是否正确（VCC、DATA、GND）
- 确认上拉电阻（4.7KΩ）已连接
- 测量电源电压（3.3V-5V）
问题2：OLED显示异常
- 确认I2C地址（0x78或0x7A）
- 检查I2C线序（SCL、SDA）
- 尝试降低I2C时钟速度
问题3：数据跳动严重
- 增加软件滤波算法
- 检查电源稳定性
- 避免传感器附近有强烈气流
实际调试中发现，DHT11对时序要求严格，微秒级延时误差可能导致读取失败。建议使用定时器实现精确延时，而非简单的循环延时。
