New LUA scripts & widgets

.editorconfig

@@ -0,0 +1,22 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+charset = utf-8
+
+[*.lua]
+indent_style = space
+indent_size = 2
+max_line_length = 120
+
+[Makefile]
+indent_style = tab
+
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false

.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+  workflow_dispatch:
+
+jobs:
+  check:
+    name: Lint and Typecheck
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          submodules: true
+
+      - name: Cache cargo
+        uses: actions/cache@v5
+        with:
+          path: ~/.cargo
+          key: cargo-stylua-${{ runner.os }}
+
+      - name: Install tools
+        run: make install-tools
+
+      - name: Run checks
+        run: make check

.gitignore

@@ -0,0 +1,6 @@
+*.luac
+src/WIDGETS/ELRSVTXAdmin/presets.txt
+src/SCRIPTS/TOOLS/ExpressLRSBind/history.txt
+bin/
+.claude/plans/
+TODO.md

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "edgetx-lua-stdlib"]
+	path = edgetx-lua-stdlib
+	url = https://github.com/jurgelenas/edgetx-lua-stdlib.git
+	branch = edgetx-2.12

.luarc.json

@@ -0,0 +1,16 @@
+{
+  "runtime.version": "Lua 5.3",
+  "runtime.builtin": {
+    "os": "disable",
+    "debug": "disable",
+    "package": "disable",
+    "coroutine": "disable",
+    "utf8": "disable",
+    "io": "disable",
+    "bit32": "disable"
+  },
+  "workspace.library": ["edgetx-lua-stdlib"],
+  "workspace.ignoreDir": ["bin", "edgetx-lua-stdlib"],
+  "workspace.checkThirdParty": false,
+  "diagnostics.disable": ["lowercase-global"]
+}

.stylua.toml

@@ -0,0 +1,7 @@
+column_width = 120
+line_endings = "Unix"
+indent_type = "Spaces"
+indent_width = 2
+quote_style = "AutoPreferDouble"
+call_parentheses = "Always"
+collapse_simple_statement = "Never"

Makefile

@@ -0,0 +1,48 @@
+SRC_DIR := src
+
+LUALS_VERSION := 3.17.1
+LUALS_DIR := bin/lua-language-server
+LUALS := $(LUALS_DIR)/bin/lua-language-server
+LUALS_URL := https://github.com/LuaLS/lua-language-server/releases/download/$(LUALS_VERSION)/lua-language-server-$(LUALS_VERSION)-linux-x64.tar.gz
+
+.PHONY: help install-tools install-stylua install-luals format format-check typecheck check sync push
+
+help:
+	@echo "Usage: make <target>"
+	@echo ""
+	@echo "  install-tools   Install stylua and lua-language-server"
+	@echo "  install-stylua  Install stylua (via cargo)"
+	@echo "  install-luals   Install lua-language-server"
+	@echo "  format          Format Lua files with stylua"
+	@echo "  format-check    Check formatting without modifying files"
+	@echo "  typecheck       Run lua-language-server type checking"
+	@echo "  check           Run format-check and typecheck"
+	@echo "  sync            Sync source files to EdgeTX simulator SD card"
+	@echo "  push            Install package to EdgeTX radio and eject"
+
+install-stylua:
+	@command -v cargo >/dev/null 2>&1 || { echo "cargo is required (install Rust: https://rustup.rs)"; exit 1; }
+	cargo install stylua --features lua53
+
+install-luals:
+	mkdir -p $(LUALS_DIR)
+	curl -fSL $(LUALS_URL) | tar xz -C $(LUALS_DIR)
+
+install-tools: install-stylua install-luals
+
+format:
+	stylua $(SRC_DIR)
+
+format-check:
+	stylua --check $(SRC_DIR)
+
+typecheck:
+	$(LUALS) --check .
+
+check: format-check typecheck
+
+sync:
+	edgetx-cli dev sync ../edgetx-sdcard
+
+push:
+	edgetx-cli pkg install . --eject

README.md

@@ -1,13 +1,135 @@
+# ExpressLRS Lua Scripts
 
-`elrs.lua` works with all versions of ExpressLRS from v2.0 to current. There is no requirement to use an e.g. elrsV3.lua for 3.x, just use elrs.lua.
+Lua configuration tool and bind phrase manager for ExpressLRS on EdgeTX radios. Both work on black & white LCD and color LCD radios.
 
-## Old ELRS.lua
+The package also includes two color-LCD widgets: the **ELRS Telemetry Widget** and the **VTX Administrator Widget**.
 
-When copying the lua to you handset, delete any old versions such as ELRS.lua, elrsV2.lua, or elrsV3.lua. The version-labeled filenames have been obsoleted.
+## Features
 
-### Downloading from Github:
-Click the file link above, find the "Raw" button near the top of that page. Right-click, Save link as.., copy the .lua file into the /SCRIPTS/TOOLS directory of the SD card on your handset.
+- Configure packet rate, telemetry ratio, switch mode, model match, antenna mode, TX power, WiFi connectivity, and more
+- Compatible with **ExpressLRS v3.5.4+**
 
-### Downloading from Configurator:
-Use the button shown in the image below to download the .lua script into the /SCRIPTS/TOOLS directory of the SD card on your handset.
-![downloadlua](https://user-images.githubusercontent.com/68074253/129203116-c1234719-3e8c-4cbf-a391-b7fb8dc0262d.png)
+## Installation
+
+Copy the contents of the `src/` directory to the **root** of your radio's SD card, preserving the directory structure. Delete any old ELRS scripts (`ELRS.lua`, `elrsV2.lua`, `elrsV3.lua`, `expresslrs.lua` and their `.luac` counterparts) from `SCRIPTS/TOOLS/`.
+
+When done, your SD card should contain:
+
+```
+SCRIPTS/
+  ELRS/
+    crsf.lua                  -- shared CRSF protocol library
+    crsf_params.lua           -- parameter codec (tool, VTX Admin)
+    crsf_session.lua          -- stateful parameter client (tool, VTX Admin)
+    msp.lua                   -- MSP-over-CRSF codec (bind tool)
+    defer.lua                 -- deferred-callback timer (bind tool)
+    loader.lua                -- GC-guarded script loader (both tools)
+    edgetx_version.lua        -- EdgeTX minimum-version gate (both tools)
+    ui/
+      lcd/
+        text_edit.lua         -- BW text editor (bind tool)
+        alert.lua             -- BW alert screen (both tools)
+      lvgl/
+        dialogs.lua           -- color startup dialogs (both tools)
+    sensors.lua               -- telemetry sensor reader
+    file_storage.lua          -- key=value file persistence
+    shim.lua                  -- BW compatibility shim
+  TOOLS/
+    ExpressLRS/
+      main.lua                -- entry point
+      navigation.lua          -- folder navigation
+      ui/
+        lvgl.lua              -- color LCD UI (LVGL)
+        lcd.lua               -- black & white LCD UI
+    ExpressLRSBind/
+      main.lua                -- entry point
+      history_storage.lua     -- bind phrase history persistence
+      ui/
+        lvgl.lua              -- color LCD UI (LVGL)
+        lcd.lua               -- black & white LCD UI
+WIDGETS/
+  ELRSTelemetry/
+    main.lua                  -- entry point
+    telemetry.lua             -- link state: drain, device info, model match, sensor snapshot
+    rf_modes.lua              -- RF mode names and RSSI floors, by firmware version
+    loadable.lua              -- per-instance wiring and lifecycle
+    ui/
+      display.lua             -- read model shared by every layout below
+      fullscreen.lua          -- full-screen page
+      topbar.lua              -- top-bar layout
+      sd.lua sd_tall.lua hd.lua portrait.lua small.lua
+  ELRSVTXAdmin/
+    main.lua                  -- entry point
+    loadable.lua              -- VTX config client and wiring
+    presets_storage.lua       -- preset slot persistence
+    presets.txt
+    ui/
+      display.lua             -- read model shared by every layout below
+      fullscreen.lua          -- full-screen editor
+      topbar.lua              -- top-bar layout
+      sd.lua sd_tall.lua hd.lua portrait.lua small.lua
+```
+
+The shared library `SCRIPTS/ELRS/` is required by both tools and both widgets.
+
+### Install with edgetx-cli
+
+You can also install this package using [edgetx-cli](https://github.com/jurgelenas/edgetx-cli):
+
+```sh
+edgetx-cli pkg install ExpressLRS/Lua-Scripts
+```
+
+Use the `--eject` flag to automatically unmount the SD card after installation.
+
+## ExpressLRS Configuration Tool
+
+The main tool (`SCRIPTS/TOOLS/ExpressLRS/`) lets you configure your ExpressLRS transmitter and receiver settings directly from your radio.
+
+<img src="screenshots/tool_main_bw.png" width="256" alt="ExpressLRS Configuration Tool"><br/>
+
+<img src="screenshots/tool_main.png" width="472" alt="ExpressLRS Configuration Tool">
+
+## ExpressLRS Bind Phrase Manager
+
+The bind tool (`SCRIPTS/TOOLS/ExpressLRSBind/`) sets the bind phrase -- or a raw UID entered as
+comma-separated bytes -- on the transmitter, the receiver, or both in one sequence, reads the
+current UID back for verification, and can put the TX in bind mode or unbind a connected receiver.
+The last five phrases are kept as a pick-and-send history. Setting the phrase over MSP requires
+**ExpressLRS 4.1+** on the device.
+
+<img src="screenshots/tool_bind_bw.png" width="256" alt="ExpressLRS Bind Phrase Manager"><br/>
+
+<img src="screenshots/tool_bind.png" width="472" alt="ExpressLRS Bind Phrase Manager">
+
+## Widgets
+
+Both widgets running side-by-side on the home screen:
+
+<img src="screenshots/widgets.png" width="472" alt="ELRS Widgets">
+
+## ELRS Telemetry Widget
+
+The telemetry widget (`WIDGETS/ELRSTelemetry/`) displays real-time link statistics on your home screen: link quality, RSSI, range, RF mode, TX power, battery voltage, current, GPS, and flight mode. It supports multiple screen resolutions (800x480, 480x320, 480x272, 320x480, 320x240).
+
+<img src="screenshots/widget_telemetry_fullscren.png" width="472" alt="ELRS Telemetry Widget">
+
+## VTX Administrator Widget
+
+The VTX Administrator widget (`WIDGETS/ELRSVTXAdmin/`) provides control over your video transmitter settings -- band, channel, power level, and pit mode -- directly from your radio telemetry screen. It also supports 6POS quick change for rapid VTX channel switching via a 6POS switch. Presets are organised into six collections selected in the widget's editor, so your home field and a race event can each keep their own set of channels.
+
+<img src="screenshots/widget_vtxadmin_fullscreen.png" width="472" alt="VTX Administrator Widget">
+
+## Development
+
+See [docs/development.md](docs/development.md) for the tool's internal architecture and the CRSF simulator used for testing inside the EdgeTX simulator.
+
+## Compatibility
+
+| Radio type | Firmware | ExpressLRS |
+|------------|----------|------------|
+| Black & white LCD | EdgeTX 2.11.6+, 2.12.1+, or 3.0+ | v3.5.4+ |
+| Color LCD | EdgeTX 2.11.6+, 2.12.1+, or 3.0+ | v3.5.4+ |
+
+The bind phrase manager additionally requires **ExpressLRS 4.1+** on the device for its MSP
+configuration support; on older firmware it reports "No response (needs ELRS 4.1+)".