hs3003_driver

Renesas HS3003 temperature and humidity sensor driver for MicroPython via I2C

1.0.0 yangcong-bit Updated At: 2026-11-10
Install Package
Local Install
mpremote mip install https://upypi.net/pkgs/hs3003_driver/1.0.0
Remote Install
mip.install("https://upypi.net/pkgs/hs3003_driver/1.0.0")
Version Selection
README

HS3003 温湿度传感器 MicroPython 驱动

目录

简介

本驱动用于瑞萨(Renesas)HS3003 温湿度传感器,通过 I2C 总线读取温度和相对湿度数据。驱动保持原版公共 API,提供 measurements、temperature、relative_humidity 三个读取接口和 status 状态属性,并由外部注入 I2C 总线实例。

主要功能

  • 支持 HS3003 默认 I2C 地址 0x44。
  • 读取温度和相对湿度,并返回浮点结果。
  • 检测状态位中的 stale 数据;最多重试 2 次,仍失败时抛出 HS3003StaleDataError。
  • 通过只读 status 属性公开最近一次读取状态。
  • 保留原版 measurements、temperature、relative_humidity API。
  • I2C 总线由外部注入,驱动内部不创建硬件总线。
  • 提供 deinit() 释放驱动持有的硬件引用。

硬件要求

硬件 说明
HS3003 传感器模块 I2C 接口温湿度传感器
RP2040 / ESP32 等开发板 运行 MicroPython
杜邦线 VCC、GND、SCL、SDA
HS3003 引脚 功能 main.py 默认连接
VCC 电源正极 3.3V
GND 电源负极 GND
SCL I2C 时钟 GPIO5
SDA I2C 数据 GPIO4

软件环境

项目 说明
MicroPython v1.23 或兼容版本
依赖模块 machine、time、micropython
驱动版本 1.0.0

文件结构

hs3003_driver/
├── code/
│   ├── hs3003.py
│   └── main.py
├── package.json
├── README.md
└── LICENSE

文件说明

文件 说明
code/hs3003.py HS3003 驱动源码,提供 HS3003 类
code/main.py 手动测试入口,包含 I2C 扫描、设备响应检查和定时温湿度打印
package.json mip 包配置,仅发布运行必需的 hs3003.py
LICENSE MIT 许可证,沿用原仓库版权信息

快速开始

将 code/hs3003.py 复制到设备根目录,然后运行以下最小示例:

from machine import I2C, Pin
from hs3003 import HS3003, HS3003StaleDataError

i2c = I2C(0, scl=Pin(5), sda=Pin(4), freq=100000)
sensor = HS3003(i2c, address=0x44)

try:
    temperature, humidity = sensor.measurements
    print("Temperature: %.2f C" % temperature)
    print("Humidity: %.2f %%" % humidity)
except HS3003StaleDataError:
    print("Measurement is stale; retry later")

sensor.deinit()

也可以将 code/main.py 与 code/hs3003.py 一起复制到设备运行。main.py 会先扫描 I2C 总线并确认设备存在,然后每 1 秒读取并打印一次温湿度。

注意事项

项目 说明
I2C 地址 默认 0x44
I2C 频率 main.py 默认使用 100 kHz
读取时序 每次读取会发送唤醒命令并等待 100 ms,随后读取 4 字节数据
状态位 sensor.status 返回最近一次状态:-1 表示尚未读取、0 表示正常、1 表示 stale。stale 时驱动会执行完整测量时序并最多重试 2 次;仍失败则抛出 HS3003StaleDataError,不会返回该数据
ID 验证 HS3003 无固定芯片 ID 寄存器,测试文件通过最小测量读取判断器件是否响应
实机验证 本任务未执行设备连接、烧录、串口或 mpremote 测试

版本记录

版本号 日期 作者 修改说明
1.0.0 2026-09-07 Jose D. Montoya 按 GraftSense 规范整理 HS3003 I2C 温湿度驱动

联系方式

  • GitHub: https://github.com/FreakStudioCN

许可协议

本包采用 MIT 许可证,完整许可证及版权归属见同包 LICENSE。

File List
Name Size Type
LICENSE 1.1KB File
README.md 4.0KB Doc
code/hs3003.py 8.9KB Python
code/main.py 2.5KB Main
package.json 465B Conf