lm75_driver/
├── lm75.py        # LM75 核心驱动
├── main.py        # 测试示例
├── package.json   # mip 包配置文件
├── wiring.png     # 接线图
└── README.md      # 说明文档

from machine import Pin, I2C
from lm75 import LM75

# 创建 I2C 总线实例
i2c = I2C(0, scl=Pin(22), sda=Pin(21), freq=100000)

# 扫描 I2C 设备确认 LM75 存在
devices = i2c.scan()
print("Devices:", [hex(d) for d in devices])

# 实例化传感器并读取温度
sensor = LM75(i2c, addr=0x48)
temp_c, point = sensor.get_temp()
print("Temperature: %d.%d C" % (temp_c, point))
sensor.deinit()

# Python env   : MicroPython v1.23.0
# -*- coding: utf-8 -*-
# @Time    : 2026/07/24
# @Author  : OldhamMade
# @File    : main.py
# @Description : 测试 LM75 驱动类
# @License : MIT

from machine import Pin, I2C
from lm75 import LM75
import time

# ======================================== 导入相关模块 =========================================
# ======================================== 全局变量 ============================================

# LM75 默认 I2C 地址
LM75_DEFAULT_ADDR = 0x48

# LM75 无芯片 ID 寄存器（纯温度传感器，通过读写验证设备存在）

# 打印间隔（毫秒）
PRINT_INTERVAL_MS = 2000

# 上次打印时间戳
last_print_time = 0

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


def test_boundary_params():
    """
    测试边界参数（可 REPL 手动调用）
    测试不同 I2C 地址和 debug 模式
    """
    print("--- Boundary Parameter Test ---")
    # 测试最高有效地址（LM75 地址引脚 A2/A1/A0 可配置 0x48~0x4F）
    try:
        sensor_high_addr = LM75(i2c, addr=0x4F, debug=True)
        temp_c, point = sensor_high_addr.get_temp()
        print("Addr 0x4F result: %d.%d C" % (temp_c, point))
        sensor_high_addr.deinit()
    except Exception as e:
        print("Addr 0x4F test skipped: %s" % str(e))

    # 测试最低有效地址
    try:
        sensor_low_addr = LM75(i2c, addr=0x48, debug=True)
        temp_c, point = sensor_low_addr.get_temp()
        print("Addr 0x48 result: %d.%d C" % (temp_c, point))
        sensor_low_addr.deinit()
    except Exception as e:
        print("Addr 0x48 test skipped: %s" % str(e))

    print("--- Boundary test done ---")


def test_exception_params():
    """
    测试异常参数（可 REPL 手动调用）
    验证非法参数是否正确抛出异常
    """
    print("--- Exception Parameter Test ---")

    # 测试无效 I2C 实例（非 I2C 对象）
    try:
        LM75("not_i2c")
    except ValueError as e:
        print("Invalid I2C caught: %s" % str(e))

    # 测试地址超出范围（>127）
    try:
        LM75(i2c, addr=128)
    except ValueError as e:
        print("Addr >127 caught: %s" % str(e))

    # 测试负地址
    try:
        LM75(i2c, addr=-1)
    except ValueError as e:
        print("Negative addr caught: %s" % str(e))

    # 测试地址类型错误
    try:
        LM75(i2c, addr="0x48")
    except ValueError as e:
        print("Wrong addr type caught: %s" % str(e))

    print("--- Exception test done ---")


# ======================================== 自定义类 ============================================
# ======================================== 初始化配置 ==========================================

# 等待硬件稳定
time.sleep(3)

print("FreakStudio: Testing LM75 I2C Temperature Sensor Driver")

# 创建 I2C 总线实例
# ESP32 默认引脚: SCL=GPIO22, SDA=GPIO21
# ESP8266 默认引脚: SCL=GPIO5(D1), SDA=GPIO4(D2)
SCL_PIN = 22
SDA_PIN = 21
i2c = I2C(0, scl=Pin(SCL_PIN), sda=Pin(SDA_PIN), freq=100000)

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

# 检查 LM75 是否在预期地址
if LM75_DEFAULT_ADDR not in devices:
    raise RuntimeError(
        "LM75 not found at expected address 0x%02X" % LM75_DEFAULT_ADDR
    )

# LM75 无芯片 ID 寄存器，通过读取验证设备响应
print("Verifying LM75 at address 0x%02X..." % LM75_DEFAULT_ADDR)
try:
    # 尝试读取 2 字节确认设备响应
    verify_buf = bytearray(2)
    i2c.readfrom_into(LM75_DEFAULT_ADDR, verify_buf)
    print("LM75 device found and responding")
except OSError as e:
    raise RuntimeError("LM75 device not responding") from e

# 实例化 LM75 驱动（正常参数场景：默认地址，debug 关闭）
sensor = LM75(i2c, addr=LM75_DEFAULT_ADDR, debug=False)

# 记录初始时间戳
last_print_time = time.ticks_ms()

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

try:
    while True:
        current_time = time.ticks_ms()

        # 低频核心 API：定时自动执行温度采集
        if time.ticks_diff(current_time, last_print_time) >= PRINT_INTERVAL_MS:
            # 读取温度值（核心 API）
            temp_c, point = sensor.get_temp()
            print("Temperature: %d.%d C" % (temp_c, point))

            # 读取原始数据（调试用）
            msb, lsb = sensor.get_output()
            print("  Raw: MSB=0x%02X LSB=0x%02X" % (msb, lsb))

            last_print_time = current_time

        # 边界参数测试（注释自动执行，可 REPL 手动调用）
        # test_boundary_params()

        # 异常参数测试（注释自动执行，可 REPL 手动调用）
        # test_exception_params()

        # 主循环延时
        time.sleep_ms(100)

except KeyboardInterrupt:
    print("Program 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...")
    sensor.deinit()
    del sensor
    print("Program exited")