MissionPlanner

How to compile

On Windows (Recommended)

1. Install software

Main requirements

Currently, Mission Planner needs:

Visual Studio 2022

IDE

Visual Studio Community

To compile Mission Planner, we recommend using Visual Studio. You can download Visual Studio Community from the Visual Studio Download page.

Visual Studio is a comprehensive suite with built-in Git support, but it can be overwhelming due to its complexity. To streamline the installation process, you can customize your installation by selecting the relevant "Workloads" and "Individual components" based on your software development needs.

To simplify this selection process, we have provided a configuration file that specifies the components required for MissionPlanner development. Here's how you can use it:

Go to "More" in the Visual Studio installer.
Select "Import configuration."
Use the following file: vs2022.vsconfig.

By following these steps, you'll have the necessary components installed and ready for Mission Planner development.

VSCode

Currently VSCode with C# plugin is able to parse the code but cannot build.

2. Get the code

If you get Visual Studio Community, you should be able to use Git from the IDE. Clone https://github.com/ArduPilot/MissionPlanner.git to get the full code.

In case you didn't install an IDE, you will need to manually install Git. Please follow instruction in https://ardupilot.org/dev/docs/where-to-get-the-code.html#downloading-the-code-using-git

Open a git bash terminal in the MissionPlanner directory and type, "git submodule update --init" to download all submodules

3. Build

To build the code:

Open MissionPlanner.sln with Visual Studio
From the Build menu, select "Build MissionPlanner"

On other systems

Building Mission Planner on other systems isn't support currently.

Launching Mission Planner on other system

Mission Planner is available for Android via the Play Store. https://play.google.com/store/apps/details?id=com.michaeloborne.MissionPlanner Mission Planner can be used with Mono on Linux systems. Be aware that not all functions are available on Linux. Native MacOS and iOS support is experimental and not recommended for inexperienced users. https://github.com/ArduPilot/MissionPlanner/releases/tag/osxlatest For MacOS users it is recommended to use Mission Planner for Windows via Boot Camp or Parallels (or equivalent).

On Linux

Requirements

Those instructions were tested on Ubuntu 20.04. Please install Mono, either :

sudo apt install mono-complete mono-runtime libmono-system-windows-forms4.0-cil libmono-system-core4.0-cil libmono-winforms4.0-cil libmono-corlib4.0-cil libmono-system-management4.0-cil libmono-system-xml-linq4.0-cil

Launching

Get the lastest zipped version of Mission Planner here : https://firmware.ardupilot.org/Tools/MissionPlanner/MissionPlanner-latest.zip
Unzip in the directory you want
Go into the directory
run with mono MissionPlanner.exe

You can debug Mission Planner on Mono with MONO_LOG_LEVEL=debug mono MissionPlanner.exe

External Services Used

Source	Use	How to disable	Custodian
https://firmware.oborne.me	used as a global cdn for checking for MP update check - checked once per day at startup	edit missionplanner.exe.config	Michael Oborne
https://firmware.ardupilot.org	used for updates to stable, firmware metadata, firmware, user alerts, gstreamer, SRTM, SITL	updates to stable (edit missionplanner.exe.config) - all others Not possible	Ardupilot Team
https://github.com/	used for updates to beta	edit missionplanner.exe.config	Michael Oborne
https://raw.githubusercontent.com	old param metadata, sitl config files	Not possible	Ardupilot Team
https://api.github.com/	ardupilot preload param files	Not possible	Ardupilot Team
https://raw.oborne.me/	used as glocal cdn for parameter metadata generator, no longer primary source	only used at user request to regenerate, edit missionplanner.exe.config	Michael Oborne
https://maps.google.com	used for elevation api - removed due to abuse	N/A	N/A
https://discuss.cubepilot.org/	use for SB2 reporting - only on affected boards when user enters details	only used at user request	CubePilot
https://altitudeangel.com	utm data - user enabled	only used at user request	Altitude Angel
https://autotest.ardupilot.org	dataflash log meta data, parameter metadata	Not Possible	Ardupilot Team
Many	your choice of map provider google/bing/openstreetmap/etc	User selectable	User/Many
https://www.cloudflare.com	geo location provider - for NFZ selection	Not Possible	Michael Oborne
https://esua.cad.gov.hk	HK no fly zones - user enabled	User selectable	HK Gov
https://ssl.google-analytics.com	Google Analytics Anonymous Stats - Screen Loads, Exceptions/Crashs, Events (Connect), Startup Timing, FW upload (FW Type and Board Type)	disable in Config > Planner > OptOut Anon Stats	Michael Oborne
https://api.dronelogbook.com	logging - disabled	N/A	N/A
https://ardupilot.org	help urls on many pages	User Initiated	ArduPilot Team
https://www.youtube.com	help videos on many pages	User Initiated	ArduPilot Team
https://files.rfdesign.com.au	RFD firmwares	User Initiated	RFDesign
https://teck.airmarket.io	airmarket - disabled	N/A	N/A

Offline Use - No Internet

Location	Use	Transferable between pcs
C:\ProgramData\Mission Planner\gmapcache	Map cache	yes
C:\ProgramData\Mission Planner\srtm	Elevation data cache	yes
C:\ProgramData\Mission Planner\*.pdef.xml	Parameter cache	yes
C:\ProgramData\Mission Planner\LogMessages*.xml	DF Log metadata cache	yes

on linux this is in /home//.local/share/Mission Planner/

Offline Data Supported

Elevation

SRTM Cache
GeoTiff's in WGS84/EGM96
DTED

Images

Map Cache
WMS
WMTS
GDAL

Paths used - Default

Location	Use
C:\ProgramData\Mission Planner	All cross user content
C:\Users\USERNAME\Documents\Mission Planner	All per user content