手把手教你用STM32的HAL库驱动SHT30温湿度传感器（附完整代码）
手把手教你用STM32的HAL库驱动SHT30温湿度传感器（附完整代码）
在嵌入式开发中，温湿度传感器是环境监测系统的核心组件之一。SHT30作为一款高精度、低功耗的数字温湿度传感器，凭借其I2C接口和出色的性能，成为STM32开发者的热门选择。本文将带你从零开始，使用STM32CubeMX和HAL库实现SHT30的完整驱动，解决实际开发中的常见问题，并提供可直接移植的代码模块。
1. 环境准备与硬件连接
1.1 硬件配置要点
SHT30传感器与STM32的连接非常简单，只需要4根线：
- VCC：接3.3V电源
- GND：接地
- SCL：接STM32的I2C时钟线
- SDA：接STM32的I2C数据线
注意：SHT30的ADDR引脚决定了设备地址。接GND时地址为0x44，接VCC时为0x45。本文默认使用0x44地址。
1.2 STM32CubeMX配置
- 打开STM32CubeMX，选择你的STM32型号
- 在"Pinout & Configuration"选项卡中启用I2C外设
- 配置I2C参数：
- 模式：I2C
- 速度：标准模式(100kHz)或快速模式(400kHz)
- 其他参数保持默认
// 生成的I2C初始化代码示例（HAL库） 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;2. SHT30驱动实现
2.1 传感器初始化
SHT30支持单次测量和周期性测量两种模式。以下是周期性测量模式的初始化代码：
#define SHT30_ADDR 0x44 << 1 // 左移1位，HAL库要求 void SHT30_Init(I2C_HandleTypeDef *hi2c) { uint8_t cmd[2]; // 周期性测量模式，1次/秒，高重复性 cmd[0] = 0x21; cmd[1] = 0x30; HAL_I2C_Master_Transmit(hi2c, SHT30_ADDR, cmd, 2, HAL_MAX_DELAY); HAL_Delay(150); // 等待传感器初始化完成 }2.2 数据读取与处理
SHT30返回的原始数据需要按照公式转换为实际温湿度值：
int SHT30_ReadData(I2C_HandleTypeDef *hi2c, float *temp, float *hum) { uint8_t cmd[2] = {0xE0, 0x00}; uint8_t data[6]; uint16_t rawTemp, rawHum; // 发送读取命令 if(HAL_I2C_Master_Transmit(hi2c, SHT30_ADDR, cmd, 2, 100) != HAL_OK) return -1; // 读取6字节数据（温度+CRC+湿度+CRC） if(HAL_I2C_Master_Receive(hi2c, SHT30_ADDR, data, 6, 100) != HAL_OK) return -1; // 组合原始数据（忽略CRC校验） rawTemp = (data[0] << 8) | data[1]; rawHum = (data[3] << 8) | data[4]; // 转换为实际值 *temp = -45 + 175 * (float)rawTemp / 65535.0f; *hum = 100 * (float)rawHum / 65535.0f; return 0; }3. 常见问题与优化
3.1 I2C通信超时处理
HAL库的I2C通信可能会因各种原因超时。以下是几种解决方案：
增加超时时间：
#define I2C_TIMEOUT 1000 // 1秒超时 HAL_I2C_Master_Transmit(hi2c, addr, data, size, I2C_TIMEOUT);错误重试机制：
int retry = 3; while(retry--) { if(HAL_I2C_Master_Transmit(hi2c, addr, data, size, timeout) == HAL_OK) break; HAL_Delay(10); }硬件检查：
- 确认上拉电阻（通常4.7kΩ）已正确连接
- 检查电源稳定性
- 确保时钟配置正确
3.2 提高测量精度
SHT30在不同模式下有不同的精度表现：
| 模式 | 重复性 | 典型精度(温度) | 典型精度(湿度) | 电流消耗 |
|---|---|---|---|---|
| 高 | 高 | ±0.2°C | ±2%RH | 1.2mA |
| 中 | 中 | ±0.3°C | ±3%RH | 0.8mA |
| 低 | 低 | ±0.4°C | ±4%RH | 0.5mA |
可以通过修改初始化命令选择不同精度模式：
// 高精度模式 cmd[0] = 0x21; cmd[1] = 0x30; // 中精度模式 cmd[0] = 0x21; cmd[1] = 0x24; // 低精度模式 cmd[0] = 0x21; cmd[1] = 0x1B;4. 完整示例与应用
4.1 主程序示例
#include "main.h" #include "sht30.h" I2C_HandleTypeDef hi2c1; UART_HandleTypeDef huart2; int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_I2C1_Init(); MX_USART2_UART_Init(); float temp, hum; char buf[64]; SHT30_Init(&hi2c1); while(1) { if(SHT30_ReadData(&hi2c1, &temp, &hum) == 0) { sprintf(buf, "Temp: %.2f°C, Hum: %.2f%%\r\n", temp, hum); HAL_UART_Transmit(&huart2, (uint8_t*)buf, strlen(buf), HAL_MAX_DELAY); } else { HAL_UART_Transmit(&huart2, (uint8_t*)"Read failed!\r\n", 13, HAL_MAX_DELAY); } HAL_Delay(1000); } }4.2 进阶应用：数据滤波
传感器数据可能会有微小波动，可以通过简单的移动平均滤波提高稳定性：
#define FILTER_SIZE 5 typedef struct { float buffer[FILTER_SIZE]; uint8_t index; } Filter_t; float Filter_AddValue(Filter_t *f, float newValue) { f->buffer[f->index] = newValue; f->index = (f->index + 1) % FILTER_SIZE; float sum = 0; for(int i = 0; i < FILTER_SIZE; i++) { sum += f->buffer[i]; } return sum / FILTER_SIZE; } // 使用示例 Filter_t tempFilter = {0}; Filter_t humFilter = {0}; float filteredTemp = Filter_AddValue(&tempFilter, temp); float filteredHum = Filter_AddValue(&humFilter, hum);