MAVLINKHUD

Overview

The MSG parameter group (specifically MSG_TIME or OSD_MSG_TIME) manages the visibility of status notifications.

Key Concepts

1. Message Persistence

When the autopilot triggers a status message (e.g., "Armed," "RTL Engaged," or "Low Battery"), it is displayed as a pop-up on the On-Screen Display (OSD).

  • MSG_TIME: Sets how long (in seconds) the text remains on screen before fading away.
    • Recommendation: 5-10 seconds is standard. Longer values ensure you don't miss warnings, but may block other telemetry.

Developer Notes

  • Library: libraries/AP_OSD.
  • Context: Only relevant if an analog or digital OSD is active.

MSG_TIME: Message display duration in seconds

Description

Sets the duration (in seconds) that temporary status messages and warnings remain visible on the OSD.

Values

  • Range: 1 to 20
  • Units: s
  • Default: 10
  • Increment: 1

Description

This parameter controls the persistence of "pop-up" messages on the On-Screen Display.

  • Examples: Flight mode changes ("STABILIZE"), Arm/Disarm notifications, Battery warnings ("LOW BATT"), and GCS text messages.
  • Tuning:
    • Too Short: You might miss important warnings while flying.
    • Too Long: The message might obscure other critical flight data (like the horizon or battery voltage) for an annoying amount of time.

Source Code

ardupilot/libraries/AP_OSD/AP_OSD.cpp