Tutorial: Change PID & VTX Settings using Taranis in Raceflight

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.

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! :)

15 thoughts on “Tutorial: Change PID & VTX Settings using Taranis in Raceflight

  1. Jerome Demers

    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

    Reply
  2. Jean-Sebastien Comeau

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

    Reply
    1. Giuliano

      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.

      Reply
  3. Kleinfeld Marcel

    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

    Reply
    1. Scott Davis

      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

      Reply
    2. J lai

      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.

      Reply
  4. Tom Shope

    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.

    Tom

    Reply
    1. Oscar Post author

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

      Reply

Leave a Reply

Your email address will not be published. Required fields are marked *

Are you Robot? *

I only check blog comments once or twice a week, if you want a quick reply you can post your question on this forum IntoFPV.com... You might get a faster response from me there (multirotor related only).