시리얼 디버그
운영 규칙
사용자가 명시적으로 MCP를 요청하거나 MCP 클라이언트가 이미 설정되지 않은 경우, 먼저 serial-mcp-server CLI를 사용합니다. stdout 데이터는 진단 정보와 분리하고, 정확한 명령어를 인용하며, 하드웨어 성공 여부는 장비에서 나온 실제 명령 증거를 기준으로 합니다.
워크플로우
- 바이너리가 사용 가능한지 확인합니다:
serial-mcp-server --help
- 장치를 선택하기 전에 사용 가능한 포트를 나열합니다:
serial-mcp-server list-ports --json
- 장비 간단 테스트(smoke test)의 경우, 먼저 포트를 프로브(probe)한 후 프로브가 성공했을 때만 쓰기/읽기를 수행합니다:
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이 관련된 경우, 요청된 라인 레벨을 명시하고 control-line 명령어를 사용합니다:
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 및 매크로를 호출하는 어셈블리를 지원합니다. 셸 명령어, 언어 실행, 루프, 변수, Quick 명령어 또는 RTS/DTR 매크로 단계는 지원하지 않습니다.
참고 자료
- 정확한 명령어 동작, 출력 예상 사항 및 자동화 규칙은
references/cli.md를 읽으세요. - 사용자가 MCP 설정이나 MCP 도구 사용을 요청할 때는
references/mcp.md를 읽으세요. - 보드(Baud), 배선, 전압 레벨, RTS, DTR 또는 리셋/부트 라인을 변경하기 전에
references/hardware-safety.md를 읽으세요. - 명령어가 실패하거나, 시간 초과되거나, 포트를 찾을 수 없거나, 장치를 열 수 없을 때는
references/troubleshooting.md를 읽으세요.
보고
명령어, 종료 상태, 관련 JSON 또는 오류 발췌문을 보고하세요. 하드웨어가 연결되지 않은 경우, 검증 요약을 포트 검색 및 도움말 경로로 제한합니다.