iRange ELRS Module Setup Guide for FrSky ETHOS Radios
iRange ELRS Module Setup Guide for FrSky ETHOS Radios
This guide explains how to install the ELRS Lua script on a FrSky ETHOS radio for use with an external iRange ELRS module, and how to update the ELRS module firmware using the official ExpressLRS Web Flasher.
A lot of users confuse the Lua script on the radio with the firmware inside the ELRS module. They are two separate things. The Lua script gives ETHOS the correct ELRS tools/menu support. The firmware update changes the software running inside the external ELRS module itself.
• What the ELRS Lua script does on ETHOS
• Where FrSky stores the ETHOS ELRS Lua file on GitHub
• Where to install the ELRS Lua script on the radio SD card
• How to update the iRange ELRS module using ExpressLRS Web Flasher
• Which Web Flasher target to select for the common DIY ESP32 E28 2.4GHz TX module
• How to confirm the Lua script and ELRS module are working
What Is a Lua Script in ETHOS?
A Lua script in FrSky ETHOS is like a small app or plugin for the radio. It adds extra functions, menus, or device support that ETHOS can load from the SD card.
For an ELRS module, the Lua script allows the radio to access ELRS-related settings and tools from the ETHOS interface. Without the correct script installed in the correct folder, ELRS menu support may not appear correctly.
The Lua script is like an app on your radio.
The module firmware is the operating code inside the ELRS module.
They are not the same thing.
What Is GitHub and Why Does FrSky Use It?
GitHub is an online platform used to store and manage files, code, updates, documentation, and revision history. FrSky uses GitHub to host ETHOS-related community content, including Lua files and support resources.
For ETHOS users, this means some support files are not only found on a normal product download page. In many cases, they are stored in FrSky’s public GitHub repository.
https://github.com/FrSkyRC/ETHOS-Feedback-Community
Where the FrSky ETHOS ELRS Lua Script Is Located
The ETHOS Lua script for ELRS modules is located in FrSky’s ETHOS GitHub repository here:
The required file is:
https://github.com/FrSkyRC/ETHOS-Feedback-Community/blob/1.6/lua/modules/elrs/main.lua
Where to Install the ELRS Lua Script on the Radio
On the radio SD card, the ELRS script should be installed in this exact path:
That means:
- The folder should be named elrs
- The file should be named main.lua
- The file should be inside the /scripts folder on the radio SD card
Do not rename the file and do not move it to another folder path. ETHOS expects the script in the proper location. If you rename it or place it elsewhere, ELRS tools may not load correctly.
How to Copy the ELRS Lua Script to the Radio
Step 1 — Connect the Radio by USB
Power on the radio and connect it to your computer using a USB cable.
When the radio shows the USB mode selection screen, choose:
Do not select Joystick mode. ETHOS Suite mode is the one that allows the radio to mount as USB storage so you can copy files.
Step 2 — Open the Radio SD Card
After selecting ETHOS Suite mode, open the SD card drive on your computer.
Look for the scripts folder:
If there is no elrs folder inside /scripts, create it.
Step 3 — Copy main.lua
Download the ELRS main.lua file from the FrSky ETHOS GitHub repository and copy it to:
Step 4 — Safely Disconnect and Reboot
Eject the radio drives from your computer, unplug the USB cable, and reboot the radio.
Re-check the folder path. The most common mistake is copying the file to the wrong folder, using the wrong folder name, or accidentally saving the file as something other than main.lua.
Updating the iRange ELRS Module Firmware
Firmware updates for the iRange ELRS module are performed using the official ExpressLRS Web Flasher. For this process, remove the ELRS module from the radio and connect the module directly to your computer using a USB-C cable.
Remove the module from the radio before flashing. Connect the USB-C cable directly to the ELRS module.
https://expresslrs.github.io/web-flasher/
Recommended Browser
Use a browser that supports WebSerial, such as Google Chrome or Microsoft Edge. Some browsers may not allow direct USB flashing from the web page.
Step 1 — Remove the Module From the Radio
Power off the radio and remove the iRange ELRS module from the external module bay.
Step 2 — Connect the Module by USB-C
Connect a USB-C cable directly from the ELRS module to your computer.
Use a real data-capable USB-C cable. Some USB-C cables are charge-only and will not allow the computer to detect the module.
Step 3 — Open ExpressLRS Web Flasher
Open the ExpressLRS Web Flasher page and select the proper firmware target for the module.
Step 4 — Select the Firmware Target
For the common iRange ELRS module using the DIY ESP32 E28 2.4GHz TX target, use the following Web Flasher options:
- Firmware Version: Latest stable release, for example 3.6.4
- Hardware Vendor: DIY devices
- Radio Frequency: 2.4GHz Transmitter
- Hardware Target: DIY ESP32 E28 2.4GHz TX
Example Web Flasher Target Selection
The target shown above is for the common DIY ESP32 E28 2.4GHz TX style ELRS module. If your module is a different hardware version, do not blindly flash this target. Confirm the correct target before flashing.
Step 5 — Set Your Binding Phrase
Enter your ELRS binding phrase if you use one. Your transmitter module and receivers must use the same binding phrase to bind automatically.
Save your binding phrase somewhere safe. If you flash the module with the wrong phrase, your existing receivers may no longer bind until they are updated or rebound with matching settings.
Step 6 — Build and Flash
After selecting the correct target and settings, use the Web Flasher to build and flash the firmware directly to the module over USB-C.
Do not unplug the module while the flashing process is running. Wait until the Web Flasher confirms the update is complete.
Interrupting a firmware flash can leave the module in a failed or recovery state.
Step 7 — Reinstall the Module
Once flashing is complete, disconnect the USB-C cable, reinstall the ELRS module into the radio, and power the radio back on.
How to Confirm the ELRS Lua Script Is Installed Correctly
After copying the ELRS Lua script to:
Reboot the radio and check that the ELRS tools are available from the radio interface.
What to Check
- The external ELRS module is fully seated in the radio.
- The model is configured to use the external RF module.
- The ELRS Lua tool opens without an error.
- The ELRS menu can read or adjust module settings.
If the ELRS Lua tool opens and communicates with the module, the Lua script is installed correctly and ETHOS is recognizing the ELRS module support.
Check that the file exists at /scripts/elrs/main.lua, that the folder name is elrs, that the file name is main.lua, and that the radio was rebooted after copying the file.
Troubleshooting
| Issue | What to Check |
|---|---|
| ELRS Lua tool does not appear | Confirm the file is installed at /scripts/elrs/main.lua and reboot the radio. |
| Lua tool opens but does not communicate | Confirm the ELRS module is fully seated, powered, and selected as the active external RF module. |
| Web Flasher does not see the module | Use Chrome or Edge, try another USB-C data cable, and connect directly to the module instead of through the radio. |
| Wrong target selected | Stop before flashing and confirm the exact ELRS hardware target for your module. |
| Receivers no longer bind after update | Confirm the binding phrase, firmware major version compatibility, and regulatory domain settings match your receivers. |
| Module works before update but not after | Verify the firmware target, reflash with the correct target, and confirm the module powers correctly after reinstalling it in the radio. |
Final Verification Checklist
- ELRS Lua script installed at /scripts/elrs/main.lua
- Radio rebooted after copying the Lua file
- External ELRS module fully seated in the radio
- ELRS Lua tool opens correctly on the radio
- Firmware updated using ExpressLRS Web Flasher over USB-C
- Module was removed from the radio during firmware flashing
- Correct Web Flasher hardware target selected
- Binding phrase and receiver settings confirmed
The ETHOS ELRS Lua file and the ELRS module firmware are separate. Install the Lua file on the radio SD card, but update the ELRS module firmware directly through ExpressLRS Web Flasher using USB-C.
Quick Summary
- The ELRS Lua script and ELRS module firmware are two separate things.
- The FrSky ETHOS ELRS script should be installed as /scripts/elrs/main.lua.
- The ELRS Lua file comes from the FrSky ETHOS GitHub repository.
- The iRange ELRS module firmware is updated using ExpressLRS Web Flasher.
- Remove the ELRS module from the radio before updating firmware.
- Connect USB-C directly to the ELRS module for flashing.
- For the common DIY ESP32 E28 2.4GHz TX module, select DIY devices → 2.4GHz Transmitter → DIY ESP32 E28 2.4GHz TX.
Copyright © 2026 New England RC LLC. All rights reserved.
This guide is provided for educational and informational purposes only for customers and hobbyists using FrSky ETHOS radios, ELRS modules, and related RC equipment.
This content may not be copied, republished, redistributed, or reproduced in whole or in part without written permission from New England RC LLC.
FrSky, ETHOS, ExpressLRS, ELRS, iRange, and other product names are trademarks of their respective owners and are used only for compatibility and identification purposes.