简介本资源是一套基于STM32F103系列单片机的嵌入式温湿度监测系统完整工程代码面向嵌入式初学者、课程设计学生及物联网实践开发者解决环境参数采集、本地可视化、异常报警与PC端数据回传等典型应用场景问题。压缩包共238个文件含36个C源文件如OLED.c、stm32f10x_rcc.c等驱动与主控逻辑、36个头文件.h、48个编译中间文件.o、47个依赖描述文件.d及Keil MDK工程配置文件.uvprojx、.uvoptx、.sct等整体大小为6.61MB结构规范便于理解STM32标准外设库开发流程与模块化编程思想。已有137人学习下载资源包含可直接编译运行的完整工程涵盖DHT22单总线协议解析、OLED SSD1306 I2C显示驱动、蜂鸣器阈值触发逻辑及USART串口数据打包发送功能配套注释清晰适合用于实验验证、毕业设计参考或嵌入式入门项目实战。1. 项目概述与核心价值最近在整理一些嵌入式开发的入门项目发现一个非常经典的组合用STM32单片机读取DHT22温湿度传感器的数据然后通过OLED屏幕实时显示当温湿度超过预设阈值时触发蜂鸣器报警同时把所有数据通过串口发送到电脑端的串口调试助手。这个项目麻雀虽小五脏俱全几乎涵盖了嵌入式开发中传感器驱动、人机交互、外设控制和数据通信这几个最核心的模块。对于刚学完STM32基础外设GPIO、定时器、串口的朋友来说这是一个绝佳的练手项目能把分散的知识点串联成一个完整的系统。我手头正好有一套基于STM32F103C8T6也就是常说的“蓝桥杯”或“最小系统板”的源代码代码风格清晰注释也比较详细。这个项目看似简单但在实际调试过程中从传感器时序的精准抓取到OLED显示的稳定刷新再到串口数据的可靠传输每一步都有不少细节需要注意。网上很多教程只给代码不讲背后的原理和调试时可能遇到的坑导致新手照着抄也跑不通。在这篇文章里我不光会分享经过实测可用的源代码更重要的是我会拆解每一个模块的实现逻辑解释“为什么要这样写代码”并分享我在调试过程中遇到的那些典型问题和解决方法。无论你是想复现这个项目还是想深入理解这些外设如何协同工作相信都能从中找到答案。2. 硬件选型与电路连接解析动手写代码之前得先把硬件平台搭起来。这个项目的硬件清单非常常见成本也很低大部分模块在淘宝上都能以“STM32入门套件”的形式一次性购齐。2.1 核心控制器STM32F103C8T6我选择STM32F103C8T6作为主控原因很简单资源足够、价格便宜、社区资料极其丰富。它拥有72MHz的主频、64KB Flash、20KB RAM驱动本项目的外设绰绰有余。更重要的是它的GPIO、定时器和USART外设功能完善Hal库和标准库的支持都非常好便于我们快速开发。对于这个项目我们主要会用到它的以下几个功能一个通用定时器如TIM2用于产生微秒级延时这是驱动DHT22传感器的关键。一个USART如USART1用于和电脑进行串口通信发送温湿度数据。若干通用GPIO分别用于连接DHT22的数据线、OLED的I2C或SPI接口、蜂鸣器的控制引脚。2.2 传感器模块DHT22AM2302DHT22是一款数字式温湿度复合传感器它通过单总线协议与MCU通信。相比DHT11它的精度和量程更高温度-40~80℃湿度0~99.9%RH。这里需要理解一个关键点DHT22的“单总线”协议。它只用一根数据线DQ完成双向通信这意味着这根线既要作为MCU的输出发送开始信号又要作为输入读取传感器数据。因此在硬件连接上通常会在数据线和VCC之间连接一个4.7K~10K的上拉电阻以确保在总线空闲时保持高电平。在实际接线时将DHT22的VCC接3.3VGND接地数据线接STM32的某个GPIO引脚例如PA0并确保上拉电阻已连接很多模块已经集成。2.3 显示模块0.96寸OLEDSSD1306驱动OLED我选用的是最常见的0.96寸、128x64分辨率的型号驱动芯片是SSD1306。它支持I2C和SPI两种通信方式。为了节省IO口和简化布线我强烈推荐使用I2C接口只需要连接4根线VCC3.3V、GND、SCL时钟线、SDA数据线。I2C通信同样需要上拉电阻通常模块上也已集成。将SCL和SDA分别连接到STM32的对应I2C引脚上例如I2C1的PB6SCL和PB7SDA。2.4 报警模块有源蜂鸣器蜂鸣器分有源和无源。有源蜂鸣器内部自带振荡电路通电就响声音频率固定无源蜂鸣器需要外部提供PWM信号驱动才能发声可以控制音调和旋律。对于简单的报警提示有源蜂鸣器更方便。我们只需要用一个GPIO引脚例如PB8通过一个三极管或MOS管来驱动它即可。因为STM32的GPIO引脚驱动电流有限通常约20mA而蜂鸣器工作电流可能达到30mA以上直接驱动可能损坏IO口或导致声音小。最简单的办法是使用一个NPN三极管如S8050做开关STM32的IO口接三极管基极蜂鸣器正极接VCC负极接三极管集电极三极管发射极接地。当IO输出高电平时三极管导通蜂鸣器响起。2.5 通信与调试接口USB转TTL串口模块这是连接STM32和电脑的桥梁。STM32的USART1的TXPA9和RXPA10引脚需要连接到USB转TTL模块的RX和TX引脚注意交叉连接。同时共地GND是必须的。这样我们就可以在电脑上使用串口调试助手如SSCOM、XCOM来接收数据了。注意接线时务必仔细核对VCC电压。STM32、DHT22、OLED通常都是3.3V电平务必接3.3V。USB转TTL模块的VCC可以选择接5V或3.3V但为了统一和保险建议其VCC也接3.3V如果模块支持或者只连接其GND、RX、TX三条线不给STM32供电由其他电源为STM32供电。3. 软件架构与模块驱动实现硬件连接好后我们进入软件部分。我采用的是STM32CubeMX进行基础配置然后使用Hal库进行编程。这样的好处是初始化代码由工具生成我们只需关注应用逻辑且代码移植性更好。3.1 工程创建与外设初始化STM32CubeMX配置首先用STM32CubeMX创建一个针对STM32F103C8T6的工程。系统核心SYS在SYS选项卡中将Debug设置为Serial Wire这是为了保留SWD下载调试接口。时钟RCC在RCC选项卡中将High Speed Clock (HSE)设置为Crystal/Ceramic Resonator这样我们才能使用外部8MHz晶振并通过PLL将系统时钟倍频到72MHz。GPIO配置DHT22数据引脚如PA0设置为GPIO_Output初始输出电平为高因为单总线空闲时为高电平。在代码中我们会动态切换输入输出模式。蜂鸣器控制引脚如PB8设置为GPIO_Output初始输出低电平蜂鸣器不响。OLED的I2C引脚找到I2C1将模式设置为I2C引脚会自动映射到PB6和PB7。参数通常保持默认标准模式100kHz即可。定时器配置我们需要一个高精度的微秒延时函数。添加一个通用定时器例如TIM2。将其时钟源设为内部时钟预分频器PSC设置为72-1因为系统时钟72MHz分频后得到1MHz的计数频率即每个计数1微秒。自动重载值ARR可以设一个较大值如65535。然后生成代码。串口配置添加USART1模式为Asynchronous异步通信。波特率设置为115200字长8 Bits停止位1无校验。这将是和电脑通信的标准配置。生成代码设置好工程路径和工具链MDK-ARM V5然后生成代码。3.2 DHT22单总线驱动代码详解DHT22的驱动是整个项目的难点因为它对时序要求非常严格。其通信过程分为三步MCU发送开始信号 - DHT22响应 - DHT22发送40位数据。首先我们需要实现一个微秒级延时函数这依赖于前面配置的TIM2。// 微秒延时函数 void delay_us(uint16_t us) { __HAL_TIM_SET_COUNTER(htim2, 0); // 定时器计数器清零 HAL_TIM_Base_Start(htim2); // 启动定时器 while (__HAL_TIM_GET_COUNTER(htim2) us); // 等待计数值达到 HAL_TIM_Base_Stop(htim2); // 停止定时器 }接下来是DHT22的读取函数。关键点在于引脚模式的动态切换和时序的精确判断。// DHT22数据读取函数 uint8_t DHT22_Read_Data(float *temperature, float *humidity) { uint8_t data[5] {0}; uint8_t i, j; // 1. MCU发送开始信号 HAL_GPIO_WritePin(DHT22_GPIO_Port, DHT22_Pin, GPIO_PIN_RESET); // 拉低至少800us delay_us(1000); // 这里给1000us留有余量 HAL_GPIO_WritePin(DHT22_GPIO_Port, DHT22_Pin, GPIO_PIN_SET); // 释放总线拉高20-40us delay_us(30); // 2. 设置引脚为输入模式等待DHT22响应 GPIO_InitTypeDef GPIO_InitStruct {0}; GPIO_InitStruct.Pin DHT22_Pin; GPIO_InitStruct.Mode GPIO_MODE_INPUT; GPIO_InitStruct.Pull GPIO_NOPULL; // 外部已有上拉这里不启用内部上下拉 HAL_GPIO_Init(DHT22_GPIO_Port, GPIO_InitStruct); // 等待DHT22拉低总线响应信号 uint32_t timeout 10000; // 超时计数防止死循环 while (HAL_GPIO_ReadPin(DHT22_GPIO_Port, DHT22_Pin) GPIO_PIN_SET) { if (--timeout 0) return 1; // 超时返回错误 } // 等待低电平结束约80us timeout 10000; while (HAL_GPIO_ReadPin(DHT22_GPIO_Port, DHT22_Pin) GPIO_PIN_RESET) { if (--timeout 0) return 2; } // 等待高电平结束约80us timeout 10000; while (HAL_GPIO_ReadPin(DHT22_GPIO_Port, DHT22_Pin) GPIO_PIN_SET) { if (--timeout 0) return 3; } // 3. 开始读取40位数据 for (i 0; i 5; i) { for (j 0; j 8; j) { // 等待每个比特位开始的50us低电平 timeout 10000; while (HAL_GPIO_ReadPin(DHT22_GPIO_Port, DHT22_Pin) GPIO_PIN_RESET) { if (--timeout 0) return 4; } // 测量高电平持续时间以判断是0还是1 uint32_t count 0; while (HAL_GPIO_ReadPin(DHT22_GPIO_Port, DHT22_Pin) GPIO_PIN_SET) { count; delay_us(1); // 循环延时1us进行计数 if (count 100) break; // 超时保护 } // 如果高电平持续时间大于30us则为1否则为0 data[i] 1; if (count 30) { data[i] | 0x01; } } } // 4. 读取完毕将引脚恢复为输出模式保持高电平 GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull GPIO_NOPULL; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(DHT22_GPIO_Port, GPIO_InitStruct); HAL_GPIO_WritePin(DHT22_GPIO_Port, DHT22_Pin, GPIO_PIN_SET); // 5. 校验数据 if (data[4] (data[0] data[1] data[2] data[3])) { // 数据格式湿度高8位、湿度低8位、温度高8位、温度低8位、校验和 // DHT22温度值最高位为1表示负数 int16_t hum (data[0] 8) | data[1]; int16_t temp (data[2] 8) | data[3]; if (temp 0x8000) // 判断是否为负数 { temp -(temp 0x7FFF); } *humidity hum / 10.0; *temperature temp / 10.0; return 0; // 成功 } return 5; // 校验失败 }实操心得DHT22的时序非常敏感。上述代码中的delay_us(1)在循环中计数在实际72MHz主频下这个延时可能不精确但用于区分0和1的阈值30us是足够的。更精确的做法是使用定时器的输入捕获功能但对于入门项目这种延时循环法更直观易懂。如果发现读取失败率高可以尝试微调delay_us函数的精度或者调整判断0/1的阈值比如从30us改为40us。3.3 OLED (SSD1306) I2C驱动与显示OLED显示我们使用现有的开源驱动库例如ssd1306.h和ssd1306.c。我们需要做的是适配I2C接口。通常驱动库会提供几个底层函数需要我们实现I2C_Write、I2C_WriteMulti等。在Hal库中我们可以用HAL_I2C_Mem_Write函数来简化操作。首先在ssd1306.c文件中找到硬件抽象层HAL的实现部分填充以下函数#include “main.h” // 包含你的主头文件里面有hi2c1的定义 extern I2C_HandleTypeDef hi2c1; // 声明外部I2C句柄 #define SSD1306_I2C_ADDR (0x3C 1) // SSD1306的I2C地址左移一位是因为Hal库需要7位地址 void ssd1306_WriteCommand(uint8_t command) { HAL_I2C_Mem_Write(hi2c1, SSD1306_I2C_ADDR, 0x00, I2C_MEMADD_SIZE_8BIT, command, 1, HAL_MAX_DELAY); } void ssd1306_WriteData(uint8_t* data, uint16_t size) { HAL_I2C_Mem_Write(hi2c1, SSD1306_I2C_ADDR, 0x40, I2C_MEMADD_SIZE_8BIT, data, size, HAL_MAX_DELAY); }然后在主函数初始化部分调用ssd1306_Init()之后就可以使用库函数如ssd1306_Fill()、ssd1306_SetCursor()、ssd1306_WriteString()来显示内容了。例如显示温湿度char str_buf[32]; float temp, hum; if(DHT22_Read_Data(temp, hum) 0) { ssd1306_Fill(Black); // 清屏 ssd1306_SetCursor(0, 0); sprintf(str_buf, “Temp: %.1f C”, temp); ssd1306_WriteString(str_buf, Font_7x10, White); ssd1306_SetCursor(0, 20); sprintf(str_buf, “Hum: %.1f %%”, hum); ssd1306_WriteString(str_buf, Font_7x10, White); ssd1306_UpdateScreen(); // 将缓存更新到屏幕 }3.4 蜂鸣器报警逻辑报警逻辑很简单就是判断读取到的温湿度值是否超过我们设定的阈值。#define TEMP_THRESHOLD_HIGH 30.0 // 温度高阈值 #define HUM_THRESHOLD_HIGH 80.0 // 湿度高阈值 void check_alarm(float temp, float hum) { if (temp TEMP_THRESHOLD_HIGH || hum HUM_THRESHOLD_HIGH) { HAL_GPIO_WritePin(BUZZER_GPIO_Port, BUZZER_Pin, GPIO_PIN_SET); // 蜂鸣器响 } else { HAL_GPIO_WritePin(BUZZER_GPIO_Port, BUZZER_Pin, GPIO_PIN_RESET); // 蜂鸣器停 } }在实际项目中你可能需要更复杂的报警逻辑比如延时报警、不同级别的声光报警等。3.5 串口数据发送与格式化最后我们需要将数据打包成字符串通过串口发送出去。使用Hal库的HAL_UART_Transmit函数非常方便。void send_data_via_uart(float temp, float hum) { char uart_buf[64]; int len sprintf(uart_buf, “Temperature: %.1f C, Humidity: %.1f %%RH\r\n”, temp, hum); HAL_UART_Transmit(huart1, (uint8_t*)uart_buf, len, HAL_MAX_DELAY); }这里的\r\n是回车换行符这样在串口调试助手中每条数据都会单独显示一行非常清晰。4. 系统整合与主循环设计各个模块的驱动都准备好后我们需要将它们整合到一个有序的主循环中。一个好的主循环设计应该考虑任务的实时性、CPU的占用率以及系统的稳定性。4.1 主函数初始化流程在main.c的main函数中初始化顺序很重要int main(void) { HAL_Init(); // Hal库初始化 SystemClock_Config(); // 系统时钟配置由CubeMX生成 MX_GPIO_Init(); // GPIO初始化 MX_I2C1_Init(); // I2C初始化用于OLED MX_TIM2_Init(); // 定时器初始化用于微秒延时 MX_USART1_UART_Init(); // 串口初始化 // 初始化OLED ssd1306_Init(); ssd1306_Fill(Black); ssd1306_UpdateScreen(); // 初始化DHT22引脚为输出高电平 HAL_GPIO_WritePin(DHT22_GPIO_Port, DHT22_Pin, GPIO_PIN_SET); // 通过串口发送启动信息 char start_msg[] “STM32 DHT22 System Started.\r\n”; HAL_UART_Transmit(huart1, (uint8_t*)start_msg, sizeof(start_msg)-1, HAL_MAX_DELAY); float temperature 0, humidity 0; uint32_t last_read_time 0; const uint32_t read_interval 2000; // 读取间隔2秒DHT22最快2秒读一次 while (1) { uint32_t current_time HAL_GetTick(); // 获取系统运行时间毫秒 // 4.2 定时读取传感器数据 if (current_time - last_read_time read_interval) { last_read_time current_time; if (DHT22_Read_Data(temperature, humidity) 0) { // 4.3 更新OLED显示 update_oled_display(temperature, humidity); // 4.4 检查并触发报警 check_alarm(temperature, humidity); // 4.5 发送数据到串口 send_data_via_uart(temperature, humidity); } else { // 读取失败处理可以在OLED或串口显示错误信息 char err_msg[] “DHT22 Read Error!\r\n”; HAL_UART_Transmit(huart1, (uint8_t*)err_msg, sizeof(err_msg)-1, HAL_MAX_DELAY); } } // 此处可以添加其他低优先级任务如按键扫描等 HAL_Delay(10); // 主循环延时降低CPU占用 } }4.2 传感器读取的定时策略DHT22传感器两次读取之间需要至少2秒的间隔否则可能读取失败。因此我们不能在while(1)循环里不停地调用DHT22_Read_Data。上面的代码使用HAL_GetTick()提供的毫秒级系统时钟进行非阻塞式延时每2秒读取一次。这是一种非常经典和实用的定时任务处理方法。4.3 显示、报警、通信的同步在成功读取数据后我们依次执行显示更新、报警判断和串口发送。这三件事是顺序执行的执行时间很短毫秒级不会影响2秒的读取周期。这样做逻辑清晰代码易于维护。4.4 错误处理与系统健壮性代码中包含了DHT22读取失败的错误处理通过返回值判断并在串口输出错误信息。在实际项目中还可以考虑增加重试机制比如连续失败3次后再报错或者让OLED显示一个特定的错误图标提高用户体验。5. 调试技巧与常见问题排查即使代码逻辑正确在实际硬件调试中也可能遇到各种问题。下面我总结几个最常见的坑和解决办法。5.1 DHT22读取始终失败这是最高频的问题可能的原因和排查步骤如下硬件连接首先用万用表检查DHT22的VCC是否为稳定的3.3VGND是否接通。数据线的上拉电阻4.7K-10K是否已连接如果没有务必加上。时序问题单总线协议对时序极其敏感。确保你的delay_us函数是准确的。一个验证方法是用这个延时函数控制一个LED闪烁然后用示波器或者逻辑分析仪测量闪烁周期是否与预期相符。如果没有仪器可以尝试将代码中判断比特位0/1的阈值上文代码中的30us适当增大或减小比如尝试20us或40us。电源噪声DHT22对电源纹波比较敏感。如果使用开发板的3.3V输出同时给多个模块供电可能在DHT22启动测量时造成电压跌落。尝试在DHT22的VCC和GND之间并联一个100uF的电解电容进行电源滤波。接线过长数据线过长会引入信号完整性问题。尽量让DHT22靠近STM32导线长度最好在20厘米以内。5.2 OLED屏幕不显示或显示乱码I2C地址错误SSD1306的常见I2C地址是0x3C或0x3D。大部分模块是0x3C。在驱动代码中地址需要左移一位0x3C 1这是Hal库的要求。如果不确定可以用I2C扫描代码搜索一下总线上存在的设备地址。初始化顺序确保在调用ssd1306_Init()之前I2C外设hi2c1已经通过MX_I2C1_Init()正确初始化。屏幕对比度有些屏幕初始对比度很低看起来像没显示。可以在初始化后调用ssd1306_SetContrast()函数提高对比度试试。更新屏幕使用ssd1306_WriteString等函数只是在内部缓存中写入了数据必须调用ssd1306_UpdateScreen()才会真正把缓存内容发送到屏幕显示。这是新手常忘的一步。5.3 串口调试助手收不到数据或乱码线接反了务必确认STM32的TX接USB转TTL的RXSTM32的RX接USB转TTL的TX。共地确保STM32的GND和USB转TTL模块的GND连接在一起这是形成通信回路的基础。波特率不匹配检查代码中MX_USART1_UART_Init()设置的波特率如115200是否与串口调试助手软件上选择的波特率完全一致。开发板上的串口引脚冲突STM32F103C8T6的PA9和PA10默认也是USB的DP和DM引脚如果用了USB功能。确保你的工程没有启用USB设备库否则会导致冲突。在CubeMX中检查USB选项是否被禁用。5.4 蜂鸣器不响或声音小驱动能力不足这是最常见的原因。STM32的GPIO引脚无法直接驱动有源蜂鸣器。请检查你是否按照前面所述使用了三极管如S8050或MOS管来驱动。简单的判断方法将蜂鸣器正极直接接3.3V负极接地如果响了说明蜂鸣器是好的问题在驱动电路。控制逻辑反了有些蜂鸣器模块是低电平触发有些是高电平触发。确认你的电路和控制逻辑。如果接了三极管通常是GPIO高电平时三极管导通蜂鸣器响。供电不足蜂鸣器工作时瞬时电流较大可能导致整个系统电压被拉低。可以尝试单独给蜂鸣器供电或者在主电源上并联一个大电容。6. 功能扩展与优化思路当基础功能跑通后你可以尝试以下扩展让项目更具挑战性和实用性。6.1 增加按键设置报警阈值目前报警阈值是写在代码里的常量。可以增加两个按键一个加一个减用来实时调整温度或湿度的报警阈值。这需要你学习STM32的外部中断或按键扫描并在OLED上显示当前的阈值设置菜单。这能让你深入理解中断处理和简单状态机的编程思想。6.2 使用RTOS进行任务管理当前的主循环是“超级循环”Super Loop架构。当你想增加更多功能比如网络通信、复杂的用户界面时这种架构会变得难以维护。可以尝试移植FreeRTOS这样的实时操作系统。你可以创建几个独立的任务一个任务专门定时读取传感器一个任务管理OLED显示一个任务处理串口通信一个任务检查报警。RTOS能让你更好地管理多任务和系统资源。6.3 将数据上传到物联网平台这是非常有价值的扩展。你可以增加一个ESP8266 Wi-Fi模块通过AT指令让STM32连接家里的Wi-Fi然后将温湿度数据按照JSON格式打包通过MQTT协议发送到阿里云、腾讯云等物联网平台。这样你就可以在手机App上远程查看温湿度数据和历史曲线了。这一步会涉及到串口AT指令解析、网络协议、JSON编解码等知识是一个质的飞跃。6.4 优化显示效果与低功耗目前的显示是简单的文本。你可以用图形库在OLED上绘制温湿度计、趋势曲线图让显示更直观。另外如果项目是电池供电就需要考虑低功耗。可以让STM32在两次读取间隔进入睡眠模式Stop Mode仅靠RTC或外部中断唤醒这样可以极大降低系统功耗。这个项目从硬件连接到软件调试完整地走了一遍嵌入式系统开发的流程。我最深的体会是嵌入式开发三分在写代码七分在调试。遇到问题时最有效的方法就是“分而治之”先用最简单的代码测试每个模块是否独立工作比如单独测试串口发送、单独测试OLED显示一个固定字符然后再将它们组合起来。逻辑分析仪或者一个简单的示波器对于调试DHT22这种时序严格的单总线协议有奇效。希望这份详细的解析和源代码能帮你少走些弯路更扎实地掌握STM32的开发。本文还有配套的精品资源点击获取