Depuração Serial
Regra de Operação
Use o CLI serial-mcp-server primeiro, a menos que o usuário solicite explicitamente o MCP ou um cliente MCP já esteja configurado. Mantenha os dados de stdout separados dos diagnósticos, cite comandos exatos e baseie o sucesso do hardware em evidências reais de comandos do dispositivo.
Fluxo de Trabalho
- Confirme que o binário está disponível:
serial-mcp-server --help
- Liste as portas disponíveis antes de escolher um dispositivo:
serial-mcp-server list-ports --json
- Para um teste rápido do dispositivo, primeiro teste a porta e depois escreva/leia apenas quando o teste for bem-sucedido:
serial-mcp-server probe --port <porta> --baud 115200 --json
serial-mcp-server write --port <porta> --baud 115200 --data H --read --timeout-ms 1000 --json
- Se RTS ou DTR estiverem envolvidos, informe os níveis de linha solicitados e use o comando de control-lines:
serial-mcp-server set-control-lines --port <porta> --rts high --dtr low --json
- Para procedimentos seriais repetíveis, prefira pacotes de macros JSON e valide ou planeje-os antes da execução em hardware real:
serial-mcp-server macro validate --file <pacote.json> --json
serial-mcp-server macro plan --file <pacote.json> --macro <nome> --json
serial-mcp-server macro run --file <pacote.json> --macro <nome> --simulate-read <resposta> --json
serial-mcp-server macro run --file <pacote.json> --macro <nome> --port <porta> --baud 115200 --json
Pacotes de macro são arquivos DSL JSON restritos. v0.3 suporta send, delay, expect contains, expect equals e montagens que chamam macros. Não suporta execução de shell, execução de linguagem, loops, variáveis, comandos rápidos ou etapas de macro RTS/DTR.
Referências
- Leia
references/cli.mdpara comportamento exato de comandos, expectativas de saída e regras de automação. - Leia
references/mcp.mdquando o usuário solicitar configuração MCP ou uso de ferramentas MCP. - Leia
references/hardware-safety.mdantes de alterar baud, cabeamento, níveis de tensão, RTS, DTR ou linhas de reset/boot. - Leia
references/troubleshooting.mdquando um comando falhar, expirar, não retornar portas ou não conseguir abrir o dispositivo.
Relatório
Relate o comando, o status de saída e o trecho relevante de JSON ou erro. Se nenhum hardware estiver conectado, limite o resumo de validação aos caminhos de descoberta e ajuda.