Overview

Sweet dreams and flying machines¹

mwp (originally "multi-wii planner") is a mission planner, ground control station and flight logger for MSP (Multiwiii Serial Protocol) compatible flight controller firmware (INAV and Multiwii at least).

From its MultiWii origins mwp has evolved to support navigation capabilities in INAV.

INAV is now the main development target, however MultiWii mission planning and ground control remains a supported function.

You can also download this manual as PDF for offline reference.

Features

• Mission Planner : Supports all INAV and MultiWii mission planning functions, including all INAV extensions.
• Ground Control Station : (Near) real time ground control monitoring, using a wide range of telemetry options. Audio status reports.
• Monitoring and warning of other airspace users (INAV radar, manned aviation ADS-B)
• Flight log replay (Blackbox, OTX/ETX logs, BulletGCSS)
• Embedded video (live and replay)
• Support functions
  • INAV Safehome editor
  • Automatic mission shape generation, block moves, animated mission preview.
  • Terrain Analysis with WP mission rewrite to safe elevation margins
  • Line of sight Analysis along a WP mission file.
  • Favourite sites editor
  • KML/KMZ static overlays

Supported Protocols

mwp supports the following telemetry protocols :

• MSP (MultiWii Serial Protocol)
• LTM (Lightweight Telemetry)
• MAVLink (INAV subset)
• Smartport (direct / via inverter / or from Multi-protocol Module)
• Crossfire (CRSF)
• Flysky AA (via Multi-protocol Module)
• BulletGCSS MQTT

Monitoring

mwp also supports the real-time display of adjacent aircraft using:

• INAV-radar (INAV UAS)
• dump1090 / SBS-1 Basestation (SDR ADS-B), streaming TCP, for general aviation
• MAVlink Traffic Report (e.g. general aviation, typically ADS-B via a device such as uAvionix PingRX)

Log replay formats

mwp supports replay of:

• mwp log files (logged by mwp/GCS)
• Blackbox logs
• OpenTX and EdgeTX CSV (sdcard) logs
• BulletGCSS logs
• Ardupilot (.bin) log

Log replay requires tools from the flightlog2x project.

Platforms and OS

The tools are designed to be portable and as far as possible platform and architecture agnostic. The suite is developed on Arch Linux and is tested on Debian (Bullseye, Sid), Ubuntu (latest and most recent LTS), Fedora (current) and FreeBSD (current release). mwp also runs on MS Windows; Windows 11 / WSL-g is almost on feature parity with Linux / FreeBSD. Other (older) OS are unsupported, but may work (i.e. Debian 10 is used for the "release" builds).

Build and installation

Build and installation is described in the following sections:

• Generic build and installation Linux, FreeBSD, Windows / WSL
  • Windows additional information (Win11, Win10 and earlier)

Installation Tutorial

Somewhat outdated, if you follow this, please note that some of is much simplified by the later Generic build and installation article.

---

1. James Taylor, Fire and Rain. Full line is 'sweet dreams and flying machines in pieces on the ground', you may skip the final part. ↩