pub struct TelepathServer<T, const N: usize> { /* private fields */ }Expand description
RPC server that runs on the target MCU.
T is the transport type implementing transport::Transport.
N is the size of the internal receive accumulator and transmit buffers.
§Type parameter guidance
Choose N ≥ 512 to accommodate a max-payload frame with COBS overhead.
Implementations§
Source§impl<T, const N: usize> TelepathServer<T, N>
impl<T, const N: usize> TelepathServer<T, N>
Sourcepub fn new(transport: T, commands: &'static [CommandMetadata]) -> Self
pub fn new(transport: T, commands: &'static [CommandMetadata]) -> Self
Create a new server with the given transport and command registry.
Sourcepub fn resource<R: 'static>(self, val: R) -> Self
pub fn resource<R: 'static>(self, val: R) -> Self
Register a resource for #[resource] injection.
The value is moved into the server’s internal registry and made
available to command shims that declare a matching #[resource]
parameter.
Sourcepub fn find_command(&self, id: u16) -> Option<&CommandMetadata>
pub fn find_command(&self, id: u16) -> Option<&CommandMetadata>
Look up a command by its ID using linear scan.
Linear scan is intentional: embedded command counts are typically ≤ 64, making hash-map overhead unjustified.
Sourcepub fn dispatch(
&mut self,
cmd_id: u16,
input: &[u8],
output: &mut [u8],
) -> Result<DispatchOutcome, DispatchError>
pub fn dispatch( &mut self, cmd_id: u16, input: &[u8], output: &mut [u8], ) -> Result<DispatchOutcome, DispatchError>
Dispatch a pre-decoded payload slice to the matching command handler.
Returns a DispatchOutcome describing how many bytes were written to
output and which ResponseStatus should be emitted.