The main elements of the UI are:
- Map: Displays the numbered indicators for the current mission, including the Planned Home. Click on the indicators to select them (for editing) or drag them around to reposition them.
- Plan Toolbar: Status information for the currently selected waypoint relative to the previous waypoint, as well as statistics for the entire mission (e.g. horizontal distance and time for mission).
Max telem distis the distance between the Planned Home and the furthest waypoint.
- When connected to a vehicle it also shows an Upload button, can be used to upload the plan to the vehicle.
- Plan Tools: Used to create and manage missions.
- Mission Command List/Overlay: Displays the current list of mission items (select items to edit).
- Terrain Altitude Overlay: Shows the relative altitude of each mission command.
It shows you information related to the currently selected waypoint as well as statistics for the entire mission.
Planning a Mission
At very high level, the steps to create a mission are:
- Change to Plan View.
- Add waypoints or commands to the mission and edit as needed.
- Upload the mission to the vehicle.
- Change to Fly View and fly the mission.
The following sections explain some of the details in the view.
Planned Home Position
The Planned Home shown in Plan View is used to set the approximate start point when planning a mission (i.e. when a vehicle may not even be connected to a vehicle). It is used by QGC to estimate mission times and to draw waypoint lines.
You should move/drag the planned home position to roughly the location where you plan to takeoff. The altitude for the planned home position is set in the Mission Settings panel.
The Fly View displays the actual home position set by the vehicle firmware when it arms (this where the vehicle will return in Return/RTL mode).
The plan tools are used for adding individual waypoints, easing mission creation for complicated geometries, uploading/downloading/saving/restoring missions, and for navigating the map. The main tools are described below.
Center map, Zoom In, Zoom Out tools help users better view and navigate the Plan view map (they don't affect the mission commands sent to the vehicle).
Click on the Add Waypoint tool to activate it. While active, clicking on the map will add new mission waypoint at the clicked location. The tool will stay active until you select it again. Once you have added a waypoint, you can select it and drag it around to change its position.
The File tools are used to move missions between the ground station and vehicle, and to save/restore them from files. The tool displays an
! to indicate that there are mission changes that you have not sent to the vehicle.
Before you fly a mission you must upload it to the vehicle.
The File tools provide the following functionality:
- Upload (Send to vehicle)
- Download (Load from vehicle)
- Save/Save as to File, including as KML file.
- Load from File
- Remove All (removes all mission waypoints from Plan view and from vehicle)
Mission Command List
Mission commands for the current mission are listed on the right side of the view. At the top are a set of options to switch between editing the mission, GeoFence and rally points. Within the list you can select individual mission items to edit their values.
Mission Command Editors
Click on a mission command in the list to display its editor (in which you can set/change the command attributes).
You can change the type of the command by clicking on the command name (for example: Waypoint). This will display the Select Mission Command dialog shown below. By default this just displays the "Basic Commands", but you can use the Category drop down menu to display more (e.g. choose All commands to see all the options).
To the right of each command name is a menu that you can click to access to additional options such as Insert and Delete.
The list of available commands will depend on firmware and vehicle type. Examples may include: Waypoint, Start image capture, Jump to item (to repeat mission) and other commands.
The Mission Start panel is the first item that appears in the mission command list. It may be used to specify a number default settings that may affect the start or end of the mission.
Set the default altitude for the first mission item added to a plan (subsequent items take an initial altitude from the previous item). This can also be used to change the altitude of all items in a plan to the same value; you will be prompted if you change the value when there are items in a plan.
Set a flight speed for the mission that is different than the default mission speed.
Return to Launch after mission end
Check this if you want your vehicle to Return/RTL after the final mission item.
Planned Home Position
The Planned Home Position section allows you to simulate the vehicle's home position while planning a mission. This allows you to view the waypoint trajectory for your vehicle from takeoff to mission completion.
This is only the planned home position and you should place it where you plan to start the vehicle from. It has no actual impact on flying the mission. The actual home position of a vehicle is set by the vehicle itself when arming.
The section allows you to set the Altitude and Set Home to Map Centre (you can move it to another position by dragging it on the map).
The camera section allows you to specify a camera action to take, control the gimbal and set your camera into photo or video mode.
The available camera actions are:
- No change (continue current action)
- Take photos (time)
- Take photos (distance)
- Stop taking photos
- Start recording video
- Stop recording video
The appropriate mission commands for the vehicle depend on the firmware and vehicle type.
If you are planning a mission while you are connected to a vehicle the firmware and vehicle type will be determined from the vehicle. This section allows you to specify the vehicle firmware/type when not connected to a vehicle.
The additional value that can be specified when planning a mission is the vehicle flight speed. By specifying this value, total mission or survey times can be approximated even when not connected to a vehicle.
Mission (Plan) Upload/Download Failures
Plan uploading and downloading can fail over a noisy communication link (affecting missions, GeoFence, and rally points). If a failure occurs you should see a status message in the QGC UI similar to:
Mission transfer failed. Retry transfer. Error: Mission write mission count failed, maximum retries exceeded.
The loss rate for your link can be viewed in Settings View > MAVLink. The loss rate should be in the low single digits (i.e. maximum of 2 or 3):
- A loss rate in the high single digits can lead to intermittent failures.
- Higher loss rates often lead to 100% failure.
There is a much smaller possibility that issues are caused by bugs in either flight stack or QGC. To analyse this possibility you can turn on Console Logging for Plan upload/download and review the protocol message traffic.