Widgets

There are multiple widgets that you can use. They are described here.

Map 2D

name: map2d

This is a classic 2D map to display waypoints and aircrafts.

A telemetry message can be dropped on it to display a papget.

It can be configured to add buttons in a left and right columns to display other widgets over it. The left column is a rail along the edge of the map: a button opens its widget in a card over the map, a long press keeps it open, and dragging the button moves the widget (see Layout/Tabs).

The cards can be moved over the map by their title bar (double click: back next to the rail) and resized with the grip in their bottom right corner.

Messages from the aircraft, a low battery and lost links are shown as notifications at the top of the map. Messages disappear after a few seconds, warnings stay until fixed or dismissed. Click a notification to select its aircraft and open the chat.

  • Double click an aircraft to select it; with several aircraft their names show (in their color) when the pointer is on them or when they overlap. Aircrafts > Colors changes the color of an aircraft; aircraft with the same configured color get distinct ones.

  • Drag a waypoint to move it: a card next to it shows how far it moved and its height above ground, and its old position stays on the map until the aircraft confirms the move.

  • Map layers has a brightness slider: a slightly darker map makes the aircraft and waypoints stand out.

  • File > Settings > General can show the battery and link icons next to the aircraft.

../_images/notifications.png
map2d widget

map2d, with an overlay widget

Strip

name: strips

Display some data about the drone status.

../_images/strip.png

First row: aircraft name, AP mode, current block and flight time (click the time to show the block or stage time).

Second row, with a caption above each value:

  • battery (amber when low, red when critical)

  • altitude AGL or AMSL (click to change) | altitude difference to the target

  • ground speed / air speed / vertical speed (click to change)

  • throttle

Link, GPS, RC and IMU are only shown when they are not ok. When links are lost the strip gets an amber or red frame. Click on a strip to select the aircraft for the other widgets, double click it to center the map on it. With more than 3 aircraft, the strips of the aircraft that are not selected are compact (two lines). The round icon next to the throttle shows its state: green while the throttle is on, red (and KILLED) while it is killed; clicking it kills or resurrects the throttle, after a confirmation. Click the battery to show the voltage per cell or the total (with BAT_NB_CELLS in the airframe). The link, GPS, RC and IMU icons are shown by default; File > Settings > General can hide them when ok.

PFD

name: PFD

Primary flight display of the selected aircraft: an attitude indicator (roll and pitch), the ground speed (air speed below) on the left, the height above ground on the right with a marker at the target height and the climb rate, the heading below, and the values as text.

Right click on it to choose the view: pilot view (the horizon moves, as in an aircraft) or ground view (the horizon stays level and the aircraft symbol banks and pitches, as seen from the ground).

../_images/PFD.png

Commands

name: commands

Basic commands, flight plan buttons and setting buttons.

../_images/commands.png

Flight plan

name: flightplan

Control the flight plan.

The first tab shows the blocks, the current block being highlighted in green with its time. Tap a block, then Go, or double click it to switch to it (amber until the aircraft is in it).

../_images/flightplan_blocks.png

The second tab show the detail of the flight plan, parsed from the XML. Double click on a block to switch to it.

../_images/flightplan_details.png

Settings

name: settings

Aircraft settings, one per line with its control: buttons or a list for named values, a switch for on/off, a field for a number. Click the name of a setting to open it: the slider for a number, and Ask (the value on the aircraft, asked again after 3 s without answer), Previous, Initial, Undo and Send. A value outside the range is shown in red and sent after a confirmation. A sent value stays amber until the aircraft confirms it. Search finds settings in all groups; groups with the same name are shown as one. The save button writes the changed settings into the airframe file. File > Settings > General can show every setting open, as in the old layout.

../_images/settings.png

Chat

name: chat

Messages from the aircraft (INFO_MSG) and the ground, one row per message with the sender name in its color; the time is shown on hover. Messages about a problem (low, lost, fail, …) are highlighted. With more than one aircraft, a filter shows the messages of one sender.

../_images/chat.png

Plotter

name: plotter

Plot a field of a message.

Switch between plots with menu opened by the arrow down button. You can also add new plots coming from ground messages from there.

Add a plot coming from the telemetry class by dropping a field from the Messages tool (same as for the real-time plotter).

  • Zoom on the plot with the mouse wheel.

  • Move the plot up or down by dragging it.

  • Tune the history time with the spinbox

  • Remove the plot with the top right button.

../_images/plotter.png

This widget can be configured from the layout file. See Layout/Plotter.