用途:当传感器或设备本应挂在I2C总线上,但I2C链路仍不可信时,使用该技能进行故障隔离。适用情形包括提示“no I2C devices found”、扫描器能发现地址但库无法初始化设备、两个I2C设备冲突或其中一个消失、ESP32引脚/总线/第二通道混淆、上拉、线长或电平兼容问题,以及基本检测成功但读数明显错误。
主要能力与工作流:先确定故障形态——扫描器完全无检测则查阅references/bringup-flow.md;扫描器检测到但库失败则查阅references/scanner-vs-library.md;ESP32系列多总线或引脚问题则查阅references/esp32-and-board-quirks.md。随后在更换库之前确认电气基础:供电、共地、SDA与SCL映射、上拉电阻、逻辑电平兼容。只有当总线在电气上合理后,再检查地址、设备模式和库的预期。若涉及Uno R4系列且属板级I2C或支持问题,另查阅../../docs/board-support/uno-r4-family.md。
核心规则:扫描器成功不能证明库正确使用了设备;库失败不能证明传感器已损坏;在盲目改代码前,必须明确总线电压、上拉和引脚映射;ESP32系列开发板的引脚选择与多总线假设在不同变体间不一定可移植。
验证要点:确认扫描器是否看到预期地址;确认最小寄存器或识别读取是否成功;确认失败行为是否跟随板卡系列、总线实例或库而非仅传感器;确认最终修复能通过重复扫描和实际传感器读取。
集成与输出:可与circuit-debugger搭配做更深硬件隔离,与datasheet-interpreter搭配确认正确地址、供电或时序,与arduino-code-generator搭配生成最小测试草图或整理总线探测。遵循共享Arduino技能契约:说明假设、所需工具与版本、实施步骤、各证明阶段的测试/证据、已知限制及恢复/安全说明。具体命令、价格与平台支持信息暂未提供。