Setting up INAV Lua scripts

I. Principle

INAV Lua scripts is a powerful feature for OpenTX/EdgeTX RC transmitters that can provide INAV telemetry data, displaying real-time key information such as aircraft altitude, speed, GPS status, and battery level.
Currently supported features include:

• Orientation and position indicators for the model (based on pilot or home position) - ideal for when orientation is lost or visual contact is lost
• Compass-based orientation indicator (using magnetometer sensors on multirotors or fixed-wing with GPS)
• Pilot (glass cockpit) view with attitude indicator and additional data layout familiar to pilots
• Radar (map) view showing the relationship between the model and home position, displayed with pilot/home-based or compass-based orientation
• Altitude graph view showing altitude for the past 1-6 minutes
• Color LCD transmitter displays all views with additional features such as scrolling bars
• Fuel gauge (remaining battery %), battery voltage, RSSI strength, transmitter battery, GPS accuracy (HDOP), barometric altitude (and altitude for X9D, X9D+ and X9E transmitters)
• Display and voice alerts for flight modes and mode modifiers (such as altitude hold, heading hold, reset home, etc.)
• Voice notifications for battery remaining % (based on current), low/critical voltage, high altitude, GPS lost, ready, armed, disarmed, etc.
• GPS information: locked satellites, GPS accuracy (HDOP), GPS altitude, GPS coordinates. Also records last GPS position (viewable from configuration menu)
• Current/maximum value display: altitude, distance, speed, and current
• Current/minimum value display: battery voltage, RSSI strength
• Header display for model name, flight timer, transmitter voltage, and receiver voltage
• Menu configuration options can be changed within the script and can be uniquely configured for each model
• Speed and distance values can be displayed in metric or imperial units based on the telemetry settings of the transmitter
• Voice files, modes, and configuration menus support English, German, French, or Spanish
• OpenTX: Replay previous flights through telemetry log files, including fast forward, rewind, and pause functions

II. Equipment Preparation

1) Flight Controller: This tutorial is applicable to any of the following flight controllers: SpeedyBee F405 WING APP / SpeedyBee F405 WING MINI / CoreWing F405 WING V2
2) Transmitter: FrSky Taranis and Horus transmitters, Jumper T12, T16, FLYSKY Nirvana NV14, Radiomaster TX16S, TX12, Zorro, Boxer, etc.
3) Receiver: FrSky (compatible) telemetry receivers (X, R9 and D series), Crossfire receivers, CRSF protocol receivers (SpeedyBee Nano 2G4)
4) Computer: Used for downloading and transferring files, and configuring the ground control station.

III. Specific Operations

3.1 Firmware Version Check

Important

The following are the officially supported environments for INAV Lua firmware:

Important

For information on upgrading INAV firmware, refer to this article: https://docs.corewing.com/plane/beforetuning/inav-fw-update.html

Important

For information on upgrading RC transmitter system versions, refer to this article: https://docs.corewing.com/plane/other/edgetx/buddy-fw-update.html

3.2 INAV Lua Script Download

Important

1. For EdgeTX color screen RC transmitters with version EdgeTX2.11, you must download source code Lua scripts. Downloading compiled scripts will cause crashes and make them unusable.
2. For EdgeTX color screen RC transmitters with version EdgeTX2.10 or earlier, or later versions, you can download compiled Lua scripts.
3. For EdgeTX black and white screen RC transmitters, always download source code Lua scripts.

Important

Compiled Lua scripts download: LuaTelemetry_v2.3.0.zip

Important

Source code Lua scripts download: LuaTelemetry_v2.3.0_lua.zip

3.3 Lua Script Import

1. Connect the RC transmitter to the computer using a data cable and select USB storage (SD)
   
2. Extract and open the downloaded file
   
3. Copy the [SCRIPTS] folder and [WIDGETS] folder from the download to the corresponding folders on the RC transmitter's SD card.
   
   
4. Eject the USB drive
   

3.4 INAV Ground Control Station Settings—Using CRSF Protocol Receiver as Example

Connect the flight controller to the computer → Open INAV GCS → Navigate to the Receiver page → Set the following parameters → Click Save and Reboot.

3.5 RC Transmitter Settings

Color screen:

1. Restart the RC transmitter, connect to the receiver, navigate to MDL→TELEMETRY interface → Find Discover new and click it.
   
2. Return to the RC transmitter main page and press the TELE button.
   
3. Click to create a new screen, select the unformatted screen (FULL SCREEN), and turn off all widgets at the bottom.
   
4. Long-press the screen to pop up and click Select widget.
   
5. Select iNav.
   
6. If this interface appears, the setup is complete, and you can view the flight controller's relevant data.
   
   Black and white screen:
7. Restart the RC transmitter, connect to the receiver, navigate to MDL→TELEMETRY interface → Find Discover new and click it.
   
8. Navigate to the DISPLAY interface, set any Screen to Script iNav.
   
9. Return to the RC transmitter main page, press the TELE key, and use the PAGE key to switch pages. If you see the following interface, the setup is successful.
   

3.6 Script-Related Settings

Refer to the following videos:
【【INAV Script Tutorial 01】Using INAV telemetry script on Open TX & Edge TX RC transmitter for instrument flight with F4 flight controller INAV firmware - Beginner's guide for fixed-wing drones and whoop drones】
https://www.bilibili.com/video/BV1hS4y1h792/?share\_source=copy\_web&vd\_source=b4001ce0fef5f9acabc4a5730638b5de
【【Whoop Drone Tutorial】INAV Lua usage tutorial】
https://www.bilibili.com/video/BV1Cr4y1x75E/?share\_source=copy\_web&vd\_source=b4001ce0fef5f9acabc4a5730638b5de

IV. Q&A

Technical Support QR Code