LiPo battery checker script (for Taranis X9D, X9D+, and X9E)

Florent MartelFrSky2 Comments

Share this Post

 

If you ever wondered after landing whether your battery still had enough charge for another short flight, you will find the following script very useful.

A Lua script developed by Heisenberg and published on the French frskytaranis.forumactif.org forum allows users of an FLVSS or MLVSS LiPo battery sensor to check the voltage level of each cell of their battery pack in a well-designed interface.

 

Example Cell Voltage Sensor: FrSky MLVSS Smart Port

 

Screen showing the LiPo battery checker script for Taranis

LI-PO BATTCHECK V4.1

These setup instructions are for OpenTX 2.2 but the script is otherwise also compatible with OpenTX 2.1:

Download Battery Checker.zip file.

Enter bootloader mode on the Taranis by sliding both horizontal trims, each under the main sticks, towards the center and then turning the Taranis on. The top of the Taranis LCD screen should now display “Taranis Bootloader.”

Actions to enter bootloader mode on the Taranis

Actions to enter bootloader mode on the Taranis

Connect a USB cable between the Taranis and the computer. “USB Connected” should appear in the center of the Taranis LCD screen.

Extract the contents of the “SDcard” folder found in Battery Checker.zip to the root directory of Taranis SD card (the SD card should appear as a computer drive and contains multiple folders, including one named SCRIPTS). When extracting, make sure to “merge” the contents and replace/overwrite any file already on the SD card when prompted. Do not delete the folders already on the SD card before copying the folders to the root directory of the SD card.

Unplug the USB cable, navigate the choices with the +/- buttons, select “Exit,” and press ENT to validate. Repeat the following steps for each model with which you want to use the battery checker:

Press on MENU from the main screen, then press on PAGE. From the MODEL SELECTION menu, create a new model (or copy the one you’re currently using).

This script cannot be activated on the same model as FlightDeck, so a separate model should be created for the battery checker script.

Screenshot showing how to create a model on the Model Selection screen

Creating a Model on the Model Selection Screen

Once the model is created, press on PAGE until the CUSTOM SCRIPTS menu is displayed. Press ENT to edit the LUA1 entry. On the LUA1 page, press ENT, navigate the choices with the +/- buttons, select “batchk,” press ENT to validate then press EXIT. The screen should display batchk next to the LUA1 entry:

screenshot of the Custom Scripts screen showing batchk as the LUA1 script

Custom Scripts screen showing batchk as the LUA1 script

Press on PAGE until the DISPLAY menu is displayed. Scroll down using the – button and highlight the “None” entry next to “Screen 2.” Once “None” is highlighted, press ENT, navigate the choices with the +/- buttons until “Script” appears and press ENT to validate. Press – to move to the right (highlighting “- – -“). Press ENT, navigate the choices with the +/- buttons, select “batchk” and press ENT to validate.

Screenshot showing how to assign the batchk script to Screen 1

Assigning the batchk script to Screen 1

FlightDeck and the Battery Checker script need different models
The FlightDeck script (“fltdk”) and the battery checker script (“batchk”) cannot be activated on the same model because of memory limitations, so make sure that only the batchk script is active on this new model.

Finally, you will need to discover the “Cels” sensor. To discover it, turn on your Smart Port receiver and your FLVSS or MLVSS sensor (which should be plugged into your battery to see values displayed). Press on PAGE until the TELEMETRY menu is displayed. Scroll down using the – button and highlight “Discover new sensors.” Once “Discover new sensors” is highlighted, press ENT.

Screenshot showing how to discover new sensors in OpenTX

Discovering new sensors in order to discover the LiPo cell sensor

“Stop discovery” should now be displayed. Sensors should appear, and among them the “Cels” sensor.

Screenshot showing the discovered cell sensor

Once the cell sensor has been discovered it appears in the Sensors list

Stop discovery, long press on EXIT, then long press on PAGE to display the battery checker interface.

The battery checker script is neither made by nor supported by Craft and Theory LLC.

---- ###############################################################
 ---- #                                                            #

---- #        Telemetry Lua Script for FrSky RC Taranis TX        #

---- #    LI-xx BATTCHECK v4.1  // Use it with OpenTX 2.1.x       #

---- #      Version  with ACCU LIPO discharge lookup table        #

---- #      Version in 2 parts: script MIX LUA & Telemetry        #

---- #                                                            #

---- #                                                            #

---- #  License: Share alike                                      #

---- #  Can be used and changed non commercial                    #

---- #                                                            #

---- #  Developped by Heisenberg.                                 #

---- #  Debugged by Sacre100 (the hardest job) who succeeded      #

---- #  decreasing GC and memory use for Taranis compatibility.   #

---- #  Improved by Dev.Fred to get correct percent li-po values  #

---- #                                                            #

---- #  Credits to Dev.Fred, Kilrah, and some of other members    #

---- #  from the french forum frskytaranis.forumactif.org/        #

---- #  And especially more to Sacre100 for his patience and      #

---- #  knowledge shares.                                         #

---- #                                                            #

---- ###############################################################

 

Source: http://frskytaranis.forumactif.org/t2800-lua-download-un-testeur-de-batterie-sur-la-radio

 

Purchase MLVSS or FLVSS LiPo Cell sensor.

Purchase telemetry cable.

Share this Post

2 Comments on “LiPo battery checker script (for Taranis X9D, X9D+, and X9E)”

  1. Woo cool script but is it possible to use the qx7 smartport to use it or it must use a rx with smartport ?

Leave a Reply

Your email address will not be published. Required fields are marked *