simon
47c75110c9
Slaves push BMA456 samples at 16ms when enabled; the master caches per client and exposes ACCEL_SNAPSHOT and ACCEL_STREAM over UART. goTool adds dashboard stream controls, HTTP accel-stream routes, and an external WebSocket API with per-connection receive/interval and slave stream commands. Co-authored-by: Cursor <cursoragent@cursor.com>
110 lines
2.6 KiB
Protocol Buffer
110 lines
2.6 KiB
Protocol Buffer
syntax = "proto3";
|
||
|
||
import "nanopb.proto";
|
||
|
||
package alox;
|
||
|
||
enum EspNowMessageType {
|
||
ESPNOW_UNKNOWN = 0;
|
||
ESPNOW_DISCOVER = 1;
|
||
ESPNOW_SLAVE_INFO = 2;
|
||
ESPNOW_HEARTBEAT = 3;
|
||
ESPNOW_SET_ACCEL_DEADZONE = 4;
|
||
ESPNOW_UNICAST_TEST = 5;
|
||
ESPNOW_OTA_START = 6;
|
||
ESPNOW_OTA_PAYLOAD = 7;
|
||
ESPNOW_OTA_END = 8;
|
||
ESPNOW_OTA_STATUS = 9;
|
||
ESPNOW_FIND_ME = 10;
|
||
ESPNOW_RESTART = 11;
|
||
ESPNOW_ACCEL_SAMPLE = 12;
|
||
ESPNOW_SET_ACCEL_STREAM = 13;
|
||
}
|
||
|
||
message EspNowUnicastTest {
|
||
uint32 seq = 1;
|
||
}
|
||
|
||
/** Master → slave: locate pod (LED ring R/G/B ×3 @ full brightness). */
|
||
message EspNowFindMe {
|
||
/** 0 = any slave; otherwise only slave_id must match */
|
||
uint32 client_id = 1;
|
||
}
|
||
|
||
/** Master → slave: reboot after short delay. */
|
||
message EspNowRestart {
|
||
uint32 client_id = 1;
|
||
}
|
||
|
||
message EspNowDiscover {
|
||
uint32 network = 1;
|
||
}
|
||
|
||
message EspNowSlavePresence {
|
||
uint32 network = 1;
|
||
bytes mac = 2;
|
||
uint32 version = 3;
|
||
uint32 slave_id = 4;
|
||
bool available = 5;
|
||
bool used = 6;
|
||
}
|
||
|
||
message EspNowAccelDeadzone {
|
||
uint32 deadzone = 1;
|
||
uint32 client_id = 2; // 0 = all slaves; otherwise only matching slave_id applies
|
||
}
|
||
|
||
/** Master → slave: enable/disable periodic accel ESP-NOW stream (~16 ms). */
|
||
message EspNowAccelStream {
|
||
bool enable = 1;
|
||
uint32 client_id = 2;
|
||
}
|
||
|
||
/** Slave → master: latest BMA456 sample (sent ~every 16 ms). */
|
||
message EspNowAccelSample {
|
||
uint32 slave_id = 1;
|
||
sint32 x = 2;
|
||
sint32 y = 3;
|
||
sint32 z = 4;
|
||
}
|
||
|
||
// Master → slave: begin OTA (erase inactive slot; slave replies ESPNOW_OTA_STATUS).
|
||
message EspNowOtaStart {
|
||
uint32 total_size = 1;
|
||
}
|
||
|
||
// Master → slave: firmware chunk (up to 200 bytes); slave buffers 4 KiB before flash write.
|
||
message EspNowOtaPayload {
|
||
uint32 seq = 1;
|
||
bytes data = 2 [(nanopb).max_size = 200];
|
||
}
|
||
|
||
// Master → slave: finalize OTA (flush, esp_ota_end, set boot partition).
|
||
message EspNowOtaEnd {}
|
||
|
||
// Slave → master: status / block ACK (same status codes as UART OtaStatusPayload).
|
||
message EspNowOtaStatus {
|
||
uint32 status = 1;
|
||
uint32 bytes_written = 2;
|
||
uint32 error = 3;
|
||
}
|
||
|
||
message EspNowMessage {
|
||
EspNowMessageType type = 1;
|
||
oneof payload {
|
||
EspNowDiscover discover = 2;
|
||
EspNowSlavePresence slave_info = 3;
|
||
EspNowSlavePresence heartbeat = 4;
|
||
EspNowAccelDeadzone accel_deadzone = 5;
|
||
EspNowUnicastTest unicast_test = 6;
|
||
EspNowOtaStart ota_start = 7;
|
||
EspNowOtaPayload ota_payload = 8;
|
||
EspNowOtaEnd ota_end = 9;
|
||
EspNowOtaStatus ota_status = 10;
|
||
EspNowFindMe find_me = 11;
|
||
EspNowRestart restart = 12;
|
||
EspNowAccelSample accel_sample = 13;
|
||
EspNowAccelStream accel_stream = 14;
|
||
}
|
||
}
|