# ad00t/maveric-flight-software architecture

> Architecture diagram of the GitHub repository ad00t/maveric-flight-software, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ad00t/maveric-flight-software
- Repository: https://github.com/ad00t/maveric-flight-software

## Overview

MAVERIC is a CubeSat flight-software system deployed across upper and lower payload processor modules, with a separate EPS application. The principal workflow is onboard initialization and scheduling, followed by command/message handling, subsystem or payload actions, and telemetry or communications. The README also documents persistent scheduling, autonomous LEOPS, and failsafe modes. Paths and edges reflect the provided tree, README, and source index; several capabilities are documented but their implementation details were not sampled.

Main entry points: [`projects/Maveric_LPPM/src/main.c`](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/main.c) (Lower PPM), [`projects/Maveric_UPPM/src/main.c`](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_UPPM/src/main.c) (Upper PPM), [`projects/Maveric_LPPM/src/cmdimpl.c`](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/cmdimpl.c) (Lower Commands), [`common/maveric/src/flashmgr.c`](https://github.com/ad00t/maveric-flight-software/blob/dev/common/maveric/src/flashmgr.c) (Flash Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Processor Runtime"]
  node_upper["Upper PPM<br/>[main.c]"]
  node_lower["Lower PPM<br/>[main.c]"]
  node_eps["EPS Controller<br/>[main.c]"]
end

subgraph group_comms["Commands and Communications"]
  node_cmd_upper["Upper Commands<br/>[cmdimpl.c]"]
  node_cmd_lower["Lower Commands<br/>[cmdimpl.c]"]
  node_telemetry["Telemetry<br/>[telemetry.c]"]
  node_mcp["Packet Link<br/>[mcppkt.c]"]
  node_radio["AX100 Radio<br/>[ax100.c]"]
  node_eps_commands["EPS Commands<br/>[cmdimpl.c]"]
end

subgraph group_mission["Mission Functions"]
  node_gnc["GNC and ADCS<br/>[gnc.c]"]
  node_mtq["Magnetorquers<br/>[adcsmtq.c]"]
  node_nav["Navigation Sensors<br/>[naviguider.c]"]
  node_housekeeping["Housekeeping<br/>[housekeeping.c]"]
  node_payloads["Payload Manager<br/>[pldmgr.c]"]
end

subgraph group_platform["Shared Platform"]
  node_scheduler["Persistent Scheduler<br/>[scheduler.c]"]
  node_flashmgr["Flash Manager<br/>[flashmgr.c]"]
  node_flash["Flash Driver<br/>[at25df641.c]"]
  node_systime["System Time<br/>[systime.c]"]
  node_drivers["Peripheral Drivers<br/>[i2c.c]"]
end

node_ground(("Ground Operations"))

node_upper -->|"initializes"| node_cmd_upper
node_upper -->|"initializes"| node_telemetry
node_upper -->|"initializes"| node_radio
node_upper -->|"initializes"| node_payloads
node_upper -->|"initializes"| node_scheduler
node_upper -->|"initializes"| node_flashmgr
node_lower -->|"initializes"| node_cmd_lower
node_lower -->|"initializes"| node_gnc
node_lower -->|"initializes"| node_housekeeping
node_lower -->|"initializes"| node_mtq
node_lower -->|"initializes"| node_nav
node_lower -->|"initializes"| node_mcp
node_lower -->|"initializes"| node_scheduler
node_lower -->|"initializes"| node_flashmgr
node_eps -->|"initializes"| node_eps_commands
node_cmd_upper -.->|"dispatches commands"| node_mcp
node_cmd_lower -->|"dispatches commands"| node_mcp
node_upper -->|"exchanges packets"| node_lower
node_ground -.->|"communicates via"| node_radio
node_radio -.->|"transmits"| node_telemetry
node_telemetry -.->|"downlinks data"| node_ground
node_cmd_lower -.->|"controls"| node_gnc
node_gnc -.->|"commands"| node_mtq
node_lower -->|"uses"| node_drivers
node_eps -->|"uses"| node_drivers
node_flashmgr -.->|"reads and writes"| node_flash
node_upper -.->|"stores mission state"| node_flashmgr
node_lower -.->|"stores mission state"| node_flashmgr
node_cmd_lower -->|"schedules tasks"| node_scheduler
node_cmd_lower -->|"reads time"| node_systime
node_eps -->|"initializes"| node_systime

click node_upper "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_UPPM/src/main.c"
click node_lower "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/main.c"
click node_eps "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/EPS/src/main.c"
click node_cmd_upper "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_UPPM/src/cmdimpl.c"
click node_cmd_lower "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/cmdimpl.c"
click node_telemetry "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_UPPM/src/telemetry.c"
click node_mcp "https://github.com/ad00t/maveric-flight-software/blob/dev/common/maveric/src/mcppkt.c"
click node_radio "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_UPPM/src/ax100.c"
click node_eps_commands "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/EPS/src/cmdimpl.c"
click node_gnc "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/gnc.c"
click node_mtq "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/adcsmtq.c"
click node_nav "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/naviguider.c"
click node_housekeeping "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/housekeeping.c"
click node_payloads "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_UPPM/src/pldmgr.c"
click node_scheduler "https://github.com/ad00t/maveric-flight-software/blob/dev/common/maveric/src/scheduler.c"
click node_flashmgr "https://github.com/ad00t/maveric-flight-software/blob/dev/common/maveric/src/flashmgr.c"
click node_flash "https://github.com/ad00t/maveric-flight-software/blob/dev/common/maveric/src/at25df641.c"
click node_systime "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/EPS/src/systime.c"
click node_drivers "https://github.com/ad00t/maveric-flight-software/blob/dev/projects/EPS/src/i2c.c"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_upper,node_lower,node_eps toneBlue
class node_cmd_upper,node_cmd_lower,node_telemetry,node_mcp,node_radio,node_eps_commands toneAmber
class node_gnc,node_mtq,node_nav,node_housekeeping,node_payloads toneMint
class node_scheduler,node_flashmgr,node_flash,node_systime,node_drivers toneRose
class node_ground toneIndigo
```

## Components

### Processor Runtime

- [Upper PPM](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_UPPM/src/main.c): `projects/Maveric_UPPM/src/main.c`
- [Lower PPM](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/main.c): `projects/Maveric_LPPM/src/main.c`
- [EPS Controller](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/EPS/src/main.c): `projects/EPS/src/main.c`

### Commands and Communications

- [Upper Commands](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_UPPM/src/cmdimpl.c): `projects/Maveric_UPPM/src/cmdimpl.c`
- [Lower Commands](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/cmdimpl.c): `projects/Maveric_LPPM/src/cmdimpl.c`
- [Telemetry](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_UPPM/src/telemetry.c): `projects/Maveric_UPPM/src/telemetry.c`
- [Packet Link](https://github.com/ad00t/maveric-flight-software/blob/dev/common/maveric/src/mcppkt.c): `common/maveric/src/mcppkt.c`
- [AX100 Radio](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_UPPM/src/ax100.c): `projects/Maveric_UPPM/src/ax100.c`
- [EPS Commands](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/EPS/src/cmdimpl.c): `projects/EPS/src/cmdimpl.c`

### Mission Functions

- [GNC and ADCS](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/gnc.c): `projects/Maveric_LPPM/src/gnc.c`
- [Magnetorquers](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/adcsmtq.c): `projects/Maveric_LPPM/src/adcsmtq.c`
- [Navigation Sensors](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/naviguider.c): `projects/Maveric_LPPM/src/naviguider.c`
- [Housekeeping](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_LPPM/src/housekeeping.c): `projects/Maveric_LPPM/src/housekeeping.c`
- [Payload Manager](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/Maveric_UPPM/src/pldmgr.c): `projects/Maveric_UPPM/src/pldmgr.c`

### Shared Platform

- [Persistent Scheduler](https://github.com/ad00t/maveric-flight-software/blob/dev/common/maveric/src/scheduler.c): `common/maveric/src/scheduler.c`
- [Flash Manager](https://github.com/ad00t/maveric-flight-software/blob/dev/common/maveric/src/flashmgr.c): `common/maveric/src/flashmgr.c`
- [Flash Driver](https://github.com/ad00t/maveric-flight-software/blob/dev/common/maveric/src/at25df641.c): `common/maveric/src/at25df641.c`
- [System Time](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/EPS/src/systime.c): `projects/EPS/src/systime.c`
- [Peripheral Drivers](https://github.com/ad00t/maveric-flight-software/blob/dev/projects/EPS/src/i2c.c): `projects/EPS/src/i2c.c`

### Other components

- **Ground Operations**

## Connections

- Upper PPM → Upper Commands: initializes (evidence: `projects/Maveric_UPPM/src/main.c`)
- Upper PPM → Telemetry: initializes (evidence: `projects/Maveric_UPPM/src/main.c`)
- Upper PPM → AX100 Radio: initializes (evidence: `projects/Maveric_UPPM/src/main.c`)
- Upper PPM → Payload Manager: initializes (evidence: `projects/Maveric_UPPM/src/main.c`)
- Upper PPM → Persistent Scheduler: initializes (evidence: `projects/Maveric_UPPM/src/main.c`)
- Upper PPM → Flash Manager: initializes (evidence: `projects/Maveric_UPPM/src/main.c`)
- Lower PPM → Lower Commands: initializes (evidence: `projects/Maveric_LPPM/src/main.c`)
- Lower PPM → GNC and ADCS: initializes (evidence: `projects/Maveric_LPPM/src/main.c`)
- Lower PPM → Housekeeping: initializes (evidence: `projects/Maveric_LPPM/src/main.c`)
- Lower PPM → Magnetorquers: initializes (evidence: `projects/Maveric_LPPM/src/main.c`)
- Lower PPM → Navigation Sensors: initializes (evidence: `projects/Maveric_LPPM/src/main.c`)
- Lower PPM → Packet Link: initializes (evidence: `projects/Maveric_LPPM/src/main.c`)
- Lower PPM → Persistent Scheduler: initializes (evidence: `projects/Maveric_LPPM/src/main.c`)
- Lower PPM → Flash Manager: initializes (evidence: `projects/Maveric_LPPM/src/main.c`)
- EPS Controller → EPS Commands: initializes (evidence: `projects/EPS/src/main.c`)
- Upper Commands → Packet Link: dispatches commands
- Lower Commands → Packet Link: dispatches commands (evidence: `projects/Maveric_LPPM/src/cmdimpl.c`)
- Upper PPM → Lower PPM: exchanges packets (evidence: `README.md`)
- Ground Operations → AX100 Radio: communicates via
- AX100 Radio → Telemetry: transmits
- Telemetry → Ground Operations: downlinks data
- Lower Commands → GNC and ADCS: controls
- GNC and ADCS → Magnetorquers: commands
- Lower PPM → Peripheral Drivers: uses (evidence: `projects/Maveric_LPPM/src/main.c`)
- EPS Controller → Peripheral Drivers: uses (evidence: `projects/EPS/src/main.c`)
- Flash Manager → Flash Driver: reads and writes
- Upper PPM → Flash Manager: stores mission state (evidence: `projects/Maveric_UPPM/src/main.c`)
- Lower PPM → Flash Manager: stores mission state (evidence: `projects/Maveric_LPPM/src/main.c`)
- Lower Commands → Persistent Scheduler: schedules tasks (evidence: `projects/Maveric_LPPM/src/cmdimpl.c`)
- Lower Commands → System Time: reads time (evidence: `projects/Maveric_LPPM/src/cmdimpl.c`)
- EPS Controller → System Time: initializes (evidence: `projects/EPS/src/main.c`)
