Skip to main content

TelepathServer

Struct TelepathServer 

Source
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>

Source

pub fn new(transport: T, commands: &'static [CommandMetadata]) -> Self

Create a new server with the given transport and command registry.

Source

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.

Source

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.

Source

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.

Source§

impl<T: Transport, const N: usize> TelepathServer<T, N>

Source

pub fn poll(&mut self)

Process any pending bytes from the transport.

Call this in a tight loop. Reads all available bytes, accumulates them into COBS frames, and sends a response for each complete request.

Auto Trait Implementations§

§

impl<T, const N: usize> !Freeze for TelepathServer<T, N>

§

impl<T, const N: usize> !RefUnwindSafe for TelepathServer<T, N>

§

impl<T, const N: usize> Send for TelepathServer<T, N>
where T: Send,

§

impl<T, const N: usize> !Sync for TelepathServer<T, N>

§

impl<T, const N: usize> Unpin for TelepathServer<T, N>
where T: Unpin,

§

impl<T, const N: usize> UnsafeUnpin for TelepathServer<T, N>
where T: UnsafeUnpin,

§

impl<T, const N: usize> UnwindSafe for TelepathServer<T, N>
where T: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.