mpr121_driver/
├── mpr121.py      # MPR121 驱动核心文件
├── main.py        # 测试示例程序
└── README.md      # 本说明文档

# Python env   : MicroPython v1.23.0
# -*- coding: utf-8 -*-
# @Time    : 2026/04/26
# @Author  : Mike Causer
# @File    : main.py
# @Description : 测试 MPR121 电容触摸键盘驱动类的代码
# @License : MIT

# ======================================== 导入相关模块 =========================================
from machine import I2C, Pin
import time
from mpr121 import MPR121

# ======================================== 全局变量 ============================================
# I2C 设备地址
MPR121_I2C_ADDR = 0x5A

# 打印间隔控制
last_print_time = time.ticks_ms()
print_interval = 1000

# ======================================== 功能函数 ============================================
def print_all_filtered_data():
    """
    打印所有电极的滤波数据（高频，默认注释调用，可 REPL 手动调用）
    """
    print("Filtered data for all electrodes:")
    for i in range(12):
        data = mpr121.filtered_data(i)
        print("  Electrode %d: %d" % (i, data))

def print_all_baseline_data():
    """
    打印所有电极的基线数据（高频，默认注释调用，可 REPL 手动调用）
    """
    print("Baseline data for all electrodes:")
    for i in range(12):
        data = mpr121.baseline_data(i)
        print("  Electrode %d: %d" % (i, data))

def test_threshold_config():
    """
    测试阈值配置（模式切换，默认注释调用，可 REPL 手动触发）
    """
    # 测试设置所有电极阈值
    print("Setting thresholds for all electrodes: touch=20, release=10")
    mpr121.set_thresholds(20, 10)

    # 测试设置单个电极阈值
    print("Setting thresholds for electrode 0: touch=30, release=15")
    mpr121.set_thresholds(30, 15, electrode=0)

    # 恢复默认阈值
    print("Restoring default thresholds: touch=15, release=7")
    mpr121.set_thresholds(15, 7)

def test_boundary_parameters():
    """
    测试边界参数（边界场景，默认注释调用，可 REPL 手动触发）
    """
    print("Testing boundary parameters:")

    # 测试电极边界值
    print("  Reading electrode 0 (min)...")
    data = mpr121.filtered_data(0)
    print("    Filtered data: %d" % data)

    print("  Reading electrode 11 (max)...")
    data = mpr121.filtered_data(11)
    print("    Filtered data: %d" % data)

    # 测试阈值边界值
    print("  Setting threshold to 0 (min)...")
    mpr121.set_thresholds(0, 0, electrode=0)

    print("  Setting threshold to 255 (max)...")
    mpr121.set_thresholds(255, 255, electrode=0)

    # 恢复默认阈值
    mpr121.set_thresholds(15, 7)
    print("  Boundary test completed")

def test_invalid_parameters():
    """
    测试非法参数（异常场景，默认注释调用，可 REPL 手动触发）
    """
    print("Testing invalid parameters:")

    # 测试超出范围的电极编号
    try:
        mpr121.filtered_data(12)
        print("  ERROR: Should raise ValueError for electrode 12")
    except ValueError as e:
        print("  OK: Caught ValueError for electrode 12: %s" % str(e))

    # 测试超出范围的阈值
    try:
        mpr121.set_thresholds(256, 10)
        print("  ERROR: Should raise ValueError for touch threshold 256")
    except ValueError as e:
        print("  OK: Caught ValueError for touch threshold 256: %s" % str(e))

    # 测试错误类型的参数
    try:
        mpr121.is_touched("0")
        print("  ERROR: Should raise ValueError for string electrode")
    except ValueError as e:
        print("  OK: Caught ValueError for string electrode: %s" % str(e))

    print("  Invalid parameter test completed")

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

# ======================================== 初始化配置 ==========================================
time.sleep(3)
print("FreakStudio: Using MPR121 capacitive touch keypad driver...")

# 初始化 I2C 总线
i2c = I2C(0, scl=Pin(5), sda=Pin(4), freq=400000)

# 扫描 I2C 总线
print("Scanning I2C bus...")
devices = i2c.scan()
if len(devices) == 0:
    raise RuntimeError("No I2C device found")
print("Found %d device(s): %s" % (len(devices), [hex(d) for d in devices]))

# 检查目标设备地址
if MPR121_I2C_ADDR not in devices:
    raise RuntimeError("Device not found at expected address 0x%02X" % MPR121_I2C_ADDR)
print("MPR121 found at address 0x%02X" % MPR121_I2C_ADDR)

# 初始化 MPR121 驱动
mpr121 = MPR121(i2c, address=MPR121_I2C_ADDR)
print("MPR121 initialized successfully")

# ========================================  主程序  ===========================================
try:
    while True:
        current_time = time.ticks_ms()
        if time.ticks_diff(current_time, last_print_time) >= print_interval:
            # 读取 12 位触摸状态
            touch_status = mpr121.touched()
            print("Touch status: 0x%03X" % touch_status)

            # 检查每个电极的触摸状态
            touched_electrodes = []
            for i in range(12):
                if mpr121.is_touched(i):
                    touched_electrodes.append(i)

            if len(touched_electrodes) > 0:
                print("  Touched electrodes: %s" % str(touched_electrodes))
            else:
                print("  No electrode touched")

            last_print_time = current_time

        # 高频数据读取函数，注释默认执行，可 REPL 手动调用
        # print_all_filtered_data()
        # print_all_baseline_data()

        # 模式切换函数，注释默认执行，可 REPL 手动触发
        # test_threshold_config()

        # 边界参数测试，注释默认执行，可 REPL 手动触发
        # test_boundary_parameters()

        # 异常参数测试，注释默认执行，可 REPL 手动触发
        # test_invalid_parameters()

        time.sleep_ms(10)

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...")
    mpr121.deinit()
    del mpr121
    print("Program exited")