# hyp-ed/hyped-2027 architecture

> Architecture diagram of the GitHub repository hyp-ed/hyped-2027, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hyp-ed/hyped-2027
- Repository: https://github.com/hyp-ed/hyped-2027

## Overview

HYPED combines STM32 pod control and sensing with a base-station telemetry system for monitoring, visualisation, logging, and operator commands. The principal workflow runs from pod measurements over CAN and MQTT into telemetry ingestion and storage, then to live or historical views; control commands travel back through the server to the pod. The map preserves the documented control, localisation, and fault capabilities. Some pod and telemetry subsystem connections are based on README descriptions and the file tree, not sampled implementation source.

Main entry points: [`boards/stm32f767zi/src/bin/boards`](https://github.com/hyp-ed/hyped-2027/tree/main/boards/stm32f767zi/src/bin/boards) (Navigation and telemetry board), [`boards/stm32f767zi/src/tasks/can.rs`](https://github.com/hyp-ed/hyped-2027/blob/main/boards/stm32f767zi/src/tasks/can.rs) (CAN and MQTT tasks), [`telemetry/packages/server/src/modules/mqtt/ingestion/MqttIngestion.service.ts`](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/mqtt/ingestion/MqttIngestion.service.ts) (MQTT ingestion), [`telemetry/packages/ui/app/App.tsx`](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/ui/app/App.tsx) (Telemetry operations UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pod["Pod firmware"]
  node_f767["Navigation and telemetry board"]
  node_levitation["Levitation boards<br/>[levitation.rs]"]
  node_sensors["Sensor acquisition tasks<br/>[sensors.rs]"]
  node_motor["Motor control tasks<br/>[motor_control.rs]"]
  node_podcomm["CAN and MQTT tasks<br/>[can.rs]"]
end

subgraph group_shared["Shared Rust libraries"]
  node_communications["Message and event model<br/>[lib.rs]"]
  node_sensorlib["Sensor drivers<br/>[lib.rs]"]
  node_localisation["Localisation<br/>[lib.rs]"]
  node_control["Control algorithms<br/>[lib.rs]"]
  node_statemachine["Pod state machine<br/>[lib.rs]"]
end

subgraph group_backend["Telemetry server"]
  node_server["Telemetry server<br/>[app.module.ts]"]
  node_ingestion["MQTT ingestion"]
  node_measurement["Measurement service"]
  node_state["State service<br/>[State.service.ts]"]
  node_publicdata["Public data API"]
  node_historical["Historical telemetry API"]
  node_controls["Pod controls API"]
  node_faults["Fault monitoring<br/>[Fault.service.ts]"]
  node_logs["Remote and live logs"]
end

subgraph group_frontend["Telemetry interfaces"]
  node_ui["Telemetry operations UI<br/>[App.tsx]"]
  node_openmct["OpenMCT dashboards<br/>[main.ts]"]
  node_publicapp["Public pod dashboard<br/>[page.tsx]"]
end

subgraph group_infra["External systems"]
  node_broker(("MQTT broker"))
  node_influx[("InfluxDB")]
end

node_operator(("Operator"))

node_operator -->|"uses controls"| node_ui
node_operator -->|"views telemetry"| node_openmct
node_operator -->|"views status"| node_publicapp
node_sensors -->|"reads sensors"| node_sensorlib
node_f767 -->|"runs tasks"| node_sensors
node_f767 -->|"runs tasks"| node_motor
node_f767 -->|"runs tasks"| node_podcomm
node_podcomm -->|"encodes messages"| node_communications
node_levitation -->|"communicates CAN"| node_podcomm
node_f767 -->|"communicates CAN"| node_levitation
node_motor -->|"uses control"| node_control
node_f767 -->|"uses localisation"| node_localisation
node_f767 -->|"uses state machine"| node_statemachine
node_podcomm -->|"relays MQTT"| node_broker
node_broker -->|"delivers messages"| node_ingestion
node_ingestion -->|"adds readings"| node_measurement
node_ingestion -->|"adds state"| node_state
node_measurement -->|"stores readings"| node_influx
node_state -->|"stores state"| node_influx
node_publicdata -->|"requests readings"| node_historical
node_historical -->|"queries history"| node_influx
node_ui -->|"sends commands"| node_controls
node_controls -->|"publishes commands"| node_broker
node_broker -->|"delivers commands"| node_podcomm
node_openmct -->|"requests telemetry"| node_server
node_publicapp -->|"requests pod data"| node_publicdata
node_openmct -->|"uses fault data"| node_faults
node_ui -->|"submits logs"| node_logs

click node_f767 "https://github.com/hyp-ed/hyped-2027/tree/main/boards/stm32f767zi/src/bin/boards"
click node_levitation "https://github.com/hyp-ed/hyped-2027/blob/main/boards/stm32l432kc/src/bin/levitation.rs"
click node_sensors "https://github.com/hyp-ed/hyped-2027/blob/main/boards/stm32f767zi/src/tasks/sensors.rs"
click node_motor "https://github.com/hyp-ed/hyped-2027/blob/main/boards/stm32f767zi/src/tasks/motor_control.rs"
click node_podcomm "https://github.com/hyp-ed/hyped-2027/blob/main/boards/stm32f767zi/src/tasks/can.rs"
click node_communications "https://github.com/hyp-ed/hyped-2027/blob/main/lib/communications/src/lib.rs"
click node_sensorlib "https://github.com/hyp-ed/hyped-2027/blob/main/lib/sensors/src/lib.rs"
click node_localisation "https://github.com/hyp-ed/hyped-2027/blob/main/lib/localisation/src/lib.rs"
click node_control "https://github.com/hyp-ed/hyped-2027/blob/main/lib/control/src/lib.rs"
click node_statemachine "https://github.com/hyp-ed/hyped-2027/blob/main/lib/state_machine/src/lib.rs"
click node_server "https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/app.module.ts"
click node_ingestion "https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/mqtt/ingestion/MqttIngestion.service.ts"
click node_measurement "https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/telemetry/Measurement.service.ts"
click node_state "https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/state/State.service.ts"
click node_publicdata "https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/public-data/PublicData.controller.ts"
click node_historical "https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/openmct/data/historical/HistoricalTelemetryData.service.ts"
click node_controls "https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/controls/PodControls.controller.ts"
click node_ui "https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/ui/app/App.tsx"
click node_openmct "https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/ui/openmct/main.ts"
click node_publicapp "https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/public-app/app/page.tsx"
click node_faults "https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/openmct/faults/Fault.service.ts"
click node_logs "https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/remote-logs/RemoteLogs.service.ts"

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_f767,node_levitation,node_sensors,node_motor,node_podcomm toneBlue
class node_communications,node_sensorlib,node_localisation,node_control,node_statemachine toneAmber
class node_server,node_ingestion,node_measurement,node_state,node_publicdata,node_historical,node_controls,node_faults,node_logs toneMint
class node_ui,node_openmct,node_publicapp toneRose
class node_broker,node_influx,node_operator toneIndigo
```

## Components

### Pod firmware

- [Navigation and telemetry board](https://github.com/hyp-ed/hyped-2027/tree/main/boards/stm32f767zi/src/bin/boards): `boards/stm32f767zi/src/bin/boards`
- [Levitation boards](https://github.com/hyp-ed/hyped-2027/blob/main/boards/stm32l432kc/src/bin/levitation.rs): `boards/stm32l432kc/src/bin/levitation.rs`
- [Sensor acquisition tasks](https://github.com/hyp-ed/hyped-2027/blob/main/boards/stm32f767zi/src/tasks/sensors.rs): `boards/stm32f767zi/src/tasks/sensors.rs`
- [Motor control tasks](https://github.com/hyp-ed/hyped-2027/blob/main/boards/stm32f767zi/src/tasks/motor_control.rs): `boards/stm32f767zi/src/tasks/motor_control.rs`
- [CAN and MQTT tasks](https://github.com/hyp-ed/hyped-2027/blob/main/boards/stm32f767zi/src/tasks/can.rs): `boards/stm32f767zi/src/tasks/can.rs`

### Shared Rust libraries

- [Message and event model](https://github.com/hyp-ed/hyped-2027/blob/main/lib/communications/src/lib.rs): `lib/communications/src/lib.rs`
- [Sensor drivers](https://github.com/hyp-ed/hyped-2027/blob/main/lib/sensors/src/lib.rs): `lib/sensors/src/lib.rs`
- [Localisation](https://github.com/hyp-ed/hyped-2027/blob/main/lib/localisation/src/lib.rs): `lib/localisation/src/lib.rs`
- [Control algorithms](https://github.com/hyp-ed/hyped-2027/blob/main/lib/control/src/lib.rs): `lib/control/src/lib.rs`
- [Pod state machine](https://github.com/hyp-ed/hyped-2027/blob/main/lib/state_machine/src/lib.rs): `lib/state_machine/src/lib.rs`

### Telemetry server

- [Telemetry server](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/app.module.ts): `telemetry/packages/server/src/app.module.ts`
- [MQTT ingestion](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/mqtt/ingestion/MqttIngestion.service.ts): `telemetry/packages/server/src/modules/mqtt/ingestion/MqttIngestion.service.ts`
- [Measurement service](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/telemetry/Measurement.service.ts): `telemetry/packages/server/src/modules/telemetry/Measurement.service.ts`
- [State service](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/state/State.service.ts): `telemetry/packages/server/src/modules/state/State.service.ts`
- [Public data API](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/public-data/PublicData.controller.ts): `telemetry/packages/server/src/modules/public-data/PublicData.controller.ts`
- [Historical telemetry API](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/openmct/data/historical/HistoricalTelemetryData.service.ts): `telemetry/packages/server/src/modules/openmct/data/historical/HistoricalTelemetryData.service.ts`
- [Pod controls API](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/controls/PodControls.controller.ts): `telemetry/packages/server/src/modules/controls/PodControls.controller.ts`
- [Fault monitoring](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/openmct/faults/Fault.service.ts): `telemetry/packages/server/src/modules/openmct/faults/Fault.service.ts`
- [Remote and live logs](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/server/src/modules/remote-logs/RemoteLogs.service.ts): `telemetry/packages/server/src/modules/remote-logs/RemoteLogs.service.ts`

### Telemetry interfaces

- [Telemetry operations UI](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/ui/app/App.tsx): `telemetry/packages/ui/app/App.tsx`
- [OpenMCT dashboards](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/ui/openmct/main.ts): `telemetry/packages/ui/openmct/main.ts`
- [Public pod dashboard](https://github.com/hyp-ed/hyped-2027/blob/main/telemetry/packages/public-app/app/page.tsx): `telemetry/packages/public-app/app/page.tsx`

### External systems

- **MQTT broker**
- **InfluxDB**

### Other components

- **Operator**

## Connections

- Operator → Telemetry operations UI: uses controls
- Operator → OpenMCT dashboards: views telemetry
- Operator → Public pod dashboard: views status
- Sensor acquisition tasks → Sensor drivers: reads sensors
- Navigation and telemetry board → Sensor acquisition tasks: runs tasks
- Navigation and telemetry board → Motor control tasks: runs tasks
- Navigation and telemetry board → CAN and MQTT tasks: runs tasks
- CAN and MQTT tasks → Message and event model: encodes messages
- Levitation boards → CAN and MQTT tasks: communicates CAN
- Navigation and telemetry board → Levitation boards: communicates CAN
- Motor control tasks → Control algorithms: uses control
- Navigation and telemetry board → Localisation: uses localisation
- Navigation and telemetry board → Pod state machine: uses state machine
- CAN and MQTT tasks → MQTT broker: relays MQTT
- MQTT broker → MQTT ingestion: delivers messages
- MQTT ingestion → Measurement service: adds readings
- MQTT ingestion → State service: adds state
- Measurement service → InfluxDB: stores readings
- State service → InfluxDB: stores state
- Public data API → Historical telemetry API: requests readings
- Historical telemetry API → InfluxDB: queries history
- Telemetry operations UI → Pod controls API: sends commands
- Pod controls API → MQTT broker: publishes commands
- MQTT broker → CAN and MQTT tasks: delivers commands
- OpenMCT dashboards → Telemetry server: requests telemetry
- Public pod dashboard → Public data API: requests pod data
- OpenMCT dashboards → Fault monitoring: uses fault data
- Telemetry operations UI → Remote and live logs: submits logs
