From 54d3c9fc55e490d59645edbb33a12bb5a5f7250c Mon Sep 17 00:00:00 2001 From: MUSTARDTIGER Date: Mon, 27 Jul 2026 21:11:08 +0200 Subject: [PATCH] webui: document Voltage Calibration, WiFi State and the password reveal Three parts of the 4.1 Web UI are not covered by this page. Voltage Calibration is a whole tab that is not mentioned at all. It is added between Hardware Layout and Continuous Wave to match the order of the navigation menu. The tab only appears on receivers, and only when the Hardware Layout defines at least one voltage source, so the section says so. The four wizard steps match the panel: High Voltage, Low Voltage, No Voltage, Review. Values are entered in millivolts. The Information Tab section did not describe the WiFi State row. It reports Client with the network name, or AP mode, and adds the signal strength in dBm where the device can measure it. The note records that the number means different things in the two modes, since in Access Point mode it is the RSSI of the single connected client and is absent on ESP8285. A weak signal is a common cause of a failed firmware upload, so that is called out. The WiFi Tab section did not mention the control that reveals the stored password, or the obvious consequence of using it. --- docs/quick-start/webui.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/docs/quick-start/webui.md b/docs/quick-start/webui.md index b32b9344a..5621aaedb 100644 --- a/docs/quick-start/webui.md +++ b/docs/quick-start/webui.md @@ -234,6 +234,13 @@ ExpressLRS 4.0 improves upon this with a new layout allowing for more sections o ### Information Tab This Tab will show the basic information about the device, including Hardware name, Firmware version, GitHub commit hash, Radio Chip, Regulatory Domain, Binding UID and any options that's been changed from the default or flashed settings. + The `WiFi State` row shows how the device is connected. In Home WiFi mode it shows `Client` and the network name. In Access Point mode it shows `AP mode`. Where the device can measure it, the row also shows the WiFi signal strength in dBm followed by a short description of the quality. + + A weak WiFi signal makes a firmware upload slow, and can make it fail part way through. If the value is worse than -80dBm, move the device closer to the router, or use the Access Point instead of Home WiFi, before you use the Update Tab. + + !!! note "Note" + The signal strength means different things in the two modes. In Home WiFi mode it is how well the device hears your router. In Access Point mode it is how well the device hears the one connected client, and it is not shown at all on ESP8285 devices. +
![Information Tab](../assets/images/webui/information.png)
@@ -316,6 +323,8 @@ ExpressLRS 4.0 improves upon this with a new layout allowing for more sections o This tab lets you change the device' WiFi network connectivity and how it will behave when it is in WiFi mode. + The password field has an eye button at its right edge. Use it to show the stored Home WiFi password in plain text, which is useful to check a password that does not connect. The password becomes readable by anyone who can see the screen, so hide it again before you show the page to someone else or share a screenshot. +
![WiFi Tab](../assets/images/webui/wifi.png)
@@ -339,6 +348,27 @@ ExpressLRS 4.0 improves upon this with a new layout allowing for more sections o ![HW Layout Tab](../assets/images/webui/hardware.png) + ### Voltage Calibration + + Introduced in ExpressLRS 4.1. This tab appears on receivers that have at least one voltage source defined in the Hardware Layout. It runs a wizard that measures your receiver against a known voltage and works out the correct scale and offset, so the battery voltage reported over telemetry matches reality. + + You need an adjustable power supply, or a battery and a multimeter, to give the receiver a voltage you already know. + + Select the source to calibrate, then work through the four steps: + + 1. **High Voltage**. Apply a voltage near the top of the range you want to measure, type the actual value in millivolts, and capture it. + 2. **Low Voltage**. Apply a lower known voltage, type the actual value in millivolts, and capture it. + 3. **No Voltage**. Disconnect the source and capture the idle reading. Skip this step if the source is always connected. + 4. **Review**. The wizard shows the calculated offset and scale, and how far the fit is from your two known points. Reconnect the source, check the live reading, then save. + + The receiver reboots when the calibration is saved. On ESP32 receivers the wizard also tries each available input attenuation and keeps the one that gives the best result without the reading going off scale. + + !!! warning "Warning" + Do not apply a voltage above what the receiver is designed for. The voltage divider on the board sets that limit, and the wizard cannot protect the hardware. Check the specification for your receiver first. + + !!! note "Note" + The calibration is stored in the Hardware Layout, so it is kept when the settings are exported and restored. Flashing a device and choosing not to keep the existing configuration will discard it. + ### Continuous Wave This tab is for Advanced Users only. This allows a user to put the RF chip into a mode where it transmits a continuous wave at the center frequency that the module is made for. It can help determine whether there's a frequency shift or deviation from the ideal frequency. See [Crystal Frequency Error](../hardware/crystal-frequency-error.md).