User interface#
Main Window#
The mwp main window and the main user interface elements are:
- Menu bar. The menu options are described later.
- Map and Mission settings
- Communications and telemetry settings
- Map window
- Dock Bar
- Dock Items (Docklets)
- Mouse location (user preference units, cursor or map centre location)
- Flight controller information
- Sensor status and flight timer
In the sections that follow, there will be a brief summary of each part; more detail will then provided in subsequent sections.
Menu Bar (1)#
The following tables summarise the available menu options. Where usage is not obvious, operation will be described later on.
File Menu#
| Item | Usage |
|---|---|
| Open Mission | Offers a dialog to open a mission file |
| Append Mission file | Appends a mission to the current mission set (creates a multi-mission element) |
| Save Mission | Saves the mission to the current mission file, overwriting any extant content |
| Save Mission As | Saves the mission to a user selected file. For a multi-mission the user can choose not to save specified mission segments. |
| Download Mission from FC | Downs a (multi-) mission from the flight controller |
| Upload Mission to FC > Upload Active Mission | Uploads the current mission segment to the flight controller |
| Upload Mission to FC > Upload All Missions | Uploads all mission segments to the flight controller |
| Restore Mission from EEPROM | Restores the EEPROM stored mission from the flight controller |
| Save Mission to EEPROM | Saves the current mission segment(s) to the flight controller. The current active mission segment (in a multi-mission) is set as the active mission in the FC |
| Replay mwp log | Replay a mwp (JSON) log file |
| Load mwp log | Loads a mwp (JSON) log file (i.e, as fast as practical, ignoring timings) |
| Replay blackbox log | Replays a Blackbox log file |
| Load blackbox log | Loads a Blackbox log file (i.e, as fast as practical, ignoring timings) |
| Replay OTX log | Replays an OpenTX / EdgeTX CSV log file. (Also BulletGCSS and Ardupilot logs where available) |
| Load OTX log | Loads an OpenTX / EdgeTX CSV log file. (Also BulletGCSS and Ardupilot logs where available) |
| Stop Replay | Stops a running replay |
| Static Overlay > Load | Loads a static KML format overlay file |
| Static Overlay > Remove | Removes a loaded KML file from the display |
| Safe Homes | Invokes the inav safe-home editor |
| Quit | Cleanly quits the application, saving the display layout |
Edit Menu#
| Item | Usage |
|---|---|
| Preferences | Displays the preferences dialogue |
| Multi Mission Manager | Display the multi-mission dialogue to remove segments from a multi-mission |
| CLI serial terminal | Displays the inav CLI using the current connection |
| Nav Config | (Legacy MW) MW Nav Configuration |
| Get FC Mission Info | Display the mission status from a connected FC |
| Seed current map | Shows a dialogue to seed the map cache for offline (field) use |
| Reboot FC | Reboots a connected flight controller |
| Audio Test | Reads out the mwp version number as an audio test |
View Menu#
| Item | Usage |
|---|---|
| Zoom to Mission | Zooms the map to the currently loaded mission |
| Set location as default | Sets the current location as the default (startup) location |
| Centre on position ... | Shows the "Centre on Position" selector and "favourite places" editor" |
| Map Source | Displays a dialogue with information on the selected map source |
| GPS Statistics | Displays FC GPS status (rate, packets, errors, timeouts, HDOP/EPV/EPH) |
| Mission Editor | Adds the Mission Editor (tabular view) to the dock (default) |
| MW Nav Status | Adds the (legacy MW) Nav Status docklet to the dock |
| GPS Status | Adds the (legacy MW) GPS Status docklet to the dock |
| Radio Status | Adds the radio status docklet to the dock (default) |
| Battery Monitor | Adds the Battery Status docklet to the dock (default) |
| Telemetry Status | Adds the Telemetry Status docklet to the dock |
| Artificial Horizon | Adds the Artificial Horizon docklet to the dock |
| Direction View | Adds the Direction View (mag v. GPS) docklet to the dock |
| Flight View | Adds the Flight View docklet to the dock (default) |
| Vario View | Adds the Vario docklet to the dock |
| Radar View | Displays the Radar (inav radar / ADS-B) view |
| Flight Statistics | Display the flight statistic dialogue (also automatic on disarm) |
| Layout Manager > Save | Saves the current dock layout |
| Layout Manager > Restore | Restores a saved dock layout |
| Video Stream | Opens the (live_ video stream window |
| GCS Location | Displays the indicative GCS location icon |
Help Menu#
| Item | Usage |
|---|---|
| Shortcut keys list | Displays the short cut keys list |
| About | Displays version, author and copyright information |
Map and Mission Settings (2)#
A number of different map provides are available. mwp offers the mapping library (libchamplain) defaults, Bing Maps (Bing Proxy) using a bespoke mwp API key, and user defined options, for example anonymous maps.
The zoom level may be selected from the control here, or by zooming the map with the mouse wheel. The +Edit WPs button enables mission edit mode (click on the map to create a WP, drag to move, right mouse button for properties). Graphical WP editing may be augmented by the table orientated mission table view, which allows additional control (altitude, speed, special functions, for example fly-by-home waypoints).
The "Active Mission" drop down supports inav 4.0+ multi-mission. There is also a multi-mission manager under the Edit menu.
Communications and telemetry settings (3)#
There is a (blue "!" in the example) 'navigation safe' status icon. If this icon is shown (i.e. navigation is unsafe, then clicking on the item will provide more information:
The Device drop-down offers detected and pre-set (Preferences) devices for the FC / telemetry port. The device syntax is described the Device and Protocol definition article.
The Protocol Selection drop-down (here showing Auto) allows the user to provide a hint as to communication protocols available on Device. These are further described in the Device and Protocol definition article.
The Connect / Disconnect button connects / disconnects the displayed device.
The auto button causes mwp to automatically attempt to connect to the nominated device.
Map Area (4)#
The map area displays the currently selected map at the desired zoom level. The map may be managed using familiar controls (drag, scroll wheel etc).
Graphics Requirement
The map API used my mwp requires OpenGL / 3D accelerated graphics. Performance with software rendering is likely to be disappointing and CPU intensive.
Dock Bar (5)#
The Dock Bar contains essentially minimised Docklets, selected from the View menu. In the illustration, these are the Vario view, Telemetry statistics, and Mission Editor. Hovering the mouse over the icon will reveal its function:
Docklets (6)#
Docklets are display items that can be docked, iconised, hidden or displayed in floating windows. See Dock Management. In the main window screen shot (left to right, top to bottom) we have:
- Radio status (RSSI or LQ)
- Artificial horizon
- Direction Status (Heading (Position Estimator/Compass v. GPS). Useful to diagnose mag EMF interference on multi-rotors).
- Flight View. General geo-spatial information.
- Battery status. Current usage is also shown when available.
Location (7)#
The location (of the mouse pointer), user setting "pos-is-centre" for either mouse pointer or map centre, and format (Preferences).
FC Information (8)#
Displays the firmware, version and build with API information, profile and flight mode.
Sensors and flight status (9)#
- Follow : user setting "auto-follow". whether the map always displays the aircraft icon (required GPS).
- In View : Scrolls the map to keep the aircraft in view; otherwise the map is centred on the aircraft (requires GPS).
- Logger : Generate mwp logs (JSON format).
- Audio : user setting "audio-on-arm". Whether to "speak" status information.
The green / red bars show gyro / acc / baro / mag / gps / sonar sensor status. If a required sensor fails, a map annotation will be displayed, together with an audible alarm.
