Files
codetiger 7dfe9fa48b Add ProtocolSync command and improve MITM logging format
SangamIO changes:
- Add ProtocolSync command (0x0C) for GD32 wake sequence at boot
- Add CMD_PROTOCOL_SYNC constant and cmd_protocol_sync() builder
- Handle protocol sync ACK in reader loop with logging
- Update COMMANDS.md with full AuxCtrl init sequence from MITM capture

Protocol-MITM changes:
- Simplify log format to CSV for easier parsing and analysis
- Configure PTY slave for raw mode to prevent escape encoding
- Remove verbose packet decoding (now done in post-processing)
- Update documentation with new CSV format specification

Other:
- Add *.log to gitignore
- Remove unused mitm_init.sh script
- Update deployment scripts for simplified workflow
2025-11-27 15:55:56 +05:30
..

MITM Logging Tools

Helper scripts for automated GD32 protocol capture during vacuum cleaning operations.

Quick Start

# 1. Deploy everything to robot
./mitm_deploy_all.sh

# 2. Enable MITM mode
./mitm_enable.sh

# 3. For each of 3-5 runs:
./mitm_reboot_robot.sh          # Reboot & start MITM
# → Press button on robot to start cleaning
# → Wait for robot to dock
./mitm_finish_run.sh            # Stop logging

# 4. Retrieve all logs
./mitm_retrieve_logs.sh

# 5. Disable MITM and restore
./mitm_disable.sh

Available Scripts

Script Purpose
mitm_deploy_all.sh Build serial_mitm binary and deploy all scripts to robot
mitm_enable.sh Enable MITM mode (takes effect on next boot)
mitm_disable.sh Disable MITM mode and restore normal operation
mitm_reboot_robot.sh Reboot robot and wait for MITM to start
mitm_finish_run.sh Stop current capture run and show progress
mitm_retrieve_logs.sh Download all capture logs from robot

Documentation

See ../docs/MITM_LOGGING_GUIDE.md for complete documentation.