Protocol ======== 0 0 X Ping (no further payload) 1 0 0 Pong (maybe return version string in the future) 2 0 0 Reset (64 bytes reset secret) 4 0 N Unlock secret (64 bytes payload) 4 1..N-1 N Firmware binary (64 bytes payload) 4 N N First half of hash 5 n N Firmware ACK 6 0..N-1 N+3 Image binary (64 bytes payload) 6 N N+3 Salt A 6 N+1 N+3 Salt B 6 N+2 N+3 Hash A 6 N+3 N+3 Hash B 7 n 0 Image ACK 8 0 4 Parameter block (64 bytes payload) 8 1 4 Salt A 8 2 4 Salt B 8 3 4 Hash A 8 4 4 Hash B 9 n 0 Parameter ACK 10 0 0 Sample (64 bytes payload) 11 0 0 Sample ACK 13 n 0 Samples Unlock, firmware, image, and parameter packets all have a fixed-size 64 bytes payload. Pings and acknowledgements have no payload. Pongs may have a variable-size payload. Even numbered packet types correspond to packets sent from the remote controller to the device. Odd numbered packet types correspond to responses. The device never initiates communication. Image format ============ Two bytes per line. LSB of first byte is LED A1, MSB of last byte is B8. Unused lines must be set to zero. Sample format ============= Each sample packet has the following structure: Offset Size 0 2 Absolute time of X sample, high 16 bits 2 8*N N samples Where each sample is Offset Size 0 2 Absolute time of X sample, lower 16 bits 2 2 X sample (0-1023) 4 2 Absolute time of Y sample, lower 16 bits 6 2 Y sample (0-1023) Byte order is little-endian.