STM32F103C8T6与DHT11温湿度传感器：从零构建一个稳定可靠的嵌入式数据采集系统

对于许多嵌入式开发者而言，将传感器数据稳定、准确地采集到微控制器中，是项目成功的第一步。STM32F103C8T6，这颗被誉为“蓝色药丸”的经典Cortex-M3芯片，以其极高的性价比和丰富的生态，成为了无数入门和中级项目的首选。而DHT11，作为一款普及度极高的数字温湿度传感器，其简单的单总线协议看似友好，却在实际应用中暗藏不少时序“陷阱”。今天，我们就抛开那些千篇一律的教程，深入探讨如何基于STM32F103C8T6，构建一个工业级可靠的DHT11数据采集模块。这不仅仅是连接引脚和复制代码，更是关于时序精度、错误处理、代码架构以及调试技巧的实战分享。

1. 项目核心：理解你的硬件伙伴

在动手写一行代码之前，我们必须像了解老朋友一样，熟悉手中的两个核心硬件。这能帮助我们在后续调试中，快速定位问题是出在硬件连接、传感器本身，还是我们的软件逻辑。

1.1 STM32F103C8T6的GPIO能力与配置要点

STM32F103C8T6的GPIO口功能强大，但对于DHT11这种对时序极其敏感的器件，配置不当会导致通信彻底失败。

首先，我们需要明确几个关键点：

• 推挽输出 vs. 开漏输出：DHT11的单总线需要主机（MCU）能够主动拉高和拉低线路。因此，在主机发送起始信号时，GPIO必须配置为推挽输出模式。开漏输出模式在拉低时有效，但拉高依赖于外部上拉电阻，在高速切换时可能无法提供快速、稳定的高电平，不推荐使用。
• 输入模式的选择：当STM32需要读取DHT11的数据时，GPIO需切换为输入模式。通常使用浮空输入或上拉输入。由于DHT11协议要求总线有一个外部上拉电阻（通常4.7KΩ-10KΩ），因此配置为浮空输入即可。如果省去了外部上拉电阻，则可以配置为内部上拉输入，但稳定性可能不如外部电阻。
• 速度设置：GPIO输出速度配置（如GPIO_Speed_2MHz, 10MHz, 50MHz）会影响信号边沿的陡峭程度。对于DHT11这种最高通信速率不超过100Kbps的器件，2MHz或10MHz足以满足要求，且噪声更小。设置为50MHz虽然可以，但可能引入更多的振铃和过冲，在长导线连接时需谨慎。

一个常被忽略的细节是，在代码中动态切换GPIO的输入输出模式时，STM32的标准外设库（SPL）或HAL库的配置函数（GPIO_Init）会重新配置整个端口组。如果你的DHT11数据引脚与其他外设（如LED、按键）共用同一GPIO端口（如GPIOA），频繁的重新初始化可能会干扰其他设备的工作。更优雅的做法是，利用STM32的引脚重映射或选择独立引脚，或者采用更精细的位操作来避免影响同端口其他引脚。

1.2 DHT11传感器：协议深潜与“坑点”预警

DHT11的数据手册看起来简单，但魔鬼藏在细节里。我们来拆解其单总线协议，并指出那些容易导致读取失败的关键参数。

通信时序的精确解读：

一次完整的DHT11数据读取分为三个阶段：主机发起起始信号、DHT11响应、数据传输。

1. 主机起始信号：主机拉低总线至少18毫秒，然后拉高20-40微秒。这里第一个坑是“至少18ms”。很多教程代码里写Delay_ms(20)，没问题。但如果你在实时操作系统（RTOS）的任务里调用，或者被高优先级中断频繁打断，可能导致低电平时间不足，DHT11无法被正确唤醒。

2. 传感器响应信号：DHT11接收到起始信号后，会拉低总线80微秒作为应答，随后再拉高80微秒准备发送数据。我们的代码必须在这段时间内，将GPIO从输出模式切换到输入模式，并开始检测这个响应信号。响应超时判断至关重要，代码必须包含超时退出机制，否则一旦DHT11不存在或损坏，程序将死循环在等待响应的代码里。

3. 数据传输：每一位数据都以一个50微秒的低电平起始脉冲开始，随后的高电平持续时间决定数据位是0还是1。

   • 26-28微秒的高电平表示 ‘0’
   • 70微秒的高电平表示 ‘1’

   这里最大的挑战在于如何精确测量这段高电平的宽度。在禁止中断的环境下，使用微秒级延时循环进行“测量”是常见方法，但这种方法严重依赖于系统时钟的准确性。如果系统时钟因配置错误而有偏差，测量就会出错。

数据格式与校验： DHT11输出40位（5字节）数据。格式如下表所示：

字节序号	数据内容	说明
0	湿度整数部分	范围：20%~90%RH
1	湿度小数部分	对于DHT11，此字节始终为0
2	温度整数部分	范围：0~50°C
3	温度小数部分	对于DHT11，此字节始终为0
4	校验和	字节0至字节3之和的低8位

注意：许多初学者会疑惑为什么读取到的小数部分总是0。这是因为DHT11的分辨率就是1%RH和1°C，它本身不提供小数输出。如果你需要更精确的读数，应该考虑使用DHT22（AM2302）传感器。

校验和是验证数据完整性的简单有效手段。如果(Byte0 + Byte1 + Byte2 + Byte3) & 0xFF不等于Byte4，则本次数据必须丢弃，并重新发起一次读取。

2. 硬件连接：不仅仅是连线那么简单

正确的硬件连接是通信稳定的物理基础。一个典型的连接图如下：

STM32F103C8T6                  DHT11
      PA0         <-------->     DATA (Pin 2)
      3.3V        <-------->     VCC  (Pin 1)
      GND         <-------->     GND  (Pin 4)
                               NC    (Pin 3) - 悬空

（注：DATA引脚可连接至任何具有中断或普通输入输出能力的GPIO，如PA0, PA1, PB0, PB1等）

关键硬件设计考量：

1. 上拉电阻：DHT11的DATA线必须接一个上拉电阻到VCC，阻值通常在4.7kΩ到10kΩ之间。这个电阻确保了总线在空闲时处于确定的高电平状态。即使STM32的GPIO配置为内部上拉，也强烈建议保留这个外部电阻，因为它能提供更强的拉高能力，对抗线路干扰。
2. 电源去耦：在DHT11的VCC和GND引脚之间，尽可能靠近传感器放置一个0.1μF的陶瓷电容。这可以滤除电源线上的噪声，对于提高传感器在电气噪声环境下的稳定性非常有效。
3. 导线长度：单总线协议对线路电容敏感。如果传感器需要远离MCU（超过1-2米），通信失败率会显著上升。对于长距离连接，应考虑降低上拉电阻阻值（如用2.2kΩ），或使用屏蔽线，甚至改用抗干扰能力更强的通信协议（如RS-485转换后的单总线）。
4. 电源一致性：确保STM32和DHT11使用同一个稳定的3.3V电源。如果DHT11由其他电源或LDO供电，需确保其电压与STM32的IO电平兼容，且上电时序不会导致IO口倒灌。

3. 驱动代码编写：追求鲁棒性与可维护性

我们将采用STM32标准外设库进行开发，但代码结构将超越简单的函数堆砌，注重错误处理、资源管理和可移植性。

3.1 工程结构与头文件设计

首先，创建一个清晰的工程结构。在项目Inc和Src文件夹下，分别创建dht11.h和dht11.c。

dht11.h 头文件设计：

#ifndef __DHT11_H
#define __DHT11_H

#ifdef __cplusplus
 extern "C" {
#endif

#include "stm32f10x.h"

/* 用户可配置区域 - 根据实际硬件连接修改 */
#define DHT11_GPIO_PORT               GPIOA
#define DHT11_GPIO_PIN                GPIO_Pin_0
#define DHT11_RCC_APB2Periph_GPIO     RCC_APB2Periph_GPIOA

/* 超时重试相关配置 */
#define DHT11_RESPONSE_TIMEOUT_US     100   // 等待响应信号超时（微秒）
#define DHT11_BIT_START_TIMEOUT_US    100   // 等待位起始低电平超时
#define DHT11_READ_RETRY_COUNT        3     // 读取失败后重试次数

/* 数据类型定义 */
typedef struct {
    uint8_t humidity_integer;
    uint8_t temperature_integer;
    uint8_t checksum_ok; // 1:校验成功， 0:校验失败
} DHT11_Data_t;

/* 函数接口 */
uint8_t DHT11_Init(void);
uint8_t DHT11_ReadData(DHT11_Data_t *pData);

#ifdef __cplusplus
}
#endif

#endif /* __DHT11_H */

这个头文件的特点在于：

• 使用结构体封装数据，使数据传递更清晰。
• 将硬件依赖（端口、引脚）定义为宏，方便移植。
• 引入了可配置的超时参数和重试机制。
• 添加了C++兼容支持。

3.2 核心驱动实现（dht11.c）

驱动代码的核心是精确的时序控制。我们将使用SysTick或通用定时器来实现微秒级延时，这比循环延时更精确。这里假设我们已经有一个可靠的Delay_us(uint32_t us)函数。

#include "dht11.h"
#include "delay.h" // 假设包含微秒延时函数

/* 静态函数前置声明 */
static void DHT11_SetPinOutput(void);
static void DHT11_SetPinInput(void);
static uint8_t DHT11_WaitForPinState(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, uint8_t state, uint32_t timeout_us);
static uint8_t DHT11_ReadBit(void);
static uint8_t DHT11_ReadByte(void);
static void DHT11_SendStartSignal(void);

/**
  * @brief  初始化DHT11的GPIO引脚
  * @retval 1: 初始化成功且传感器响应正常， 0: 初始化失败或传感器无响应
  */
uint8_t DHT11_Init(void) {
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    /* 使能GPIO时钟 */
    RCC_APB2PeriphClockCmd(DHT11_RCC_APB2Periph_GPIO, ENABLE);

    /* 初始配置为推挽输出，并默认拉高总线 */
    GPIO_InitStruct.GPIO_Pin = DHT11_GPIO_PIN;
    GPIO_InitStruct.GPIO_Mode = GPIO_Mode_Out_PP;
    GPIO_InitStruct.GPIO_Speed = GPIO_Speed_2MHz;
    GPIO_Init(DHT11_GPIO_PORT, &GPIO_InitStruct);

    GPIO_SetBits(DHT11_GPIO_PORT, DHT11_GPIO_PIN); // 拉高，总线空闲

    /* 发送起始信号并检查响应 */
    DHT11_SendStartSignal();
    return DHT11_WaitForPinState(DHT11_GPIO_PORT, DHT11_GPIO_PIN, 0, DHT11_RESPONSE_TIMEOUT_US);
}

/**
  * @brief  发送DHT11通信起始信号（拉低至少18ms后拉高20-40us）
  */
static void DHT11_SendStartSignal(void) {
    DHT11_SetPinOutput();
    GPIO_ResetBits(DHT11_GPIO_PORT, DHT11_GPIO_PIN); // 拉低
    Delay_ms(20);                                    // 保持低电平20ms
    GPIO_SetBits(DHT11_GPIO_PORT, DHT11_GPIO_PIN);   // 拉高
    Delay_us(30);                                    // 保持高电平30us
}

/**
  * @brief  读取一次完整的温湿度数据
  * @param  pData: 指向DHT11_Data_t结构体的指针，用于存储读取结果
  * @retval 1: 读取成功且校验正确， 0: 读取失败（超时、校验错等）
  */
uint8_t DHT11_ReadData(DHT11_Data_t *pData) {
    uint8_t buffer[5] = {0};
    uint8_t retry = DHT11_READ_RETRY_COUNT;
    uint8_t i;

    if (pData == NULL) {
        return 0;
    }

    while (retry--) {
        DHT11_SendStartSignal();

        /* 等待DHT11的响应低电平（约80us） */
        if (DHT11_WaitForPinState(DHT11_GPIO_PORT, DHT11_GPIO_PIN, 0, DHT11_RESPONSE_TIMEOUT_US) == 0) {
            continue; // 等待响应低电平超时，重试
        }

        /* 等待DHT11结束响应低电平，进入准备发送数据的高电平（约80us） */
        if (DHT11_WaitForPinState(DHT11_GPIO_PORT, DHT11_GPIO_PIN, 1, DHT11_RESPONSE_TIMEOUT_US) == 0) {
            continue; // 等待响应高电平超时，重试
        }

        /* 此时DHT11已准备好，切换为输入模式，开始读取40位数据 */
        DHT11_SetPinInput();

        for (i = 0; i < 5; i++) {
            buffer[i] = DHT11_ReadByte();
        }

        /* 校验数据 */
        uint8_t sum = buffer[0] + buffer[1] + buffer[2] + buffer[3];
        if (sum == buffer[4]) {
            pData->humidity_integer = buffer[0];
            pData->temperature_integer = buffer[2];
            pData->checksum_ok = 1;
            return 1; // 读取并校验成功
        }
        // 校验失败，自动进入下一轮重试
        Delay_ms(100); // 两次读取之间稍作延迟，避免传感器忙
    }
    // 所有重试均失败
    pData->checksum_ok = 0;
    return 0;
}

/* 以下为内部静态辅助函数实现 */
static void DHT11_SetPinOutput(void) {
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    GPIO_InitStruct.GPIO_Pin = DHT11_GPIO_PIN;
    GPIO_InitStruct.GPIO_Mode = GPIO_Mode_Out_PP;
    GPIO_InitStruct.GPIO_Speed = GPIO_Speed_2MHz;
    GPIO_Init(DHT11_GPIO_PORT, &GPIO_InitStruct);
}

static void DHT11_SetPinInput(void) {
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    GPIO_InitStruct.GPIO_Pin = DHT11_GPIO_PIN;
    GPIO_InitStruct.GPIO_Mode = GPIO_Mode_IN_FLOATING; // 浮空输入，依赖外部上拉
    GPIO_Init(DHT11_GPIO_PORT, &GPIO_InitStruct);
}

/**
  * @brief  等待引脚达到指定状态，带超时功能
  * @param  state: 0-等待低电平， 1-等待高电平
  * @param  timeout_us: 超时时间（微秒）
  * @retval 1: 在超时前等到目标状态， 0: 超时
  */
static uint8_t DHT11_WaitForPinState(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, uint8_t state, uint32_t timeout_us) {
    uint32_t tickstart = GetMicrosecondTicks(); // 假设有获取微秒计数的函数
    while ((GPIO_ReadInputDataBit(GPIOx, GPIO_Pin) ? 1 : 0) != state) {
        if ((GetMicrosecondTicks() - tickstart) > timeout_us) {
            return 0; // 超时
        }
    }
    return 1; // 成功等到
}

/**
  * @brief  读取一个数据位
  * @retval 读取到的位值，0或1
  */
static uint8_t DHT11_ReadBit(void) {
    /* 等待位起始的50us低电平结束 */
    if (DHT11_WaitForPinState(DHT11_GPIO_PORT, DHT11_GPIO_PIN, 1, DHT11_BIT_START_TIMEOUT_US) == 0) {
        return 0xFF; // 错误标志，但外层应处理超时
    }

    /* 延时40us后采样引脚电平 */
    Delay_us(40);
    return GPIO_ReadInputDataBit(DHT11_GPIO_PORT, DHT11_GPIO_PIN) ? 1 : 0;
}

/**
  * @brief  读取一个字节数据
  */
static uint8_t DHT11_ReadByte(void) {
    uint8_t byte = 0;
    for (uint8_t i = 0; i < 8; i++) {
        byte <<= 1;
        byte |= DHT11_ReadBit();
    }
    return byte;
}

这份驱动代码的改进之处在于：

• 全面的超时机制：每个等待环节都有超时判断，防止程序卡死。
• 自动重试：在DHT11_ReadData函数内部集成了重试逻辑，提高了单次读取的可靠性。
• 结构化的数据返回：通过结构体返回数据，并包含校验状态。
• 模块化内部函数：每个函数职责单一，便于测试和维护。

4. 系统集成、调试与性能优化

驱动写好了，但把它融入一个完整的系统，并确保其长期稳定运行，还需要一些技巧。

4.1 在主循环中优雅地调用

避免在主循环中无延迟地频繁读取DHT11。DHT11两次测量之间需要至少1秒的间隔。一个常见的模式是使用状态机或基于SysTick的定时读取。

// 在主程序或某个任务中
DHT11_Data_t env_data = {0};
uint32_t last_read_time = 0;
const uint32_t read_interval_ms = 2000; // 每2秒读取一次

while (1) {
    uint32_t current_time = GetSystemTickMs(); // 获取系统毫秒时钟

    if ((current_time - last_read_time) > read_interval_ms) {
        if (DHT11_ReadData(&env_data)) {
            if (env_data.checksum_ok) {
                printf("Temperature: %d C, Humidity: %d %%\r\n",
                       env_data.temperature_integer,
                       env_data.humidity_integer);
                // 这里可以将数据发送到显示屏、无线模块或上传到服务器
            } else {
                printf("Checksum error!\r\n");
            }
        } else {
            printf("Failed to read from DHT11 after retries.\r\n");
            // 可以在这里触发硬件故障诊断，如检查电源、线路
        }
        last_read_time = current_time;
    }
    // ... 处理其他任务
}

4.2 高级调试技巧：当通信失败时

即使代码看起来完美，通信仍可能失败。以下是一些排查思路：

1. 示波器/逻辑分析仪是终极武器：这是最有效的方法。观察DATA线上的实际波形。

   • 检查起始信号的低电平时间是否足够（>18ms）？
   • 检查DHT11的响应脉冲（80us低+80us高）是否存在？
   • 检查数据位的波形，高电平时间是否明显区分出0和1（26-28us vs 70us）？
   • 观察总线空闲时是否为稳定的高电平？有无毛刺？

2. 软件模拟与日志输出：如果没有硬件工具，可以增加详细的调试日志。

   // 在DHT11_WaitForPinState等函数中增加调试
   #define DHT11_DEBUG 1
   if (DHT11_DEBUG) {
       printf("Waiting for pin %d to become %d...\n", pin, state);
   }
   // 超时后打印信息
   printf("Timeout occurred at function %s, line %d\n", __func__, __LINE__);
   

   通过串口观察程序卡在哪一步。

3. 检查系统时钟：确保你的STM32系统时钟（SYSCLK）配置正确，Delay_us函数是准确的。一个不准确的微秒延时是时序类驱动失败的常见原因。可以用一个简单的GPIO翻转程序，用示波器测量Delay_us(100)产生的脉冲宽度是否为100us来校准。

4. 电源与接地检查：用万用表测量DHT11的VCC引脚电压，确保是稳定的3.3V。检查所有GND连接是否牢固共地。尝试在靠近DHT11的电源引脚处并联一个10uF电解电容和一个0.1uF陶瓷电容，看是否改善。

4.3 性能与可靠性优化进阶

对于要求更高的应用，可以考虑以下优化：

• 中断法读取：将DATA引脚配置为外部中断模式。在DHT11开始发送数据位时，每个位起始的低电平都会触发中断。在中断服务例程中，开启一个高精度定时器（如TIM2），测量高电平的脉冲宽度，以此判断数据位。这种方法几乎不占用CPU时间，且时序测量极其精确，但代码复杂度较高。
• DMA+定时器捕获：更高级的做法是使用定时器的输入捕获功能配合DMA。将DATA引脚连接到定时器的输入捕获通道，配置DMA在捕获事件发生时自动将定时器计数器的值传输到内存数组。这样，一次完整的40位数据传输可以在硬件层面自动记录下每个边沿的时间戳，最后由CPU解析。这是实现超低CPU占用和高精度测量的工业级方案。
• 温度补偿与滤波：虽然DHT11精度有限，但可以通过软件滤波提升读数稳定性。例如，连续读取5次，去掉最大最小值后取平均。或者实现一个一阶低通数字滤波器（如 filtered_value = alpha * new_value + (1-alpha) * filtered_value），使显示值更平滑。

最终，我个人的经验是，对于DHT11这类传感器，硬件连接的可靠性占7成，软件时序的鲁棒性占3成。把上拉电阻焊好，电源处理好，导线尽量短，代码里加上超时和重试，项目基本就成功了。当你在一个实际产品中，看到它连续数月稳定地输出着温湿度数据时，你会觉得这些在时序和调试上花费的功夫都是值得的。