MAVLINKHUD

Overview

The COMMON parameter group is a container for parameters that don't fit neatly into a specific library subclass or are shared generically across vehicle types (though often defined in vehicle-specific code).

In this specific documentation set, it largely contains the Flight Mode switch mapping parameters for Rover (and historically other vehicles before they moved to FLTMODE_).

Key Concepts

1. Mode Switch Mapping (MODEx)

ArduPilot allows you to map up to 6 flight modes to a single RC channel (usually Channel 5 or 8) using PWM ranges.

  • MODE1: PWM 0-1230.
  • MODE2: PWM 1231-1360.
  • MODE3: PWM 1361-1490.
  • MODE4: PWM 1491-1620.
  • MODE5: PWM 1621-1749.
  • MODE6: PWM 1750+.

Parameter Breakdown

  • MODE1..MODE6: Selects the active mode for that switch position (e.g., MANUAL, STEERING, AUTO).
  • DUMMY: A test parameter with no effect.

Integration Guide

  • Setup: Use the "Flight Modes" tab in Mission Planner. It automatically sets these parameters based on the dropdown menu selections.

Developer Notes

  • Note: Copter uses FLTMODE_x. Plane uses FLTMODE_x. Rover uses MODE_x. This inconsistency is historical.

DUMMY

Default 0

Dummy Parameter (DUMMY)

Description

This is a test parameter used by the ArduPilot Replay tool and other internal test suites. It has no effect on vehicle flight behavior.

The Mathematics

None.

The Engineer's View

Defined in Tools/Replay/Replay.cpp.

Tuning & Behavior

  • Ignore: Do not modify.

MODE3

Default 0
Range 0 255

Mode3 (MODE3)

Description

This parameter assigns the flight/drive mode active when the RC Mode Switch (channel 5 or 8) is in its middle position (PWM ~1425us).

The Mathematics

PWM Mapping Logic.

The Engineer's View

Defined in Rover/Parameters.cpp (and other vehicle folders). Maps integer ID to mode.

Tuning & Behavior

  • Default Value: Vehicle dependent.
  • Select: Choose from the list of available flight modes (e.g., MANUAL, ACRO, STEERING, HOLD, AUTO).

MODE4

Default 0
Range 0 255

Mode4 (MODE4)

Description

This parameter assigns the flight/drive mode active when the RC Mode Switch is in position 4 (PWM ~1555us). See MODE3.

The Mathematics

PWM Mapping.

The Engineer's View

Defined in Rover/Parameters.cpp.

Tuning & Behavior

  • Default Value: Vehicle dependent.

MODE5

Default 0
Range 0 255

Mode5 (MODE5)

Description

This parameter assigns the flight/drive mode active when the RC Mode Switch is in position 5 (PWM ~1685us). See MODE3.

The Mathematics

PWM Mapping.

The Engineer's View

Defined in Rover/Parameters.cpp.

Tuning & Behavior

  • Default Value: Vehicle dependent.

MODE6

Default 0
Range 0 255

Mode6 (MODE6)

Description

This parameter assigns the flight/drive mode active when the RC Mode Switch is in position 6 (High, PWM > 1750us). See MODE3.

The Mathematics

PWM Mapping.

The Engineer's View

Defined in Rover/Parameters.cpp.

Tuning & Behavior

  • Default Value: Vehicle dependent.