# ardupilot/missionplanner architecture

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

- Interactive diagram: https://gitdiagram.com/ardupilot/missionplanner
- Repository: https://github.com/ardupilot/missionplanner

## Overview

Mission Planner is a ground-control application for configuring and operating ArduPilot vehicles. The principal workflow is a pilot launching the application, connecting to a vehicle, working with its mission and telemetry, then monitoring or controlling the flight. The README also documents firmware updates, selectable map providers, offline map/elevation data, and optional Altitude Angel airspace services. Those capabilities are represented, but most implementation files were not sampled; dashed links with null evidence mark relationships that are plausible from the product description, not verified calls.

Main entry points: [`Program.cs`](https://github.com/ardupilot/missionplanner/blob/master/Program.cs) (Mission Planner), [`ExtLibs/ArduPilot/Mavlink/MAVLinkInterface.cs`](https://github.com/ardupilot/missionplanner/blob/master/ExtLibs/ArduPilot/Mavlink/MAVLinkInterface.cs) (MAVLink interface), [`Controls/GMAPCache.cs`](https://github.com/ardupilot/missionplanner/blob/master/Controls/GMAPCache.cs) (Map display), [`Controls`](https://github.com/ardupilot/missionplanner/tree/master/Controls) (Flight controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and UI"]
  node_application["Mission Planner<br/>[Program.cs]"]
  node_controls["Flight controls"]
end

subgraph group_vehicle["Vehicle operations"]
  node_connection["Vehicle connection"]
  node_mavlink["MAVLink interface"]
  node_mission["Mission planning<br/>[mav_mission.cs]"]
  node_telemetry["Vehicle telemetry<br/>[CurrentState.cs]"]
  node_firmware["Firmware management<br/>[APFirmware.cs]"]
end

subgraph group_mapping["Maps and planning"]
  node_maps["Map display<br/>[GMAPCache.cs]"]
  node_elevation["Elevation data"]
  node_offline[("Offline data")]
end

subgraph group_services["External services"]
  node_mapproviders["Map providers"]
  node_altitudeangel["Altitude Angel"]
  node_airspace["Airspace service"]
end

subgraph group_support["Monitoring and support"]
  node_warnings["Warning engine<br/>[WarningEngine.cs]"]
  node_warningui["Warning display<br/>[WarningsManager.cs]"]
  node_logs["Flight logs<br/>[LogAnalyzer.cs]"]
end

node_pilot(("Pilot"))
node_firmwarehost["ArduPilot firmware host"]

node_pilot -.->|"launches"| node_application
node_pilot -.->|"uses"| node_controls
node_application -.->|"presents"| node_controls
node_controls -.->|"configures"| node_connection
node_connection -.->|"communicates"| node_mavlink
node_mavlink -.->|"transfers missions"| node_mission
node_mavlink -.->|"updates state"| node_telemetry
node_pilot -.->|"plans flight"| node_mission
node_pilot -.->|"updates vehicle"| node_firmware
node_firmware -->|"downloads updates"| node_firmwarehost
node_pilot -.->|"views maps"| node_maps
node_maps -->|"loads tiles"| node_mapproviders
node_maps -->|"reads cache"| node_offline
node_elevation -->|"reads elevation cache"| node_offline
node_pilot -->|"enables service"| node_altitudeangel
node_altitudeangel -.->|"retrieves airspace data"| node_airspace
node_application -.->|"shows warnings"| node_warningui
node_warningui -->|"uses engine"| node_warnings
node_warnings -->|"raises messages"| node_warningui
node_pilot -.->|"analyzes logs"| node_logs

click node_application "https://github.com/ardupilot/missionplanner/blob/master/Program.cs"
click node_controls "https://github.com/ardupilot/missionplanner/tree/master/Controls"
click node_connection "https://github.com/ardupilot/missionplanner/blob/master/Controls/ConnectionControl.cs"
click node_mavlink "https://github.com/ardupilot/missionplanner/blob/master/ExtLibs/ArduPilot/Mavlink/MAVLinkInterface.cs"
click node_mission "https://github.com/ardupilot/missionplanner/blob/master/ExtLibs/ArduPilot/mav_mission.cs"
click node_telemetry "https://github.com/ardupilot/missionplanner/blob/master/ExtLibs/ArduPilot/CurrentState.cs"
click node_firmware "https://github.com/ardupilot/missionplanner/blob/master/ExtLibs/ArduPilot/APFirmware.cs"
click node_maps "https://github.com/ardupilot/missionplanner/blob/master/Controls/GMAPCache.cs"
click node_elevation "https://github.com/ardupilot/missionplanner/blob/master/Controls/ElevationProfile.cs"
click node_altitudeangel "https://github.com/ardupilot/missionplanner/blob/master/ExtLibs/AltitudeAngelWings/Service/AltitudeAngelService.cs"
click node_warnings "https://github.com/ardupilot/missionplanner/blob/master/ExtLibs/Utilities/Warnings/WarningEngine.cs"
click node_warningui "https://github.com/ardupilot/missionplanner/blob/master/Warnings/WarningsManager.cs"
click node_logs "https://github.com/ardupilot/missionplanner/blob/master/Controls/LogAnalyzer.cs"

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_application,node_controls toneBlue
class node_connection,node_mavlink,node_mission,node_telemetry,node_firmware toneAmber
class node_maps,node_elevation,node_offline toneMint
class node_mapproviders,node_altitudeangel,node_airspace toneRose
class node_warnings,node_warningui,node_logs,node_pilot,node_firmwarehost toneIndigo
```

## Components

### Application and UI

- [Mission Planner](https://github.com/ardupilot/missionplanner/blob/master/Program.cs): `Program.cs`
- [Flight controls](https://github.com/ardupilot/missionplanner/tree/master/Controls): `Controls`

### Vehicle operations

- [Vehicle connection](https://github.com/ardupilot/missionplanner/blob/master/Controls/ConnectionControl.cs): `Controls/ConnectionControl.cs`
- [MAVLink interface](https://github.com/ardupilot/missionplanner/blob/master/ExtLibs/ArduPilot/Mavlink/MAVLinkInterface.cs): `ExtLibs/ArduPilot/Mavlink/MAVLinkInterface.cs`
- [Mission planning](https://github.com/ardupilot/missionplanner/blob/master/ExtLibs/ArduPilot/mav_mission.cs): `ExtLibs/ArduPilot/mav_mission.cs`
- [Vehicle telemetry](https://github.com/ardupilot/missionplanner/blob/master/ExtLibs/ArduPilot/CurrentState.cs): `ExtLibs/ArduPilot/CurrentState.cs`
- [Firmware management](https://github.com/ardupilot/missionplanner/blob/master/ExtLibs/ArduPilot/APFirmware.cs): `ExtLibs/ArduPilot/APFirmware.cs`

### Maps and planning

- [Map display](https://github.com/ardupilot/missionplanner/blob/master/Controls/GMAPCache.cs): `Controls/GMAPCache.cs`
- [Elevation data](https://github.com/ardupilot/missionplanner/blob/master/Controls/ElevationProfile.cs): `Controls/ElevationProfile.cs`
- **Offline data**

### External services

- **Map providers**
- [Altitude Angel](https://github.com/ardupilot/missionplanner/blob/master/ExtLibs/AltitudeAngelWings/Service/AltitudeAngelService.cs): `ExtLibs/AltitudeAngelWings/Service/AltitudeAngelService.cs`
- **Airspace service**

### Monitoring and support

- [Warning engine](https://github.com/ardupilot/missionplanner/blob/master/ExtLibs/Utilities/Warnings/WarningEngine.cs): `ExtLibs/Utilities/Warnings/WarningEngine.cs`
- [Warning display](https://github.com/ardupilot/missionplanner/blob/master/Warnings/WarningsManager.cs): `Warnings/WarningsManager.cs`
- [Flight logs](https://github.com/ardupilot/missionplanner/blob/master/Controls/LogAnalyzer.cs): `Controls/LogAnalyzer.cs`

### Other components

- **Pilot**
- **ArduPilot firmware host**

## Connections

- Pilot → Mission Planner: launches
- Pilot → Flight controls: uses
- Mission Planner → Flight controls: presents (evidence: `Program.cs`)
- Flight controls → Vehicle connection: configures
- Vehicle connection → MAVLink interface: communicates
- MAVLink interface → Mission planning: transfers missions
- MAVLink interface → Vehicle telemetry: updates state
- Pilot → Mission planning: plans flight
- Pilot → Firmware management: updates vehicle
- Firmware management → ArduPilot firmware host: downloads updates (evidence: `README.md`)
- Pilot → Map display: views maps
- Map display → Map providers: loads tiles (evidence: `README.md`)
- Map display → Offline data: reads cache (evidence: `README.md`)
- Elevation data → Offline data: reads elevation cache (evidence: `README.md`)
- Pilot → Altitude Angel: enables service (evidence: `README.md`)
- Altitude Angel → Airspace service: retrieves airspace data
- Mission Planner → Warning display: shows warnings
- Warning display → Warning engine: uses engine (evidence: `Warnings/WarningsManager.cs`)
- Warning engine → Warning display: raises messages (evidence: `ExtLibs/Utilities/Warnings/WarningEngine.cs`)
- Pilot → Flight logs: analyzes logs
