htu31d_driver/
├── code/
│   ├── htu31d.py        # 核心驱动
│   └── main.py          # 测试示例
├── package.json         # 包配置
├── README.md            # 说明文档
└── LICENSE              # 许可协议

# Python env   : MicroPython v1.23.0
# -*- coding: utf-8 -*-
# @Time    : 2026/07/25
# @Author  : FreakStudio
# @File    : main.py
# @Description : 测试 HTU31D 温湿度传感器驱动类
# @License : MIT

# ======================================== 导入相关模块 =========================================

import time
from machine import Pin, I2C
from micropython_htu31d import htu31d

# ======================================== 全局变量 ============================================

# HTU31D I2C 地址（参见数据手册）
_I2C_ADDRESS = 0x40

# 定时打印参数
last_print_time = time.ticks_ms()
print_interval = 2000  # 打印间隔（ms）

# ======================================== 功能函数 ============================================

def scan_i2c_bus(i2c: I2C):
    """扫描 I2C 总线，验证 HTU31D 设备存在"""
    print("Scanning I2C bus...")
    devices = i2c.scan()
    # 检查总线是否扫描到任何设备
    if not devices:
        raise RuntimeError("No I2C device found on bus")
    # 格式化输出扫描到的所有设备地址
    print("Found devices: %s" % str([hex(d) for d in devices]))
    # 验证目标地址是否存在
    found = _I2C_ADDRESS in devices
    if not found:
        raise RuntimeError("Device not found at expected address 0x%02X" % _I2C_ADDRESS)
    print("HTU31D detected at 0x%02X" % _I2C_ADDRESS)
    return found


def toggle_heater(sensor: htu31d.HTU31D):
    """切换加热器开关模式（模式切换，默认注释调用，可 REPL 手动触发）"""
    current = sensor.heater
    sensor.heater = not current
    print("Heater switched: %s -> %s" % (current, sensor.heater))


def test_resolutions(sensor: htu31d.HTU31D):
    """测试所有分辨率组合（模式切换，默认注释调用，可 REPL 手动触发）"""
    # 遍历温度分辨率选项
    for temp_res in ("0.040", "0.025", "0.016", "0.012"):
        sensor.temp_resolution = temp_res
        # 遍历湿度分辨率选项
        for hum_res in ("0.020%", "0.014%", "0.010%", "0.007%"):
            sensor.humidity_resolution = hum_res
            temp, hum = sensor.measurements
            print("T_res=%-5s H_res=%-6s  Temp=%-6.2fC  Hum=%-5.2f%%" %
                  (temp_res, hum_res, temp, hum))
            time.sleep(0.1)


def test_boundary_params(sensor: htu31d.HTU31D):
    """测试边界和异常参数（边界/异常参数场景，默认注释调用，可 REPL 手动触发）"""
    print("--- Boundary param tests ---")

    # 测试非法 heater 参数
    print("Test: heater = 1 (should raise ValueError)...")
    try:
        sensor.heater = 1
    except ValueError as e:
        print("  ValueError caught: %s" % str(e))

    # 测试非法温度分辨率
    print("Test: temp_resolution = 'invalid' (should raise ValueError)...")
    try:
        sensor.temp_resolution = "invalid"
    except ValueError as e:
        print("  ValueError caught: %s" % str(e))

    # 测试非法湿度分辨率
    print("Test: humidity_resolution = '0.050%' (should raise ValueError)...")
    try:
        sensor.humidity_resolution = "0.050%"
    except ValueError as e:
        print("  ValueError caught: %s" % str(e))

    print("--- Boundary tests done ---")

# ======================================== 自定义类 ============================================

# ======================================== 初始化配置 ==========================================

# 上电等待（确保传感器供电稳定）
time.sleep(3)
print("FreakStudio: HTU31D temperature and humidity sensor driver test")

# 初始化 I2C 总线（ESP32: I2C(1, scl=Pin(22), sda=Pin(21))
# 根据实际硬件接线修改引脚编号）
i2c = I2C(1, scl=Pin(22), sda=Pin(21), freq=100000)

# I2C 总线扫描与设备存在性验证
scan_i2c_bus(i2c)

# 实例化传感器驱动（默认地址 0x40，开启 debug 日志）
sensor = htu31d.HTU31D(i2c, address=_I2C_ADDRESS, debug=False)

# 读取并打印传感器序列号
serial = sensor.serial_number
print("Serial number: %s" % str(serial[0]))

# 打印初始分辨率配置
print("Humidity resolution: %s" % sensor.humidity_resolution)
print("Temperature resolution: %s" % sensor.temp_resolution)

# ========================================  主程序  ===========================================

try:
    while True:
        # 获取当前时间戳
        current_time = time.ticks_ms()

        # 定时打印温湿度数据（低频核心 API，自动执行）
        if time.ticks_diff(current_time, last_print_time) >= print_interval:
            temp, hum = sensor.measurements
            print("Temperature: %.2f C  |  Humidity: %.2f %%RH" % (temp, hum))
            last_print_time = current_time

        # toggle_heater(sensor)       # 模式切换，注释默认执行，可 REPL 手动触发
        # test_resolutions(sensor)    # 分辨率遍历测试，注释默认执行，可 REPL 手动触发
        # test_boundary_params(sensor) # 边界和异常参数测试，注释默认执行，可 REPL 手动触发

        time.sleep_ms(100)

except KeyboardInterrupt:
    print("Program interrupted by user")
except OSError as e:
    print("Hardware communication error: %s" % str(e))
except RuntimeError as e:
    print("Runtime error: %s" % str(e))
except Exception as e:
    print("Unknown error: %s" % str(e))
finally:
    print("Cleaning up resources...")
    sensor.deinit()
    del sensor
    print("Program exited")