# welee666/openhd architecture

> Architecture diagram of the GitHub repository welee666/openhd, 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/welee666/openhd
- Repository: https://github.com/welee666/openhd

## Overview

OpenHD is the device-side core of a low-latency UAV link: it carries HD video, two-way UAV telemetry, audio, and RC control over a specially configured Wi-Fi broadcast link. The runtime starts in an air or ground role, then coordinates radio networking, video capture/transport, and MAVLink telemetry. The tree also shows camera recording, link management, networking helpers, and persistent settings. Several subsystem relationships are documented only at the product level; those links are marked dashed rather than presented as inspected call paths.

Main entry points: [`OpenHD/main.cpp`](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/main.cpp) (Runtime entry), [`OpenHD/ohd_video/src/ohd_video_air.cpp`](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_video/src/ohd_video_air.cpp) (Air and ground video), [`OpenHD/ohd_interface/src/wb_link_manager.cpp`](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_interface/src/wb_link_manager.cpp) (Radio link manager), [`OpenHD/ohd_interface/src/wb_link.cpp`](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_interface/src/wb_link.cpp) (Wireless link)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and settings"]
  node_main["Runtime entry<br/>[main.cpp]"]
  node_settings[("Settings and profiles<br/>[openhd_config.cpp]")]
end

subgraph group_radio["Radio networking"]
  node_radio_manager["Radio link manager"]
  node_wireless_link["Wireless link<br/>[wb_link.cpp]"]
  node_wifi["Wi-Fi discovery"]
  node_ethernet["Ethernet manager"]
end

subgraph group_video["Video and audio"]
  node_camera["Camera discovery"]
  node_capture["Video stream"]
  node_pipeline["GStreamer helpers<br/>[gst_helper.hpp]"]
  node_video_roles["Air and ground video<br/>[ohd_video_air.cpp]"]
  node_recording["Video recording<br/>[gst_recorder.cpp]"]
end

subgraph group_telemetry["Telemetry and control"]
  node_telemetry_roles["Air and ground telemetry<br/>[OHDTelemetry.cpp]"]
  node_telemetry_core["Telemetry core"]
  node_endpoints["MAVLink endpoints<br/>[SerialEndpoint.cpp]"]
  node_joystick["RC joystick input<br/>[JoystickReader.cpp]"]
end

subgraph group_common["Shared services"]
  node_common_utils["Platform and utilities<br/>[openhd_platform.h]"]
  node_actions["Link actions"]
end

node_operator(("UAV operator"))
node_external_network(("Ethernet peer"))
node_flight_controller(("Flight controller"))

node_operator -.->|"starts runtime"| node_main
node_main -.->|"loads settings"| node_settings
node_main -.->|"starts link"| node_radio_manager
node_radio_manager -.->|"manages link"| node_wireless_link
node_radio_manager -.->|"discovers adapters"| node_wifi
node_main -.->|"starts video"| node_video_roles
node_video_roles -.->|"selects camera"| node_camera
node_video_roles -.->|"configures stream"| node_capture
node_capture -->|"builds pipeline"| node_pipeline
node_capture -->|"records stream"| node_recording
node_main -.->|"starts telemetry"| node_telemetry_roles
node_telemetry_roles -.->|"runs components"| node_telemetry_core
node_telemetry_core -.->|"routes MAVLink"| node_endpoints
node_flight_controller -.->|"exchanges MAVLink"| node_endpoints
node_joystick -.->|"provides RC input"| node_telemetry_core
node_main -.->|"starts networking"| node_ethernet
node_ethernet -.->|"forwards traffic"| node_external_network
node_main -.->|"uses platform support"| node_common_utils
node_radio_manager -.->|"registers link actions"| node_actions
node_operator -.->|"views live video"| node_video_roles
node_video_roles -.->|"transmits video"| node_wireless_link
node_telemetry_roles -.->|"transmits telemetry"| node_wireless_link
node_joystick -.->|"transmits RC control"| node_wireless_link

click node_main "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/main.cpp"
click node_settings "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_common/src/openhd_config.cpp"
click node_radio_manager "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_interface/src/wb_link_manager.cpp"
click node_wireless_link "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_interface/src/wb_link.cpp"
click node_wifi "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_interface/src/wifi_card_discovery.cpp"
click node_ethernet "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_interface/src/ethernet_manager.cpp"
click node_camera "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_video/src/camera_discovery.cpp"
click node_capture "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_video/src/gstreamerstream.cpp"
click node_pipeline "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_video/inc/gst_helper.hpp"
click node_video_roles "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_video/src/ohd_video_air.cpp"
click node_recording "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_video/src/gst_recorder.cpp"
click node_telemetry_roles "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_telemetry/src/OHDTelemetry.cpp"
click node_telemetry_core "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_telemetry/src/internal/OHDMainComponent.cpp"
click node_endpoints "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_telemetry/src/endpoints/SerialEndpoint.cpp"
click node_joystick "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_telemetry/src/rc/JoystickReader.cpp"
click node_common_utils "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_common/inc/openhd_platform.h"
click node_actions "https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_common/src/openhd_action_handler.cpp"

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_main,node_settings toneBlue
class node_radio_manager,node_wireless_link,node_wifi,node_ethernet toneAmber
class node_camera,node_capture,node_pipeline,node_video_roles,node_recording toneMint
class node_telemetry_roles,node_telemetry_core,node_endpoints,node_joystick toneRose
class node_common_utils,node_actions,node_operator,node_external_network,node_flight_controller toneIndigo
```

## Components

### Runtime and settings

- [Runtime entry](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/main.cpp): `OpenHD/main.cpp`
- [Settings and profiles](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_common/src/openhd_config.cpp): `OpenHD/ohd_common/src/openhd_config.cpp`

### Radio networking

- [Radio link manager](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_interface/src/wb_link_manager.cpp): `OpenHD/ohd_interface/src/wb_link_manager.cpp`
- [Wireless link](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_interface/src/wb_link.cpp): `OpenHD/ohd_interface/src/wb_link.cpp`
- [Wi-Fi discovery](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_interface/src/wifi_card_discovery.cpp): `OpenHD/ohd_interface/src/wifi_card_discovery.cpp`
- [Ethernet manager](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_interface/src/ethernet_manager.cpp): `OpenHD/ohd_interface/src/ethernet_manager.cpp`

### Video and audio

- [Camera discovery](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_video/src/camera_discovery.cpp): `OpenHD/ohd_video/src/camera_discovery.cpp`
- [Video stream](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_video/src/gstreamerstream.cpp): `OpenHD/ohd_video/src/gstreamerstream.cpp`
- [GStreamer helpers](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_video/inc/gst_helper.hpp): `OpenHD/ohd_video/inc/gst_helper.hpp`
- [Air and ground video](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_video/src/ohd_video_air.cpp): `OpenHD/ohd_video/src/ohd_video_air.cpp`
- [Video recording](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_video/src/gst_recorder.cpp): `OpenHD/ohd_video/src/gst_recorder.cpp`

### Telemetry and control

- [Air and ground telemetry](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_telemetry/src/OHDTelemetry.cpp): `OpenHD/ohd_telemetry/src/OHDTelemetry.cpp`
- [Telemetry core](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_telemetry/src/internal/OHDMainComponent.cpp): `OpenHD/ohd_telemetry/src/internal/OHDMainComponent.cpp`
- [MAVLink endpoints](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_telemetry/src/endpoints/SerialEndpoint.cpp): `OpenHD/ohd_telemetry/src/endpoints/SerialEndpoint.cpp`
- [RC joystick input](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_telemetry/src/rc/JoystickReader.cpp): `OpenHD/ohd_telemetry/src/rc/JoystickReader.cpp`

### Shared services

- [Platform and utilities](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_common/inc/openhd_platform.h): `OpenHD/ohd_common/inc/openhd_platform.h`
- [Link actions](https://github.com/welee666/openhd/blob/2.7-evo/OpenHD/ohd_common/src/openhd_action_handler.cpp): `OpenHD/ohd_common/src/openhd_action_handler.cpp`

### Other components

- **UAV operator**
- **Ethernet peer**
- **Flight controller**

## Connections

- UAV operator → Runtime entry: starts runtime
- Runtime entry → Settings and profiles: loads settings
- Runtime entry → Radio link manager: starts link
- Radio link manager → Wireless link: manages link
- Radio link manager → Wi-Fi discovery: discovers adapters
- Runtime entry → Air and ground video: starts video
- Air and ground video → Camera discovery: selects camera
- Air and ground video → Video stream: configures stream
- Video stream → GStreamer helpers: builds pipeline (evidence: `OpenHD/ohd_video/src/gstreamerstream.cpp`)
- Video stream → Video recording: records stream (evidence: `OpenHD/ohd_video/src/gstreamerstream.cpp`)
- Runtime entry → Air and ground telemetry: starts telemetry
- Air and ground telemetry → Telemetry core: runs components
- Telemetry core → MAVLink endpoints: routes MAVLink
- Flight controller → MAVLink endpoints: exchanges MAVLink
- RC joystick input → Telemetry core: provides RC input
- Runtime entry → Ethernet manager: starts networking
- Ethernet manager → Ethernet peer: forwards traffic
- Runtime entry → Platform and utilities: uses platform support (evidence: `OpenHD/main.cpp`)
- Radio link manager → Link actions: registers link actions
- UAV operator → Air and ground video: views live video
- Air and ground video → Wireless link: transmits video
- Air and ground telemetry → Wireless link: transmits telemetry
- RC joystick input → Wireless link: transmits RC control
