Skip to content Link Search Menu Expand Document
ModalAI DOCS
Store

MVX Pairing & Encryption Keys

Pair a VTX and VRX by sharing an encryption key, and replace the factory default key with your own.

Table of contents

  1. Overview
  2. USB flash drive requirements
  3. Generate a key on the VRX
  4. Install the key
  5. Generate a key from the command line
  6. Check the pairing
  7. Several drones with one key

Overview

The MVX link is encrypted end to end. A VTX and a VRX pair by holding the same key file, vtx.key; there is no over-the-air pairing step. A VRX with a different key cannot show the video from that VTX.

Every unit ships with the same factory default key, so any MVX receiver still on factory settings can view your video. Generate your own key and install it on all of your units before operational use.

USB flash drive requirements

The VTX and VRX read and write keys on a USB flash drive, and the VRX also records video to it. The unit has to be able to mount the drive and write to it:

  • Format the drive as FAT32. Other formats, such as exFAT or NTFS, may not mount, or may mount read-only. On macOS, FAT32 is “MS-DOS (FAT)” with the “Master Boot Record” scheme. Windows formats drives larger than 32 GB as exFAT by default, so use a drive of 32 GB or less, or a FAT32 formatting tool.
  • Use a writable drive. If the drive has a write-protect (lock) switch, turn it off. Make sure it has free space.
  • Keep the drive’s partition table. New drives come partitioned, and reformatting with Windows or macOS keeps it. A drive formatted as a whole device with no partition table is not mounted.
  • Insert one drive at a time. A second drive is ignored while the first is mounted.

If the VRX does not show NEW ENCRYPTION KEY CREATED after you generate a key (see the next section), the drive was not mounted or is read-only. To check, connect to the unit over ADB:

adb shell "mount | grep /media/usb"
adb shell cat /tmp/usb-mount.log

A mounted drive shows on /media/usb, and rw in its mount options means it is writable. /tmp/usb-mount.log records each drive the unit has seen and whether it mounted.

Generate a key on the VRX

  1. Insert a USB flash drive into the VRX and power it on.
  2. Hold button 3 (Function), then press and hold button 2 (Record). Keep both held for about 1 second.
  3. The OSD shows NEW ENCRYPTION KEY CREATED and the key is written to the flash drive as vtx.key.

Press Function first: pressing Record first starts a recording instead.

Install the key

Each unit imports a vtx.key from a USB flash drive when the drive is mounted, and loads the key when its video service starts. Install the same key on the VRX and on every drone that should pair with it.

From a USB flash drive (VRX, or a drone with a USB port):

  1. Insert the flash drive holding vtx.key.
  2. Power cycle the unit with the drive still inserted.

Over ADB (a drone without a USB port):

adb push vtx.key /data/modalai/vtx.key
adb shell systemctl restart voxl-vtx

On a VRX, restart voxl-vrx instead of voxl-vtx.

Generate a key from the command line

voxl-vtx-keygen runs on the VTX or VRX and writes a new random key:

voxl-vtx-keygen -f /tmp/vtx.key

Copy the key off the unit (for example with adb pull /tmp/vtx.key) and install it on each unit as described above.

Check the pairing

After both units restart with the new key, the VRX shows video as soon as it is on the drone’s channel. If the VRX OSD shows INVALID ENCRYPTION KEY, the two units hold different keys: install the same vtx.key on both.

Several drones with one key

Several drones can share one key. A VRX shows whichever drone it locks onto on its channel, and once it has a picture, another drone with the same key on that channel cannot take it over. To fly several drones at once, put each one on its own channel, or give each drone and its VRX their own key. See Channels, Bandwidth & Power.