Depuración Serie
Regla de Operación
Use primero la CLI serial-mcp-server a menos que el usuario solicite explícitamente MCP o que un cliente MCP ya esté configurado. Mantenga los datos de stdout separados de los diagnósticos, cite comandos exactos y base el éxito del hardware en evidencia real de comandos del dispositivo.
Flujo de Trabajo
- Confirme que el binario está disponible:
serial-mcp-server --help
- Enumere los puertos disponibles antes de elegir un dispositivo:
serial-mcp-server list-ports --json
- Para una prueba rápida del dispositivo, primero sondee el puerto, luego escriba/lea solo si el sondeo tiene éxito:
serial-mcp-server probe --port <puerto> --baud 115200 --json
serial-mcp-server write --port <puerto> --baud 115200 --data H --read --timeout-ms 1000 --json
- Si RTS o DTR están involucrados, indique los niveles de línea solicitados y use el comando de líneas de control:
serial-mcp-server set-control-lines --port <puerto> --rts high --dtr low --json
- Para procedimientos serie repetibles, prefiera paquetes de macros JSON y valídelos o planifíquelos antes de la ejecución en hardware real:
serial-mcp-server macro validate --file <paquete.json> --json
serial-mcp-server macro plan --file <paquete.json> --macro <nombre> --json
serial-mcp-server macro run --file <paquete.json> --macro <nombre> --simulate-read <respuesta> --json
serial-mcp-server macro run --file <paquete.json> --macro <nombre> --port <puerto> --baud 115200 --json
Los paquetes de macros son archivos DSL JSON restringidos. v0.3 soporta send, delay, expect contains, expect equals y ensambles que llaman macros. No soporta comandos de shell, ejecución de lenguajes, bucles, variables, comandos rápidos ni pasos de macro RTS/DTR.
Referencias
- Lea
references/cli.mdpara conocer el comportamiento exacto de los comandos, las expectativas de salida y las reglas de automatización. - Lea
references/mcp.mdcuando el usuario solicite configuración de MCP o uso de herramientas MCP. - Lea
references/hardware-safety.mdantes de cambiar la velocidad en baudios, el cableado, los niveles de voltaje, RTS, DTR o las líneas de reset/arranque. - Lea
references/troubleshooting.mdcuando un comando falle, se agote el tiempo de espera, no devuelva puertos o no pueda abrir el dispositivo.
Reportes
Reporte el comando, el estado de salida y el extracto relevante de JSON o error. Si no hay hardware conectado, limite el resumen de validación a las rutas de descubrimiento y ayuda.