field-power-and-connectivity-triager

电源与连接故障排查

当项目在工作台上运行正常，但接入实际使用时的电源后出现故障，请使用此技能。适用于电压／电流路径不确定的任何电路板或负载；ESP32 示例很常见，但这并不意味着其他电路板也适用相同的限制。

资源

• references/power-path-triage.md - USB、VIN 与 3V3 的诊断工作流
• references/wifi-and-peak-current.md - WiFi 启动、欠压复位与电流峰值行为
• references/measurement-checklist.md - 归咎于代码之前需要测量的项目
• ../../docs/board-support/uno-r4-family.md - 相关情况下 Uno R4 系列电路板的注意事项

适用场景

当请求涉及以下情况时，请使用此技能：

• “通过 USB 供电时可以运行，但使用我的电源时不行”
• WiFi 在工作台上可以连接，但在部署环境中无法连接
• 仅在现场出现复位、欠压复位或传感器不稳定
• 怀疑稳压器或接线路径存在问题
• 电池、VIN 或 3V3 供电路径相关问题

工作流

1. 重现供电方式不同导致的差异：
   • USB 供电时正常
   • 使用预期的供电路径时失败
2. 打开 references/power-path-triage.md，对供电路径进行分类。
3. 如果涉及 WiFi 或无线电启动，请打开 references/wifi-and-peak-current.md。
4. 在假定故障出在用户代码之前，根据 references/measurement-checklist.md 记录实际测量值。
5. 如果目标是 Uno R4 WiFi，请打开 ../../docs/board-support/uno-r4-family.md， 并明确区分连接侧的硬件部分。

核心规则

• “通过 USB 供电时可以运行”说明供电路径可能存在问题，不能证明代码没有问题。
• ESP32 级别电路板的 WiFi 启动电流峰值是首要怀疑对象。
• 先诊断供电路径，再盲目调整网络代码。
• 如果传感器在现场供电时不稳定，在测量结果排除之前，应将其视为可能的电源完整性问题。
• 不要用标称电压或空闲电流读数来证明峰值电流安全；应将测得的负载路径与电路板及元件的限值进行比较。

验证

• 确认故障仅在使用预期供电路径时复现。
• 确认故障阶段的电压和电流状况，而不仅仅是空闲时的状况。
• 确认故障发生在启动时、WiFi 关联期间，还是之后的负载运行期间。
• 确认修正供电路径后，同一份草图程序的行为是否稳定一致。

集成

• 如果问题可能是电源容量不足，请搭配 power-budget-calculator 使用。
• 如果 OTA 仅在现场供电时失败，请搭配 ota-deployment-guardian 使用。
• 如果怀疑电路板接线本身存在问题，请搭配 circuit-debugger 使用。

共享输出规范

请遵循共享 Arduino 技能规范：说明假设、所需工具和版本、实施步骤、各验证阶段的测试／证据、已知限制，以及恢复／安全注意事项。