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.
- For KISS: https://oscarliang.com/change-pid-vtx-settings-taranis-lua-kiss/
- For Betaflight: https://oscarliang.com/betaflight-change-pid-vtx-settings-taranis/
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! :)
20 comments
Great Info!
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?
hi, can this be done in horus X10s?
This lua script sucks the beta flight one is way faster intutive n responsive
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
if you plug audio from your unify pro to the revolt then what happen if you want also the audio from your runcam swift.
Im trying to figure this out too using crossfire and ch4 SA
Hi What are the settings needed to be set for the Tramp VTX ?
Did you tested it also on RF18?
When will tramp be able to set up by lua in raceflight?
Ask Raceflight :) We’re wondering too!
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.
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
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
Same here. x9d plus. No menu, only title shown.
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.
Same problem did you manage to figure it out
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
Please contact Raceflight mate :)
Hello everybody, i can’t find the lua script for the FrSky Horus, can anyone help me?
You need to contact Raceflight to get the file, we didn’t look for it as we only tested on Taranis.