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
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:
| Profile | Camera | Notes |
|---|---|---|
| Adaptive | Hi-res | The default. Adaptive link is on. |
| Boson | Boson thermal | Added when a Boson is configured. Channel 12 switches white hot / black hot. |
| Nyctis | Nyctis thermal | Added when a Nyctis is configured. Channel 12 switches white hot / black hot. |
| Tracking Front or Tracking Left | Tracking camera | Added when a front tracking camera is configured; --tracking_stereo uses the left camera of a stereo pair. |
| Tracking Down | Downward tracking camera | Added when a downward tracking camera is configured. |
| Lepton | Lepton thermal | Added with --lepton_enable. |
| Long Range | Hi-res | A lower-bitrate stream for distance. |
| Low Latency | Hi-res | Tuned 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_togglein the profile). - OSD on/off: set
osd_rc_toggleto 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.
Adaptive link
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.