Skip to content
Eric Stockenstrom edited this page Aug 30, 2019 · 40 revisions

Welcome to the Mav2Passthru (Mav2PT) wiki


What is Mav2Passthru, and why do I need it?

  • Mav2Passthru is firmware to convert Mavlink telemetry to FrSky Passthru telemetry.

  • Passthru is the name given to the FrSky compatible telemetry protocol characterised as "DIY", or non-proprietary.

  • Passthru protocol telemetry is the only telemetry that works with yaapu (Alex Apostoli)'s excellent LUA display scripts for the Taranis and Horus transmitters. See yaapus_GitHub

  • Passthru protocol telemetry is required for Craft & Theory's FlightDeck

  • Passthru protocol telemetry is optional (type=10) on Ardupilot, but not supported by the PX4 flight stack (as at July 2019).

  • The older APM 5.2 flight controllers, and the Radiolink Mini Pix do do support Passthru (as at July 2019)

  • Many medium and long range telemetry / command radio systems support Mavlink, but not Passthru (as at July 2019)

  • Mav2Passthru firmware running in a micro-controller converts Mavlink (1 & 2) telemetry to Passthru telemetry

  • Mav2Passthru can be configured to run in one of three modes:

Ground Mode

In ground mode, the Mav2Passthru converter is usually co-located with a long-range XJT radio long-range module in the back bay of the Taranis/Horus. It accepts Mavlink telemetry from the XJT module, converts it into Passthru protocol telemetry, and feeds that into the S.Port of the Taranis/Horus. Since there is no FrSky receiver to provide sensor polling, a routine in the firmware emulates FrSky receiver sensor polling.

Air Mode

In air mode, the Mav2Passthru converter is located on the aircraft between the Flight Controller and a FrSky receiver. It converts Mavlink out of a Pixhawk or APM flight controller and feeds Passthru telemetry to the FrSky receiver, which in turn sends it to a Taranis/Horus on the ground. In this situation it responds to the FrSky receiver's sensor polling. This mode is necessary for older Arducopter and PX4 flight controllers which cannot natively send Passthru telemetry.

Relay Mode

This hybrid mode is useful where an air-side LRS tranceiver (trx) (like the DragonLink or Orange) communicates with a matching ground-side trx located in a "relay" box near using Mavlink telemetry. The UHF trx in the relay box feeds Mavlink telemetry into the Mav2Passthru converter, and the converter in turn feeds FrSky Passthru telemetry into a FrSky receiver (like an XSR), also located in the relay box. The XSR receiver (actually a tranceiver - trx) then communicates on the RC band with a Taranis/Horus nearby. In these circumstances the converter need not emulate sensor polling, as the FrSky receiver will provide it. However, the converter must determine the true RSSI of the air link and forward it, as the RSSI forwarded by the FrSky receiver in the relay box will incorrectly be that of the short terrestrial link from the relay box to the Taranis.

Suitable uController Boards

The Mav2Passthru firmware is configurable to run on three broad platforms:

  1. ESP32 Dev board and other variants. This is the most powerful platform, with snappy performance and rich features including an OLED display, WiFi and Bluetooth I/O and SD card support. It is slightly more costly, and physically larger. Includes S.PORT inversion, but still requires an external converter to single-wire for S.Port compatibility.
  2. Teensy 3.1 or 3.2. Fairly snappy performance in a very compact board. Less affordable that the STMF103C boards. Includes S.PORT inversion and single-wire S.Port conversion.
  3. STM32F103C variants like Blue Pill and Maple Mini. Acceptable performance and affordable, in a slightly larger format. Requires a bi-directional inverter/single-wire converter for S.Port compatibility.

NOTE: 16 bit AVR boards like the Mini Pro, and even the ATmega boards are not recommended for this application.


This application is free software. You may redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation. See here http://www.gnu.org/licenses

The application was written in the hope that it will be useful, but it comes without any warranty or implied warranty of merchantability or fitness for a particular purpose


Inspired by original S.Port firmware by Rolf Blomgren

Author: Eric Stockenstrom / zs6buj

Acknowledgements and thanks to Craft and Theory (http://www.craftandtheoryllc.com/) for
the Mavlink / Frsky Passthru protocol

Thank you to yaapu for advice, code and testing, and his excellent LUA script

Thank you athertop for advice and testing

Thank you florent for advice on working with FlightDeck