当前位置：首页 > news >正文

STM32 HAL库实战：用CubeMX快速驱动SHT30温湿度传感器（附完整代码）

news 2026/5/23 19:19:56

STM32 HAL库实战：用CubeMX快速驱动SHT30温湿度传感器（附完整代码）

在嵌入式开发中，温湿度传感器是环境监测系统的核心组件之一。SHT30作为一款高精度数字传感器，通过I2C接口与主控芯片通信，成为STM32开发者的热门选择。传统开发方式需要手动编写底层I2C驱动代码，不仅耗时且容易出错。本文将展示如何利用STM32CubeMX图形化工具和HAL库，快速实现SHT30的驱动开发，大幅降低开发门槛。

1. 环境准备与CubeMX工程配置

1.1 硬件连接与器件选型

SHT30传感器与STM32的硬件连接极为简单，仅需四条线：

VCC（2.4V-5.5V）
GND
SCL（时钟线）
SDA（数据线）

注意：I2C总线需要上拉电阻（通常4.7kΩ），部分开发板已内置，若使用裸传感器模块需自行添加。SHT30的7位设备地址为0x44（地址引脚接地）或0x45（地址引脚接VCC）。

1.2 CubeMX工程初始化

打开STM32CubeMX，选择对应STM32型号（如STM32F103C8T6）
配置系统时钟（RCC）：
- HSE选择Crystal/Ceramic Resonator
- 在Clock Configuration中设置主频（如72MHz）
启用I2C外设：
- 选择I2C1或I2C2
- 模式设为I2C
- 参数保持默认（标准模式100kHz）

// CubeMX生成的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. HAL库I2C通信实现

2.1 HAL_I2C关键API解析

HAL库提供了高度封装的I2C操作函数，主要使用以下两个核心接口：

// 主设备发送数据 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);

参数说明：

DevAddress：7位设备地址左移1位（如0x44 << 1 = 0x88）
pData：数据缓冲区指针
Size：传输字节数
Timeout：超时时间（毫秒）

2.2 SHT30指令集封装

SHT30通过特定指令控制测量过程，常用指令如下：

指令代码	功能描述	测量精度
0x2C06	高重复性测量，时钟拉伸	±0.2℃
0x2C0D	中重复性测量，时钟拉伸	±0.3℃
0x2400	单次测量，无时钟拉伸	±0.3℃

封装发送测量指令的函数：

#define SHT30_ADDR (0x44 << 1) // 设备地址左移1位 void SHT30_StartMeasurement(void) { uint8_t cmd[2] = {0x2C, 0x06}; // 高精度测量指令 HAL_I2C_Master_Transmit(&hi2c1, SHT30_ADDR, cmd, 2, 100); }

3. 数据读取与处理

3.1 原始数据读取实现

SHT30测量完成后返回6字节数据（温度高/低字节、温度CRC、湿度高/低字节、湿度CRC）：

HAL_StatusTypeDef SHT30_ReadData(uint8_t *data) { return HAL_I2C_Master_Receive(&hi2c1, SHT30_ADDR, data, 6, 100); }

3.2 CRC校验与数据转换

SHT30使用CRC-8校验确保数据可靠性，校验多项式为0x31：

uint8_t SHT30_CheckCRC(uint8_t *data, uint8_t len) { uint8_t crc = 0xFF; for(uint8_t i=0; i<len; i++) { crc ^= data[i]; for(uint8_t j=0; j<8; j++) { crc = (crc & 0x80) ? (crc << 1) ^ 0x31 : (crc << 1); } } return crc; }

温度湿度转换公式（来自SHT30数据手册）：

void SHT30_ConvertData(uint8_t *raw, float *temp, float *humi) { uint16_t tempRaw = (raw[0] << 8) | raw[1]; uint16_t humiRaw = (raw[3] << 8) | raw[4]; *temp = -45 + 175 * (tempRaw / 65535.0f); *humi = 100 * (humiRaw / 65535.0f); }

4. 完整代码实现与优化

4.1 驱动程序完整实现

// sht30.h #ifndef __SHT30_H #define __SHT30_H #include "stm32f1xx_hal.h" #define SHT30_ADDR (0x44 << 1) #define SHT30_MEAS_HIGH 0x2C06 #define SHT30_MEAS_MEDIUM 0x2C0D #define SHT30_MEAS_LOW 0x2400 typedef struct { float temperature; float humidity; } SHT30_Data; HAL_StatusTypeDef SHT30_Init(I2C_HandleTypeDef *hi2c); HAL_StatusTypeDef SHT30_ReadValues(I2C_HandleTypeDef *hi2c, SHT30_Data *data); #endif

// sht30.c #include "sht30.h" static uint8_t Check_CRC8(uint8_t *data, uint8_t len); HAL_StatusTypeDef SHT30_ReadValues(I2C_HandleTypeDef *hi2c, SHT30_Data *data) { uint8_t cmd[2] = {0x2C, 0x06}; // 高精度测量 uint8_t raw[6]; // 发送测量指令 if(HAL_I2C_Master_Transmit(hi2c, SHT30_ADDR, cmd, 2, 100) != HAL_OK) return HAL_ERROR; HAL_Delay(20); // 等待测量完成 // 读取数据 if(HAL_I2C_Master_Receive(hi2c, SHT30_ADDR, raw, 6, 100) != HAL_OK) return HAL_ERROR; // CRC校验 if(Check_CRC8(raw, 2) != raw[2] || Check_CRC8(&raw[3], 2) != raw[5]) return HAL_ERROR; // 数据转换 uint16_t tempRaw = (raw[0] << 8) | raw[1]; uint16_t humiRaw = (raw[3] << 8) | raw[4]; >// main.c #include "sht30.h" I2C_HandleTypeDef hi2c1; SHT30_Data env_data; int main(void) { HAL_Init(); SystemClock_Config(); MX_I2C1_Init(); while(1) { if(SHT30_ReadValues(&hi2c1, &env_data) == HAL_OK) { printf("Temperature: %.1f℃, Humidity: %.1f%%\r\n", env_data.temperature, env_data.humidity); } else { printf("SHT30 read error!\r\n"); } HAL_Delay(2000); } }

5. 性能优化与问题排查

5.1 硬件I2C vs 模拟I2C对比

特性	硬件I2C	模拟I2C
开发效率	高（CubeMX配置）	低（需手动实现）
时序精度	严格符合标准	依赖延时函数精度
CPU占用	低（硬件处理）	高（软件轮询）
灵活性	固定引脚	任意GPIO
多设备支持	容易	需要复杂调度

提示：在STM32F1系列中，硬件I2C可能存在bug，若通信不稳定可尝试降低时钟速度或改用模拟I2C

5.2 常见问题解决方案

通信失败：
- 检查硬件连接和上拉电阻
- 用逻辑分析仪抓取I2C波形
- 尝试降低I2C时钟频率（如50kHz）
数据校验错误：
- 确保供电稳定（VCC≥3.3V）
- 检查CRC校验算法实现
- 增加测量后的延迟时间
CubeMX配置注意事项：
- I2C时钟源必须使能
- GPIO模式应设为"Alternate Function Open Drain"
- 确保没有引脚冲突