Skip to content

Commit

Permalink
Give a bit more information about how Plane Guided works
Browse files Browse the repository at this point in the history
  • Loading branch information
timtuxworth committed Jul 6, 2024
1 parent a874c45 commit ec6f61c
Showing 1 changed file with 26 additions and 3 deletions.
29 changes: 26 additions & 3 deletions plane/source/docs/guided-mode.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,33 @@
GUIDED Mode
===========

The GUIDED mode is used when you want the aircraft to fly to a specific
point on the map without setting up a mission. Most ground control
GUIDED mode is used when you want the aircraft to fly to a specific
point on the map, or in specific direction (heading) without setting up a mission.

Location sub-mode
-----------------
Most ground control
stations support a "click to fly to" feature where you can click a point
on the map and the aircraft will fly to that location then loiter.
on the map and the aircraft will fly to that location then loiter. If an
altitude is requested, the aircraft will fly at the current altitude until
it reaches the target location, then will loiter down or up to the requested
altitude.

Heading sub-mode
----------------
The guided mode heading feature isn't supported by Mission Planner or QGroundControl, but can be
requested via MavLink commands or using Lua. If the aircraft receives a GUIDED_CHANGE_HEADING
command it will fly indefinitely towards the heading in degrees.

The target altitude and desired airspeed or
groundspeed of the vehicle to fly at can be set using the GUIDED_CHANGE_ALTITUDE and GUIDED_CHANGE_SPEED
MavLink commands. If the aircraft is flying in Guided "heading" sub-mode then it will try to
achieve the altitude as it flies, as there is no "end point" to a heading target for a final loiter.

If the vehicle is flying in Guided "Location sub-mode" then GUIDED_CHANGE_ALTITUDE and GUIDED_CHANGE_SPEED
commands will be ignored.

For more information about this, see the MavLink GUIDED_CHANGE_HEADING documentation

The other major use for GUIDED mode is in :ref:`geo-fencing <geofencing>`.
When the geo-fence is breached the aircraft will enter GUIDED mode, and
Expand Down

0 comments on commit ec6f61c

Please sign in to comment.