Struct Ipc 

#[non_exhaustive]
pub struct Ipc;

Handle that posts a function to a CPU through the IPC interrupt.

Copies of this handle share one state table.

Implementations

impl Ipc

pub const fn new(_ipc: IPC<'_>) -> Self

Creates a new Ipc handle.

The constructor does not install an interrupt handler. crate::init installs the IPC path.

pub fn call_function(self, core: Cpu, handler: fn())

Runs handler on core.

handler runs in an interrupt handler at Priority::min. This call does not wait for handler to return, and a context switch does not delay it.

The interrupt handler saves the registers that the calling convention lets the callee clobber, except the floating-point registers. handler must not use those registers, and must be callable with the cache disabled.

A CPU holds one posted function at a time. If core already holds one, this call behaves as follows:

• If core holds handler, that function has not run yet, and it runs after this call. The two calls coalesce into one run, and this call returns. A caller that needs a run of its own must wait for the pending run.
• If core holds a different function, this call waits until core takes that function. core takes it in a minimum-priority interrupt. That interrupt cannot run in an interrupt-free context, and cannot run on the APP CPU while that CPU is in reset. The wait never ends in those cases.

Panics

In debug builds, panics if core is the APP CPU and that CPU is not running.

Trait Implementations

impl Clone for Ipc

Available on crate feature unstable only.

fn clone(&self) -> Ipc

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Ipc

Available on crate feature unstable only.

impl Debug for Ipc

Available on crate feature unstable only.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.