1. 项目概述
在嵌入式开发中，温湿度传感器是常见的环境监测元件。SHT30作为一款高精度数字温湿度传感器，通过I2C接口与主控芯片通信。本文将详细介绍如何在STM32平台上使用HAL库驱动SHT30传感器，包含完整的配置过程、代码实现和调试技巧。
2. 硬件准备与CubeMX配置
2.1 硬件连接
SHT30传感器与STM32的典型连接方式如下：
| SHT30引脚 | STM32引脚 | 说明 |
|---|---|---|
| VDD | 3.3V | 电源正极 |
| GND | GND | 电源地 |
| SDA | PB7 | I2C数据线 |
| SCL | PB6 | I2C时钟线 |
注意：SHT30的工作电压范围为2.4V-5.5V，但建议使用3.3V供电以确保与STM32电平兼容。
2.2 CubeMX基础配置
-
在Pinout & Configuration界面中启用I2C1：
- 模式选择I2C
- 时钟速度设置为100kHz（标准模式）
- 其他参数保持默认
-
GPIO配置：
- SDA引脚(PB7)配置为Alternate Open Drain
- SCL引脚(PB6)配置为Alternate Open Drain
- 两个引脚都启用内部上拉电阻
-
时钟配置：
- 确保I2C时钟源正确
- APB1时钟分频比适当（通常保持默认）
2.3 高级参数设置
在I2C参数配置中，有几个关键参数需要注意：
- Timing参数：对于100kHz时钟，推荐值为0x2000090E
- 噪声滤波器：可启用数字滤波器以减少干扰
- 时钟延展：建议启用（Clock Stretching Enabled）
3. 软件实现详解
3.1 SHT30驱动头文件
c复制#ifndef __SHT30_H
#define __SHT30_H
#include "stm32f1xx_hal.h"
#include <stdint.h>
#define SHT30_ADDRESS 0x44
#define SHT30_ADDRESS_W (SHT30_ADDRESS << 1)
#define SHT30_ADDRESS_R ((SHT30_ADDRESS << 1) | 0x01)
uint8_t SHT30_ReadData(float *temp, float *humi);
#endif
提示：地址定义时左移1位是因为I2C协议中地址是7位的，最低位表示读/写方向。
3.2 CRC校验实现
SHT30使用CRC-8校验，多项式为0x31：
c复制#define POLYNOMIAL 0x31
uint8_t SHT30_CRC(uint8_t *data, uint8_t len) {
uint8_t crc = 0xFF;
for(uint8_t byteCtr = 0; byteCtr < len; byteCtr++) {
crc ^= data[byteCtr];
for(uint8_t bit = 8; bit > 0; --bit) {
if(crc & 0x80) {
crc = (crc << 1) ^ POLYNOMIAL;
} else {
crc = (crc << 1);
}
}
}
return crc;
}
3.3 数据读取函数
c复制uint8_t SHT30_ReadData(float *temp, float *humi) {
uint8_t buf[6];
uint8_t send_buf[2] = {0x2C, 0x06}; // 高重复性测量命令
// 发送测量命令
if(HAL_I2C_Master_Transmit(&hi2c1, SHT30_ADDRESS_W, send_buf, 2, 100) != HAL_OK) {
return 1; // 传输失败
}
HAL_Delay(15); // 等待测量完成
// 读取数据
if(HAL_I2C_Master_Receive(&hi2c1, SHT30_ADDRESS_R, buf, 6, 100) != HAL_OK) {
return 2; // 接收失败
}
// CRC校验
if(SHT30_CRC(&buf[0], 2) != buf[2] || SHT30_CRC(&buf[3], 2) != buf[5]) {
return 3; // CRC校验失败
}
// 温度计算
uint16_t temp_raw = (buf[0] << 8) | buf[1];
*temp = -45 + 175.0 * (temp_raw / 65535.0);
// 湿度计算
uint16_t humi_raw = (buf[3] << 8) | buf[4];
*humi = 100 * (humi_raw / 65535.0);
return 0; // 成功
}
4. 应用示例与调试技巧
4.1 基本应用
c复制float temperature, humidity;
void main(void) {
HAL_Init();
SystemClock_Config();
MX_I2C1_Init();
while(1) {
if(SHT30_ReadData(&temperature, &humidity) == 0) {
printf("Temperature: %.2f C, Humidity: %.2f %%\n", temperature, humidity);
} else {
printf("Sensor read error!\n");
}
HAL_Delay(2000); // 每2秒读取一次
}
}
4.2 常见问题排查
-
I2C通信失败
- 检查硬件连接是否正确
- 用逻辑分析仪观察I2C波形
- 确认上拉电阻值合适（通常4.7kΩ）
-
CRC校验失败
- 检查CRC计算函数是否正确
- 尝试降低I2C时钟速度
- 检查电源是否稳定
-
数据异常
- 确认计算公式正确
- 检查传感器是否初始化完成
- 尝试复位传感器（断电重启）
4.3 性能优化建议
- 使用DMA传输减少CPU占用
- 实现非阻塞式读取提高系统响应
- 添加传感器软复位功能提高可靠性
- 实现温度补偿算法提高精度
5. 高级应用扩展
5.1 多传感器应用
通过改变I2C地址引脚配置，可以连接多个SHT30传感器：
c复制#define SHT30_ADDRESS_ALT 0x45 // ADDR引脚接VDD时的地址
uint8_t SHT30_ReadData_Alt(float *temp, float *humi) {
// 实现与主传感器类似的读取函数
// 只需修改I2C地址相关定义
}
5.2 低功耗模式
对于电池供电设备，可以优化功耗：
- 在两次测量间将传感器置于休眠模式
- 降低测量频率
- 使用单次测量模式代替周期测量
c复制void SHT30_Sleep(void) {
uint8_t cmd[2] = {0xB0, 0x98}; // 休眠命令
HAL_I2C_Master_Transmit(&hi2c1, SHT30_ADDRESS_W, cmd, 2, 100);
}
5.3 校准与精度提升
- 定期读取传感器序列号验证设备
- 实现多点校准补偿非线性误差
- 添加数据滤波算法平滑输出
c复制uint32_t SHT30_ReadSerial(void) {
uint8_t cmd[2] = {0x37, 0x80}; // 读序列号命令
uint8_t buf[6];
HAL_I2C_Master_Transmit(&hi2c1, SHT30_ADDRESS_W, cmd, 2, 100);
HAL_Delay(1);
HAL_I2C_Master_Receive(&hi2c1, SHT30_ADDRESS_R, buf, 6, 100);
return (buf[0]<<24) | (buf[1]<<16) | (buf[3]<<8) | buf[4];
}
在实际项目中，我发现SHT30的稳定性很大程度上取决于电源质量。使用LDO稳压器而非开关电源可以显著降低测量噪声。另外，在PCB布局时，应尽量缩短传感器与MCU之间的走线长度，避免平行走线以减少串扰。