RFSuite Lua Scripts for Ethos

Rotorflight is a powerful flight control software suite built specifically for single-rotor RC helicopters. It is not designed for multirotors or airplanes. The software includes:

• Rotorflight Flight Controller Firmware

• Rotorflight Configurator – used for flashing and configuring the flight controller

• Rotorflight Blackbox Explorer – for analyzing flight logs

• Rotorflight Lua Scripts – used to configure the flight controller directly from your transmitter

These scripts support the following transmitter operating systems:

• EdgeTX / OpenTX

• Ethos (this repository)

Rotorflight is based on Betaflight 4.3, but includes a wide range of advanced features optimized for helicopter flight. This version of Rotorflight is also referred to as Rotorflight 2 (RF2).

---

What is RFSuite?

RFSuite is a touch-based, Lua-scripted GUI suite for the Ethos platform. It enables easy setup, tuning, and diagnostics of Rotorflight-based helicopters using supported FrSky transmitters. It offers:

• Full touchscreen interface

• FrSky and ELRS receiver compatibility

• Multiple embedded tools and widgets

You can preview the experience using the interactive simulator:

👉 Launch Web Simulator

This opens the RFSuite in your browser, showcasing its functionality within the Ethos UI.

Key UI Screens

Status Widget

Flight Logs

FBL Configuration (Home)

Governor Configuration

---

Rotorflight Features

Rotorflight includes a rich feature set, including:

Protocol Support

• Receiver: CRSF, S.BUS, F.Port, DSM, IBUS, XBUS, EXBUS, GHOST, CPPM

• Telemetry: CRSF, S.Port, HoTT, and more

• ESC telemetry: BLHeli32, Hobbywing, Scorpion, Kontronik, OMP Hobby, ZTW, APD, YGE

Helicopter-Specific Features

• Advanced PID control tuned for helicopters

• Rotor speed governor

• Stabilization modes (6D)

• Tail Torque Assist (TTA or TALY)

• Motorized tail support

Remote Tuning & Configuration

• Via transmitter knobs/switches

• Lua script interface on EdgeTX/OpenTX/Ethos

Additional Capabilities

• AUX outputs for custom motor/servo functions

• Fully customizable mixer

• Sensor support: voltage, current, BEC, etc.

• Advanced filtering: Dynamic RPM notch, FFT-based notch, and LPF

• High-speed Blackbox logging

Plus Betaflight-Inherited Features:

• Multiple configuration and rate profiles

• DSHOT, PWM, Multishot ESC protocols

• RGB LEDs and buzzers

• GPS integration

---

Lua Script Requirements

To use RFSuite, you'll need:

• Ethos 1.6.2 or later

• A compatible FrSky transmitter:

  • X10, X12, X14, X18, X20, or Twin X Lite

• A supported receiver:

  • FrSky (Smartport or F.Port over ACCESS, ACCST, TD, TW)

  • ExpressLRS (ELRS) modules supported by Ethos

---

Verified Compatible Receivers

RFSuite has been successfully tested on the following receiver models (with X10, X14, X18, X20, XLite):

• TWMX

• TD MX

• R9 MX ACCESS

• R9 Mini ACCESS

• Archer RS / Archer Plus RS / RS Mini (ACCESS / F.Port)

• RX6R ACCESS

• R-XSR ACCESS / ACCST F.Port

• ELRS (all versions)

---

Development Guide

To build and deploy RFSuite locally:

Requirements

• FrSky Simulator (Ethos)

• Visual Studio Code (VS Code)

• Python 3

• Install tqdm and serial:

  pip install tqdm
  pip install serial

If you do not have npm command, you will need to install NodeJS

Config file

Copy the file bin/config-example.json to a folder outside of github and name to suite your preference.

Setup en env var of RFSUITE_CONFIG=C:\GitHub\rotorflight-lua-ethos-suite.json (the path to the file)

Suggested: Repo: C:\GitHub\rotorflight-lua-ethos-suite<files> Config: C:\GitHub\rotorflight-lua-ethos-suite.json

VS Code Tasks

• Deploy & Launch – Pushes scripts to the default simulator

• Deploy & Choose – Pushes scripts to the selected simulator

• Deploy Radio – Pushes scripts to the radio

• Deploy Radio and Debug – Pushes scripts to the radio and starts serial console

---

Installation Instructions

1. Download the latest files:

   • Click Code > Download ZIP

2. Install using the Ethos Suite Lua Tools on your transmitter.

---

Contributing

Rotorflight is a community-driven open-source project. You can contribute by:

• Helping users on Rotorflight Discord or forums

• Reporting issues or requesting features via GitHub

• Testing and giving feedback on new versions

• Updating documentation and tutorials on the Rotorflight Website

• Translating the configurator to other languages

• Contributing code (fixes, features, enhancements)

🔧 See the full Contributing Guide

---

Project Origins

Rotorflight is open source and available free of charge, with no warranties.

• Forked from Betaflight

• Which was forked from Cleanflight

• Also draws inspiration and code from HeliFlight3D

🙏 A big thank you to everyone who has contributed along the way!

---

Contact

📧 Reach out to the Rotorflight team at:
[email protected]

Donate

If you find Rotorflight useful, please consider supporting the development by donating to the Rotorflight Project.