快速开始
准备与连接
准备模块、Qwiic 线、具备 3.3 V I2C 接口的主控、USB 数据线和 Arduino IDE。主控没有 Qwiic 时，按引脚表连接 3.3 V、GND、SDA、SCL；5 V 逻辑需匹配的电平转换。
- 主控断电后连接模块，确认公共 GND。
- 为 Arduino IDE 安装主控实际型号的支持包。
- 在库管理器安装或更新官方 Arduino_Modulino 库。
- 打开库中对应模块的示例。
- 选择主控型号与端口，编译并上传到主控。
- 按示例波特率打开串口监视器，检查输出。
示例验证
打开 Thermo 示例，读取温度和相对湿度。官方类为 ModulinoThermo，使用 getTemperature() 与 getHumidity() 获取结果，单位分别为 °C 和 %RH。更新库以支持新旧传感器的自动识别。
先在稳定、通风且无凝露的环境下观察读数，等待安装后的热平衡。再改变周围环境，检查读数是否随环境变化。不要通过触摸传感器、滴水或直接吹热风来验证精度。
若扫描到 0x44，需结合 PCB 版本判断是旧版 HS3003，还是被闭合 SJ1 的新版 GXHT30C，不能仅凭地址直接判定。
故障检查
| 现象 | 检查方法 |
|---|---|
| 扫描不到设备 | 核对 3.3 V、GND、总线选择和 SDA/SCL |
| 初始化失败 | 更新官方库，核对地址、硬件版本和地址冲突 |
| 加入多个模块后异常 | 检查地址唯一性、电源余量、线长和总线上拉 |
| 串口无输出 | 核对主控端口、波特率和示例是否运行 |