Tweaks

plane/source/docs/automatic-takeoff.rst

@@ -4,38 +4,36 @@
 Automatic Takeoff
 =================
 
-Plane can automatically launch a wide range of aircraft types. The
+Plane can automatically takeoff in AUTO modee a wide range of aircraft types. The
 instructions below will teach you how to setup your mission to support
-automatic takeoff. Automatic takeoff can also be accomplished by the :ref:`takeoff-mode` supported in 
-ArduPlane 4.0 and later versions.
+automatic takeoff. Automatic takeoff can also be accomplished by the :ref:`takeoff-mode`.
 
 Basic Instructions
 ==================
 
 To cause the plane to execute a takeoff, add a NAV_TAKEOFF command to your
 mission, usually as the first command. There are two parameters to this
-command - the minimum pitch, and the takeoff altitude. The minimum pitch
-controls how steeply the aircraft will climb at minimum during the takeoff. A value
+command - the minimum ``pitch``, and the takeoff altitude. The minimum pitch
+controls how steeply the aircraft will climb, at a minimum, during the takeoff. A value
 of between 10 and 15 degrees is recommended for most aircraft. The
-takeoff altitude controls the altitude above home at which the takeoff
+takeoff ``altitude`` controls the altitude above home at which the takeoff
 is considered complete. Make sure that this is high enough that the
 aircraft can safely turn after takeoff. An altitude of 40 meters is good
-for a wide range of aircraft.
+for a wide range of aircraft. After the takeoff is complete, the mission will move to the next mission item, or, if there are none, switch to RTL mode.
 
 During takeoff the wings will be held level to within
 :ref:`LEVEL_ROLL_LIMIT <LEVEL_ROLL_LIMIT>`
 degrees until :ref:`TKOFF_LVL_ALT<TKOFF_LVL_ALT>` (10m by default) meters of altitude is reached, gradually allowing more roll until
 the normal :ref:`ROLL_LIMIT_DEG<ROLL_LIMIT_DEG>` limit is allowed once 3x :ref:`TKOFF_LVL_ALT<TKOFF_LVL_ALT>` meters of altitude is
-reached. This prevents a sharp roll from causing the wings to hit the
-runway for ground takeoffs.
+reached. This prevents a sharp roll from causing the wings to hit the runway for ground takeoffs.
 
 Note that the takeoff direction is set from the direction the plane is
-pointing when the automatic takeoff command is started. So you need to
+pointing when the automatic takeoff command is started, if a compass is used, or the heading once a valid GPS heading is obtained with sufficient ground speed. So you need to
 point the plane in the right direction, then switch to AUTO mode. During
 the first stage of the takeoff the autopilot will use the gyroscope as
 the principal mechanism for keeping the aircraft flying straight, or the compass if
 equipped. After sufficient speed for a good GPS heading is reached the aircraft will
-switch to using the GPS ground track (and compass if so equipped) which allows it to account for a
+switch to using the GPS ground track if not using compass, or the initial compass heading which allows it to account for a
 cross-wind.
 
 You should try to launch into the wind whenever possible.
@@ -58,7 +56,7 @@ The keys to a good hand launch are:
 -  ensuring that the aircraft does not try to climb out too steeply
 -  assuring that the parameters are set to actually start the motor after the vehicle leaves your hand
 
-.. note:: default values for the following parameters will usually start the motor as soon at takeoff is selected (mode or mission item). This may be fine for certain hand launch situations/vehicles, but adjusting the following parameters to non-default values may be needed for safety in other situations.
+.. note:: default values for the following parameters will usually start the motor as soon as takeoff is selected (mode or mission item). This may be fine for certain hand launch situations/vehicles, but adjusting the following parameters to non-default values may be needed for safety in other situations.
 
 The main parameters that control the hand launch motor start are:
 

plane/source/docs/takeoff-mode.rst

@@ -16,11 +16,11 @@ reached the target altitude specified in the mission. The mission will then exec
 TAKEOFF Flight Mode
 ===================
 
-In ArduPlane 4.0 and later, Automatic Takeoff is also a mode itself. When entered, the plane will use maximum throttle as set by the :ref:`TKOFF_THR_MAX<TKOFF_THR_MAX>` parameter, climbing with :ref:`TKOFF_LVL_PITCH<TKOFF_LVL_PITCH>` maximum and takeoff roll limits (:ref:`LEVEL_ROLL_LIMIT<LEVEL_ROLL_LIMIT>` ) up to the :ref:`TKOFF_ALT<TKOFF_ALT>` altitude.
+Automatic Takeoff is also a mode itself. When entered, the plane will use maximum throttle as set by the :ref:`TKOFF_THR_MAX<TKOFF_THR_MAX>` parameter, climbing with :ref:`TKOFF_LVL_PITCH<TKOFF_LVL_PITCH>` maximum and takeoff roll limits (:ref:`LEVEL_ROLL_LIMIT<LEVEL_ROLL_LIMIT>` ) up to the :ref:`TKOFF_ALT<TKOFF_ALT>` altitude.
 Then, it will loiter at :ref:`TKOFF_ALT<TKOFF_ALT>` altitude until the mode is changed.
-If the plane travels for :ref:`TKOFF_DIST<TKOFF_DIST>` from the point where the mode is entered, before reaching :ref:`TKOFF_ALT<TKOFF_ALT>` altitude, then it will loiter on that spot, still trying to climb to :ref:`TKOFF_ALT<TKOFF_ALT>`.
+If the plane travels for :ref:`TKOFF_DIST<TKOFF_DIST>` from the point where the mode is entered, before reaching :ref:`TKOFF_ALT<TKOFF_ALT>` altitude, then it will loiter at that spot, still trying to climb to :ref:`TKOFF_ALT<TKOFF_ALT>`.
 
-Once :ref:`TKOFF_LVL_ALT<TKOFF_LVL_ALT>` is reached, or the loiter point distance is reached, maximum throttle and takeoff roll limits (:ref:`LEVEL_ROLL_LIMIT<LEVEL_ROLL_LIMIT>` ) are stopped and normal navigation begins to the loiter point and altitude. Normally, :ref:`TKOFF_LVL_ALT<TKOFF_LVL_ALT>` is 10 meters and is intended to limit navigation (roll) in order to prevent wing tip ground strikes.
+Once :ref:`TKOFF_LVL_ALT<TKOFF_LVL_ALT>` is reached, or the loiter point distance is reached, maximum throttle and takeoff roll limits (:ref:`LEVEL_ROLL_LIMIT<LEVEL_ROLL_LIMIT>` ) are stopped and normal navigation begins towards the loiter point and altitude. Normally, :ref:`TKOFF_LVL_ALT<TKOFF_LVL_ALT>` is 10 meters and is intended to limit navigation (roll) in order to prevent wing tip ground strikes.
 
 If the mode is entered while already flying, it will immediately begin loitering as in LOITER mode if at or above :ref:`TKOFF_ALT<TKOFF_ALT>` altitude above ground, otherwise it will climb to that altitude and then begin loitering .
 
@@ -50,11 +50,11 @@ TAKEOFF Throttle
 By default, Plane will set the throttle to :ref:`TKOFF_THR_MAX<TKOFF_THR_MAX>` (or if that is 0, to :ref:`THR_MAX<THR_MAX>`) up until it reaches :ref:`TKOFF_ALT<TKOFF_ALT>`.
 This behaviour is reflected in the :ref:`TKOFF_OPTIONS<TKOFF_OPTIONS>` bit 0 setting, which by default is 0 (unset).
 
-In case more fine-grained throttle control is required, an airspeed sensor must be installed and enabled via the :ref:`ARPSD_USE<ARSPD_USE>` parameter and :ref:`TKOFF_OPTIONS<TKOFF_OPTIONS>` bit 0 must be set to 1.
+In case more fine-grained throttle control is required, an airspeed sensor must be installed and enabled via the :ref:`ARPSD_USE<ARSPD_USE>` parameter and :ref:`TKOFF_OPTIONS<TKOFF_OPTIONS>` bit 0 must be set to 1. IF no airspeed sensor is enabled or :ref:`TECS_SYNAIRSPEED<TECS_SYNAIRSPEED>` is enabled (not recommended), then this bit has no effect.
 
 In this configuration, right after takeoff the throttle is set to :ref:`TKOFF_THR_MAX<TKOFF_THR_MAX>` for :ref:`TKOFF_THR_MAX_T<TKOFF_THR_MAX_T>` or until :ref:`TKOFF_LVL_ALT<TKOFF_LVL_ALT>` (whichever lasts longer).
 
-Finally, the throttle will be managed by the TECS controller to achieve a controlled climb, ranging between :ref:`TKOFF_THR_MIN<TKOFF_THR_MIN>` and :ref:`TKOFF_THR_MAX<TKOFF_THR_MAX>`.
+Finally, the throttle will be managed by the TECS controller to achieve a speed controlled, maximum (:ref:`TECS_CLMB_MAX<TECS_CLMB_MAX>`) climb, ranging between :ref:`TKOFF_THR_MIN<TKOFF_THR_MIN>` and :ref:`TKOFF_THR_MAX<TKOFF_THR_MAX>`.
 
 The difference between these two throttle control options can be seen in the following diagrams: