STM32 HAL库驱动SHT30温湿度传感器，从零开始手把手教你搞定I2C通信（附完整代码）
STM32 HAL库驱动SHT30温湿度传感器实战指南
在物联网和智能硬件开发中，环境监测是最基础也最关键的环节之一。SHT30作为新一代数字温湿度传感器，凭借其±2%RH的湿度精度和±0.2℃的温度精度，成为许多专业级应用的首选。本文将完整展示如何利用STM32CubeMX和HAL库快速构建一个稳定可靠的SHT30驱动方案，相比传统的标准库和模拟I2C方式，HAL库的硬件I2C接口能大幅降低开发复杂度，提升代码可维护性。
1. 硬件准备与CubeMX配置
1.1 硬件连接要点
SHT30采用标准的I2C接口，硬件连接时需注意：
- 电源引脚：VDD接3.3V，GND接地
- 信号引脚：SCL接STM32的I2C时钟线，SDA接数据线
- 上拉电阻：SCL和SDA线需接4.7kΩ上拉电阻至3.3V
提示：SHT30的7位设备地址为0x44（ADDR引脚接GND）或0x45（ADDR引脚接VDD）
1.2 CubeMX图形化配置
- 新建工程选择对应STM32型号
- 在Pinout视图中启用I2C外设（通常为I2C1）
- 配置I2C参数：
I2C Mode: I2C Clock Speed: 400 kHz (Fast Mode) Duty Cycle: 2 - 配置GPIO模式为开漏输出（GPIO_MODE_AF_OD）
- 生成代码前确保在Project Manager中勾选"Generate peripheral initialization as a pair of .c/.h files"
2. HAL库I2C通信实现
2.1 HAL库I2C函数解析
HAL库提供了完整的I2C传输函数，主要使用以下三个核心API：
HAL_StatusTypeDef HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout); HAL_StatusTypeDef HAL_I2C_Master_Receive(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout); HAL_StatusTypeDef HAL_I2C_Mem_Write(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout);2.2 SHT30指令封装
SHT30支持多种测量模式，我们封装最常用的单次高精度测量指令：
#define SHT30_ADDR 0x44 << 1 // HAL库要求左移1位 typedef enum { SHT30_SINGLE_HIGH = 0x2400, SHT30_SINGLE_MEDIUM = 0x240B, SHT30_SINGLE_LOW = 0x2416 } SHT30_MeasureMode; uint8_t SHT30_StartMeasurement(I2C_HandleTypeDef *hi2c, SHT30_MeasureMode mode) { uint8_t cmd[2]; cmd[0] = (mode >> 8) & 0xFF; // 高字节 cmd[1] = mode & 0xFF; // 低字节 return HAL_I2C_Master_Transmit(hi2c, SHT30_ADDR, cmd, 2, 100) == HAL_OK; }3. 数据读取与CRC校验
3.1 原始数据读取实现
SHT30每次测量返回6字节数据，包含温度、湿度及各自的CRC校验码：
typedef struct { float temperature; float humidity; uint8_t temp_crc_valid; uint8_t humi_crc_valid; } SHT30_Data; HAL_StatusTypeDef SHT30_ReadData(I2C_HandleTypeDef *hi2c, SHT30_Data *result) { uint8_t raw_data[6]; HAL_StatusTypeDef status; status = HAL_I2C_Master_Receive(hi2c, SHT30_ADDR | 0x01, raw_data, 6, 100); if(status != HAL_OK) return status; // 温度数据校验 result->temp_crc_valid = (SHT30_CheckCRC(&raw_data[0], 2) == raw_data[2]); if(result->temp_crc_valid) { uint16_t temp_raw = (raw_data[0] << 8) | raw_data[1]; result->temperature = -45 + 175 * (temp_raw / 65535.0f); } // 湿度数据校验 result->humi_crc_valid = (SHT30_CheckCRC(&raw_data[3], 2) == raw_data[5]); if(result->humi_crc_valid) { uint16_t humi_raw = (raw_data[3] << 8) | raw_data[4]; result->humidity = 100 * (humi_raw / 65535.0f); } return HAL_OK; }3.2 CRC-8校验算法实现
SHT30使用特定的CRC-8多项式进行数据校验：
uint8_t SHT30_CheckCRC(uint8_t *data, uint8_t len) { uint8_t crc = 0xFF; uint8_t i, j; for(i = 0; i < len; i++) { crc ^= data[i]; for(j = 0; j < 8; j++) { crc = (crc & 0x80) ? (crc << 1) ^ 0x31 : (crc << 1); } } return crc; }4. 完整工程实现与优化
4.1 工程架构设计
推荐采用模块化设计，工程包含以下关键文件：
sht30.h/c：传感器驱动核心i2c_hal.h/c：I2C硬件抽象层main.c：应用逻辑
4.2 典型应用流程
// 在main函数中的典型调用流程 I2C_HandleTypeDef hi2c1; SHT30_Data sensor_data; int main(void) { HAL_Init(); SystemClock_Config(); MX_I2C1_Init(); while(1) { if(SHT30_StartMeasurement(&hi2c1, SHT30_SINGLE_HIGH)) { HAL_Delay(20); // 等待测量完成 if(SHT30_ReadData(&hi2c1, &sensor_data) == HAL_OK) { if(sensor_data.temp_crc_valid && sensor_data.humi_crc_valid) { printf("Temp: %.2fC, Humi: %.2f%%\r\n", sensor_data.temperature, sensor_data.humidity); } } } HAL_Delay(1000); } }4.3 性能优化技巧
- DMA传输：对于频繁读取的场景，可配置I2C使用DMA减少CPU开销
- 低功耗模式：在两次测量间让MCU进入STOP模式
- 错误恢复：添加I2C总线复位机制应对异常情况
void I2C_ResetBus(I2C_HandleTypeDef *hi2c) { GPIO_InitTypeDef GPIO_InitStruct = {0}; // 1. 配置SDA/SCL为普通GPIO输出 GPIO_InitStruct.Pin = hi2c->Instance == I2C1 ? GPIO_PIN_6|GPIO_PIN_7 : GPIO_PIN_10|GPIO_PIN_11; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct); // 2. 模拟I2C总线复位时序 HAL_GPIO_WritePin(GPIOB, hi2c->Instance == I2C1 ? GPIO_PIN_6|GPIO_PIN_7 : GPIO_PIN_10|GPIO_PIN_11, GPIO_PIN_SET); HAL_Delay(1); for(int i=0; i<9; i++) { HAL_GPIO_WritePin(GPIOB, hi2c->Instance == I2C1 ? GPIO_PIN_7 : GPIO_PIN_11, GPIO_PIN_RESET); HAL_Delay(1); HAL_GPIO_WritePin(GPIOB, hi2c->Instance == I2C1 ? GPIO_PIN_7 : GPIO_PIN_11, GPIO_PIN_SET); HAL_Delay(1); } // 3. 重新初始化I2C外设 HAL_I2C_Init(hi2c); }5. 常见问题排查
5.1 I2C通信失败排查步骤
- 检查硬件连接：确认电源、上拉电阻、信号线连接正确
- 用逻辑分析仪捕获I2C波形，观察起始条件、地址和ACK
- 检查I2C时钟配置是否超出传感器支持范围
- 尝试降低I2C时钟频率（如切换到100kHz标准模式）
5.2 数据异常处理方案
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| CRC校验失败 | 数据传输错误 | 检查I2C信号质量，降低通信速率 |
| 温度值固定 | 传感器未正确初始化 | 确认发送了正确的测量命令 |
| 湿度值跳变 | 电源噪声干扰 | 增加电源滤波电容，缩短传感器供电走线 |
实际项目中，我发现SHT30对电源质量较为敏感，建议在VDD引脚就近放置0.1μF去耦电容。另外，当通信线长度超过20cm时，应考虑使用I2C缓冲器或降低通信速率至100kHz以下。