micropython_sht45/
├── __init__.py       # 包初始化文件
├── sht45.py          # 核心驱动
└── main.py           # 测试示例

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

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

import time
from machine import I2C, Pin
from micropython_sht45 import SHT45

try:
    import micropython
    micropython.alloc_emergency_exception_buf(100)
except (ImportError, AttributeError):
    pass

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

# I2C 引脚配置（请根据实际接线修改）
I2C_SCL_PIN = const(5)
I2C_SDA_PIN = const(4)
I2C_FREQ = const(100000)

# 打印间隔（ms）
_PRINT_INTERVAL_MS = const(2000)

# 时间追踪变量
_last_print_time = 0

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

def test_all_precision_modes(sht):
    """
    测试所有温度精度模式（模式切换，默认注释调用，可 REPL 手动触发）
    Args:
        sht (SHT45): 传感器实例
    """
    print("\n=== Testing All Precision Modes ===")
    modes = [
        (SHT45.HIGH_PRECISION, "HIGH_PRECISION"),
        (SHT45.MEDIUM_PRECISION, "MEDIUM_PRECISION"),
        (SHT45.LOW_PRECISION, "LOW_PRECISION"),
    ]
    for mode_value, mode_name in modes:
        sht.temperature_precision = mode_value
        print("Precision set to: %s" % sht.temperature_precision)
        time.sleep(0.5)
        temp, hum = sht.measurements
        print("  Temperature: %.2f C, Humidity: %.2f %%RH" % (temp, hum))
    sht.temperature_precision = SHT45.HIGH_PRECISION
    print("Precision restored to: %s" % sht.temperature_precision)


def test_all_heater_settings(sht):
    """
    测试所有加热功率和时长组合（模式切换，默认注释调用，可 REPL 手动触发）
    注意：加热命令执行后需等待完成，耗时较长
    Args:
        sht (SHT45): 传感器实例
    """
    print("\n=== Testing Heater Settings ===")
    powers = [
        (SHT45.HEATER200mW, "HEATER200mW"),
        (SHT45.HEATER110mW, "HEATER110mW"),
        (SHT45.HEATER20mW, "HEATER20mW"),
    ]
    times = [
        (SHT45.TEMP_1, "TEMP_1 (1s heat)"),
        (SHT45.TEMP_0_1, "TEMP_0_1 (0.1s heat)"),
    ]
    for power_val, power_name in powers:
        for time_val, time_name in times:
            sht.heater_power = power_val
            sht.heat_time = time_val
            print("Heater: %s, Duration: %s" % (power_name, time_name))
            temp, hum = sht.measurements
            print("  Temperature: %.2f C, Humidity: %.2f %%RH" % (temp, hum))
            time.sleep(0.5)
    sht.heater_power = SHT45.HEATER20mW
    sht.heat_time = SHT45.TEMP_0_1
    sht.temperature_precision = SHT45.HIGH_PRECISION
    print("Heater settings restored to default")


def test_invalid_params(sht):
    """
    测试非法参数异常处理（异常参数场景，默认注释调用，可 REPL 手动触发）
    Args:
        sht (SHT45): 传感器实例
    """
    print("\n=== Testing Invalid Parameter Handling ===")
    try:
        sht.temperature_precision = 99
        print("ERROR: Should have raised ValueError")
    except ValueError as e:
        print("ValueError caught (precision): %s" % e)
    try:
        sht.heater_power = 99
        print("ERROR: Should have raised ValueError")
    except ValueError as e:
        print("ValueError caught (heater_power): %s" % e)
    try:
        sht.heat_time = 99
        print("ERROR: Should have raised ValueError")
    except ValueError as e:
        print("ValueError caught (heat_time): %s" % e)
    print("Invalid parameter tests passed")


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

time.sleep(3)

print("FreakStudio: SHT45 Temperature and Humidity Sensor Test")
print("Author: %s" % SHT45.__author__)
print("Version: %s" % SHT45.__version__)

print("\nInitializing I2C (SCL=Pin(%d), SDA=Pin(%d))..." % (I2C_SCL_PIN, I2C_SDA_PIN))
i2c = I2C(0, scl=Pin(I2C_SCL_PIN), sda=Pin(I2C_SDA_PIN), freq=I2C_FREQ)

print("Scanning I2C bus...")
devices = i2c.scan()
if not devices:
    raise RuntimeError("No I2C device found on bus")
print("Found %d device(s): %s" % (len(devices), [hex(d) for d in devices]))

sht_addr = SHT45.SHT45.DEFAULT_ADDR
if sht_addr not in devices:
    raise RuntimeError("Device not found at expected address 0x%02X" % sht_addr)
print("SHT45 found at address 0x%02X" % sht_addr)

sht = SHT45.SHT45(i2c, address=sht_addr)
print("SHT45 instance created")

try:
    temp, hum = sht.measurements
    print("Initial reading — Temperature: %.2f C, Humidity: %.2f %%RH" % (temp, hum))
    print("Sensor verified successfully")
except Exception as e:
    raise RuntimeError("Sensor verification failed: %s" % e)

print("\nInitial Configuration:")
print("  Temperature Precision: %s" % sht.temperature_precision)
print("  Heater Power: %s" % sht.heater_power)
print("  Heat Time: %s" % sht.heat_time)

print("\n--- Starting periodic measurements ---")
print("(Interval: %d ms, I2C addr: 0x%02X)" % (_PRINT_INTERVAL_MS, sht_addr))
print("Available REPL commands:")
print("  test_all_precision_modes(sht)   — 测试所有精度模式")
print("  test_all_heater_settings(sht)   — 测试所有加热组合")
print("  test_invalid_params(sht)        — 测试非法参数处理")
print("  sht.reset()                     — 复位传感器")

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

try:
    while True:
        current_time = time.ticks_ms()
        if time.ticks_diff(current_time, _last_print_time) >= _PRINT_INTERVAL_MS:
            temp, hum = sht.measurements
            print("[%d] Temperature: %.2f C, Humidity: %.2f %%RH" %
                  (current_time // 1000, temp, hum))
            _last_print_time = current_time

        # test_all_precision_modes(sht)     # 模式切换，注释默认执行，可 REPL 手动触发
        # test_all_heater_settings(sht)     # 加热测试，注释默认执行，耗时长，可 REPL 手动触发
        # test_invalid_params(sht)          # 异常测试，注释默认执行，可 REPL 手动触发
        # sht.reset()                       # 传感器复位，注释默认执行，可 REPL 手动触发

        time.sleep_ms(100)

except KeyboardInterrupt:
    print("\nProgram interrupted by user")
except OSError as e:
    print("Hardware communication error: %s" % str(e))
except Exception as e:
    print("Unknown error: %s" % str(e))
finally:
    print("Cleaning up resources...")
    if hasattr(sht, 'deinit'):
        sht.deinit()
    del sht
    print("Program exited")