シリアルデバッグ
運用ルール
ユーザーが明示的にMCPを要求した場合、またはMCPクライアントが既に設定されている場合を除き、最初はserial-mcp-server CLIを使用してください。stdoutのデータは診断情報と分けて保持し、正確なコマンドを引用し、ハードウェアの成功はデバイスからの実際のコマンド証拠に基づいてください。
ワークフロー
- バイナリが利用可能かを確認する:
serial-mcp-server --help
- デバイスを選択する前に、利用可能なポートを一覧表示する:
serial-mcp-server list-ports --json
- デバイスのスモークテストでは、まずポートをプローブし、プローブが成功した場合のみ書き込み/読み取りを行う:
serial-mcp-server probe --port <port> --baud 115200 --json
serial-mcp-server write --port <port> --baud 115200 --data H --read --timeout-ms 1000 --json
- RTSまたはDTRが関係する場合は、要求するライン・レベルを指定し、制御ライン・コマンドを使用する:
serial-mcp-server set-control-lines --port <port> --rts high --dtr low --json
- 反復可能なシリアル手順では、JSONマクロパックを優先し、実際のハードウェア実行前に検証または計画する:
serial-mcp-server macro validate --file <pack.json> --json
serial-mcp-server macro plan --file <pack.json> --macro <name> --json
serial-mcp-server macro run --file <pack.json> --macro <name> --simulate-read <response> --json
serial-mcp-server macro run --file <pack.json> --macro <name> --port <port> --baud 115200 --json
マクロパックは制限付きJSON DSLファイルです。v0.3では、send、delay、expect contains、expect equals、およびマクロを呼び出すアセンブリをサポートしています。シェルコマンド、言語実行、ループ、変数、Quickコマンド、またはRTS/DTRのマクロステップはサポートしていません。
リファレンス
- 正確なコマンド動作、出力の期待値、自動化ルールについては
references/cli.mdを参照してください。 - ユーザーがMCPのセットアップまたはMCPツールの使用を要求した場合は
references/mcp.mdを参照してください。 - ボーレート、配線、電圧レベル、RTS、DTR、リセット/ブートラインを変更する前に
references/hardware-safety.mdを参照してください。 - コマンドが失敗した、タイムアウトした、ポートが返ってこない、またはデバイスを開けない場合は
references/troubleshooting.mdを参照してください。
レポート
コマンド、終了ステータス、関連するJSONまたはエラー抜粋を報告してください。ハードウェアが接続されていない場合は、検証サマリーをディスカバリとヘルプパスに限定してください。