Skip to content

Commit

Permalink
Plane: Document setup without GPS or airspeed sensor
Browse files Browse the repository at this point in the history
Signed-off-by: Ryan Friedman <[email protected]>
  • Loading branch information
Ryanf55 committed Jan 5, 2025
1 parent c7035c3 commit 3f68718
Show file tree
Hide file tree
Showing 3 changed files with 40 additions and 0 deletions.
1 change: 1 addition & 0 deletions common/source/docs/common-advanced-configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ tuning options for the vehicle.
Auxiliary Functions <common-auxiliary-functions>
Battery Voltage Compensation <battery-voltage-compensation>
Bootloader Update <common-bootloader-update>
Flying without GPS or Airspeed <no-gps-airspeed>
[/site]
BLHeli ESCs <common-blheli32-passthru>
CAN Bus Setup <common-canbus-setup-advanced>
Expand Down
5 changes: 5 additions & 0 deletions common/source/docs/common-non-gps-to-gps.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <no-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
-----

Expand Down
34 changes: 34 additions & 0 deletions plane/source/docs/no-gps-airspeed.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
.. _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<STALL_PREVENTION>` set to 0
* Disable GPS's with :ref:`GPS1_TYPE<GPS1_TYPE>` set to 0
* Disable airspeed with :ref:`ARSPD_USE<ARSPD_USE>` set to 0
* Force DCM with :ref:`AHRS_EKF_TYPE<AHRS_EKF_TYPE>` set to 0

Limitations
===========

:ref:`SERVO_AUTO_TRIM<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 <automatic-tuning-with-autotune>` is not possible because it requires the vehicle to be flying faster than :ref:`AIRSPEED_MIN<AIRSPEED_MIN>`.
To tune your aircraft without GPS and airspeed sensor, you must do it manually.

0 comments on commit 3f68718

Please sign in to comment.