序列除錯
操作規則
除非使用者明確要求 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 以及呼叫巨集的組合。不支援 shell 指令、語言執行、迴圈、變數、快速指令或 RTS/DTR 巨集步驟。
參考資料
- 讀取
references/cli.md以了解精確的指令行為、輸出預期及自動化規則。 - 當使用者要求 MCP 設定或 MCP 工具使用時,請讀取
references/mcp.md。 - 在變更 baud、接線、電壓準位、RTS、DTR 或重置/開機線之前,請讀取
references/hardware-safety.md。 - 當指令失敗、逾時、未回傳任何埠或無法開啟裝置時,請讀取
references/troubleshooting.md。
回報
回報指令、退出狀態及相關的 JSON 或錯誤片段。若無連接硬體,則將驗證摘要限於探索與說明路徑。