docs/Navigation.md

   1 # Navigation
   2
   3 Navigation system in INAV is responsible for assisting the pilot allowing altitude and position hold, return-to-home and waypoint flight.
   4
   5 ## NAV ALTHOLD mode - altitude hold
   6
   7 Altitude hold requires a valid source of altitude - barometer, GPS or rangefinder. The best source is chosen automatically. GPS is available as an altitude source for airplanes only.
   8 In this mode THROTTLE stick controls climb rate (vertical velocity). When pilot moves stick up - quad goes up, pilot moves stick down - quad descends, you keep stick at neutral position - quad hovers.
   9
  10 ### CLI parameters affecting ALTHOLD mode:
  11 * *nav_use_midthr_for_althold* - when set to "0", firmware will remember where your throttle stick was when ALTHOLD was activated - this will be considered neutral position. When set to "1" - 50% throttle will be considered neutral position.
  12
  13 ### Related PIDs
  14 PIDs affecting altitude hold: ALT & VEL
  15 PID meaning:
  16 * ALT - translates altitude error to desired climb rate and acceleration. Tune P for altitude-to-velocity regulator and I for velocity-to-acceleration regulator
  17 * VEL - translated Z-acceleration error to throttle adjustment
  18
  19 ## Throttle tilt compensation
  20
  21 Throttle tilt compensation attempts to maintain constant vertical thrust when copter is tilted giving additional throttle if tilt angle (pitch/roll) is not zero. Controlled by *throttle_tilt_comp_str* CLI variable.
  22
  23 ## NAV POSHOLD mode - position hold
  24
  25 Position hold requires GPS, accelerometer and compass sensors. Flight modes that require a compass (POSHOLD, RTH) are locked until compass is properly calibrated.
  26 When activated, this mode will attempt to keep copter where it is (based on GPS coordinates). Can be activated together with ALTHOLD to get a full 3D position hold. Heading hold in this mode is assumed and activated automatically.
  27
  28 ### CLI parameters affecting ALTHOLD mode:
  29 * *nav_user_control_mode* - can be set to "0" (GPS_ATTI) or "1" (GPS_CRUISE), controls how firmware will respond to roll/pitch stick movement. When in GPS_ATTI mode, right stick controls attitude, when it is released, new position is recorded and held. When in GPS_CRUISE mode right stick controls velocity and firmware calculates required attitude on its own.
  30
  31 ### Related PIDs
  32 PIDs affecting position hold: POS, POSR
  33 PID meaning:
  34 * POS - translated position error to desired velocity, uses P term only
  35 * POSR - translates velocity error to desired acceleration
  36
  37 ## NAV RTH - return to home mode
  38
  39 Home for RTH is position, where copter was armed. RTH requires accelerometer, compass and GPS sensors.
  40
  41 If barometer is NOT present, RTH will fly directly to home, altitude control here is up to pilot.
  42
  43 If barometer is present, RTH will maintain altitude during the return and when home is reached copter will attempt automated landing.
  44 When deciding what altitude to maintain, RTH has 4 different modes of operation (controlled by *nav_rth_alt_mode* and *nav_rth_altitude* cli variables):
  45 * 0 (NAV_RTH_NO_ALT) - keep current altitude during whole RTH sequence (*nav_rth_altitude* is ignored)
  46 * 1 (NAV_RTH_EXTRA_ALT) - climb to current altitude plus extra margin prior to heading home (*nav_rth_altitude* defines the extra altitude (cm))
  47 * 2 (NAV_RTH_CONST_ALT) - climb/descend to predefined altitude before heading home (*nav_rth_altitude* defined altitude above launch point (cm))
  48 * 3 (NAV_RTH_MAX_ALT) - track maximum altitude of the whole flight, climb to that altitude prior to the return (*nav_rth_altitude* is ignored)
  49 * 4 (NAV_RTH_AT_LEAST_ALT) - same as 2 (NAV_RTH_CONST_ALT), but only climb, do not descend