diff --git a/common/source/docs/common-advanced-configuration.rst b/common/source/docs/common-advanced-configuration.rst index 4937cc0d62..eb7de78344 100644 --- a/common/source/docs/common-advanced-configuration.rst +++ b/common/source/docs/common-advanced-configuration.rst @@ -31,6 +31,7 @@ tuning options for the vehicle. Auxiliary Functions Battery Voltage Compensation Bootloader Update + Flying without GPS or Airspeed [/site] BLHeli ESCs CAN Bus Setup diff --git a/common/source/docs/common-non-gps-to-gps.rst b/common/source/docs/common-non-gps-to-gps.rst index 853d2f818e..9c102e9960 100644 --- a/common/source/docs/common-non-gps-to-gps.rst +++ b/common/source/docs/common-non-gps-to-gps.rst @@ -11,6 +11,11 @@ ArduPilot 4.1 (and higher) support in-flight transitions between GPS and Non-GPS .. note:: Non-GPS navigation is available for all vehicles. However, it is not applicable to fast or high flying vehicles such as conventional Planes. QuadPlanes can utilize this when in VTOL operation and close to the ground, as when docking inside a hangar using 3D cameras or beacons. +[site wiki="plane"] +If you want to fly a Plane without a GPS or airspeed sensor installed, see :ref:`Flying without GPS or Airspeed `. +This wiki page covers flying with the sensor(s) installed and allowing the EKF to gracefully handle when GPS is lost. +[/site] + Setup ----- diff --git a/plane/source/docs/no-gps-airspeed.rst b/plane/source/docs/no-gps-airspeed.rst new file mode 100644 index 0000000000..9bdd1906e3 --- /dev/null +++ b/plane/source/docs/no-gps-airspeed.rst @@ -0,0 +1,40 @@ +.. _no-gps-or-airspeed: + +============================== +Flying without GPS or Airspeed +============================== + +Generally, most features in ArduPlane rely on two assumptions: + +* The plane can determine where it is in the world, generally with the use of a GPS +* The plane can determine its airspeed, either through a synthetic estimate or through a dedicated airspeed sensor. + +The default parameters for ArduPlane assume that the above statements are true. +Much of the wiki is written assuming you have a GPS. +In the special case that you want to fly without either of these, +such as using just MANUAL and FBWA for initial flights, then follow this guide. + +Recommended Parameters +====================== + +* Disable stall prevention with :ref:`STALL_PREVENTION` set to 0 +* Disable GPS's with :ref:`GPS1_TYPE` set to 0 +* Disable airspeed use with :ref:`ARSPD_USE` set to 0 +* Disable the first airspeed sensor with :ref:`ARSPD_TYPE` set to 0 +* Force DCM with :ref:`AHRS_EKF_TYPE` set to 0 +* Change the failsafe long action to ``Glide`` with :ref:`FS_LONG_ACTN` + +.. warning:: Using the :ref:`FS_LONG_ACTN` default of ``Continue``, or ``ReturnToLaunch``, will cause a fly-away. + RTL requires GPS and should NOT be used. + + +Limitations +=========== + +:ref:`SERVO_AUTO_TRIM` won't work - this requires a velocity estimate. Although it's disabled by default, you will have to rely on manual trimming. + +Most navigation modes won't be allowed, including AUTO, FBWB, and RTL. + +:ref:`AUTOTUNE ` is not possible because it requires the vehicle to be flying faster than :ref:`AIRSPEED_MIN`. +To tune your aircraft without GPS and airspeed sensor, you must do it manually. +