STM32CubeMX+HAL库驱动SHT31温湿度传感器（附完整代码与CRC校验避坑指南）
STM32CubeMX+HAL库驱动SHT31温湿度传感器实战指南
在嵌入式开发领域，快速实现传感器数据采集一直是工程师关注的重点。传统开发方式需要手动配置寄存器、编写底层驱动，不仅耗时耗力，还容易因细节疏忽导致通信失败。本文将展示如何利用STM32CubeMX图形化工具和HAL库，快速构建SHT31温湿度传感器的完整驱动方案。
1. 环境搭建与CubeMX工程配置
1.1 硬件准备与CubeMX初始化
在开始前，确保已准备好以下硬件：
- STM32开发板（以NUCLEO-F401RE为例）
- SHT31传感器模块（I2C接口）
- 杜邦线若干
打开STM32CubeMX，选择对应型号的MCU，首先配置时钟系统：
- 在Pinout & Configuration选项卡中设置HSE时钟源
- 进入Clock Configuration界面，配置系统时钟为最大允许值（F401RE可配置为84MHz）
1.2 I2C外设配置关键步骤
SHT31通过I2C接口通信，CubeMX中的配置要点如下：
| 参数项 | 推荐值 | 说明 |
|---|---|---|
| I2C Mode | I2C | 标准模式 |
| Speed Mode | Standard Mode | 100kHz速率 |
| Clock Stretch Mode | Enabled | 支持时钟延展 |
| Primary Slave Address | 0x44 | SHT31默认地址 |
注意：实际使用中若ADDR引脚接高电平，需将地址改为0x45。CubeMX会自动计算7位地址对应的HAL库宏定义。
配置完成后生成代码，CubeMX会自动生成以下关键初始化代码：
static void MX_I2C1_Init(void) { hi2c1.Instance = I2C1; hi2c1.Init.ClockSpeed = 100000; hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2; hi2c1.Init.OwnAddress1 = 0; hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT; hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE; hi2c1.Init.OwnAddress2 = 0; hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE; hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE; if (HAL_I2C_Init(&hi2c1) != HAL_OK) { Error_Handler(); } }2. HAL库驱动实现
2.1 传感器初始化流程
SHT31需要发送特定命令启动测量，创建sht31.c文件实现初始化函数：
#define SHT31_ADDR 0x44<<1 #define CMD_SOFT_RESET 0x30A2 #define CMD_MEAS_HIGHREP 0x2400 HAL_StatusTypeDef SHT31_Init(I2C_HandleTypeDef *hi2c) { uint8_t cmd[2]; // 软件复位 cmd[0] = CMD_SOFT_RESET >> 8; cmd[1] = CMD_SOFT_RESET & 0xFF; HAL_I2C_Master_Transmit(hi2c, SHT31_ADDR, cmd, 2, HAL_MAX_DELAY); HAL_Delay(20); // 启动高精度测量模式 cmd[0] = CMD_MEAS_HIGHREP >> 8; cmd[1] = CMD_MEAS_HIGHREP & 0xFF; return HAL_I2C_Master_Transmit(hi2c, SHT31_ADDR, cmd, 2, HAL_MAX_DELAY); }2.2 数据读取与CRC校验
SHT31返回的数据包含CRC校验字节，必须验证数据有效性：
uint8_t SHT31_CheckCRC(uint8_t *data, uint8_t len) { const uint8_t POLY = 0x31; uint8_t crc = 0xFF; for(uint8_t i = 0; i < len; i++) { crc ^= data[i]; for(uint8_t bit = 0; bit < 8; bit++) { if(crc & 0x80) { crc = (crc << 1) ^ POLY; } else { crc <<= 1; } } } return crc; } HAL_StatusTypeDef SHT31_ReadTempHumid(I2C_HandleTypeDef *hi2c, float *temp, float *humid) { uint8_t rxData[6]; uint8_t cmd[2] = {0xE0, 0x00}; // 读取数据命令 // 发送读取命令 if(HAL_I2C_Master_Transmit(hi2c, SHT31_ADDR, cmd, 2, 100) != HAL_OK) return HAL_ERROR; // 读取6字节数据（温度+CRC，湿度+CRC） if(HAL_I2C_Master_Receive(hi2c, SHT31_ADDR, rxData, 6, 100) != HAL_OK) return HAL_ERROR; // 校验温度数据 if(SHT31_CheckCRC(rxData, 2) != rxData[2]) return HAL_ERROR; // 校验湿度数据 if(SHT31_CheckCRC(rxData+3, 2) != rxData[5]) return HAL_ERROR; // 数据转换 *temp = -45 + 175 * ((rxData[0] << 8 | rxData[1]) / 65535.0f); *humid = 100 * ((rxData[3] << 8 | rxData[4]) / 65535.0f); return HAL_OK; }3. 典型问题排查与优化
3.1 I2C通信失败常见原因
根据实际项目经验，HAL库驱动SHT31时常见问题包括：
时序问题：
- 上电后立即通信导致失败 → 添加至少20ms延时
- 连续读取间隔不足 → 高精度模式需至少15ms间隔
硬件连接问题：
- 忘记连接上拉电阻（典型值4.7kΩ）
- SDA/SCL线序接反
配置错误：
// 错误配置示例：未启用时钟延展 hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_ENABLE; // 应设为DISABLE
3.2 性能优化技巧
对于需要高频采集的应用，可采用以下优化策略：
DMA传输：修改CubeMX配置，为I2C接口启用DMA
// 在CubeMX中添加I2C RX/TX DMA请求 // 修改读取函数使用DMA版本 HAL_I2C_Master_Receive_DMA(&hi2c1, SHT31_ADDR, rxData, 6);低功耗模式：利用SHT31的单次测量模式，配合MCU的STOP模式
// 单次测量命令 uint8_t cmd[2] = {0x24, 0x16}; // 1次高精度测量后进入休眠
4. 完整应用示例
4.1 主程序框架
int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_I2C1_Init(); float temp, humid; if(SHT31_Init(&hi2c1) != HAL_OK) { printf("Sensor init failed!\r\n"); while(1); } while (1) { if(SHT31_ReadTempHumid(&hi2c1, &temp, &humid) == HAL_OK) { printf("Temp: %.2fC, Humid: %.2f%%\r\n", temp, humid); } else { printf("Read error!\r\n"); } HAL_Delay(2000); } }4.2 调试输出建议
通过串口输出调试信息时，推荐格式：
[I2C] Status: OK | Temp: 25.34C | Humid: 56.78% [CRC] Temp check: PASS (0x3A) | Humid check: PASS (0x7C)实际项目中遇到过最棘手的问题是CRC校验偶尔失败，后来发现是I2C总线受到电源干扰。解决方法包括：
- 在传感器电源引脚添加10μF去耦电容
- 缩短I2C走线长度
- 将上拉电阻从10kΩ改为4.7kΩ