MAVLINKHUD

Overview

The VTX parameter group configures the Video Transmitter control interface. This allows the pilot to change the channel, band, and power level of their FPV transmitter directly through the ArduPilot OSD or GCS.

Key Concepts

1. SmartAudio and Tramp

ArduPilot supports the SmartAudio (TBS) and Tramp (IRC) protocols for VTX control.

  • VTX_ENABLE: Master switch.

2. Frequency Control

  • VTX_BAND: Selects the band (A, B, E, Fatshark, Raceband).
  • VTX_CHANNEL: Selects the channel (1-8).
  • VTX_FREQ: Displays the resulting frequency in MHz.

3. Power Control

  • VTX_POWER: Sets the output power (e.g., 25mW, 200mW, 800mW).
  • VTX_MAX_POWER: Limits the maximum power to ensure local legal compliance or prevent overheating.

Integration Guide

  1. Hardware: Connect the SmartAudio/Tramp wire from the VTX to a UART TX pin.
  2. Serial: Set SERIALx_PROTOCOL = 37 (SmartAudio) or 42 (Tramp).
  3. Config: Set VTX_ENABLE = 1.
  4. Control: Access the VTX menu via the OSD to change settings in the field.

Developer Notes

  • Library: libraries/AP_VideoTX.
  • Tables: Supports "VTX Tables" in newer versions for custom frequency mapping.

VTX_ENABLE: Is the Video Transmitter enabled or not

Description

Toggles the Video Transmitter on and off.

Values

Value Meaning
0 Disable
1 Enable
  • Default: 0

Description

This parameter enables the Video Transmitter (VTX) Control subsystem.

  • Function: When enabled, ArduPilot will attempt to communicate with the VTX (using SmartAudio, IRC Tramp, or CRSF) to set the channel, band, and power level based on the VTX_ parameters.
  • Benefit: Allows you to change your video channel from the OSD menu or Ground Control Station without pressing buttons on the VTX itself. It also enables features like "Pit Mode" to keep power low until you are ready to fly.

VTX_BAND

Default 0
Range 0 5

Video Transmitter Band (VTX_BAND)

Description

VTX_BAND defines the group of frequencies (Band) your video transmitter is using.

  • 1: Band A.
  • 2: Band B.
  • 3: Band E.
  • 4: Airwave (Fatshark).
  • 5: Raceband. (Most popular for multi-pilot racing).

Tuning & Behavior

  • Default: 0.
  • Usage: Set this to match your video goggles. If you are flying with others, coordinate your Band and Channel to prevent signal overlap.

VTX_CHANNEL

Default 0
Range 0 7

Video Transmitter Channel (VTX_CHANNEL)

Description

VTX_CHANNEL selects the specific frequency within your chosen VTX_BAND.

Most bands have 8 channels. This parameter uses an index from 0 to 7 (representing channels 1 to 8).

Tuning & Behavior

  • Default: 0.
  • Usage: If you are experiencing interference from another pilot, try switching to a different channel within your band.
  • Verification: You should see the frequency update on your GCS status screen (if using SmartAudio/Tramp) and your goggles should lose and re-acquire the signal on the new frequency.

VTX_FREQ

MHz
Default 5800
Range 1000 6000

Video Transmitter Frequency (VTX_FREQ)

Description

VTX_FREQ allows you to specify a custom frequency for your video link, rather than using the standard VTX_BAND and VTX_CHANNEL presets.

Tuning & Behavior

  • Default: 5800 MHz.
  • Note: In most cases, it is better to use the Band and Channel parameters to ensure compatibility with standard video goggles.

VTX_MAX_POWER

mW
Default 800
Range 25 1000

Video Transmitter Max Power Limit (VTX_MAX_POWER)

Description

VTX_MAX_POWER acts as a safety "Cap" for your video transmitter.

If you have assigned an RC channel to change your VTX power while flying, this parameter prevents you from accidentally selecting a power level higher than your hardware can safely handle.

Tuning & Behavior

  • Default: 800 mW.
  • Recommendation: Set this to the maximum rated output of your physical VTX. If your VTX only supports up to 400mW, set this to 400 to avoid sending unsupported commands to the hardware.

VTX_POWER

mW
Default 0
Range 0 1000

Video Transmitter Power Level (VTX_POWER)

Description

VTX_POWER controls the strength of your video signal.

  • Standard Values: 25, 100, 200, 400, 600, 800 (mW).
  • 0: Lowest available power (Pit mode).

Tuning & Behavior

  • Recommendation: Use the lowest power necessary for your flight. High power settings (800mW+) generate significant heat and can damage the VTX if there is no airflow (e.g., sitting on the bench).
  • Protocol: Requires a VTX that supports SmartAudio or Tramp protocol connected to a serial port.