1. 项目概述与环境准备

大家好，今天我来分享一个非常实用的STM32项目——使用HAL库驱动DHT11温湿度传感器。这个项目特别适合刚接触嵌入式开发的朋友，我会从最基础的部分开始讲解，确保每个人都能轻松上手。

DHT11是一款性价比极高的数字温湿度传感器，它采用单总线通信协议，只需要一个GPIO引脚就能同时获取温度和湿度数据。在实际项目中，我经常用它来做环境监测、智能家居或者物联网设备的数据采集模块。相比其他传感器，DHT11的最大优势就是简单易用，成本低廉，特别适合初学者练手。

在开始编码之前，我们需要准备以下硬件和软件环境：

• STM32开发板（我使用的是STM32F103系列，但其他系列也完全适用）
• DHT11温湿度传感器模块
• STM32CubeMX配置工具
• Keil MDK或者STM32CubeIDE开发环境
• USB转串口模块（用于数据输出和调试）

接线方面非常简单，DHT11只有三个引脚需要连接：VCC接3.3V或5V（DHT11支持3-5.5V宽电压），GND接地，DATA引脚接STM32的任意GPIO口（我这里用的是PA6）。记得在DATA线上加一个4.7K或5K的上拉电阻，这是保证通信稳定的关键。

2. CubeMX工程配置

打开STM32CubeMX，我们先来配置基础的外设。首先选择正确的STM32型号，然后启用外部高速时钟（HSE）作为系统时钟源。这样能确保系统时钟的准确性，对后续的微秒级延时很关键。

接下来配置GPIO引脚。我选择PA6作为数据线，初始模式设置为推挽输出（Output Push Pull），上拉模式（Pull-up），这样能确保总线在空闲时保持高电平。速度选择中等（Medium）就足够了，不需要设置得太高。

然后配置一个定时器用于微秒延时。我选择TIM2，因为它是32位通用定时器，可以避免计数溢出问题。在时钟树配置中，确保APB1定时器时钟为72MHz（如果你的芯片不同，时钟频率可能会有所区别）。将预分频系数设置为72-1，这样定时器时钟就是1MHz，每个计数正好是1微秒。计数模式选择向上计数，自动重装载值设为最大值0xFFFFFFFF。

最后启用USART1作为串口输出，模式选择异步通信（Asynchronous），波特率设为115200，数据位8位，无校验位，停止位1位。这样配置后，我们就可以通过printf函数将温湿度数据输出到串口了。

完成所有配置后，生成工程代码，选择你熟悉的开发工具链（MDK-ARM或STM32CubeIDE）。

3. 微秒延时函数实现

在HAL库中，虽然有HAL_Delay()函数提供毫秒级延时，但没有现成的微秒延时函数。而DHT11的通信时序要求精确到微秒级别，所以我们需要自己实现一个高精度的微秒延时函数。

这里我使用定时器来实现微秒延时，相比循环计数的方式更加精确和可靠。下面是完整的实现代码：

#include "stm32f1xx_hal.h"

static TIM_HandleTypeDef htim2;

void delay_us(uint32_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);
}

这个函数的原理很简单：先重置定时器计数器为0，然后启动定时器，在循环中不断检查计数器值，直到达到指定的微秒数后停止定时器。我在实际测试中发现，这种方法的精度可以控制在±0.5us以内，完全满足DHT11的时序要求。

有几点需要特别注意：首先，一定要使用32位定时器，避免计数溢出问题。其次，在调用延时函数前确保定时器已经初始化完成。最后，如果系统中还有其他中断服务程序，可能会影响延时的精确性，这时可以考虑在延时期间暂时关闭中断。

4. DHT11驱动代码实现

DHT11的驱动代码是整个项目的核心，它包含了初始化、开始信号发送、数据读取等功能。让我来详细讲解每个部分的实现细节。

首先定义硬件相关的宏和引脚：

#define DHT11_PORT GPIOA
#define DHT11_PIN GPIO_PIN_6

#define DHT11_HIGH() HAL_GPIO_WritePin(DHT11_PORT, DHT11_PIN, GPIO_PIN_SET)
#define DHT11_LOW() HAL_GPIO_WritePin(DHT11_PORT, DHT11_PIN, GPIO_PIN_RESET)
#define DHT11_READ() HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN)

接下来是GPIO模式切换函数。DHT11通信需要在不同时刻切换引脚的输入输出模式：

void DHT11_GPIO_Output(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    GPIO_InitStruct.Pin = DHT11_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_PULLUP;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_MEDIUM;
    HAL_GPIO_Init(DHT11_PORT, &GPIO_InitStruct);
}

void DHT11_GPIO_Input(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    GPIO_InitStruct.Pin = DHT11_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
    GPIO_InitStruct.Pull = GPIO_PULLUP;
    HAL_GPIO_Init(DHT11_PORT, &GPIO_InitStruct);
}

然后是发送开始信号的函数。这个函数负责初始化与DHT11的通信：

uint8_t DHT11_Start(void)
{
    uint8_t retry = 0;
    
    DHT11_GPIO_Output();
    DHT11_LOW();
    delay_us(18000);  // 拉低至少18ms
    
    DHT11_HIGH();
    delay_us(30);     // 拉高20-40us
    
    DHT11_GPIO_Input();
    
    // 等待DHT11响应
    while (DHT11_READ() == 1)
    {
        delay_us(1);
        if (++retry > 100) return 0;
    }
    
    retry = 0;
    while (DHT11_READ() == 0)
    {
        delay_us(1);
        if (++retry > 100) return 0;
    }
    
    retry = 0;
    while (DHT11_READ() == 1)
    {
        delay_us(1);
        if (++retry > 100) return 0;
    }
    
    return 1;
}

数据读取部分包括位读取和字节读取两个函数：

uint8_t DHT11_Read_Bit(void)
{
    uint8_t retry = 0;
    
    while (DHT11_READ() == 0)
    {
        delay_us(1);
        if (++retry > 100) return 0;
    }
    
    delay_us(40);  // 等待40us后判断电平高低
    
    if (DHT11_READ() == 1)
    {
        return 1;
    }
    else
    {
        return 0;
    }
}

uint8_t DHT11_Read_Byte(void)
{
    uint8_t i, byte = 0;
    
    for (i = 0; i < 8; i++)
    {
        byte <<= 1;
        byte |= DHT11_Read_Bit();
    }
    
    return byte;
}

最后是完整的数据读取函数，包含校验和验证：

uint8_t DHT11_Read_Data(uint8_t *temperature, uint8_t *humidity)
{
    uint8_t buf[5];
    uint8_t i;
    
    if (DHT11_Start() == 0)
    {
        return 0;
    }
    
    for (i = 0; i < 5; i++)
    {
        buf[i] = DHT11_Read_Byte();
    }
    
    DHT11_GPIO_Output();
    DHT11_HIGH();
    
    // 校验数据
    if (buf[0] + buf[1] + buf[2] + buf[3] == buf[4])
    {
        *humidity = buf[0];
        *temperature = buf[2];
        return 1;
    }
    
    return 0;
}

在实际编写代码时，我踩过一个坑：没有及时初始化变量导致数据读取错误。所以大家一定要养成良好的编程习惯，所有变量在使用前都要初始化。

5. 串口输出与数据格式化

现在我们已经能够从DHT11读取数据了，接下来需要将这些数据通过串口输出，方便我们查看和记录。首先需要重定向printf函数，让它可以输出到串口。

在usart.c文件中添加以下代码：

#include <stdio.h>

int __io_putchar(int ch)
{
    HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, HAL_MAX_DELAY);
    return ch;
}

然后在工程设置中勾选"Use MicroLIB"选项，这样就能使用标准printf函数了。有些开发环境可能需要不同的重定向方法，但基本原理都是一样的。

接下来在main函数中初始化所有外设，然后循环读取和输出数据：

int main(void)
{
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_USART1_UART_Init();
    MX_TIM2_Init();
    
    uint8_t temperature = 0;
    uint8_t humidity = 0;
    
    printf("DHT11温湿度监测系统启动成功\r\n");
    printf("==========================\r\n");
    
    while (1)
    {
        if (DHT11_Read_Data(&temperature, &humidity))
        {
            printf("温度: %d℃ 湿度: %d%%RH\r\n", temperature, humidity);
        }
        else
        {
            printf("传感器读取失败，请检查连接\r\n");
        }
        
        HAL_Delay(2000);  // 每2秒读取一次
    }
}

为了提升输出数据的可读性，我建议添加一些格式化元素。比如可以添加时间戳、数据分隔线，甚至可以用ASCII字符制作简单的表格边框。如果需要更复杂的数据处理，还可以考虑将数据转换为JSON格式，方便其他系统调用。

在实际使用中，我发现串口输出偶尔会出现乱码，这通常是波特率不匹配造成的。确保你的串口调试工具设置的波特率与代码中的设置一致（都是115200）。另外，长距离传输时建议添加奇偶校验位，提高数据传输的可靠性。

6. 常见问题与调试技巧

在开发过程中，大家可能会遇到各种问题。我这里总结了一些常见的情况和解决方法，希望能帮大家少走弯路。

首先是最常见的传感器无响应问题。如果每次读取都失败，首先检查硬件连接是否正确，VCC和GND有没有接反，DATA线是否接触良好。然后检查上拉电阻是否连接，DHT11需要4.7K-10K的上拉电阻才能正常工作。如果硬件没问题，就要检查时序是否正确，特别是开始信号中的18ms低电平时长一定要足够。

数据校验失败是另一个常见问题。如果偶尔读取失败但多数时候正常，可能是时序不够精确造成的。可以尝试调整微秒延时函数的精度，或者检查系统中是否有其他中断影响了时序。如果总是校验失败，可能是传感器本身有问题，可以换一个传感器试试。

电源稳定性也很重要。DHT11对电源波动比较敏感，建议在VCC和GND之间加一个100nF的滤波电容。我在实际项目中就遇到过因为电源噪声导致数据不稳定的情况，添加电容后问题就解决了。

对于调试，我推荐使用逻辑分析仪来观察实际的通信波形。如果没有逻辑分析仪，也可以用示波器或者甚至用另一个GPIO口来模拟输出调试信号。比如可以在关键代码段设置GPIO电平变化，然后用示波器观察执行时间。

还有一个实用的技巧是添加超时机制。在等待DHT11响应的循环中，一定要添加超时判断，避免程序卡死。我上面的代码中已经包含了这个机制，但超时时间可以根据实际情况调整。

最后提醒大家，DHT11的测量精度和环境温度有关。在极端温度条件下，测量结果可能会有较大偏差。如果项目对精度要求很高，可以考虑使用更高级的传感器如DHT22或SHT系列。

7. 项目优化与扩展应用

基础功能实现后，我们可以考虑对项目进行一些优化和扩展，让它更加实用和强大。

首先可以考虑添加均值滤波算法。原始传感器数据可能会有一些波动，通过计算多次测量的平均值，可以得到更加稳定的读数。我通常使用简单的移动平均算法，取最近5-10次测量的平均值：

#define SAMPLE_SIZE 8

uint8_t temp_samples[SAMPLE_SIZE];
uint8_t humi_samples[SAMPLE_SIZE];
uint8_t sample_index = 0;

void update_samples(uint8_t temp, uint8_t humi)
{
    temp_samples[sample_index] = temp;
    humi_samples[sample_index] = humi;
    sample_index = (sample_index + 1) % SAMPLE_SIZE;
}

uint8_t calculate_average(uint8_t *samples)
{
    uint16_t sum = 0;
    for (int i = 0; i < SAMPLE_SIZE; i++)
    {
        sum += samples[i];
    }
    return sum / SAMPLE_SIZE;
}

另一个有用的优化是添加异常值检测。如果某次测量结果与之前的值差异太大，可以将其视为异常值并丢弃，避免影响整体数据质量。

在扩展应用方面，可以考虑将数据输出到OLED显示屏，这样就不需要一直连接电脑查看数据了。或者添加蓝牙/WiFi模块，将数据无线传输到手机或云平台。我最近做的一个项目就是使用ESP8266将DHT11数据上传到物联网平台，实现远程环境监控。

如果需要同时监控多个点的温湿度，可以使用多个DHT11传感器。每个传感器连接到不同的GPIO口，通过分时复用的方式轮流读取数据。注意要给每个传感器添加独立的上拉电阻。

对于低功耗应用，可以调整读取频率。DHT11每次读取后需要一段时间才能进行下一次测量，在电池供电的场景下，可以降低读取频率，大部分时间让MCU进入睡眠模式，显著降低功耗。

最后，建议添加一些诊断功能，比如传感器状态检测、数据质量评估等。这些功能在长期部署时非常有用，可以帮助及时发现和解决问题。