MAVLINKHUD

Overview

The GROUND parameter group configures the Ground Steering logic for ArduPlane.

This system manages the transition from using the Rudder (airflow-based steering) to the Nose/Tail Wheel (mechanical ground-based steering) during takeoff and landing.

Key Concepts

1. Ground Steering Alt (GROUND_STEER_ALT)

Defines the altitude (meters) above which ground steering is disabled.

  • Takeoff: Once the plane climbs above this height, the steering wheel is centered (or follows rudder) to reduce drag and prevent a sudden jerk if the wheels touch back down.

2. Steering Rate (GROUND_STEER_DPS)

Limits the maximum rotation rate (degrees per second) of the steering servo.

  • Purpose: Prevents high-speed "tank slappers" or tip-overs by preventing the pilot (or autopilot) from slamming the steering wheel to full lock at high taxi speeds.

Parameter Breakdown

  • GROUND_STEER_ALT: Transition altitude (m).
  • GROUND_STEER_DPS: Max steering slew rate (deg/s).

Integration Guide

  • Nose Wheel: Map your nose-wheel servo to GroundSteering (Function 39) rather than Rudder to utilize these specific ground-handling features.

Developer Notes

  • Library: ArduPlane/servos.cpp.
  • Context: Only relevant for ArduPlane.

GROUND_STEER_ALT

m
Default 0
Range -100 100

Ground steer altitude (GROUND_STEER_ALT)

Description

Defines the altitude threshold during takeoff at which the aircraft transitions from ground-based steering (nose wheel or tail wheel) to aerodynamic steering (rudder and ailerons).

  • 0 (default) disables the altitude-based cutoff.

GROUND_STEER_DPS

deg/s
Default 90
Range 10 360

Ground steer rate (GROUND_STEER_DPS)

Description

This parameter limits how fast the nose wheel (or tail wheel) servo can move. By slewing the steering command, it prevents the pilot from commanding an instantaneous, sharp turn that could cause the aircraft to tip over (wingtip strike) or skid during high-speed taxiing.

The Mathematics

Rate Limiter:
$$ \frac{\Delta \text{Steer Angle}}{\Delta t} \le \text{GROUND\_STEER\_DPS} $$

The Engineer's View

Defined in ArduPlane/Parameters.cpp.

Tuning & Behavior

  • Default Value: 90 $deg/s$
  • Adjustment: Decrease for top-heavy aircraft or narrow gear widths. Increase for agile ground handling at low speeds.