单片机与物联网 / 系统课时
读取温湿度传感器
读取温湿度传感器
本课以 SHT30 数字温湿度传感器为例,按照数据手册完成 I2C 命令发送、六字节数据读取、CRC 校验和定点数换算。最终程序会周期输出温度、湿度与错误状态,并能区分通信失败、校验失败和数值越界。
学习目标
- 根据数据手册确认地址、测量命令、等待时间和返回格式
- 完成原始数据读取、CRC-8 校验与温湿度换算
- 建立通信错误、校验错误和范围错误的处理路径
明确器件与数据格式
不同温湿度传感器的协议差异很大。本课选择 SHT30:默认 7 位 I2C 地址为 0x44,单次高重复性、无时钟拉伸测量命令为 0x2400。发送命令后等待至少 15 ms,再读取 6 字节数据。
返回数据依次为温度高字节、温度低字节、温度 CRC、湿度高字节、湿度低字节、湿度 CRC。CRC-8 初值为 0xFF,多项式为 0x31。只有两组 CRC 都通过后,原始值才可参与换算。温度和相对湿度的换算关系为:
为了避免嵌入式格式化浮点数带来的额外代码体积,示例把温度和湿度保存为百分之一单位,例如 2534 表示 25.34 ℃。

实现读取与校验
下面代码是可复用驱动片段,依赖 CubeMX 已生成并初始化 hi2c1。返回结构体使用定点数,既方便串口输出,也适合后续阈值判断和数据显示。
#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 初始化函数;动态测量值会随环境变化。
#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> 为运行时动态值。
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 规则。应重新从数据手册确认物理接口、启动时序、返回长度、校验算法和换算公式,只保留本课的“通信、校验、换算、判错”处理框架。