simon
3cb0b5bbe9
Slaves report pack voltages every 30s; the master caches them for fast BATTERY_STATUS reads. goTool exposes REST/WebSocket and shows values in the dashboard, with a nanopb fix so optional lipo submessages encode. Co-authored-by: Cursor <cursoragent@cursor.com>
144 lines
3.4 KiB
Protocol Buffer
144 lines
3.4 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;
|
||
ESPNOW_LED_RING = 14;
|
||
ESPNOW_BATTERY_QUERY = 15;
|
||
ESPNOW_BATTERY_REPORT = 16;
|
||
}
|
||
|
||
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: on-demand LiPo read (optional; slaves also push every ~30 s). */
|
||
message EspNowBatteryQuery {
|
||
uint32 client_id = 1;
|
||
}
|
||
|
||
/** Slave → master: LiPo voltages (periodic ~30 s and on query). */
|
||
message EspNowBatteryReport {
|
||
uint32 client_id = 1;
|
||
bool lipo1_valid = 2;
|
||
bool lipo2_valid = 3;
|
||
uint32 lipo1_mv = 4;
|
||
uint32 lipo2_mv = 5;
|
||
}
|
||
|
||
/** Master → slave: LED ring command (same modes as UART LedRingProgressRequest). */
|
||
message EspNowLedRing {
|
||
uint32 client_id = 1;
|
||
uint32 mode = 2;
|
||
uint32 progress = 3;
|
||
uint32 digit = 4;
|
||
uint32 r = 5;
|
||
uint32 g = 6;
|
||
uint32 b = 7;
|
||
uint32 intensity = 8;
|
||
uint32 blink_ms = 9;
|
||
uint32 blink_count = 10;
|
||
}
|
||
|
||
// 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;
|
||
EspNowLedRing led_ring = 15;
|
||
EspNowBatteryQuery battery_query = 16;
|
||
EspNowBatteryReport battery_report = 17;
|
||
}
|
||
}
|