Serielles Debuggen
Betriebsregel
Verwenden Sie zuerst die serial-mcp-server CLI, es sei denn, der Benutzer fragt explizit nach MCP oder ein MCP-Client ist bereits konfiguriert. Halten Sie stdout-Daten von Diagnose getrennt, zitieren Sie genaue Befehle und basieren Sie den Hardware-Erfolg auf echten Befehlsergebnissen vom Gerät.
Arbeitsablauf
- Stellen Sie sicher, dass die Binärdatei verfügbar ist:
serial-mcp-server --help
- Listen Sie verfügbare Ports auf, bevor Sie ein Gerät auswählen:
serial-mcp-server list-ports --json
- Für einen Geräte-Smoke-Test testen Sie zuerst den Port, dann schreiben/lesen Sie nur, wenn der Test erfolgreich ist:
serial-mcp-server probe --port <port> --baud 115200 --json
serial-mcp-server write --port <port> --baud 115200 --data H --read --timeout-ms 1000 --json
- Wenn RTS oder DTR beteiligt ist, geben Sie die angeforderten Leitungspegel an und verwenden Sie den Befehl zur Steuerleitung:
serial-mcp-server set-control-lines --port <port> --rts high --dtr low --json
- Für wiederholbare serielle Prozeduren bevorzugen Sie JSON-Makropakete und validieren oder planen Sie diese vor der Ausführung auf echter Hardware:
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
Makropakete sind eingeschränkte JSON-DSL-Dateien. v0.3 unterstützt send, delay, expect contains, expect equals und Assemblies, die Makros aufrufen. Es werden keine Shell-Befehle, Sprachausführung, Schleifen, Variablen, Quick-Befehle oder RTS/DTR-Makroschritte unterstützt.
Referenzen
- Lesen Sie
references/cli.mdfür genaues Befehlverhalten, Ausgabeerwartungen und Automatisierungsregeln. - Lesen Sie
references/mcp.md, wenn der Benutzer nach MCP-Einrichtung oder MCP-Toolnutzung fragt. - Lesen Sie
references/hardware-safety.md, bevor Sie Baudrate, Verkabelung, Spannungspegel, RTS, DTR oder Reset-/Boot-Leitungen ändern. - Lesen Sie
references/troubleshooting.md, wenn ein Befehl fehlschlägt, eine Zeitüberschreitung auftritt, keine Ports zurückgegeben werden oder das Gerät nicht geöffnet werden kann.
Berichterstattung
Melden Sie den Befehl, den Exit-Status und den relevanten JSON- oder Fehlerauszug. Wenn keine Hardware angeschlossen ist, beschränken Sie die Validierungszusammenfassung auf Erkennungs- und Hilfspfade.