单片机与物联网 / 系统课时

读取温湿度传感器

读取温湿度传感器

本课以 SHT30 数字温湿度传感器为例,按照数据手册完成 I2C 命令发送、六字节数据读取、CRC 校验和定点数换算。最终程序会周期输出温度、湿度与错误状态,并能区分通信失败、校验失败和数值越界。

学习目标

  • 根据数据手册确认地址、测量命令、等待时间和返回格式
  • 完成原始数据读取、CRC-8 校验与温湿度换算
  • 建立通信错误、校验错误和范围错误的处理路径

明确器件与数据格式

不同温湿度传感器的协议差异很大。本课选择 SHT30:默认 7 位 I2C 地址为 0x44,单次高重复性、无时钟拉伸测量命令为 0x2400。发送命令后等待至少 15 ms,再读取 6 字节数据。

返回数据依次为温度高字节、温度低字节、温度 CRC、湿度高字节、湿度低字节、湿度 CRC。CRC-8 初值为 0xFF,多项式为 0x31。只有两组 CRC 都通过后,原始值才可参与换算。温度和相对湿度的换算关系为:

T=−45+175×ST65535T=-45+175\times\frac{S_T}{65535}
RH=100×SRH65535RH=100\times\frac{S_{RH}}{65535}

为了避免嵌入式格式化浮点数带来的额外代码体积,示例把温度和湿度保存为百分之一单位,例如 2534 表示 25.34 ℃。

SHT30 温湿度采集与异常分支流程

实现读取与校验

下面代码是可复用驱动片段,依赖 CubeMX 已生成并初始化 hi2c1。返回结构体使用定点数,既方便串口输出,也适合后续阈值判断和数据显示。

c
#include "main.h"
#include <stdint.h>
#include <stddef.h>

extern I2C_HandleTypeDef hi2c1;

#define SHT30_ADDR (0x44U << 1)

typedef enum {
    SHT30_OK = 0,
    SHT30_ERR_TX,
    SHT30_ERR_RX,
    SHT30_ERR_CRC,
    SHT30_ERR_RANGE
} SHT30_Status;

typedef struct {
    int32_t temperature_centi_c;
    uint32_t humidity_centi_pct;
} SHT30_Data;

static uint8_t SHT30_Crc8(const uint8_t *data, uint8_t length)
{
    uint8_t crc = 0xFF;

    for (uint8_t i = 0; i < length; ++i) {
        crc ^= data[i];

        for (uint8_t bit = 0; bit < 8U; ++bit) {
            crc = (crc & 0x80U) != 0U
                ? (uint8_t)((crc << 1U) ^ 0x31U)
                : (uint8_t)(crc << 1U);
        }
    }

    return crc;
}

SHT30_Status SHT30_Read(SHT30_Data *result)
{
    if (result == NULL) {
        return SHT30_ERR_RANGE;
    }

    const uint8_t command[2] = {0x24, 0x00};
    uint8_t raw[6];

    if (HAL_I2C_Master_Transmit(
            &hi2c1, SHT30_ADDR, (uint8_t *)command, sizeof(command), 100
        ) != HAL_OK) {
        return SHT30_ERR_TX;
    }

    HAL_Delay(20);

    if (HAL_I2C_Master_Receive(
            &hi2c1, SHT30_ADDR, raw, sizeof(raw), 100
        ) != HAL_OK) {
        return SHT30_ERR_RX;
    }

    if (SHT30_Crc8(&raw[0], 2) != raw[2] ||
        SHT30_Crc8(&raw[3], 2) != raw[5]) {
        return SHT30_ERR_CRC;
    }

    uint16_t raw_temperature =
        (uint16_t)(((uint16_t)raw[0] << 8U) | raw[1]);
    uint16_t raw_humidity =
        (uint16_t)(((uint16_t)raw[3] << 8U) | raw[4]);

    // 使用四舍五入的整数运算,单位分别为 0.01 ℃ 和 0.01 %RH。
    int32_t temperature =
        -4500 + (int32_t)((17500LL * raw_temperature + 32767LL) / 65535LL);
    uint32_t humidity =
        (uint32_t)((10000ULL * raw_humidity + 32767ULL) / 65535ULL);

    if (temperature < -4000 || temperature > 12500 || humidity > 10000U) {
        return SHT30_ERR_RANGE;
    }

    result->temperature_centi_c = temperature;
    result->humidity_centi_pct = humidity;
    return SHT30_OK;
}

该函数先完成总线事务,再校验数据完整性,最后换算并检查范围。任何一步失败都不会把未验证的数据写入结果结构体,调用方可以继续保留上一次有效值。

周期读取并输出

下面入口代码使用 USART2 输出测量结果。它依赖 CubeMX 生成的时钟、GPIO、I2C1 和 USART2 初始化函数;动态测量值会随环境变化。

c
#include "main.h"
#include <stdio.h>
#include <string.h>

extern UART_HandleTypeDef huart2;

typedef enum {
    SHT30_OK = 0,
    SHT30_ERR_TX,
    SHT30_ERR_RX,
    SHT30_ERR_CRC,
    SHT30_ERR_RANGE
} SHT30_Status;

typedef struct {
    int32_t temperature_centi_c;
    uint32_t humidity_centi_pct;
} SHT30_Data;

SHT30_Status SHT30_Read(SHT30_Data *result);

static void UART_Print(const char *text)
{
    HAL_UART_Transmit(
        &huart2, (uint8_t *)text, (uint16_t)strlen(text), 100
    );
}

int main(void)
{
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_I2C1_Init();
    MX_USART2_UART_Init();

    char line[96];
    SHT30_Data data;

    while (1) {
        SHT30_Status status = SHT30_Read(&data);

        if (status == SHT30_OK) {
            int32_t absolute_temperature =
                data.temperature_centi_c < 0
                ? -data.temperature_centi_c
                : data.temperature_centi_c;
            char sign = data.temperature_centi_c < 0 ? '-' : '+';

            snprintf(
                line, sizeof(line),
                "T=%c%ld.%02ld C, RH=%lu.%02lu %%, status=OK\r\n",
                sign,
                (long)(absolute_temperature / 100),
                (long)(absolute_temperature % 100),
                (unsigned long)(data.humidity_centi_pct / 100U),
                (unsigned long)(data.humidity_centi_pct % 100U)
            );
        } else {
            snprintf(
                line, sizeof(line),
                "SHT30 read failed, status=%d\r\n",
                (int)status
            );
        }

        UART_Print(line);
        HAL_Delay(1000);
    }
}

预期输出格式如下,<TEMP>、<HUMIDITY> 和 <STATUS> 为运行时动态值。

text
T=<TEMP> C, RH=<HUMIDITY> %, status=OK
SHT30 read failed, status=<STATUS>

正常情况下只会周期出现第一类输出。第二类输出用于断线、总线异常、CRC 错误或范围错误,状态编号与枚举顺序一致。

异常判断与恢复

状态 含义 建议处理
SHT30_ERR_TX 测量命令未发送成功 检查地址、接线、上拉和总线占用
SHT30_ERR_RX 未在超时内收到 6 字节 增加等待时间,检查传感器供电
SHT30_ERR_CRC 数据在传输中损坏 丢弃本次数据并重读,不要继续换算
SHT30_ERR_RANGE 参数为空或换算值越界 检查缓冲区、器件型号和公式

实际项目不应因为一次失败立即判定传感器损坏。可以记录连续失败次数,例如连续 3 次失败后重新初始化 I2C,连续 10 次失败再上报告警;恢复后清零计数器。这样能避免瞬时干扰导致频繁复位。

验证与边界

验证时先在室温环境观察数值是否稳定,再用手掌靠近传感器,温度和湿度应逐渐变化而不是瞬间跳到固定极值。拔掉 SDA 或传感器电源后,程序应输出发送或接收错误;恢复接线后,应能在后续周期重新读到正常数据。

若使用 DHT11、AHT20 或其他器件,不能直接复用本课命令、等待时间和 CRC 规则。应重新从数据手册确认物理接口、启动时序、返回长度、校验算法和换算公式,只保留本课的“通信、校验、换算、判错”处理框架。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读取温湿度传感器

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通