From c299d840a43212418b0288e923d1ac68b35119aa Mon Sep 17 00:00:00 2001 From: MUSTARDTIGER Date: Mon, 27 Jul 2026 21:17:23 +0200 Subject: [PATCH] pre-1stflight: link the ExpressLRS Telemetry Widget Closes #419. The widget is an official ExpressLRS project but the site never mentions it. A search of the whole docs tree for "telemetry widget", "ElrsTelem" or "TelemWidget" returns nothing. The natural place is right after sensor discovery on the first flight page, since that is when the user has just built the sensor list and is looking at the telemetry screen. Contents come from the widget README: the WIDGETS/ELRST install path, the need to discover sensors before adding the widget, the restart if that order is missed, the expected sensor counts of 17 for Betaflight and 23 for iNav with GPS, and the ELRSb, ELRSu and ELRSt function scripts. The README gives its tested configuration as a TX16S on EdgeTX 2.5 and there is no newer compatibility statement, so the note repeats that as written and sends bug reports to that repository rather than implying support for later handsets that has not been verified. --- docs/quick-start/pre-1stflight.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/quick-start/pre-1stflight.md b/docs/quick-start/pre-1stflight.md index 9fef8ea9f..57bf76d3c 100644 --- a/docs/quick-start/pre-1stflight.md +++ b/docs/quick-start/pre-1stflight.md @@ -168,6 +168,19 @@ If you use 200Hz and 1:2 Tlm ratio the stars will not even blink because the upd ![Fast update rate](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/wiki-from-discord/fast.gif) +### ExpressLRS Telemetry Widget + +Once your sensors are discovered, you can show them on the handset home screen with the [ExpressLRS Telemetry Widget](https://github.com/ExpressLRS/ElrsTelemWidget). This is an official ExpressLRS project. It shows the ExpressLRS link statistics next to the common Betaflight and iNav values, so you can check the state of the link without opening the telemetry page. + +To install it, copy the `src/WIDGETS/ELRST` folder from that repository into the `WIDGETS/` folder on your handset SD card. The card must then hold the file `WIDGETS/ELRST/main.lua`. Discover your sensors first, then press the telemetry key, go to the widget setup page, and add the `ELRS Telem` widget to a free space. If you add the widget before the sensors are discovered, restart the handset after you discover them. + +A correct sensor discovery gives 17 sensors with Betaflight, and 23 with iNav when a GPS is fitted. Use this as a check that your telemetry is set up properly. + +The same repository holds function scripts that let you bind from a switch. Attach `ELRSb.lua`, `ELRSu.lua`, or `ELRSt.lua` to a Special Function. + +!!! note "Note" + The widget repository gives its tested configuration as a RadioMaster TX16S with EdgeTX 2.5. There is no current compatibility list for later handsets or later EdgeTX versions, so report any problem you find on the widget repository. + ## MSP To configure Betaflight from your transmitter it's possible to use the Betaflight lua scripts. If you are having trouble, make sure you are running the latest [Betaflight nightly lua](https://github.com/betaflight/betaflight-tx-lua-scripts-nightlies/releases).