MAVLINKHUD

Overview

The ALT parameter group contains miscellaneous altitude-related settings.

Note: This group is a bit of a "catch-all" in some documentation sets.

  • ALT_OFFSET is a core ArduPlane parameter for adjusting the mission altitude frame.
  • ALT_MIN is typically associated with the Proximity library (PRX_ALT_MIN), defining the floor for obstacle avoidance.

Key Concepts

1. Altitude Offset (ALT_OFFSET)

(ArduPlane Only)
This parameter shifts the autopilot's internal reference for "Home Altitude" without actually moving the Home point.

  • Usage: Useful for landing at a location that is at a different physical elevation than the takeoff point, or for adjusting altitude during repeated auto-landings in a circuit.
  • Math: Target_Alt = Mission_Alt + ALT_OFFSET.

2. Proximity Floor (ALT_MIN)

(From AP_Proximity)
Defines the minimum altitude (AGL) required for the obstacle avoidance system to engage.

  • Purpose: Prevents the ground itself from being detected as an "obstacle" during takeoff and landing, which could cause the vehicle to panic or refuse to land.

Parameter Breakdown

  • ALT_OFFSET: Altitude offset in meters. Positive adds height to targets.
  • ALT_MIN: Minimum altitude for proximity sensors to be active.

Developer Notes

  • Context: ALT_OFFSET is defined in ArduPlane/Parameters.cpp. ALT_MIN is defined in libraries/AP_Proximity.

ALT_MIN

m
Default 1.0
Range 0 10

Proximity lowest altitude (ALT_MIN)

Description

Defines the minimum altitude above ground (AGL) required for proximity sensors and avoidance logic to become active. This prevents false triggers from the ground during takeoff and landing.

Tuning & Behavior

  • Default Value: 1.0 m
  • Range: 0 to 10 m

ALT_OFFSET

m
Default 0

Altitude offset (ALT_OFFSET)

Description

A manual or GCS-provided offset added to the calculated barometric altitude. It is typically used to align the vehicle's altitude with a known ground reference.

Tuning & Behavior

  • Default Value: 0 m
  • It is automatically reset to 0 when the barometer is calibrated on reboot.

ALT_SLOPE_MIN

m
Default 15

Glide slope minimum (ALT_SLOPE_MIN)

Description

Defines the minimum vertical distance required between waypoints to trigger a linear glide slope (gradual climb/descent). For smaller changes, the aircraft may attempt an immediate altitude change.

Tuning & Behavior

  • Default Value: 15 m
  • A value of 0 disables glide slope calculations, leading to immediate altitude setpoint changes.

ALT_TYPE

Default 0

Follow Altitude Type (ALT_TYPE)

Description

Specifies the altitude reference frame used when in Follow mode.

Tuning & Behavior

  • Default Value: 0 (AMSL)
  • Values: 0:AMSL (Above Mean Sea Level), 1:Relative (Above Home)