Modulino Thermo 使用教程

产品特点​

  • 温湿度双参数检测:同时采集环境温度与相对湿度数据,用于环境状态监测。
  • 温度测量精度:HS3003 版本典型温度精度为 ±0.25°C;GXHT30C 版本为 ±0.3°C,适用温度范围见参数表。
  • 测量范围:HS3003 温度量程为 -40~125°C,GXHT30C 为 -45~130°C;两种版本的相对湿度量程均为 0~100%RH。
  • 数字分辨率:HS3003 温湿度输出均为 14 位;GXHT30C 使用 16 位 ADC,温度分辨率为 0.015°C、湿度分辨率为 0.01%RH。
  • 低功耗测量:HS3003 在 3.3 V、14 位分辨率、每秒测量一次温湿度时,传感器典型平均电流约 24.4 µA。
  • 双 Qwiic 接口:通过 3.3 V I2C 连接主控,并可与其他 Modulino 节点连接。
  • Arduino 库支持:支持 Arduino_Modulino 库,提供示例读取温湿度数据。

硬件版本与参数​

先检查 PCB 版本标识。官方最新手册区分 V0.5 起的 GXHT30C 和更早的 HS3003,不能只根据产品名称判断传感器。

项目V0.5 及更新版本早于 V0.5
传感器GXCAS GXHT30CRenesas HS3003
默认 7 位 I2C 地址0x450x44
温度量程-45~130°C-40~125°C
典型温度精度±0.3°C(-40~90°C)±0.25°C
相对湿度量程0~100%RH0~100%RH
典型湿度精度±3%RH±2.8%RH
分辨率温度 0.015°C、湿度 0.01%RH,16 位 ADC温湿度 14 位
供电与逻辑3.3 V3.3 V
典型工作电流600 µA,测量状态24.4 µA,每秒测量一次、14 位分辨率
典型低功耗平均电流1.7 µA,单次转换、每秒一次、低重复率—
典型空闲电流0.2 µA,单次转换模式、25°C0.6 µA,睡眠模式、-40~85°C
板体尺寸41 × 25.36 mm同外形

素材截图中的 HS3003 参数对应早期版本;外观、引脚和结构图片按实际内容保留,实物传感器版本以 PCB 标识为准。

GXHT30C 电流依据:GXHT30 原厂数据手册 V3.7。

HS3003 电流依据:Renesas HS3xxx 数据手册。

参数依据:Modulino Thermo 数据手册。

产品展示​


产品尺寸​



硬件接口

引脚定义​


接口或信号用途
两个 QwiicGND、3.3 V、SDA、SCL,连接同一总线
1×4 焊盘GND、3.3 V、SDA、SCL,直接接线
1×5 扩展焊盘GND、3.3 V、ADDR、nRST、ALERT,功能需对应实际版本

模块没有板载稳压器。按 3.3 V 供电,I2C 也使用 3.3 V 逻辑;不能因传感器芯片供电范围包含 5 V,就把整板接入 5 V 系统。

地址与版本识别​

版本默认地址改址方式
GXHT30C,V0.5 起0x45SJ1 闭合后为 0x44
HS3003,早期版本0x44官方手册列为不可改
GXHT30C 改址会影响官方库识别

官方库依据地址识别两类传感器。GXHT30C 的 SJ1 闭合后会被按 HS3003 处理,官方手册明确说明此时无法正常识别。使用官方 Modulino 库时保留 SJ1 默认断开;仅在自行实现 GXHT30C 驱动时考虑改址。

同地址设备不能直接并联通信,可使用分别选通的 I2C 多路复用通道。该模块不是通过 MCU 固件任意改址的 Modulino 节点。

扩展与版本差异​

新版手册将 ADDR 定义为地址选择、nRST 为低有效复位、ALERT 为阈值告警输出。nRST 和 ALERT 不由 Modulino 库公开,需自定义代码;不用告警时保留 ALERT 悬空。

目前资料中心原理图链接仍标注 V0.3、传感器为 HS3003,与新版 GXHT30C 手册不属于同一版本。高级接线需核对实物版本和相应原理图,不按旧图对新版改线。


快速开始

准备与连接​

准备模块、Qwiic 线、具备 3.3 V I2C 接口的主控、USB 数据线和 Arduino IDE。主控没有 Qwiic 时,按引脚表连接 3.3 V、GND、SDA、SCL;5 V 逻辑需匹配的电平转换。

  1. 主控断电后连接模块,确认公共 GND。
  2. 为 Arduino IDE 安装主控实际型号的支持包。
  3. 在库管理器安装或更新官方 Arduino_Modulino 库(0.10.0,由 Arduino 官方服务器分发,不需要访问 GitHub)。
  4. 打开库中对应模块的示例。
  5. 选择主控型号与端口,编译并上传到主控。
  6. 按示例波特率打开串口监视器,检查输出。

示例验证​

打开 Thermo 示例,读取温度和相对湿度。官方类为 ModulinoThermo,使用 getTemperature() 与 getHumidity() 获取结果,单位分别为 °C 和 %RH。更新库以支持新旧传感器的自动识别。

先在稳定、通风且无凝露的环境下观察读数,等待安装后的热平衡。再改变周围环境,检查读数是否随环境变化。不要通过触摸传感器、滴水或直接吹热风来验证精度。

若扫描到 0x44,需结合 PCB 版本判断是旧版 HS3003,还是被闭合 SJ1 的新版 GXHT30C,不能仅凭地址直接判定。

故障检查​

现象检查方法
扫描不到设备核对 3.3 V、GND、总线选择和 SDA/SCL
初始化失败更新官方库,核对地址、硬件版本和地址冲突
加入多个模块后异常检查地址唯一性、电源余量、线长和总线上拉
串口无输出核对主控端口、波特率和示例是否运行


温湿度测量说明

量程、精度与分辨率​

量程表示可测数值范围,分辨率表示数字输出步距,典型精度描述指定条件下的测量误差。显示更多小数位不会提高实际精度。比较结果时记录传感器版本、环境、采样间隔和参考仪器条件。

相对湿度随温度变化,同一位置因主控发热、壳体或气流不同也可能产生读数差异。传感器应远离稳压器、处理器和其他热源,保持空气流通,避免用密闭外壳阻断测量环境。

保护与环境​

GXHT30C 黑色表面为防尘透气保护膜,不能撕除。保护膜不代表模块防水,不把模块浸水或暴露于凝露。

官方推荐 GXHT30C 在 5~60°C、20~80%RH 范围使用。长期处于范围外,尤其高湿条件,可能造成湿度读数暂时偏移;恢复正常环境后需要时间恢复。

记录与阈值​

按应用需要设置采样间隔,保留时间戳、温度和相对湿度。对控制或报警设置上下阈值及恢复条件,避免读数在边界附近波动时反复触发。

阈值判断可在主控软件中完成,不等同于模块 ALERT 引脚已由官方库配置。手册列出的测量转换时间也不等于在所有主控和总线环境下的最终采样周期。

多模块测量​

将参考传感器与模块放在相近位置并等待环境稳定,再比较读数;不要用不同位置的即时读数直接判定故障。同型号旧版固定地址相同,需使用独立总线或多路复用通道。


相关资料

1. 硬件资料​

2. 技术手册​

3. 软件工具​

4. 其他资料​


技术支持

周一-周五(9:30-6:30)周六(9:30-5:30)

手机:13434470212

邮箱:services04@spotpear.cn

QQ:202004841