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 abf5411
Showing 1 changed file with 19 additions and 3 deletions.
22 changes: 19 additions & 3 deletions plane/source/docs/guided-mode.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,26 @@
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.

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.

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 altitude and desired airspeed
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 since there is no "end point" to a heading target for a final loiter.

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 abf5411

Please sign in to comment.