PluginError

Defined in: error.rs:25

pub enum PluginError {
    BadCommand(String),
    MissingActuator { command: &'static str },
    Init(String),
    UnsupportedOperation(&'static str),
    Runtime(String),
}

Errors produced by a plugin-layer controller or actuator bridge.

Phase P1 will add dedicated variants for the WASM backend: Trap, OutOfFuel, OutOfMemory, GuestPanic, Marshal, ApiVersionMismatch. The current Runtime(String) catch-all will shrink as those land.

Variants

BadCommand

BadCommand(String)

A guest returned a command containing NaN / Inf. The host must never forward such a command to the actuator layer because the downstream ODE integration would propagate the non-finite value into the whole 14-D spacecraft state.

---

MissingActuator

command: &‘static str

The actuator bridge was asked to apply a command field that the current ActuatorBundle does not have a target for (e.g. a magnetic_moment command when no magnetorquer is configured).

---

Init

Init(String)

The host could not load / init a guest (Phase P1+).

---

UnsupportedOperation

UnsupportedOperation(&‘static str)

The controller does not implement the requested optional operation (e.g. snapshot_state / restore_state on a native controller that has no serializable internal state).

---

Runtime

Runtime(String)

Catch-all for backends that have richer error taxonomies than the ones listed above. Phase P1 will replace most uses of this with dedicated variants (Trap, OutOfFuel, OutOfMemory, GuestPanic, Marshal, ApiVersionMismatch).

---