Struct NullNodeRuntime 

pub struct NullNodeRuntime;

No-op NodeDispatchRuntime for tests / placeholders. Every call returns Err(()) so callers that depend on a populated runtime fail loud rather than silently no-op.

BoardEntry::run impls replace this with a real ExecutorNodeRuntime-backed sink before invoking the user setup closure.

Trait Implementations

impl Debug for NullNodeRuntime

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

Formats the value using the given formatter.

impl Default for NullNodeRuntime

fn default() -> NullNodeRuntime

Returns the “default value” for a type.

impl NodeDispatchRuntime for NullNodeRuntime

fn spin_once(&mut self, _timeout_ms: u32) -> Result<(), ()>

Drive the underlying executor for at most timeout_ms milliseconds. Ok(()) on a clean spin (including timeout); Err(()) if the executor surfaces a spin error.

fn apply_lifecycle(&mut self, autostart: u8) -> Result<(), &'static str>

Phase 264 W2 — register the REP-2002 lifecycle services on the underlying executor + drive boot autostart. autostart: 0 = none, 1 = configure, 2 = configure+activate. Default no-op (non-executor runtimes, or nros built without lifecycle-services); the ExecutorNodeRuntime impl in nros does the real work behind that feature. nros::main! calls this (via RuntimeCtx::apply_lifecycle) when system.toml declares [lifecycle], mirroring the bake’s generate.rs::render_lifecycle_fn. issue 0460 — the Err carries a STATIC REASON, not ().

fn apply_param_services(&mut self) -> Result<(), &'static str>

Phase 264 W4b – register the 6 ROS 2 parameter services on the underlying executor and create its volatile RAM param store. Launch <param> initials are NOT passed here (issue 1272): each node’s are seeded on that node as it is built, from the params slice nros::main! sets before the node’s register call. After this, ros2 param list/get/set works against the running node; reconfigured values live in RAM until the next boot (RFC-0004 §10; persistence is out of scope, issue 0080). Default no-op (non-executor runtimes, or nros built without param-services); the ExecutorNodeRuntime impl in nros does the real work behind that feature. nros::main! calls this (via RuntimeCtx::apply_param_services) when system.toml declares [param_services], mirroring the bake’s generate.rs::render_param_persistence_fn. issue 0460 — the Err carries a STATIC REASON, not ().

fn apply_param_store(&mut self) -> Result<(), &'static str>

phase-461 W6 – build the parameter STORE and register no service: the params capability axis. nros::main! calls this (via RuntimeCtx::apply_param_store) before the per-node register calls when the system declares params and not param_services. Default no-op (non-executor runtimes, or nros built without param-store, which the entry const-asserts against).

fn executor_handle(&mut self) -> *mut c_void

Phase 258 (Track 2, 2a) — raw *mut Executor (as void*) for the owned-spin entry, so a Node pkg’s register(runtime) wrapper can call the uniform __nros_component_<pkg>_install(.., executor, ..) seam (nros::install_node_typed) instead of the retired opaque-fn-ptr register_dispatch_slot_dyn bridge. A pointer crosses the nros-platform → nros layering wall cleanly (the concrete ExecutorNodeRuntime lives in nros; this trait can’t name it).

fn apply_declared_params( &mut self, nodes: &'static [(&'static str, &'static str)], params: &'static [(&'static str, &'static str, u8)], ) -> Result<(), &'static str>

phase-446 W6 – hand the executor the parameters each node’s contract DECLARES, so a node whose code declares a parameter its contract does not (or with another type) refuses the boot naming the node, the parameter and the contract.

fn observed_callback_counts(&self) -> (usize, usize)

Observability counters from hosted/runtime tests.

fn signal_callback(&mut self, _cb: SignaledCallback<'_>)

Hand a signaled callback to the framework-side dispatcher (Phase 216.A.2). Only meaningful for DispatchStrategy::Deferred (RTIC / Embassy) runtimes — Inline runtimes drive callbacks directly from spin_once and never call this. The default panic surfaces the mis-wire loudly rather than silently dropping the callback signal.

fn dispatch_strategy(&self) -> DispatchStrategy

Declare how this runtime delivers callbacks (Phase 216.A.2). nros check (Phase 216.D.1) cross-validates each Node pkg’s Node::DISPATCH against this value. Defaults to Inline so every existing impl reports the historical behavior unchanged.