Repository navigation
Home
Widget version: 2026.10.01. 1.0 RC0 - Test version
In its current state, due to insufficient testing, the use of the widget in live operation is not recommended. At the same time, I am not aware of any situation where a Widget error would affect flight safety. I have been using it for months without any problems.
Minimum required EdgeTx version: 2.11.5, the latest is recommended. The Widget uses LVGL graphical display. Developed and tested on a Radiomaster TX16S radio.
- Counting battery flights
- Creating and displaying a flight log
- Customizable support for flying based on mAh value
- Handling of backup onboard battery
- Announcing the charge percentage of the connected battery
- Warnings when events occur
I exclusively fly helicopters, I created the widget for myself. The BattUse widget is now in a state where I decided to share it, perhaps it can be useful to others as well. I am happy to listen to constructive, civilized criticism. This is my first published project, so please be gentle :-) English is not my greatest strength, so I also appreciate help with language corrections of the documentation.
Install in the usual way, similar to other widgets, unpack the contents of the downloaded zip into the /WIDGETS/BattUse folder.
On the radio, the flight modes (FM-0, FM-1,..) must be used, this will indicate the start and end of the flight. If there is telemetry data about the battery voltage, it supports the creation of the flight log. The use of the Countdown timer is mandatory.
For the full operation of the widget, the use of several telemetry channels is also required, but it can also be used without them.
Usable telemetry channels:
- Instantaneous voltage of the battery
- mAh value used during the flight
- Highest instantaneous consumption reached during the flight (+AMP)
With telemetry values and a selected battery, flight based on the used mAmper value can be used. The landing battery charge target percentage can be set. If there is a configured telemetry channel, the flight lasts until the battery is disconnected, so switching to normal mode does not mean the end of the flight.
Without data arriving from telemetry, an entry is still made in the flight log. The end of the flight is indicated by switching back to Normal mode. Flight based on the consumed mAmper value cannot be used.
During flight without a battery, mAmp-based flight timing cannot be used, nor does the increase of the battery cycle count occur.
If there is no selected battery, a warning voice message for battery selection arrives when the battery is connected or when switching to FM-1 for the first time.
All setting options that affect the operation of BattUse are available in the Widget's full screen mode. To enter full screen mode, hold your finger on the screen on any BattUse widget and select the “Full screen” menu from the appearing menu. (As is usual with any other widget.)
Settings available on the “Input” screen in the widget's full screen mode:
Battery Voltage telemetry sensor : The selected Telemetry channel that returns the voltage of the main battery.
Current telemetry sensor : The selected Telemetry channel that returns the mAh used during the flight.
Peak current telemetry sensor : The selected Telemetry channel that returns the maximum mAh during the flight.
Battery quick selector channel: Determines the battery selection mode. If no channel is selected, the battery can be selected in full screen mode. If there is a channel (preferably one of the pots: S1,S2,LS,RS) then the battery can be selected with it using the “Quick Select” widget display. Detailed description below under the Quick Select title in this description.
Backup battery Volt: Important if you use a Backup battery or capacitor. When the main battery is disconnected, the onboard voltage does not drop to 0, but below the level specified here. It is important to specify a value close to the remaining onboard voltage, higher than that.
Battery Cell: If no battery is selected, BattUse calculates with this. The number of cells of the model being flown. If there is a selected battery, it uses the cell number from the table containing the batteries.
Timer: Mandatory selected timer, which must be a countdown. The use of flight time is also mandatory alongside mAh-based flying. Announcing the current time is the individual's responsibility, it is definitely recommended in the initial period. The sound or other timer indication can be omitted if the mA-based flight time determination works properly.
Settings available on the “Behavior” screen in the widget's full screen mode:
Landing percent : The goal is to fly out as much mAmp from the battery so that the battery is depleted to the percentage specified here upon landing. The maximum flyable (100%) mAh is the value specified in the battery's capacity field. Check the description of the battery fields in the BatUse Log Viewer script description!
Log Path : The flight log is saved in the folder selected here: /LOG or /WIDGETS/Battuse/LOGS/. It can be different per model. Do not modify the LOG path without also moving the previous log files, because it will cause problems during later log processing! (see BattUse Log Viewer, Stat and Log summaries)
Date format : The format of the dates displayed on the screen. (Indicate if you need a format that you do not find in the list.)
Battery warning when connect: Warns when the battery is connected if no battery has been selected yet.
Battery warning when disconnect on fly: Warning if the battery voltage disappears during flight. (drops to Backup battery Volt level).
Battery warning when fly begin: Warning at the beginning of the flight (FM-1) if no battery is selected.
Warning when Battery connecting and Volt under: Warning if the charge (voltage) of the battery is below the specified percentage when connecting the battery.
Battery over use warning: If the charge (voltage) of the battery is below the percentage specified here upon landing, then the battery charge percentage is displayed in a warning color on the “mAh Percent” display.
Say percent when fly mAh reach: At the consumed mAh percentage value specified here, the percentage is announced - in the language set on the radio.
Haptic sign when Fly mAh reach: At the consumed mAh percentage value specified here, the radio signals with vibration.
Haptic warning when overuse in every sec: If the mAh usable to reach the landing target has been used, then the radio signals with vibration and announcement every specified second.
- Placing the BattUse Widget on the model screen
- Setting the Model Timer to countdown (Direction : "Show remain").
- Setting the battery and models relationship -> BattUse Log Viewer (Creating the table file containing batteries and relationships based on the given sample.)
- Setting Input channels and values in the Widget's full screen mode, on the “Input” screen.
- Setting Behavior in the Widget's full screen mode, on the “Behavior” screen.
It is recommended to get familiar with the use of the BattUse widget in EdgeTX Companion.
Batteries that have been assigned to the model in the "BattUse Log Viewer" script can be selected. BattUse offers two battery selection options. If no “Quick Battery select channel” is selected on the “Input” screen, the selection can be made by switching to Full Screen.
On the “Select Bat” screen, the batteries and their more important data are displayed in a scrollable manner. The date and time of the last use is red if the last use of the battery was on the current day. (Important information if you do not charge your batteries at the flying field.)
Click on the battery and the selection is made, BattUse exits full screen mode.
If the "Quick select" channel is set on the Input page (preferably a scrollable channel not used for anything else), then the “Select bat” screen disappears in full screen mode and the selection can only be performed through the Widget, “Quick Select” display. By changing the value of the set channel (for example S2 pot), a battery can be selected.
During flight, battery selection does not work ( #FM-0 ). You cannot select a battery with the pot if the Quick Select widget is not on the screen. Thus, the selection option can also be locked by switching screens.
The squares appearing on the screen mark one battery each from the battery list, in the order they appear in the table. It is advisable to place next to the “Quick Select” BattUse-Display a BattUse-Display that shows the data of the current battery, for example: “Battery Name” , “Battery properties”, “LastUse”.
If no Quick select channel is selected, but the Quick Select BattUse-Display is placed on the screen, an error message appears.
BattUse offers several types of displays. To take advantage of this, you can place the BattUse widget on the screen multiple times, then in the “Widget settings” menu you can select the data displayed by the given widget instance.
The widgets show the finishing data of the previous flight until a new battery is selected or connected.
The BattUse-Displays adapt to the available space, some can also be placed in the "Top Bar" area.
Currently the following displays are available:
| Display | Placeable in "Top Bar" area |
|---|---|
| Battery Name | No |
| Battery status | Yes |
| Fly Time | Yes |
| Landing target % | No |
| Last used | No |
| Remanining charge | Yes |
| Peak current | No |
| Battery properties | No |
| Quick Selector | No |
| Flight Count | Yes |
In full screen mode, by clicking the "Log" button, the daily flight data from the flight log file can be accessed. By clicking on the row, detailed flight data can also be viewed. Due to the limited runtime of the widget, only the flights of the current day can be viewed. More detailed data can be queried with the "BattUse Log Viewer" OneTime script.
At the end of every flight, BattUse creates an entry in the log file containing the daily flights.
Its save location can be set in the "Behavior” menu “Log Path" field.
The name of the file containing the flight log:
"FlyLog_"[YYYYMMDD]_[model name].csv
For example: "FlyLog_20260131_TRex 700X.csv"
This project is licensed under the terms of the GNU General Public License v3.0.
The full text of the license is available in the LICENSE file. Please note that the software is provided "as is", without warranty of any kind. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability arising from, out of, or in connection with the software or its use.