Struct Protocol 

pub struct Protocol { /* private fields */ }

Transport-agnostic protocol handler

This handles protocol parsing and command buffering. It does NOT handle transport connection/disconnection.

Implementations

impl Protocol

pub fn new(device_name: &'static str) -> Self

Create a new protocol handler

pub fn device_name(&self) -> &str

Get device name

pub fn is_connected(&self) -> bool

Check if connected (application-managed)

pub fn set_connected(&mut self, connected: bool)

Set connection status (called by application)

pub fn process_received_data(&mut self, data: &[u8])

Process incoming data from transport layer

This appends data to the internal buffer for parsing. Call receive_command() to extract parsed commands.

Transport Independence: This method accepts bytes from ANY source:

• BLE notification data
• USB CDC read buffer
• UART RX buffer
• WiFi socket data

pub fn receive_command(&mut self) -> Option<Command>

Parse and consume the next command from the buffer

Returns Some(Command) if a complete, valid command was parsed. Returns None if buffer is empty or packet is incomplete/invalid.

pub fn get_capabilities_data(&self, caps: &str) -> Vec<u8, 256>

Format capabilities JSON into byte buffer

Example capabilities string:

{
  "sensors": {"accel": true, "mag": true},
  "gpio": {"digital": 8, "pwm": 8},
  "display": {"matrix": true}
}