Skip to content

Latest commit

 

History

History
55 lines (33 loc) · 4.07 KB

LUA.md

File metadata and controls

55 lines (33 loc) · 4.07 KB
Raw

mLRS Documentation: mLRS Lua Script

(back to main page)

The mLRS Lua script provides a convenient way to change the Tx module and receiver settings.

The Lua script works on both OpenTx and EdgeTx radios but there are two different versions depending on the display of your radio:

  1. If your radio has a 480x272 (e.g. Jumper T16, Radiomaster TX16S) or 480x320 (e.g. Jumper T15) color screen then use the "mLRS.lua" file
  2. If your radio has a black and white screen (e.g. Frsky Taranis X9E, Radiomaster Zorro) then use the "mLRS-bw.lua" file

Important

The mLRS Lua script requires EdgeTx version 2.9.x or later.

Setup

Three things need to be done in order to use the Lua script:

  1. The Tx module must be configured for CRSF or mBridge mode, by setting the parameter "Tx Ch Source" to "crsf" or "mbridge" respectively. Since firmware version v0.2.13 "crsf" is the default setting, so this will be already completed after an initial flash. If not, the CLI needs to be used to set this parameter accordingly, as described in CLI Commands.

  2. In EdgeTX/OpenTX, navigate to MDL->MODEL SETUP and configure the external RF module for CRSF or mBridge protocol with 400K baud rate.

    • Note: mLRS only officially supports 400K baud rate.

  3. The Lua script "mLRS.lua" or "mLRS-bw.lua" located in the "lua" folder of the mLRS github repository needs to be copied to the "SCRIPTS/TOOLS" folder of the radio's SD card. One can follow the common tutorials for how to do this.

    • Note: The correct Lua version needs to be selected based on your firmware version:
      • When using 1.3.04 pre-release, use the Lua scripts found here.
      • When using 1.3.0 release, use the Lua scripts found here.

You should then be able to run the Lua script by going to SYS->TOOLS on the radio, and selecting "mLRS Configurator" or "mLRS-bw".

Usage

Parameters are changed by:

  • Highlighting a parameter
  • Pressing the enter button
  • Scrolling through the available settings
  • Pressing the enter button on the setting
  • Selecting 'Save' to store

Note: Parameter changes are stored permanently in the devices only when a 'Save' has been executed.

Color Lua Script Notes

Parameters which are not available are not displayed on the screen (i.e. the list of shown parameters can vary depending on the device). For instance, on a device which does not support a buzzer the parameter "Buzzer" will not be displayed. Parameters which cannot be changed are displayed with the current selection but are greyed out and cannot be edited. For instance, on a device which does not support diversity the parameter "Diversity" is displayed but cannot be changed.

BW Lua Script Notes

The Lua script for radios with a black and white screen also supports editing all parameters. But because of screen and memory limitations it looks and behaves slightly differently than the color Lua script.

The starting page contains common parameters, status information, and commands such as bind and save. Seven additional parameters appear on each subsequent page and page navigation is linear via the "prev" and "next" commands.

Parameters which are not available are still displayed, but with a "-" character in the value position. Parameters which cannot be changed are displayed as normal. Unused lines on the last page contain a blank name and a value of ".". The cursor can be moved to unavailable or unchangeable parameters and unused lines, but they can not be selected for edit; pressing enter on them will provide haptic feedback to indicate they can't be edited.

Note: If you receive a "not enough memory" error, please try the pre-compiled mLRS-bw-luac.lua file. You can also try reducing the file size by running the code through a Lua minifier tool such as the one here and install the minified version as a workaround. If neither solution works, please report this to the mLRS developers.