用途:为 Arduino/ESP32/RP2040 等创客电路提供系统化硬件排障流程,适用于“电路不工作、元件发热、板子没电、传感器无响应、间歇性随机故障”等场景。
主要能力:内置脚本 scripts/generate_debug_sketch.py,可生成 I2C 扫描器、GPIO 测试器、ADC 检查器、PWM 测试器草图;参考文档 references/measurement-procedures.md 提供万用表与示波器测量指南。调试协议分五阶段:电源系统检查(目视检查、DC 电压测量)、接地连通性(所有 GND 必须共地)、信号验证(数字电平、I2C 扫描)、元件隔离(逐个接入定位故障件)、软硬件区分(最小 blink 测试)。另附常见故障速查表与万用表设置指南。
使用方式:生成 I2C 扫描器:uv run --no-project scripts/generate_debug_sketch.py --i2c --output i2c_scanner.ino;生成 GPIO 测试器:uv run --no-project scripts/generate_debug_sketch.py --gpio --pins 2,3,4,5 --output gpio_test.ino;生成全部调试草图:uv run --no-project scripts/generate_debug_sketch.py --all;交互模式:uv run --no-project scripts/generate_debug_sketch.py --interactive。
适用场景:创客与嵌入式原型调试、I2C/SPI 通信排查、电机与传感器故障定位。
限制:资料未提供具体支持版本、平台兼容范围、收费与价格信息;脚本依赖 uv 运行环境;调试结论需结合实测数据判断。