Skip to content Link Search Menu Expand Document
ModalAI DOCS
Store

MVX Digital FPV

ModalAI's encrypted digital FPV link in the VOXL SDK, the services behind it, and where to start.

Table of contents

  1. Overview
  2. Hardware
  3. Services
  4. Choose a video path
  5. Get started
  6. Video and telemetry from the VRX
  7. SDK versions and source

Overview

MVX is ModalAI’s digital FPV video link, built into the VOXL SDK. It sends low-latency HD video from a VOXL drone to the VRX Ground Unit, with the on-screen display (OSD), telemetry and a stick-driven settings menu, all encrypted. It needs no network setup: the drone and the VRX find each other on the same channel with the same key.

VRX Ground Unit with RA01 antenna

What the link does, as of SDK 1.8.1:

Setup and every feature are covered step by step in the MVX User Guides. This page shows where MVX fits among the SDK’s video services.

Hardware

ProductRole
VTX Air UnitAdd-on transmitter for your own drone: VOXL 2 Mini, radio and camera
Stinger Vision FPVFPV drone with the VTX built in
VRX Ground UnitReceiver with display output for goggles or a monitor, recording, and network ports

Services

MVX is made of standard SDK services that pass data over MPA pipes, like the rest of the SDK.

On the drone:

ServiceRole
voxl-camera-serverPublishes the camera streams, including the encoded video that the VTX sends
voxl-osdBuilds the OSD and runs the stick-driven drone menu
voxl-vtxSends video, the OSD and telemetry over the MVX radio or an IP link. See Software Setup

On the VRX:

ServiceRole
voxl-vrxReceives the link, draws the video and OSD on the display output, records, and forwards telemetry. See Software Setup
voxl-streamerServes the pilot view over RTSP
voxl-rc-serverSends a joystick’s RC to the drone on IP radio links. See RC over IP

voxl-configure-mpa sets up these services for each FPV SKU and for the VRX, so a factory unit works out of the box.

Choose a video path

This section of the SDK offers several ways to get video off the drone.

PathBest forNeeds
MVX (this page)Flying FPV in goggles or on a monitor: lowest latency, OSD and menu, no network to set upA VTX (Air Unit or built in) and a VRX
RTSP Video StreamViewing in QGroundControl, VLC or your own software over any IP networkAn IP link such as WiFi, LTE or a radio
Low Latency Video StreamingTuning glass-to-glass latency of an RTSP stream over WiFiAn IP link
Record VideoSaving footage on the droneNothing extra

They can be combined. The VRX re-serves the MVX pilot view over RTSP and MPEG-TS, so a ground station or ATAK device can watch the same video the pilot sees. See Stream to a ground station or ATAK.

Get started

Factory units ship configured. To set up a drone from scratch, enable the VTX with the defaults, or with the preset for your drone or link (see voxl-configure-vtx):

voxl-configure-vtx -f        # VTX defaults
voxl-configure-vtx --d0013   # Stinger
voxl-configure-vtx -l        # show the current configuration

Then pair the drone and the VRX with your own key (Pairing & Encryption Keys) and fly. The channel, video profile and most other settings can be changed from the goggles with the OSD menu.

To watch the link from the command line:

voxl-inspect-vtx      # on the drone
voxl-inspect-vrx      # on the VRX

See Link Diagnostics for what the columns mean and how to collect logs for support.

Video and telemetry from the VRX

The VRX is also a bridge to other ground equipment:

  • RTSP: rtsp://<VRX IP>:8900/live serves the pilot view, OSD included, out of the box.
  • MPEG-TS over UDP to a ground station or ATAK device.
  • MAVLink telemetry to and from a ground station on the VRX’s network.
  • Headless mode publishes the received video on an MPA pipe for your own software, without decoding or displaying it.

See Recording, Streaming & Flight Logs for each.

SDK versions and source

Run the same SDK release on the drone and the VRX. SDK 1.8.1 ships voxl-vtx 3.19 and voxl-osd 1.8. The drone runs the standard VOXL SDK, and the VRX runs a VRX build of the same release. See Software Setup for which SDK to flash.

voxl-vtx and voxl-vrx are not open source. voxl-osd is open source.