Mariner Satellite

Name	Mariner
Description	Demonstrator satellite serving as prototype for new satellites
Category	Example Templates
Language	Python

Description

This satellite does little, it mostly serves as demonstrator for the different functionalities of satellites. New Python satellites for Constellation may be created by copying and modifying the Mariner satellite.

Parameters

Parameter	Description	Type	Default Value
voltage	Voltage value for the Canopus star tracker	Float	5.0
current	Current value for the Canopus star tracker	Float	0.1
sample_period	Time between executions of the voltage sampling/print-out	Float	0.5

Metrics

Metric	Description	Value Type	Interval
BRIGHTNESS	Brightness	Integer	10s

Custom Commands

Command	Description	Arguments	Return Value	Allowed States
get_attitude	Get roll attitude	-	Integer	INIT, ORBIT, RUN

Framework Parameters

This satellite interprets the following configuration parameter that are provided through the Constellation framework. Parameters have to be placed in their respective configuration section.

Autonomous Operation

Parameters to control autonomy in the _autonomy section:

Parameter	Type	Description	Default Value
role	Role name	Role this satellite should take in the Constellation. Accepted values are ESSENTIAL, DYNAMIC, TRANSIENT and NONE.	DYNAMIC
max_heartbeat_interval	Unsigned integer	Maximum interval in seconds between heartbeats to be sent to other Constellation components. The time between heartbeat is adjusted automatically according to the number of nodes in the Constellation but will never exceed this value.	30

Conditional Transitions

Parameters to control conditional transitions in the _conditions section:

Parameter	Type	Description	Default Value
require_initializing_after	List of strings	List of canonical names of remote satellites for conditional transitioning in initializing state	-
require_launching_after	List of strings	List of canonical names of remote satellites for conditional transitioning in launching state	-
require_landing_after	List of strings	List of canonical names of remote satellites for conditional transitioning in landing state	-
require_starting_after	List of strings	List of canonical names of remote satellites for conditional transitioning in starting state	-
require_stopping_after	List of strings	List of canonical names of remote satellites for conditional transitioning in stopping state	-
transition_timeout	Unsigned integer	Timeout in seconds to wait for all conditions to be satisfied for conditional transitioning	30

Framework Metrics

This satellite provides the following metrics that are defined by the Constellation framework.

Basic Satellite Metrics

Metric	Description	Value Type	Interval
RUN_ID	Current run identifier. Updated whenever it changes.	String	-
STATE	Current satellite state. Updated when changed.	String	-
CPU_LOAD_AVG	CPU load average over the past 1 minute, provided in percent.	Float	10s
MEM_AVAIL	Available memory in Megabytes.	Integer	10s