-- License https://www.gnu.org/licenses/gpl-3.0.en.html
-- OpenTX Lua script
-- TELEMETRY
-- File Locations On The Transmitter's SD Card
/SCRIPTS/WIDGETS/ -- This script file
/SCRIPTS/WIDGETS/mahRe2/sounds/ -- Sound files
-- Works On OpenTX Companion Version: 2.2
-- Works With Sensor: FrSky FAS40S, FCS-150A, FAS100, FLVS Voltage Sensors
-- Author: RCdiy
-- Web: http://RCdiy.ca
-- Date: 2016 June 28
-- Update: 2017 March 27
-- Reauthored: Dean Church -- Date: 2017 March 25 -- Thanks: TrueBuild (ideas)
-- Update: 2019 November 21 by daveEccleston (Handles sensors returning a table of cell voltages)
-- Update: 2022 December 1 by David Morrison (Converted to OpenTX Widget for Horus and TX16S radios)
Choose between using consumption sensor or voltage sensor to calculate
- battery capacity remaining.
- Choose between simple and detailed display.
- Voice announcements of percentage remaining during active use
- After reset, warn if battery is not fully charged
- After reset, check cells to verify that they are within VoltageDelta of each other
- Notify if the number of cells falls below the value set in GV6
- Show current/low voltage, per cell, in full screen widget
- Show current/high Amps in full screen widget
- Show current/high Watts in full screen widget
Reads an OpenTX global variable to determine battery capacity in mAh
- The sensors used are configurable
- Reads an battery consumption sensor and/or a voltage sensor to estimate mAh and % battery capacity remaining
- A consumption sensor is a calculated sensor based on a current sensor and the time elapsed. http://rcdiy.ca/calculated-sensor-consumption/
- Displays remaining battery mAh and percent based on mAh used
- Displays battery voltage and remaining percent based on volts
- Write remaining battery mAh to a Tx global variable
- Write remaining battery percent to a Tx global variable
- Writes are optional, off by default
- Announces percentage remaining every 10% change
- Announcements are optional, off by default
- Reserve Percentage
- All values are calculated with reference to this reserve.
- % Remaining = Estimated % Remaining - Reserve %
- mAh Remaining = Calculated mAh Remaining - (Size mAh x Reserve %)
- The reserve is configurable, 20% is the set default
- The following is an example of what is dislayed at start up -- 800mAh remaining for a 1000mAh battery
- 80% remaining
- The OpenTX global variables (GV) have a 1024 limit.
- mAh values are stored in them as mAh/100
- 2800 mAh will be 28
- 800 mAh will be 8
- The GVs are global to that model, not between models.
| Global Variable | Use |
|---|---|
| GV6 | Number of Cells In Lipo |
| GV7 | Lipo Capacity / 100 |
| GV8 | Write remaining mAh (off by default) |
| GV9 | Write remaining bat percentage (off by default) |
- For help using telemetry scripts -- http://rcdiy.ca/telemetry-scripts-getting-started/
If using a current sensor to calculate mAh used then an additional sensor will need to be created to add the values collected from the Curr sensor. Create a sensor with the following settings:
| Field | Value |
|---|---|
| Name | mAh |
| Type | Calculated |
| Formula | Consumption |
| Sensor | Curr |
- The following additional configurations are available within the script
| Variable | Use |
|---|---|
| VoltageSenor | The name of the voltage sensor in the model configuration |
| mAhSensor | The name of the mAh sensor in the model configuration |
| CurrentSensor | The name of the Current sensor in the model configuration |
| CapacityReservePercent | The battery capacity reserve, set to 0 to disable |
| SwReset | The switch assigned to reset all values back to defaults |
| CellFullVoltage | The value of individual cell voltage when the pack is considered full (default is 4.0v) |
| VoltageDelta | The delta value used to alert when cells are too far out of sync |
| soundDirPath | The path to the directory where the sound files are located |
| AnnouncePercentRemaining | Play the percent remaining every 10 percent |
| SillyStuff | Play some silly/fun sounds |
