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
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.