https://github.com/expresslrs/elrstelemwidget
A simple widget to display ExpressLRS telemetry
https://github.com/expresslrs/elrstelemwidget
Last synced: 10 months ago
JSON representation
A simple widget to display ExpressLRS telemetry
- Host: GitHub
- URL: https://github.com/expresslrs/elrstelemwidget
- Owner: ExpressLRS
- Created: 2021-12-18T15:30:12.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-03-01T15:35:20.000Z (over 3 years ago)
- Last Synced: 2025-08-05T13:40:24.687Z (10 months ago)
- Language: Lua
- Size: 41 KB
- Stars: 74
- Watchers: 4
- Forks: 13
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
A collection of lua scripts to extend the functionality of an EdgeTX when working with ExpressLRS. Below describes the GUI widget, but the [wiki](https://github.com/ExpressLRS/ElrsTelemWidget/wiki/) has more information about any other scripts in this repository.
### No, you can't use this widget to configure your TX module!
The simple widget displays ExpressLRS LinkStats telemetry as well as common Betaflight and iNav flight controller telemetry.
# Installing
* Copy the `src/WIDGETS/ELRST` folder to your handset's SD card in the `WIDGETS/` folder such that your SD card will end up with a file called `WIDGETS/ELRST/main.lua`.
* Discover sensors
* Power up your receiver and flight controller and wait for a connection to be established.
* Press the MDL (model) key, then PAGE to get to the TELEMETRY page.
* Use the "Discover new" button to start discovering sensors. Betaflight should have 17, iNav should have 23 with GPS.
* Add the widget to the main screen
* Press the TELEM button on the handset and navigate to the second page.
* Tap "Setup widgets".
* Tap an open space and add the "ELRS Telem" widget.
* Use the RTN / EXIT button to go back until you're on the main screen again.
* If you forgot to Discover sensors before adding the widget, discover them and restart the handset entirely.
# Function Scripts
To be attached to "Special Functions" to allow binding on switch.
* ELRSb.lua - Force TX to send Bind command
* ELRSu.lua - Force RX to enter Bind mode (only if connected obviously)
* ELRSt.lua - Toggle. Enter Bind mode if connected, send Bind command if not connected
## Requirements
* Tested on Radiomaster TX16S with EdgeTX 2.5 only
## What is "Range"?
Range is an estimation of the model's distance. Technically, it is just the percentage of the RSSI from -50dBm (0% range) to the sensitivity limit for your selected packet rate (e.g. -105dBm for 500Hz) where it would indicate 100% range. Range does not account for dynamic power, so the indicated range may decrease as power goes up and increase as power goes down.
## Can you display GPS info?
The GPS speed, altitude and satellite count are shown on the fullscreen layout of this widget. If the model disconnects and valid GPS coordinates are available, it is displayed on the "Disconnected" mode display.
## Values displayed
| Key | Description | Notes |
|---|---|---|
|RFMD| Packet rate | |
| FM | Flight mode | Merged with RFMD on some sizes |
| TPWR | RF transmit power | Right side bar |
| 1RSS and 2RSS | RSSI / Range | Will display 2RSS if any value ever received |
| ANT | Active diversity antenna | Shown as symbol between 1RSS/2RSS and color |
| RQLY | Link quality | |
| RxBt | Receiver battery voltage | Attempts to determine per-cell voltage if possible |
| Curr | Receiver battery current | |
| Alt | GPS altitude | On fullscreen only |
| GSpd | GPS speed | On fullscreen only |
| Sats | GPS number of satellites | On fullscreen only |
| GPS | GPS position | Only shown if disconnected and GPS data received |