STM32CubeMX+HAL库驱动SHT31温湿度传感器（附完整代码与CRC校验避坑指南）

STM32CubeMXHAL库驱动SHT31温湿度传感器实战指南在嵌入式开发领域快速实现传感器数据采集一直是工程师关注的重点。传统开发方式需要手动配置寄存器、编写底层驱动不仅耗时耗力还容易因细节疏忽导致通信失败。本文将展示如何利用STM32CubeMX图形化工具和HAL库快速构建SHT31温湿度传感器的完整驱动方案。1. 环境搭建与CubeMX工程配置1.1 硬件准备与CubeMX初始化在开始前确保已准备好以下硬件STM32开发板以NUCLEO-F401RE为例SHT31传感器模块I2C接口杜邦线若干打开STM32CubeMX选择对应型号的MCU首先配置时钟系统在Pinout Configuration选项卡中设置HSE时钟源进入Clock Configuration界面配置系统时钟为最大允许值F401RE可配置为84MHz1.2 I2C外设配置关键步骤SHT31通过I2C接口通信CubeMX中的配置要点如下参数项推荐值说明I2C ModeI2C标准模式Speed ModeStandard Mode100kHz速率Clock Stretch ModeEnabled支持时钟延展Primary Slave Address0x44SHT31默认地址注意实际使用中若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 0x441 #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(rxData3, 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; // 应设为DISABLE3.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Ω