wiring-safety-check について
コードの実行や通電の前に、配線の電気的条件を確認する安全スキルです。信号レベル、電源レールとピーク電流、プルアップ、保護、安全な故障状態を点検します。
主な機能
- 01電源レールとグラウンドの整理
- 02双方向の信号レベル確認
- 03定常・ピーク電流の評価
- 04プルアップとバスの確認
- 05保護回路とドライバーの選定
- 06安全なリセット・故障状態
活用シーン
- 01センサーとボード間の接続確認
- 02ESP32 GPIO に入る 5 V 信号の評価
- 03モーターやアクチュエーターの電源・保護確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ wedsamuel1230/ embedded-engineering-skills --skill wiring-safety-checkインストール後、Claude Code で/wiring-safety-checkを入力して読み込まれたか確認します。
詳細
配線の安全性チェック
コードの書き込みや通電を行う前に、電気的な仕様を確認してください。基板の入力電圧やピンごとの最大定格だけでは、接続された信号や電源レール全体の安全性は証明できません。
事前確認
基板/モジュールの正確な型番とロジック電圧、センサー/アクチュエーターの部品番号、各電源レール、信号の方向、VIH/VIL/入力最大値、電流と起動時のピーク電流、プルアップの位置と値、グラウンド経路、ケーブル長、保護回路、デフォルト状態、およびレベルシフター、ドライバー、フライバック経路、ヒューズ、電流制限器の有無を記録してください。
手順
- USB/VIN/VSYS/3V3 の経路とレギュレーターを含め、電源レールとグラウンドのマップを作成します。
- すべての信号について、双方向を確認します。5 V 電源だからといって、I/O が 5 V に対応しているとは限りません。3.3 V MCU の入力に、規定範囲外のハイレベルを入力してはいけません。
- レギュレーター、コネクター、配線、熱設計の余裕を考慮して、定常電流とピーク電流を計算します。ピンごとの絶対最大定格を合算して、基板全体の許容電流とみなしてはいけません。
- プルアップについて、バス電圧、値、立ち上がり時間、ファンアウト、抵抗の重複を確認します。I2C/SPI/UART のデフォルトピンが基板プロファイルと一致していることを確認します。
- 電気的な仕様で必要な場合は、レベルシフト、分圧回路、トランジスター/MOSFET ドライバー、フライバック保護、デカップリング、または絶縁を追加します。
- 出力やモーターを有効にする前に、安全なリセット状態と障害時の状態を定義します。
- 導通、極性、電源レール、負荷の測定結果を記録するまで、実機ゲートで作業を止めてください。
5 V から ESP32 への接続で必須の確認事項
ユーザーが「5 V センサーを ESP32 に接続する」とだけ述べた場合は、まずレベルの互換性に関する情報が不足していることを指摘してください。ESP32 GPIO は 3.3 V クラスで、一般に 5 V トレラントではありません。センサーの実際の I/O レベルを確認し、ESP32 に入力される 5 V 信号には、適切なレベルシフターまたは分圧回路を必須としてください。グラウンドを共通化しても、レベルの非互換性は解消されません。回路を選ぶ前に、センサーが 3.3 V 電源に対応しているか、出力がオープンドレインかどうかを確認してください。
安全性を軽視する主張への対応
| 安易な判断 | 対応 |
|---|---|
| 「5 V センサーだから、データピンも安全です。」 | センサーのデータシートを確認し、5 V ハイレベルにはレベルシフトが必要だと指摘します。 |
| 「グラウンドを共通にすれば解決します。」 | グラウンド基準は必要ですが、ロジックしきい値は変わらないことを説明します。 |
| 「ピンあたり 20 mA が基板の許容電流です。」 | 電源レール、レギュレーター、コネクター、総負荷、ピーク電流を確認します。 |
| 「LED かモーターは小さいものです。」 | 突入電流、ストール電流、誘導キック、ドライバーのトポロジーを確認します。 |
| 「もう通電しました。」 | 作業を止め、点検して測定結果を記録します。動作したことから安全性を推測してはいけません。 |
検証
- 配線表に、電源側/接続先、電圧、方向、保護を記載します。
- レベルシフトとプルアップの判断には、データシートを根拠として示すか、未解決であることを明記します。
- 導通/極性、および無負荷時/負荷時の電源レール測定結果を記録します。
- ビルド/アップロードの証拠を、ハードウェアやシステムの動作証明として扱ってはいけません。
共通出力仕様
共通の Arduino スキル仕様に従って、前提条件、必要なツールとバージョン、実装手順、検証段階ごとのテスト/証拠、既知の制限事項、復旧/セキュリティに関する注意事項を示してください。