Enum BaseMode

pub(super) enum BaseMode {
    MappingMode,
    BeaconObjectiveScanningMode,
}

Represents high-level operational modes of the onboard software when in orbit. Each variant encodes different scheduling logic and task handling behavior.

Variants

MappingMode

Regular mapping mode focused on maximizing imaging coverage.

BeaconObjectiveScanningMode

Mode dedicated to get full communications mode coverage while still mapping when possible.

Implementations

impl BaseMode

const DEF_MAPPING_ANGLE: CameraAngle = CameraAngle::Narrow

Default camera angle used during mapping operations.

async fn exec_map( context: Arc<ModeContext>, end: TaskEndSignal, c_tok: CancellationToken, )

Executes a full mapping acquisition cycle, listening until either a signal or cancellation occurs.

This function initializes an image acquisition cycle using the default mapping camera angle and coordinates between the camera controller and various signal channels. It finalizes by marking orbit coverage and exporting updated coverage data.

Arguments

• context: A shared reference to a ModeContext object.
• end: A TaskEndSignal-enum type indicating how the task end condition should be defined.
• c_tok: A [CancellationToken] that is able to cancel this task with proper cleanup.

async fn exec_comms( context: Arc<ModeContext>, end: TaskEndSignal, c_tok: CancellationToken, )

Listens for Beacon Objective communication pings until a timeout or cancellation.

Uses an event-based listener to process incoming beacon messages. Automatically terminates based on task completion or shutdown signals.

Arguments

• context: A shared reference to a ModeContext object.
• end: A TaskEndSignal-enum type indicating how the task end condition should be defined.
• c_tok: A CancellationToken that is able to cancel this task with proper cleanup.

pub(super) async fn handle_sched_preconditions( &self, context: Arc<ModeContext>, ) -> DateTime<Utc>

Ensures any required preconditions for the current mode are satisfied before scheduling begins.

Arguments

• context: A shared reference to a ModeContext object.

Returns

A DateTime<Utc> indicating the time when scheduled tasks should start.

pub(super) async fn get_schedule_handle( &self, context: Arc<ModeContext>, c_tok: CancellationToken, comms_end: DateTime<Utc>, end: Option<EndCondition>, ) -> JoinHandle<()>

Returns a handle to the scheduling task corresponding to the current operational BaseMode-variant.

• For MappingMode, a standard optimal orbit scheduler is used.
• For BeaconObjectiveScanningMode, a communications-aware scheduler is launched.

Depending on the current flight state, this will also launch a mapping or beacon listening task to run concurrently.

Arguments

• context: A shared reference to a ModeContext object.
• c_tok: A CancellationToken that is able to cancel this task with proper cleanup.
• comms_end: A DateTime<Utc> indicating the end of the current comms cycle when in BeaconObjectiveScanningMode.
• end: An optional EndCondition type if i.e. a burn sequence follows to this task list.

Returns

A JoinHandle<() to join with the scheduling task

pub(super) async fn get_wait( &self, context: Arc<ModeContext>, due: DateTime<Utc>, c_tok: CancellationToken, ) -> JoinHandle<()>

Spawns the corresponding primitive for the task wait time.

The returned handle either:

• FlightState::Charge: Waits for the task timeout and exports a full image snapshot.
• FlightState::Acquisition: Executes a mapping task.
• FlightState::Comms: Executes a beacon listening task.

This is useful for blocking execution while ensuring mode-specific behavior continues.

Arguments

• context: A shared reference to a ModeContext object.
• due: A DateTime<Utc> indicating the task wait timeout time.
• c_tok: A CancellationToken that is able to cancel the spawned task with proper cleanup.

Returns

A JoinHandle<() to join with the state specific primitive.

pub(super) async fn get_task( &self, context: Arc<ModeContext>, task: SwitchStateTask, )

Executes the corresponding primitive for task execution.

In GlobalMode with a corresponding BaseMode this handles the logic for SwitchStateTask.

Arguments

• context: A shared reference to a ModeContext object.
• task: The corresponding SwitchStateTask object.

pub(super) fn get_rel_bo_event(self) -> BeaconControllerState

Returns the relevant BeaconControllerState associated with this mode.

Used to inform beacon-handling logic of the signal that would indicate switching.

pub(super) fn bo_event(self) -> Self

Returns the new BaseMode following a Beacon Objective Event.

Used to inform beacon-handling logic of the new state after a signal.

Trait Implementations

impl Clone for BaseMode

fn clone(&self) -> BaseMode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Display for BaseMode

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

Formats the value using the given formatter.

impl Copy for BaseMode