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.

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, FW Auto-Land plans. INAV8 Geozone editor.
  • Survey / Search Area Planner
  • 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 manager
  • KML/KMZ static overlays
  • UBLOX AssistNow GPS data.

Supported Protocols

mwp supports the following telemetry protocols :

• MSP (MultiWii Serial Protocol)
• LTM (Lightweight Telemetry)
• MAVLink (INAV telemetry 'push' 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)
• SDR ADS-B (dump1090 / readsb / SBS1) live reports for general aviation
• Other SDR reporting procotols
• MAVlink Traffic Report / ADSB Vehicle (e.g. general aviation, typically ADS-B via a device such as uAvionix PingRX or Aerobits TT-SC1)
• MSP2_ADSB_VEHICLE_LIST (e.g. general aviation, typically ADS-B via a device such as uAvionix PingRX or Aerobits TT-SC1)
• Internet providers / aggregators using the REST readsb JSON format.

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 also tested on Debian (Trixie / Sid), Alpine (Edge), Fedora (current) and FreeBSD (current release). Being able to satisfy the required dependencies is more important than the actual distro / OS / platform. mwptools also runs on proprietary OS such as MacOS and Windows.

Build and installation

Build and installation is described in the following sections:

• Generic build and installation.

If you are migrating from the legacy (Gtk+-3.0) version to the extant (Gtk 4) version, you are advised to read the migration guide first.

This document

This document describes the most recent (usually the development branch) version on Github. Prior versions may be checked-out from their respective Github commits / branches / tags.

---

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. ↩