Skip to content

Latest commit

 

History

History
107 lines (85 loc) · 4.92 KB

README.md

File metadata and controls

107 lines (85 loc) · 4.92 KB

mahRe2

OpenTX/EdgeTX Widget for Voltage and Current Telemetry

-- 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)

Changes/Additions:

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

Description

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

Notes & Suggestions

  • 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)

Configurations

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

Full screen widget

Quarter screen widget

Settings

mAh Sensor setup