Debug série
Règle d'utilisation
Utilisez d'abord la CLI serial-mcp-server, sauf si l'utilisateur demande explicitement MCP ou qu'un client MCP est déjà configuré. Séparez les données stdout des diagnostics, citez les commandes exactes et basez la réussite matérielle sur des preuves de commandes réelles provenant du périphérique.
Workflow
- Confirmez que le binaire est disponible :
serial-mcp-server --help
- Listez les ports disponibles avant de choisir un périphérique :
serial-mcp-server list-ports --json
- Pour un test de validation du périphérique, sondez d'abord le port, puis écrivez/lisez uniquement lorsque la sonde réussit :
serial-mcp-server probe --port <port> --baud 115200 --json
serial-mcp-server write --port <port> --baud 115200 --data H --read --timeout-ms 1000 --json
- Si RTS ou DTR est impliqué, indiquez les niveaux de ligne demandés et utilisez la commande de contrôle des lignes :
serial-mcp-server set-control-lines --port <port> --rts high --dtr low --json
- Pour les procédures série répétables, privilégiez les packs de macros JSON et validez ou planifiez-les avant l'exécution sur du matériel réel :
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
Les packs de macros sont des fichiers DSL JSON restreints. v0.3 prend en charge send, delay, expect contains, expect equals et les assemblages qui appellent des macros. Il ne prend pas en charge les commandes shell, l'exécution de langage, les boucles, les variables, les commandes rapides (Quick commands) ni les étapes de macro RTS/DTR.
Références
- Lisez
references/cli.mdpour le comportement exact des commandes, les attentes en sortie et les règles d'automatisation. - Lisez
references/mcp.mdlorsque l'utilisateur demande une configuration MCP ou l'utilisation d'outils MCP. - Lisez
references/hardware-safety.mdavant de changer le baud, les connexions, les niveaux de tension, RTS, DTR, ou les lignes de reset/boot. - Lisez
references/troubleshooting.mdlorsqu'une commande échoue, expire, ne renvoie aucun port, ou ne peut pas ouvrir le périphérique.
Rapport
Signalez la commande, l'état de sortie et l'extrait JSON ou d'erreur pertinent. Si aucun matériel n'est connecté, limitez le résumé de validation aux chemins de découverte et d'aide.