STM32F4+HAL库驱动SHT25温湿度传感器：I2C时序与CRC-8校验-北京尧图网络

STM32F4系列配HAL库驱动SHT25-TR-0.4KS这颗温湿度传感器是最近几年环境监测和冷链项目里非常常见的一套组合。SHT25本身定位不低温度典型精度能做到±0.4°C湿度典型精度±1.8%RH数字I2C输出驱动逻辑并不复杂。但真要把这套C语言驱动写得干净、稳定、可复用从I2C时序处理到CRC-8校验再到原始数据的线性转换每一层都有容易踩的坑。这篇文章会把我的实现思路和实际调试经验完整过一遍给正在调SHT2x系列驱动或者准备选型温湿度传感器又拿不准怎么落地的朋友做个参考。1. 先明确SHT25这颗传感器的定位和选型逻辑1.1 型号后缀“TR”和“0.4KS”到底代表什么拿到SHT25-TR-0.4KS这个型号第一件事是先看懂后缀不然采购和选型容易对不上号。“TR”在绝大多数元器件型号里指卷带包装Tape and Reel是给贴片机用的盘装形式没有实际电气含义。真正有精度含义的是“0.4KS”。SHT25系列按精度等级分成好几个版本常见的有1KS和0.4KS两类0.4KS代表温度精度标称能做到±0.4°C。数据手册上写的SHT25温度典型精度是±0.3°C但量产分级时厂家把满足更高指标的部分归为0.4K档剩下综合表现稍宽的归为1K档所以0.4KS在选型表里通常意味着更严格的精度筛选价格也相应高一些。这个精度分级直接影响我的选型判断。如果项目只是做个室内温湿度显示±1°C、±5%RH的传感器就绰绰有余用0.4KS纯粹浪费预算。但如果用在冷链运输的温度记录、培养箱环境监控或者需要给采集数据做溯源高精度版本的意义就体现出来了。SHT25出厂带校准数据可追溯到NIST标准这在需要定期校验的行业里是个很重要的加分项。1.2 和SHT20、SHT30放在一起比差别在哪里SHT2x系列和后来推出的SHT3x系列我用下来最大的感受是定位差异很明显。SHT20是走量款温度精度不错但湿度精度一般典型±3%RH胜在便宜。SHT30是新一代架构有可配置地址脚支持多个传感器挂一条总线功耗也更低但湿度精度同样没有超过SHT25。SHT25的湿度精度是±1.8%RH在整个SHT2x系列里属于高配而且它保留了SHT21的引脚和命令兼容性。这意味着如果你的项目老代码里已经有SHT21驱动换到SHT25几乎不用改驱动层只改器件型号和精度声明就行。我做过一个模拟项目X之前用的是SHT20因为客户对湿度一致性提出更高要求换SHT25之后软件层面只改了I2C器件地址和精度注释采集数据直接平滑了很多。这一轮对比给我的结论是SHT25不是性能参数最亮眼的传感器但它赢在精度等级明确、校准可追溯、兼容性好。在医疗、实验室、冷链类项目里“指标被量化和可证明”往往比“峰值性能高”更重要SHT25就是这种风格。1.3 什么场景适合用SHT25什么场景没必要根据实际项目经验我建议这几个方向优先考虑SHT25需要记录温度和湿度的长期趋势并且数据要经得起复核的传感器可能面临冷凝、高湿环境需要对低端湿度准确性有更高要求的产品设计上要求传感器模组可拆卸、可更换、可单独校准的反过来如果是消费级室内温湿度计或者只是做简单的环境联动控制SHT30甚至更便宜的国产传感器就够用了。SHT25在100%RH高湿环境下的长期稳定性确实比普通传感器好但它也有自己的短板比如I2C地址固定为0x40一条总线上没法挂多颗SHT25这在多点分布式采集方案里是个明显限制。2. 硬件接线和HAL库工程准备底子打不好驱动写得再漂亮也没用2.1 引脚分配和上拉电阻的细节SHT25是标准I2C接口SDA和SCL两根线就够了。在STM32F4XX上最常用的是I2C1外设映射到PB6/SCL、PB7/SDA或者I2C2映射到PB10/PB11。我习惯用I2C1加PB6/PB7的组合因为CubeMX里默认生成最快调试时逻辑分析仪也好夹。SHT25的数据手册明确说了器件内部没有集成上拉电阻所以PCB上必须自己做上拉。我一般放在4.7kΩ到10kΩ之间具体取值和总线速率、线长都有关系。100kHz标准模式下10kΩ没问题400kHz快速模式下建议用4.7kΩ。如果传感器和MCU距离超过20cm我会把上拉降到2.2kΩ同时保证总线电容不至于太大。这里有个容易被忽略的细节STM32F4的GPIO虽然可以配置内部上拉但千万不要只依赖内部上拉去跑I2C。内部上拉阻值大约在30kΩ到50kΩ对I2C来说太弱了尤其在快速模式下沿会很难看容易导致通信偶发失败。我在一个早期原型板上偷懒没焊外部上拉结果I2C初始化时好时坏用示波器一量SCL上升沿软绵绵的加上外部电阻立刻正常。电源方面SHT25供电范围是2.1V到3.6V和STM32F4的3.3V系统直接对接没有问题。但要注意在传感器VDD和GND之间放一个100nF去耦电容位置尽量贴近器件引脚。如果传感器和MCU距离较远我还建议在靠近传感器端再并联一个1μF电容防止线缆上的干扰影响内部参考电压。2.2 CubeMX里配置I2C外设的关键参数用STM32CubeMX配置I2C外设时有几个参数不是默认就能直接用的需要按实际需求调整。首先是I2C速度模式。SHT25支持最高400kHz的快速模式但我不建议一开始就往高了跑。开发阶段先用100kHz标准模式把驱动功能验证通再根据实际波形决定要不要提到400kHz。标准模式下的时序容限大很多边界问题会被掩盖等代码稳定后再提速遇到问题排查范围会小很多。其次是I2C的7位地址。SHT25的地址固定是0x40注意CubeMX的“Slave Address”栏填写的是7位地址还是8位地址这很关键。HAL库里HAL_I2C_Master_Transmit和HAL_I2C_Master_Receive传入的地址参数要求的是8位左移后的地址也就是0x40左移一位变成0x80。很多人第一次写驱动时在这里昏头把0x40直接传进去结果就是总线上的地址对不上设备永远无应答。另外CubeMX生成代码后I2C的时序参数会根据选择的速率自动计算并填到初始化结构体里正常情况下不需要手改。但如果你用的HAL库版本比较旧或者改了系统时钟频率最好重新生成一次代码避免I2C时序参数和实际时钟不匹配。2.3 我在I2C速率选择上的实际建议实际项目里我最终用的是400kHz快速模式配合4.7kΩ上拉。SHT25的转换时间在毫秒级别I2C速率本身不是瓶颈但400kHz能让单次读取从几十微秒降到十几微秒对提高系统响应有微弱帮助。需要留个心眼的是400kHz下总线对线缆长度和走线质量更敏感。我用过一种排线比较长的扩展板400kHz下偶发出现接收超时降到100kHz后就完全正常。如果你的传感器不是直接贴装在主板上而是通过线缆引出老老实实先用100kHz等系统稳定后再评估能不能提速。3. C语言驱动程序设计接口清晰、命令完整、CRC不省3.1 驱动结构怎么拆分才能在不同项目间复用我写传感器驱动有一个基本习惯驱动层只依赖HAL库的I2C句柄不掺入任何业务逻辑这样换MCU型号或者换主控平台时驱动文件基本能原封不动搬过去。SHT25驱动建议拆成两个文件。头文件里定义器件地址、命令码、状态枚举和数据结构源文件里实现初始化、单次读取、CRC校验等函数。对外只暴露三个接口设备初始化、读取温度、读取湿度必要时加一个读取温湿度的组合接口。这种设计的好处是应用层代码非常简洁。主循环里只需要定义一个sht25_data_t结构体变量调用一次sht25_read_all然后直接用结构体里的temperature_c和humidity_rh字段即可。后续如果要加多传感器轮询只需要在应用层创建多个设备上下文驱动层保持不变。3.2 SHT25命令集和初始化函数的实现SHT25的命令码不多常用的就几个0xE3是带主机保持的温度测量0xE5是带主机保持的湿度测量0xF3和0xF5分别是对应的无主机保持测量命令0xFE是软复位0xE0是读取上一次测得的温度值。初始化我一般只做一件事发送软复位命令然后延时至少15ms让器件完成复位。SHT25上电后默认分辨率就是14位温度、12位湿度不需要额外配置用户寄存器。除非你有特殊需求比如想降低分辨率来缩短转换时间否则初始化越简单越不容易出错。源文件里开头定义一个静态的I2C句柄指针初始化时把外部传入的hi2c保存下来后续所有读写函数都用这个句柄。/* sht25.h */ #ifndef SHT25_H #define SHT25_H #include main.h #define SHT25_I2C_ADDR_7BIT 0x40U #define SHT25_I2C_ADDR_WRITE (SHT25_I2C_ADDR_7BIT 1) #define SHT25_I2C_ADDR_READ (SHT25_I2C_ADDR_7BIT 1 | 0x01U) #define SHT25_CMD_T_HOLD 0xE3U #define SHT25_CMD_RH_HOLD 0xE5U #define SHT25_CMD_T_NOHOLD 0xF3U #define SHT25_CMD_RH_NOHOLD 0xF5U #define SHT25_CMD_READ_T 0xE0U #define SHT25_CMD_SOFT_RESET 0xFEU typedef enum { SHT25_STATUS_OK 0, SHT25_STATUS_ERR_I2C, SHT25_STATUS_ERR_CRC, SHT25_STATUS_ERR_TIMEOUT } sht25_status_t; typedef struct { float temperature_c; float humidity_rh; } sht25_data_t; sht25_status_t sht25_init(I2C_HandleTypeDef *hi2c); sht25_status_t sht25_read_temperature(I2C_HandleTypeDef *hi2c, float *temp); sht25_status_t sht25_read_humidity(I2C_HandleTypeDef *hi2c, float *hum); sht25_status_t sht25_read_all(I2C_HandleTypeDef *hi2c, sht25_data_t *data); #endif/* sht25.c */ #include sht25.h static I2C_HandleTypeDef *sht25_i2c; static uint8_t sht25_crc8(uint8_t *data, uint8_t len) { uint8_t crc 0; while (len--) { crc ^ *data; for (int i 0; i 8; i) { crc (crc 0x80U) ? (uint8_t)((crc 1) ^ 0x31U) : (uint8_t)(crc 1); } } return crc; } sht25_status_t sht25_init(I2C_HandleTypeDef *hi2c) { uint8_t cmd SHT25_CMD_SOFT_RESET; HAL_StatusTypeDef hal_st; sht25_i2c hi2c; hal_st HAL_I2C_Master_Transmit(hi2c, SHT25_I2C_ADDR_WRITE, cmd, 1, 100); if (hal_st ! HAL_OK) { return SHT25_STATUS_ERR_I2C; } HAL_Delay(20); return SHT25_STATUS_OK; }这段代码我在多个项目里改过几个版本最终保留的就是这个精简风格。软复位失败时直接返回I2C错误应用层可以据此做重试或者异常上报。3.3 CRC-8校验为什么不能省SHT25每个测量结果会返回3个字节前两个字节是16位的原始测量值第三个字节是CRC-8校验值。如果省掉校验直接使用原始值在电磁环境复杂的工业现场就可能拿到错误的温度和湿度数据而且你根本不知道数据是错的。SHT25的CRC-8算法基于多项式x^8 x^5 x^4 1也就是0x31初始值为0x00。计算时只需要对前两个数据字节做运算然后和第三个字节比较。我在一个温湿度记录仪原型上专门做过故障注入实验人为翻转原始数据的一个位不做CRC校验时显示温度直接从25.3°C跳成31.8°C开启CRC校验后驱动能立刻识别数据异常并返回错误码应用层重新读取一次就恢复了。这个差异在真实场景里非常重要尤其采集数据要存库的场合少一个错点比多一个看似合理但错误的数值重要得多。4. 温湿度采集流程从原始二进制到物理量的完整链路4.1 hold mode和no-hold mode到底选哪个SHT25触发测量有两种方式。0xE3/0xE5是主机保持模式MCU发出测量命令后传感器在转换期间会把SCL线拉低强制主机等待转换完成后释放SCL主机再读取数据。0xF3/0xF5是无主机保持模式传感器发完应答后立刻释放总线主机需要自己估算转换时间等够了再去读取。我推荐大部分场景使用主机保持模式。原因很简单HAL库的HAL_I2C_Master_Receive在等待从设备释放SCL时会一直阻塞转换完成的时间由传感器自己决定MCU不用关心具体的转换耗时。代码逻辑上就是发一条命令然后直接读数据简单可靠不容易出现时序竞态。无主机保持模式更适合多主机总线或者MCU需要在传感器转换期间去处理其他任务的场景。用这个模式时驱动里得根据分辨率手动延时比如14位温度转换最长约85ms12位湿度转换最长约29ms延时必须留足余量否则会读到上一次的旧数据。以下代码用的是hold mode这也是我产品里最终采用的方案。4.2 带CRC校验的完整读取函数读取函数的关键点在于数据接收长度必须是3字节。如果只接收2字节传感器返回的CRC字节会残留在I2C总线上下一次通信可能错位。sht25_status_t sht25_read_temperature(I2C_HandleTypeDef *hi2c, float *temp) { uint8_t cmd SHT25_CMD_T_HOLD; uint8_t buf[3]; HAL_StatusTypeDef hal_st; uint16_t raw; hal_st HAL_I2C_Master_Transmit(hi2c, SHT25_I2C_ADDR_WRITE, cmd, 1, 100); if (hal_st ! HAL_OK) { return SHT25_STATUS_ERR_I2C; } hal_st HAL_I2C_Master_Receive(hi2c, SHT25_I2C_ADDR_READ, buf, 3, 300); if (hal_st ! HAL_OK) { return SHT25_STATUS_ERR_I2C; } if (sht25_crc8(buf, 2) ! buf[2]) { return SHT25_STATUS_ERR_CRC; } raw (uint16_t)((buf[0] 8) | buf[1]); raw 0xFFFCU; *temp -46.85f 175.72f * ((float)raw / 65535.0f); return SHT25_STATUS_OK; } sht25_status_t sht25_read_humidity(I2C_HandleTypeDef *hi2c, float *hum) { uint8_t cmd SHT25_CMD_RH_HOLD; uint8_t buf[3]; HAL_StatusTypeDef hal_st; uint16_t raw; hal_st HAL_I2C_Master_Transmit(hi2c, SHT25_I2C_ADDR_WRITE, cmd, 1, 100); if (hal_st ! HAL_OK) { return SHT25_STATUS_ERR_I2C; } hal_st HAL_I2C_Master_Receive(hi2c, SHT25_I2C_ADDR_READ, buf, 3, 300); if (hal_st ! HAL_OK) { return SHT25_STATUS_ERR_I2C; } if (sht25_crc8(buf, 2) ! buf[2]) { return SHT25_STATUS_ERR_CRC; } raw (uint16_t)((buf[0] 8) | buf[1]); raw 0xFFFCU; *hum -6.0f 125.0f * ((float)raw / 65535.0f); if (*hum 0.0f) *hum 0.0f; if (*hum 100.0f) *hum 100.0f; return SHT25_STATUS_OK; } sht25_status_t sht25_read_all(I2C_HandleTypeDef *hi2c, sht25_data_t *data) { sht25_status_t st; st sht25_read_temperature(hi2c, data-temperature_c); if (st ! SHT25_STATUS_OK) { return st; } st sht25_read_humidity(hi2c, data-humidity_rh); if (st ! SHT25_STATUS_OK) { return st; } return SHT25_STATUS_OK; }读取结束后我做了个掩码操作raw 0xFFFC把原始数据的低两位清掉。SHT25测量数据的低两位是状态标记位可能反映器件状态或者测量分辨率不是有效数据必须屏蔽后再参与转换计算。4.3 线性转换公式的原理和容易写错的地方SHT25的温度和湿度原始值到物理量的转换都是线性映射公式本身不长但很容易写错的是缩放因子。温度换算公式是T -46.85 175.72 * S_T / 65535湿度换算公式是RH -6 125 * S_RH / 65535这里S_T和S_RH是掩码后的14位原始值分母用的是65535而不是65536或16383这是个细致活。Sensirion在出厂时把原始值映射到整个16位数据范围内即使分辨率只有14位原始数据也只是占了其中的高14位低位置零后再按65535做归一化。我见过有人把分母误写成65536结果整体偏了约0.02%放在精度要求高的项目里还是能看出来的。转换后的湿度理论上可能落在-6%到114%RH的数学范围内但物理上湿度不可能低于0%或高于100%。所以我在驱动里加了两行钳位保证输出值始终在合理范围内。温度则不做裁剪因为SHT25本身支持-40°C到125°C的工作范围超出这个范围时保留原始计算值反而便于上层做故障判断。5. 实测中遇到的坑和排查思路5.1 I2C无应答或者超时的常见原因第一类常见问题是传感器完全无应答HAL_I2C_Master_Transmit返回HAL_BUSY或者HAL_TIMEOUT。排查顺序我固定是这样先查地址确认传入的是左移后的8位地址再查上拉电阻有没有焊接然后用示波器看SCL和SDA有没有波形。如果SCL有波形但SDA一直高电平基本就是从设备地址错误或者传感器没上电。第二类问题更隐蔽总线在初始化时是通的但运行一段时间后偶发超时。我遇到过的最典型原因是I2C工作在中断模式时上一次传输还没完成就发起了下一次传输HAL返回HAL_BUSY。这种问题往往不是硬件而是驱动调用逻辑导致的。建议所有I2C操作都做成独占式或者用互斥量保护避免两个任务同时访问总线。还有一次是传感器在转换过程中MCU发生了复位SCL被传感器拉住不放。此时整个I2C总线看起来就像短路了一样任何通信都失败。处理办法是初始化时先对GPIO做几次手动翻转把SCL时钟驱动起来让从设备释放总线再重新初始化I2C。HAL库自带的复位机制不一定能覆盖到这种情况我在产品代码里加了一段总线恢复逻辑才彻底解决。5.2 CRC校验一直失败到底是谁的问题如果CRC校验通过率很低或者稳定失败先不要怀疑传感器坏了从三个方面查。首先是接线质量。SHT25的I2C信号如果走线过长或者经过接插件信号完整性问题会直接体现为数据位翻转CRC自然过不了。把速率降到100kHz试一下如果故障消失大概率是信号质量问题而不是器件问题。我在一个用杜邦线飞的调试板上就遇到过杜邦线一碰就CRC失败焊到PCB上之后就再也没出现过。其次是电源纹波。SHT25对电源噪声比较敏感如果传感器的VDD是从数字电路直接拉过来的而旁边又有大电流开关转换结果可能不稳定。在VDD引脚加100nF电容必要时再加1μF基本能解决。最后是焊接和污染。SHT25的湿敏元件对助焊剂残留很敏感如果回流焊后没有清洗器件在高湿环境下可能出现漂移表现为读数异常但CRC正常。务必要保证器件周围干净特别是不要用手指直接触摸传感器探头区域。5.3 驱动跑通之后做产品还要注意什么驱动功能正常只是第一步。真正做产品时我至少还会做三件事。第一是控制采集频率。SHT25在转换期间会消耗较大电流如果每秒读十几次不仅浪费电还会因为传感器自身发热导致温度读数偏高。我在设计里把温湿度采集频率限制在1秒一次功耗和实测精度都能兼顾。对于低功耗电池供电的设备建议每10秒甚至更久唤醒一次采集完立刻再次进入休眠SHT25待机电流可以降到微安级别。第二是考虑长期漂移。SHT25虽然出厂校准精度高但任何湿度传感器在长时间暴露于极端环境后都会有漂移。我在数据记录类产品里会在传感器旁边预留一个可拆卸的校准口定期用标准温湿度源做比对把偏移量在应用层修正。这个做法比直接把传感器焊死在主板上要灵活得多。第三是关注传感器布局和系统热量。SHT25不要紧挨着STM32主控芯片也不要放在电源电路的散热风道上。PCB铜箔会导热传感器附近的铜皮越少越好。我最早一版PCB把SHT25放在CPU旁边实测温度比环境温度高了0.6°C后来重新布局才把偏差降下来。串口打印调试信息时我习惯把原始值、CRC值、转换后的物理量一起打出来。开发阶段多打一行排障时就能少猜一个问题。产品量产前再关掉这部分打印输出实测并不会影响驱动稳定性。整段驱动从设计到稳定最大的感受是传感器驱动没有太多玄学把I2C时序吃透、把CRC校验做扎实、把数据转换公式写准确剩下的问题大多能从硬件布局和信号完整性上找到答案。SHT25这颗物料精度好、接口简单值得在可靠性优先的项目里认真对待。

STM32F4+HAL库驱动SHT25温湿度传感器：I2C时序与CRC-8校验

相关推荐

安全顶会论文泛读指南：从NDSS 2021看物联网与模糊测试等方向

Claude Opus 4.6自主推理实测：从代码修复到数据清洗的深度评测

Gated Attention门控注意力：破解YOLO26 Attention Sink困境的稀疏激活新方案

更多资讯

4-1-Computer Class Built-in Variables-sysBootTime

GeoJSEval: An Automated Evaluation Framework for Large Language Models on JavaScript-Based Geospa...

OpenAI API 错误响应排查保姆级指南

Notepad-- -- 跨平台文本编辑器：目录查找替换、文件对比和大文本模式一次配齐

UniHacker Unity 破解完整指南：3 步免费解锁 4.x 至 2022.1 与 Unity Hub

Perceptron 强化学习（RL）Pipeline 技术文档

今日更新

微信云开发旅游小程序实战：LBS打卡+UGC社交全栈方案

金融AI代理平台核心拆解：从多代理协作到财报分析实战

基于大数据的智慧旅游推荐与可视化平台架构实践

本周精选

金融AI落地指南：从调研报告到技术选型与工程实践

大模型上下文成本与注意力优化技术深度解析——为何O(n²)平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测

基于GMM的语音识别系统原理与MATLAB实现详解

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？