SuperAPI AI 工具集

field-power-and-connectivity-triager

部署与运维

查看项目

更新于 10-16 01:09

技能介绍

用途:当项目在USB台面电源下工作正常,但按真实使用方式供电时出现故障,可用此技能排查供电路径与连接问题。适用于电压/电流路径不确定的板卡或负载,ESP32示例只是常见情形,不代表所有板卡限制相同。

主要能力:提供供电路径分类与诊断流程,覆盖USB、VIN、3V3差异;分析WiFi启动、掉电复位(brownout)与电流峰值行为;给出在归咎代码前应完成的测量清单;涉及Uno R4 WiFi时参考板卡支持文档,明确连接侧硬件差异。

使用方式:先复现“USB可用、目标供电路径失败”的差异;打开references/power-path-triage.md对供电路径分类;若涉及WiFi或射频启动,打开references/wifi-and-peak-current.md;按references/measurement-checklist.md采集实际测量值,再判断是否为用户代码问题;目标为Uno R4 WiFi时打开../../docs/board-support/uno-r4-family.md。

适用场景:出现“USB能用但我的电源不行”、WiFi台面可连但部署后连不上、仅现场出现的复位/掉电/传感器不稳定、怀疑稳压器或走线路径薄弱、电池/VIN/3V3供电路径疑问。

核心规则:USB可用是供电路径的证据,不等于代码正确;ESP32类板卡的WiFi启动电流峰值是首要嫌疑;先诊断供电路径,不要盲目调网络代码;现场供电下传感器不稳定应优先视为电源完整性问题,直到测量排除;不得用标称电压或空闲电流读数证明峰值电流安全,需将实测负载路径与板卡及元件限值比较。

验证:确认故障仅在目标供电路径复现;确认失败阶段的电压与电流条件,而非仅空闲值;确认故障发生在启动、WiFi关联还是后续负载阶段;确认供电路径修正后同一程序行为一致。

集成:可能与电源容量不足相关时配合power-budget-calculator;OTA仅在现场供电下失败时配合ota-deployment-guardian;怀疑板卡接线本身时配合circuit-debugger。输出遵循共享Arduino技能契约:说明假设、所需工具与版本、实施步骤、按证明阶段给出测试/证据、已知限制及恢复/安全说明。