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 スキル共通仕様に従ってください。前提条件、必要なツールとバージョン、実装手順、検証段階ごとのテストと証拠、既知の制限、復旧とセキュリティに関する注意事項を明記します。