Struct InOrbitMode

pub struct InOrbitMode {
    base: BaseMode,
}

InOrbitMode is an implementation of GlobalMode and OrbitalMode that governs normal in-orbit operations such as transitioning between flight states, listening for event-driven interrupts (e.g., Safe Mode, ZO, BO), and executing scheduled task queues specific to the InOrbitMode.

This mode represents the satellite operating in a stable orbital state, performing mapping or communication tasks.

The mode is interruptible and reactive to new objectives, flight events, or beacon detections.

Fields

base: BaseMode

The base operational context (e.g. Mapping or Beacon Objective Scanning).

Implementations

impl InOrbitMode

const MODE_NAME: &'static str = "InOrbitMode"

The internal name of the mode used for logging and identification.

pub fn new(base: BaseMode) -> Self

Constructs a new InOrbitMode instance using the given BaseMode.

Arguments

• base – The high-level operational context (e.g., MappingMode).

Returns

• InOrbitMode – The initialized mode.

Trait Implementations

impl Clone for InOrbitMode

fn clone(&self) -> InOrbitMode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl GlobalMode for InOrbitMode

fn type_name(&self) -> &'static str

Returns the static name of this mode.

fn init_mode<'life0, 'async_trait>( &'life0 self, context: Arc<ModeContext>, ) -> Pin<Box<dyn Future<Output = OpExitSignal> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Initializes the mode by running scheduling logic and listening for early exit signals.

Reacts to Safe Mode signals and reinitializes if needed. Otherwise, continues with task list execution.

Arguments

• context – The shared execution context for the mode.

Returns

• OpExitSignal – Signal indicating if the mode should continue or reinitialize.

fn exec_task_wait<'life0, 'async_trait>( &'life0 self, c: Arc<ModeContext>, due: DateTime<Utc>, ) -> Pin<Box<dyn Future<Output = WaitExitSignal> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Delegates to the default orbital task wait logic, including early exits.

Arguments

• c – The mode context.
• due – Scheduled time of task execution.

Returns

• WaitExitSignal – Signal indicating why the wait was interrupted (if at all).

fn exec_task<'life0, 'async_trait>( &'life0 self, context: Arc<ModeContext>, task: Task, ) -> Pin<Box<dyn Future<Output = ExecExitSignal> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Executes a single scheduled task.

Only state-switching tasks are valid in this mode. Other task types will cause a fatal error.

Arguments

• context – Mode context for task execution.
• task – Task to execute.

Returns

• ExecExitSignal::Continue – Always returned unless fatal occurs.

fn safe_handler<'life0, 'async_trait>( &'life0 self, context: Arc<ModeContext>, ) -> Pin<Box<dyn Future<Output = OpExitSignal> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Handles the transition into FlightState::Safe, executing a fallback escape sequence and finishing the orbit phase.

Arguments

• context – Mode context for safe handling.

Returns

• OpExitSignal::ReInit – Always reinitializes the current mode.

fn zo_handler<'life0, 'life1, 'async_trait>( &'life0 self, c: &'life1 Arc<ModeContext>, obj: KnownImgObjective, ) -> Pin<Box<dyn Future<Output = Option<OpExitSignal>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handles the detection of a new Zoned Objective.

Attempts to switch to a ZOPrepMode. If the objective is unreachable, logs a warning and continues.

Arguments

• c – Shared context.
• obj – The newly received zoned objective.

Returns

• Some(OpExitSignal::ReInit) – If transition to ZOPrepMode is feasible.
• None – If the objective is not reachable (e.g., burn not possible).

fn bo_event_handler<'life0, 'life1, 'async_trait>( &'life0 self, context: &'life1 Arc<ModeContext>, ) -> Pin<Box<dyn Future<Output = Option<OpExitSignal>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handles a beacon objective event by toggling to the complementary base mode. Logs the beacon transition reason and returns a reinit signal to the new mode.

Arguments

• context – Shared mode context.

Returns

• Some(OpExitSignal::ReInit) – Always switches to the next beacon mode.

fn exit_mode<'life0, 'async_trait>( &'life0 self, context: Arc<ModeContext>, ) -> Pin<Box<dyn Future<Output = Box<dyn GlobalMode>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Performs final cleanup when exiting the mode and marks the phase as finished.

Arguments

• context – Shared context.

Returns

• Box<dyn GlobalMode> – A boxed copy of the current mode.

fn safe_mode_rationale(&self) -> &'static str

Returns the rationale string for finishing the current phase due to safe mode entry.

fn new_zo_rationale(&self) -> &'static str

Returns the rationale string for finishing the current phase due to a new Zoned Objective.

fn new_bo_rationale(&self) -> &'static str

Returns the rationale string for finishing the current phase due to a new Beacon Objective.

fn tasks_done_rationale(&self) -> &'static str

Returns the rationale string used when the task queue has completed.

fn tasks_done_exit_rationale(&self) -> &'static str

Returns the rationale for finishing the task queue and exiting the orbit for ZO Retrieval.

fn out_of_orbit_rationale(&self) -> &'static str

Returns the rationale for finishing the current phase due to being outside of orbit without a valid reason.

fn bo_done_rationale(&self) -> &'static str

Returns the rationale used for finishing the current phase when a beacon objective has been completed or expired.

fn exec_task_queue<'life0, 'async_trait>( &'life0 self, context: Arc<ModeContext>, ) -> Pin<Box<dyn Future<Output = OpExitSignal> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Executes all tasks in the current task queue in sequence. Waits for each task’s scheduled time and handles early exit signals such as safe transitions or new objectives.

impl OrbitalMode for InOrbitMode

fn base(&self) -> &BaseMode

Returns a reference to the current BaseMode context.

fn get_max_dt() -> TimeDelta

Returns the maximum duration allowed for scheduled task waiting. If the remaining time until a task is due exceeds this value, the mode may begin long-wait procedures; otherwise, a fallback short sleep is used.

async fn exec_task_wait( &self, context: Arc<ModeContext>, due: DateTime<Utc>, ) -> WaitExitSignal

Waits until a scheduled task’s due time or returns early if a notable event occurs.

async fn monitor_bo_mon_change( sig: BeaconControllerState, bo_mon: &RwLock<Receiver<BeaconControllerState>>, )

Continuously monitors the BeaconControllerState until it changes to the expected value.

async fn log_bo_event(&self, context: &Arc<ModeContext>, base: BaseMode)

Logs a beacon-related event and finalizes the orbit at the current satellite position.