Struct ModeContext

pub(crate) struct ModeContext {
    k: Arc<KeychainWithOrbit>,
    o_ch: Arc<RwLock<OrbitCharacteristics>>,
    super_v: Arc<Supervisor>,
    zo_mon: RwLock<Receiver<KnownImgObjective>>,
    bo_mon: RwLock<Receiver<BeaconControllerState>>,
    k_buffer: Mutex<BinaryHeap<KnownImgObjective>>,
    beac_cont: Arc<BeaconController>,
}

ModeContext is a central context container used by GlobalMode in the onboard software. It provides shared access to key mission-critical resources such as orbit state, supervisory control, objective channels, and internal buffers.

This structure enables modular FSM behavior by providing thread-safe, concurrent access to both live and buffered data, allowing GlobalMode to remain more or less stateless and focused solely on decision logic.

Fields

k: Arc<KeychainWithOrbit>

Shared keychain containing the various controllers and the orbit configuration.

o_ch: Arc<RwLock<OrbitCharacteristics>>

Orbit characteristics, updated during operation (e.g., after burns).

super_v: Arc<Supervisor>

Supervisor instance providing new observation data, objective data, etc.

zo_mon: RwLock<Receiver<KnownImgObjective>>

Receiver for new Known Image Objectives (Zoned Objectives).

bo_mon: RwLock<Receiver<BeaconControllerState>>

Watch receiver for the current state of the Beacon Controller.

k_buffer: Mutex<BinaryHeap<KnownImgObjective>>

Priority buffer for scheduled image objectives, used by internal planners.

beac_cont: Arc<BeaconController>

Shared access to the Beacon Controller for retrieval logic and updates.

Implementations

impl ModeContext

pub(crate) fn new( key: KeychainWithOrbit, o_char: OrbitCharacteristics, zo_mon_un: Receiver<KnownImgObjective>, bo_mon_un: Receiver<BeaconControllerState>, super_v: Arc<Supervisor>, beac_cont: Arc<BeaconController>, ) -> Arc<Self>

Constructs a new ModeContext, initializing all internal references.

Arguments

• key: The mission keychain, including the basic controllers and the orbit.
• o_char: Initial orbital characteristics.
• zo_mon_un: Receiver for incoming Known Image Objectives.
• bo_mon_un: Watch receiver for beacon controller state updates.
• super_v: Shared Supervisor handle.
• beac_cont: Shared BeaconController for beacon objective management.

pub(super) fn k(&self) -> &Arc<KeychainWithOrbit>

Provides a reference to the KeychainWithOrbit.

pub(crate) async fn o_ch_clone(&self) -> OrbitCharacteristics

Provides a copy of the current OrbitCharacteristics.

pub(super) fn o_ch_lock(&self) -> &RwLock<OrbitCharacteristics>

Provides a reference to the shared and locked OrbitCharacteristics.

pub(super) fn zo_mon(&self) -> &RwLock<Receiver<KnownImgObjective>>

Provides a reference to the locked Zoned Objective Event Receiver.

pub(super) fn bo_mon(&self) -> &RwLock<Receiver<BeaconControllerState>>

Provides a reference to the watch resembling the current state of the Beacon controller.

pub(super) fn super_v(&self) -> &Arc<Supervisor>

Provides a shared reference to the Supervisor.

pub(super) fn k_buffer(&self) -> &Mutex<BinaryHeap<KnownImgObjective>>

Provides a reference to the locked Zoned Objective Buffer implemented as a BinaryHeap.

pub(super) fn beac_cont(&self) -> &Arc<BeaconController>

Provides a shared reference to the BeaconController.