Tutorial: Change PID & VTX Settings using Taranis in Raceflight

by Oscar

This article shows you how to modify PID and VTX settings from your Taranis TX in RaceFlight Revolt flight controller, with the help of Lua script.

Some of the links on this page are affiliate links. I receive a commission (at no extra cost to you) if you make a purchase after clicking on one of these affiliate links. This helps support the free content for the community on this website. Please read our Affiliate Link Policy for more information.

This tutorial is written by Artur Banach, edited by Oscar.

PID tuning doesn’t require a computer anymore, you can now do it right from your TX! You can even adjust VTX settings such as channel and power with Tramp or Unify Pro. This guide is written for the Raceflight Revolt FC specifically. However you can do the same with Betaflight and KISS.

Hardware Requirement

  • Taranis X9D or QX7 TX
  • X4R-SB or XSR RX (Smart Port required)
  • Revolt Flight Controller with Raceflight One – We have only tested the Revolt and Lumenier Skitzo FC (basically the same board), according to DemonRC this also work on their Soul FC
  • TBS Unify Pro VTX (ImmersionRC Tramp is not supported currently) – Only needed if you want to be able to change VTX settings from Taranis

Connection – FC, RX and VTX

Connect S.PORT from X4R or XSR to RX3 pad on the FC. (The Skitzo board shown here is identical to Revolt V2 FC)

SmartAudio wire from TBS Unify Pro needs to be connected to the TX3 pad on the FC as shown in the picture.


Update Your Taranis Firmware

FrSky Taranis has to be updated to the latest OpenTX firmware (we tested V2.2 RC14). The process is covered in this tutorial: https://oscarliang.com/flash-opentx-firmware-taranis/.

Download LUA Script for RaceFlight

The LUA script for Raceflight (rf.lua) can be downloaded from here: https://raceflight.net/taranis/. Apart from the LUA script file, there are also the latest OpenTX firmware and its SD Card content.

Next, copy the LUA file to your Taranis SD card, in the /SCRIPTS/TELEMETRY folder.

Configurator Settings

The following options must be selected in RF1 configurator for this to work:

  • Enable Taranis telemetry (RX3 pin)
  • Select USART 3 TX under SmartAudio

Don’t forget to press SAVE.

Setting up LUA script on telemetry page

Assuming you have SmartPort (S.Port) telemetry working, and you have copied the rf.lua file to /SCRIPTS/TELEMETRY folder on the Taranis SD card, now we can proceed to to the final step.

Go to page 13 DISPLAY in your Taranis. Here you can configure which telemetry screen to execute the LUA script when pressing the PAGE button.

In Screen 1, choose Script as the first parameter, and then select the RF Lua script in the 2nd parameter.

After this you can activate RF LUA script by holding down the PAGE button. Here is what it looks like when the script is active.

Quite different from KISS and Betaflight, Raceflight uses sticks to operate. To enter program mode, you need to push both sticks toward the bottom center position (throttle down yaw right, and pitch down roll left), and hold it for around 3 seconds.

Here is how to change something:

  • >” symbol is the cursor indicating which option you are at
  • You can move the cursor up and down with the pitch stick
  • You can select an option to change its value by pushing stick to the right (roll right)
  • To change value you can move the stick up and down (pitch)
  • Once you have finished changing, push the stick to the left (roll left) to exit the option

First page that comes up is the VTX settings: Band, Channel, Power. After modifying VTX settings, remember to select “Set and Exit” to save your changes.

To access the PID section, select “VTX” option at the top of the menu.

Page 2 is for Roll PID.

Page 3 is for Pitch PID.

And Page 4 is for Yaw PID.

After changing PID you must hit SAVE before leaving to the next page, otherwise you will lose the changes. please note that there is no option to adjust rate/expo in Raceflight Lua script.

Finally Page 5 is for Returning to VTX settings page or to exit program mode.

Once you have exited program mode, press the “Exit” button right next to the Taranis screen to leave telemetry screen, and you are ready to fly.

That should be it! Have fun tuning PID and modifying VTX settings right on your Taranis in the field! :)

Leave a Comment

By using this form, you agree with the storage and handling of your data by this website. Note that all comments are held for moderation before appearing.


Ron Nowlan 1st January 2023 - 5:37 pm

Great Info!

Ron Nowlan 1st January 2023 - 3:43 pm

I see the sticks of transmitter being used in this… what a boon this would be for Qx7 folks who could use sticks to nav thru menus… any way to help those who don’t have resources to pay for a xmitter having a “+” and “-” key to run thru menus (especially for the great LUA Scripts developed by some of our friends?
Reason is— the Qx7 “roller” for cursor does not work in many LUA Scripts–OR does someone know how to control cursor using sticks in LUA?

George Angelakopoulos 21st September 2018 - 5:37 pm

hi, can this be done in horus X10s?

Airbornemech31 4th April 2018 - 3:20 am

This lua script sucks the beta flight one is way faster intutive n responsive

Jerome Demers 19th September 2017 - 4:25 am

As of sept 2017 with RF1 build 300, I got it working with tramp! The lua script is just super slow BUT I can change settings!
I had to go in CLI command and write set telem_tramp=2 and to see if everything works, you can plug batterie and type in CLI vtxinfo, you will have a dump of the settings of your vtx.

#me vtx.vtxDevice=3
#me vtx.vtxBand=4
#me vtx.vtxChannel=0
#me vtx.vtxBandChannel=r1
#me vtx.vtxPower=0
#me vtx.vtxPit=VTX Broadcasting
#me vtx.vtxRegion=0
#me vtx.vtxFrequency=5658

Jean-Sebastien Comeau 16th August 2017 - 6:40 pm

if you plug audio from your unify pro to the revolt then what happen if you want also the audio from your runcam swift.

BRANDEN M ZALESKI 27th February 2018 - 6:54 pm

Im trying to figure this out too using crossfire and ch4 SA

Itay BenNer 10th August 2017 - 1:37 pm

Hi What are the settings needed to be set for the Tramp VTX ?
Did you tested it also on RF18?

Andre 10th May 2017 - 7:13 pm

When will tramp be able to set up by lua in raceflight?

Oscar 15th May 2017 - 2:30 pm

Ask Raceflight :) We’re wondering too!

Giuliano 4th June 2017 - 11:15 pm

For my experience at the moment tramp doesn’t wokr with RF1. I’ve unmounted a TBS UNIFY PRO HV. I’ve checked all the connection and they’re right but tramp hv doesn’t work.

Kleinfeld Marcel 25th April 2017 - 11:58 pm

I have a question about the rf-LUA-script on my teranis x9d.
I have OpenTX 2.2.0 RC16 (N369) on the Taranis.
If I activate the LUA script, the menu is missing.
There is only the heading “Raceflight one Program menu”.
Moving sticks or pressing other buttons has no effect

Scott Davis 8th May 2017 - 3:33 am

I have the same problem here. Also Smartaudio doesn’t stay selected on TX3 in the GUI, it keeps switching back to say ‘esc protocol’. Does that happen to you as well? Thanks and I hope we both find the solution

J lai 25th May 2017 - 9:14 am

Same here. x9d plus. No menu, only title shown.

J lai 25th May 2017 - 10:43 am

Solved, I think. Same issue as yours. After upgrading the Raceflight FC firmware to the latest (configurator can save telemetry setting now), the menu showed, but very slowly. Better than none. But I haven’t try to change the setting yet.

Matt 19th June 2017 - 2:42 pm

Same problem did you manage to figure it out

Tom Shope 19th April 2017 - 6:40 pm

Hello, I am trying to find the rf.lua script for the taranis x9d plus. I follow the links on the thread, but every time I try to download, I end up with a .txt or .html file that is not recognized by the radio. I was able to get the betaflight bf.lua to download and get recognized by the radio, but no luck with race flight file. Can anyone show how to simply download the file that will work. Thank you for you patience with my difficulties.


Oscar 26th April 2017 - 9:11 pm

Please contact Raceflight mate :)

MrGrafcox 18th April 2017 - 8:30 pm

Hello everybody, i can’t find the lua script for the FrSky Horus, can anyone help me?

Oscar 26th April 2017 - 8:56 pm

You need to contact Raceflight to get the file, we didn’t look for it as we only tested on Taranis.