Skip to content Link Search Menu Expand Document
ModalAI DOCS
Store

MVX Video Profiles & Adaptive Link

Choose which camera and video settings the VTX sends, switch them in flight, and use adaptive video quality.

Table of contents

  1. Overview
  2. Factory profiles
  3. Switch profiles
  4. Zoom and thermal controls
  5. Adaptive link
  6. AI detection overlays

Overview

A video profile is a named set of VTX settings: which camera to stream, its transmit power, and whether adaptive link is on. The drone keeps a list of profiles and one of them is active. You can switch profiles from the OSD menu while disarmed, from a switch or wheel on your transmitter, or from the command line.

Factory profiles

voxl-configure-vtx -f writes three profiles: Adaptive, Long Range and Low Latency. The drone-specific setup flags (for example --d0013 for Stinger), the IP radio presets, --lepton_enable and --tracking_stereo also add a profile for each camera configured on the drone. The full list, in order:

ProfileCameraNotes
AdaptiveHi-resThe default. Adaptive link is on.
BosonBoson thermalAdded when a Boson is configured. Channel 12 switches white hot / black hot.
NyctisNyctis thermalAdded when a Nyctis is configured. Channel 12 switches white hot / black hot.
Tracking Front or Tracking LeftTracking cameraAdded when a front tracking camera is configured; --tracking_stereo uses the left camera of a stereo pair.
Tracking DownDownward tracking cameraAdded when a downward tracking camera is configured.
LeptonLepton thermalAdded with --lepton_enable.
Long RangeHi-resA lower-bitrate stream for distance.
Low LatencyHi-resTuned for the lowest latency.

Switch profiles

From the OSD menu: open the menu (drone disarmed), step PROFILE to the profile you want, then SAVE AND EXIT.

From a transmitter switch or wheel: the VTX reads channel 11 by default (rc_toggle), which is the camera switch on the ModalAI transmitter presets. The channel’s travel is split into equal positions, one for each entry in rc_switch_profiles, highest channel value first. Drone-specific and IP radio setups put up to five camera profiles on the switch and leave Long Range and Low Latency on the menu only; plain -f puts every profile except Long Range on it. Set rc_toggle to -1 to turn switching off.

From the command line: set the active profile by its position in the list (counting from 0):

voxl-configure-vtx -a 1

voxl-configure-vtx -l lists the current configuration, including the profiles.

Zoom and thermal controls

  • Zoom: on hi-res profiles, channel 12 (zoom_ch) zooms the hi-res camera up to 4x (zoom_max). After power-up, zoom responds once the wheel has been at its lowest position; after switching back from another camera, it responds once the wheel returns to where you left it, so the picture never jumps.
  • White hot / black hot: on the Boson and Nyctis profiles, the same channel 12 switches the thermal palette (invert_toggle in the profile).
  • OSD on/off: set osd_rc_toggle to an RC channel to hide the OSD with a switch (low shows the OSD, high hides it). It is off (-1) by default.

These controls also work from a ground-station joystick over IP, on the same channels. That needs voxl-mavlink-server 1.4.23 or newer on the drone, which ships with SDK 1.8.1.

With adaptive link on, the VTX automatically trades picture quality for link margin as the signal weakens, and restores quality as it recovers, so the picture degrades gradually instead of dropping out. It adjusts video bitrate, frame rate and channel width together. With a VRX that supports 5 and 10 MHz, it can narrow the channel for extra range.

  • Adaptive link is on in the Adaptive profile and off in the others. It is set per profile with enable_adaptive_link.
  • The VRX’s LQ Response setting must be on (the default, VRX SETTINGS > RADIO).
  • While adaptive link is running, ADVANCED > RADIO > BANDWIDTH shows ADAPTIVE because adaptive link sets the width.

Channel width with adaptive link:

  • The Adaptive profile runs at 20 MHz and narrows to 10 MHz when the signal is weak. The 10 MHz step needs a VRX on the SDK 1.8.1 system image.
  • Adaptive link does not use 5 MHz. To fly at 5 MHz, use a profile without adaptive link. With frequency hopping at 5 MHz, adaptive link is switched off automatically.
  • Adaptive link does not use 40 MHz. To fly at 40 MHz, use a profile without adaptive link.

AI detection overlays

Profiles can also carry AI detection boxes to the goggles. See the AI Detection Setup Guide.