Admin
RESETBack to passthrough
RESET drops all injection and returns the box to passthrough. Opcode 0x04.
RESET 0x04 · payload 1 byte
Fire-and-forget
A flags byte. 0x00 is the plain release below.
| Bit | Name | Effect |
|---|---|---|
0x01 | NVS | Also erases the persistent store and reboots. The box comes back at defaults, under the MAC-derived name. |
Any other bit refuses the whole frame, release included. A frame with no payload does nothing: the byte is required, like every command's payload.
Releases all PC-owned state in one frame: both accumulators, every INJECT override, every LOCK scale and the bearing, the CATCH subscription table, the rewrite rules, the transforms, the loaded clip, and any LED override.
The emitted report is then byte-identical to passthrough. A second RESET is a no-op. The safety auto-clear performs the same release. Library binding: reset.
The release runs first. The box then erases the nvs partition and reboots. The erase loses the box name, every option, and everything learned about devices seen, including any descriptor patch set. Settings load into RAM at boot, so the reboot restores the defaults.
The clone re-enumerates on the game PC. The control port stays enumerated, so queries time out until the box replies again. Library binding: factory_reset.
Plain release, then with the flag:
REBOOTRestart a chip
REBOOT restarts one of the two chips, mainly into ROM download mode (the built-in bootloader that accepts new firmware) for flashing. Opcode 0x07.
REBOOT 0x07 · payload 1 byte
Fire-and-forget
| Offset | Field | Type | Notes |
|---|---|---|---|
| 0 | target | u8 | which chip and mode (see below) |
| Target | Value | Effect |
|---|---|---|
| device download | 0 | Device chip enters ROM download, then flash over the CH343 link. |
| host download | 1 | Device chip relays a download reboot to the host chip. Flash the host chip over USB3. |
| device run | 2 | Device chip reboots to run firmware. |
| host run | 3 | Device chip relays a run reboot to the host chip. |
Reboot-to-run (2 or 3) is the board's only software cold-reboot. DTR/RTS auto-reset isn't wired. No reply. Library binding: reboot.
target = 2 (device chip to run):
LOGDevice diagnostics
LOG is unsolicited diagnostic text, in place of an ASCII console. Opcode 0x08.
LOG 0x08 · box → PC
Unsolicited
| Offset | Field | Type | Notes |
|---|---|---|---|
| 0 | level | u8 | severity (see below) |
| 1.. | text | UTF-8 | log line, not NUL-terminated, length = LEN - 1 |
| Value | Level |
|---|---|
0 | error |
1 | warn |
2 | info |
3 | debug |
4 | verbose |
Sent only while a control PC is attached. Logging before first contact is dropped. The box's other outbound frames are RESP, TRANSFER_RESP, UPDATE_RESP, and the catch events MOTION_EVENT, USAGE_EVENT and TRAFFIC_EVENT. Library binding: logs.
level = 2 (info), text hi (68 69):