UM2845
User manual
L9963E evaluation graphical user interface
Introduction
This document describes the graphical user interface (GUI) that allows the initialization and control of the EVAL-L9963E-MCU
evaluation board by changing parameters through the SPI protocol. The STSW-L9963E GUI has been developed using Labview
and it uses, as microcontroller interface, the on board microcontroller SPC574S64E3 with preloaded FW.
Hardware connection
The STSW-L9963E GUI is intended to be used with the EVAL-L9963E-MCU for system with up to 14 Li-Ion cells. In case
more cells need to be controlled it’s necessary to add the EVAL-L9963E-NDS expansion board to control them. Up to 14
EVAL-L9963E-NDS, for a grand total of 15 boards with EVAL_L9963E-MCU, can be added to the system and controlled by the
STSW-L9963E GUI.
Figure 1. EVAL-L9963E-NDS connection schemes
Figure 2. PC connection to EVAL-L9963E-MCU
UM2845 - Rev 1 - March 2021
For further information contact your local STMicroelectronics sales office.
www.st.com
1 Preliminary actions
Before running the STSW-L9963E GUI on your PC some third part SW packages has to be installed:
• NI Labview-runtime 2014
• NI VISA-RUNTIME
• FTDI driver
– Before using the UART/USB bridge FT2232H on the EVAL-L9963E-MCU, the Virtual Com Port (VCP)
driver needs to be installed. It can be downloaded by the FTDIChip website.
When all the above packages have been installed reboot your PC.
UM2845
Preliminary actions
UM2845 - Rev 1
page 2/32
2 GUI description
When the setup has finished, the user needs to check whether all the hardware connections are correct (see the
EVAL-L9963E-MCU user manual for further information) and run GUI by clicking on: STSW-L9963E.exe
UM2845
GUI description
Figure 3. Main GUI interface
2.1
There are 4 areas in the GUI which are: battery and diagnostic information, configuration and diagnostics Tabs
and general operation buttons such as “COM selection”, “save”, “load” configurations, and “diagnostic” as well as
“data logger enable” etc.
Voltage, current and temperature indicators
Figure 4. Voltage, current and temperature indicators
With reference to Figure 4. Voltage, current and temperature indicators, in the main GUI interface we have the
following gauge indicators:
1. Cell voltage indicators
2. Temperature sensor indicators
3. Total battery voltage indicator
4. VTREF measurement indicator
UM2845 - Rev 1
page 3/32
GADG260520201638SA
GADG260520201639SA
GADG260520201640SA
UM2845
Voltage, current and temperature indicators
Each indicator has the following structure:
Figure 5. Gauge indicator structure
The indicator shows the voltage measured by ADC and converted in volt, the EN flag that allows the user to
enable the channel, a LED on the left indicating the under-voltage condition and a LED on the right indicating
the overvoltage condition. Under and overvoltage threshold can be configured in the “configuration tab” described
below in this manual.
Figure 6. Chart option
By selecting the check box “Chart” all the gauges will be converted into graphs with the history of the value over
the time.
2.1.1 IC temperature
The chip temperature is available in the indicator of Figure 7. IC temperature indicator:
The chip temperature and the possible overtemperature are calculated from the SPI register of L9963E.
UM2845 - Rev 1
Figure 7. IC temperature indicator
page 4/32
2.1.2 Configurable GPIO voltage values
GADG260520201641SA
GADG260520201642SA
GADG260520201646SA
The Figure 8. GPIO voltage and under-voltage, over-voltage condition shows the GPIO configurations and the
selectable limits in "configuration tab". The indicators describe the voltage values, over-voltage and under-voltage
(LED) conditions.
Figure 8. GPIO voltage and under-voltage, over-voltage condition
2.1.3 Coulomb counter
The GUI allows to use the Coulomb counting capability of the L9963E. The Coulomb counter can be enabled in
the “configuration tab” described below in this manual.
UM2845
Voltage, current and temperature indicators
In the Coulomb counter section, the user can select the shunt resistor in mΩ and visualize the Instantaneous
current value synchronized with voltage measurements, the instantaneous current value calibrated, the time base,
the accumulator value (A) and the calculated accumulator capability in (Ah). Three LEDs represent the available
diagnostics: open of positive or negative sense resistor lead and the Coulomb counter accumulator overflow. With
the RST button the Coulomb counter accumulator can be reset.
2.1.4 Manual balancing
The GUI allows the user to select, using the checkbox, the cell to discharge using the manual balancing capability
of the L9963E. The discharge will be activated till the check box is selected or till the maximum balancing time
is reached (see the L9963E datasheet) or the undervoltage of the cell is reached. For further information please
check the L9963E datasheet.
Figure 9. Coulomb counter
Figure 10. Manual cell balancing checkbox
UM2845 - Rev 1
page 5/32
2.2 Devices ID configuration
GADG260520201648SA
GADG260520201649SA
The STSW-L9963E allows the use of a single EVAL-L9963E-MCU board or a chained system composed by an
EVAL-L9963E-MCU and up to 14 EVAL-L9963E-NDS connected using the vertical isolated interface (please see
the Figure 1. EVAL-L9963E-NDS connection schemes). For each device in the system it is necessary to define
a unique ID in order to be addressed and configured. The first operation to start working with the L9963E is
to configure the device ID. The section represented in Figure 11. ID configuration section allows the user to
configure the devices IDs.
In the ID text box, the user has to write the ID of the devices present in the system, up to 15 devices can
be configured (1x EVAL-L9963E-MCU and up to 31x EVAL-L9963E-NDS). In case of a single device (only
EVAL-L9963E-MCU) only “1” has to be written in the box Figure 12. Single board configuration.
UM2845
Devices ID configuration
Figure 11. ID configuration section
2.3
Figure 12. Single board configuration
Once the ID has been correctly written in the box, the user has to press “Configure IDs” button in order to
configure the devices it with the procedure described in the L9963E DS. If the connection is correct the ACK LED
will be green, otherwise will turn red. The user can clear all the IDs pressing on the “Clear IDs” button, if the IDs
are correctly cleared the ACK LED will be green, otherwise it will turn red.
GUI communication time interval configuration
STSW-L9963E allows to configure the time interval communication with the onboard microcontroller:
There are 6 options:
80 ms, 100 ms, 200 ms, 300 ms, 400 ms, 500 ms.
Figure 13. Communication time interval configuration
UM2845 - Rev 1
page 6/32
When the desired time interval has been chosen, to be activated the user must click on “Time interval button”.
GADG260520201650SA
If the operation has been correctly accomplished the ACK LED will be green, otherwise it will turn red. The time
interval will impact on the refresh rate of the whole GUI and on the time scale of voltage charts.
2.4 Automatic device configuration
With the automatic device configuration feature, the user can configure multiple devices.
Figure 14. Automatic configuration
UM2845
Automatic device configuration
The user can try different device configurations, when he has found the preferred one, he can save it using the
“Save configuration” button. If in a second time he wants to reuse the same configuration, he can reload it using
the “Load configuration” button and apply it to the device selected by the “Dev ID display” dropdown menu and
pressing the “Configure device” button; if the operation has been correctly accomplished the ACK LED will be
green, otherwise it will turn red. It is necessary to pay attention to the fact that the configuration will be applied
only to the selected device.
2.5 Firmware version
The EVAL-L9963E-MCU board comes with a preloaded FW in the microcontroller flash memory. Using the button
in Figure 15. Firmware version check, the user is informed on which version is loaded on the microcontroller.
This feature helps to debug the correct communication between PC and microcontroller and allows to check the
correct FW download on the EVAL-L9963E-MCU.
Clicking on the “Get Firmware version” if the board is correctly connected via USB cable to the PC, the whole
driver has been correctly installed, and the microcontroller is correctly working, the user can get the preloaded
firmware version. The correct value is version 1.5 as in Figure 15. Firmware version check.
Figure 15. Firmware version check
UM2845 - Rev 1
page 7/32
2.6 Data logger
GADG260520201652SA
The STSW-L9963E GUI allows to log the measurement on a text file in order to be post-elaborated.
UM2845
Data logger
Figure 16. Data logging procedure
In order to enable the datalogging feature, the following procedure has to be followed:
• Configure the device ID
• Configure the device register as described below in this manual
• Enable the cell voltage to be logged clicking on the EN box of the gauges
• Click on the “Single write/read” button to send the configuration to the L9963E
• Select the “Data logger” check box and finally select the “Diagnostic” check box in order to enable the cyclic
measurement in the GUI.
When the user decides to stop the data logging, the “Diagnostic” check box has to be unselected. A text file
will be generated in the data directory where the GUI is located. The file will be named with date and time of
acquisition.
UM2845 - Rev 1
page 8/32
Figure 17. Data logging file location and name
GADG260520201653SA
GADG260520201654SA
UM2845
Data logger
The generated file is a text file with equally spaced values that can be easily imported in Excel or other data
analysis tools.
The file structure is described in Figure 18. Data log file organization. Each line is acquired with the timing
defined in the GUI communication time interval configuration (Section 2.3 GUI communication time interval
configuration).
Figure 18. Data log file organization
UM2845 - Rev 1
page 9/32
2.7 Transceiver selection
GADG260520201659SA
GADG270520200913SA
On the EVAL-L9963E-MCU two transceivers L9963T are present. In Figure 19. EVAL-L9963E-MCU transceiver
schematization there is a schematization of the transceiver connection.
Figure 19. EVAL-L9963E-MCU transceiver schematization
UM2845
Transceiver selection
2.8
Under normal functioning condition, the microcontroller communicates with the onboard L9963E thanks to the
L9963T marked as U16. By checking the “SWAP” checkbox (see the Figure 20. Transceiver SWAP checkbox) the
communication is swapped from U16 to U18 allowing the microcontroller to communicate with a remote L9963E
(i.e. an EVAL-L9963E-NDS) connected on ISOPORT2.
Figure 20. Transceiver SWAP checkbox
By checking the box if the operation has been correctly accomplished the ACK LED it will be green, otherwise it
will turn red.
COM port communication
The STSW-L9963E GUI communicates with the onboard microcontroller on the EVAL-L9963E-MCU through a
virtual COM port over USB. In order to correctly establish the communication between GUI and EVAL-L9963EMCU it’s necessary to correctly select the COM port where the board is connected.
Figure 21. COM port selection
UM2845 - Rev 1
Using the I/O dropdown menu the user can select the COM port where the board is connected. If the
communication is correctly established the COM LED and the ACK LED will be green, if something goes wrong,
they will turn red. With the “Reset COM port” button it’s possible to reset the COM port and reinitialize the
microcontroller.
page 10/32
In order to double check if the communication between GUI and microcontroller is correctly established, the user
GADG270520200914SA
can use the procedure described in Section 2.5 Firmware version to check the actual firmware version loaded on
the microcontroller.
2.9 Diagnostic activation
The STSW-L9963E allows to activate the diagnostic and measurement function once or in continuous mode.
UM2845
Diagnostic activation
Figure 22. Diagnosis activation
The user can activate the single measurement and diagnostic reading pressing on the “Diagnostic once” button.
Once pressed all the measurement will be updated and the diagnostics in the diagnostic tabs (see below in
this document for description) will be updated. Checking the “Diagnostic” check box, a cyclic update of measure
and diagnostic will be accomplished by the GUI with the time base set in “Time interval configuration” (see
Section 2.3 GUI communication time interval configuration).
2.10 Stop the GUI
Using the “STOP” button in Figure 22. Diagnosis activation, the user can stop and close the GUI.
UM2845 - Rev 1
page 11/32
2.11 L9963E register management
The STSW-L9963E GUI allows the user to directly manage the L9963E registers bitwise or use the graphical tools
present in the GUI.
Figure 23. Bitwise control of L9963E registers
UM2845
L9963E register management
UM2845 - Rev 1
The bitwise register control can be done using the tools represented in Figure 24. An example of automatic
register configuration. The user can choose the register of L9963E he wants to read or write by using the
“Configuration registers” dropdown menu. With the “Write/read” dropdown menu, one can decide to write or read
the specific register. The bitwise configuration can be done clicking directly on the bit name fields, the value will
toggle once clicked and the final Hex value of the register can be read in “mosi” textbox. In order to correctly
address the device, especially in a distributed configuration, the user has to choose the correct device ID where
he wishes to send the command. This choice can be done using the “Dev ID” dropdown menu. The menu is
populated according to the device ID configuration (see the Section 2.2 Devices ID configuration). The value ‘0’
means a broadcast command sent to all the chain of distributed devices. Clicking on the “Single write/read” button
the user can send the MOSI and can read the MISO that will be written in Hex format in the “miso” textbox and
decoded in the rightmost column of the bitwise description.
Some registers can be configured graphically thanks to the GUI features. In the following figure you can see an
example referring to the cell voltage measurement enabling.
page 12/32
GADG270520200916SA
UM2845
L9963E register management
Figure 24. An example of automatic register configuration
In Figure 24. An example of automatic register configuration, the user has enabled the CELL 1, CELL 4 and CELL
14 voltage measurement by flagging the “EN” checkbox in the corresponding voltage gauge. The VCELLS_EN
register is updated accordingly. In order to activate the configuration the user has to define the Device ID where
he wants to apply the configuration and then click on the “Single write/read” button.
ATTENTION: for all the configurations made in the GUI using the graphical tool, in order to apply the
configuration, the user has to always follow these steps:
1. Select the configuration by graphical tools.
2. Define the Device ID where apply the configuration using the “Dev ID” dropdown menu.
3. Click on “Single write/read” button to send the configuration.
UM2845 - Rev 1
page 13/32
GADG270520200921SA
GADG270520200923SA
Configuration, PCB open wire diagnostic and sleep mode tab
3 Configuration, PCB open wire diagnostic and sleep mode tab
In this section, the L9963E configuration, PCB open wire diagnostic and sleep mode tab will be covered.
3.1 GPIO thresholds configuration
In this section of the GUI it’s possible to graphically configure the GPIO3 to GPIO9 over-voltage and undervoltage thresholds.
Figure 25. GPIOs thresholds configuration
UM2845
The thresholds are expressed in Volts and the GUI will perform the calculation to configure the corresponding
L9963E SPI registers GPIOx_THR (for further information please see the L9963E datasheet). To be operative
the configuration the user must follow the procedure described at the end of Section 2.11 L9963E register
management.
3.2 Cells and battery thresholds configuration
In this section of the GUI it’s possible to graphically configure the cells overvoltage and undervoltage thresholds
(L9963E register VCELL_THRESH_UV_OV), the whole battery, in terms of sum of selected cells, thresholds
(L9963E register VBAT_SUM_TH) (for further information please see the L9963E datasheet). To let the
configuration be operative the user must follow the procedure described at the end of Section 2.11 L9963E
register management.
Figure 26. Cells and battery thresholds configuration
UM2845 - Rev 1
page 14/32
3.3 Current thresholds configuration
GADG270520200954SA
GADG270520200955SA
GADG270520200956SA
In this section of the GUI it’s possible to graphically configure the over-current threshold in normal mode (L9963E
register CSA_THRESH_NORM) and in sleep mode (L9963E register CSA_GPIO_MSK) (for further information
please refer to the L9963E datasheet). To let the configuration be operative the user must follow the procedure
described at the end of Section 2.11 L9963E register management.
Figure 27. Over current thresholds configuration
UM2845
Current thresholds configuration
3.4
3.5
ADC SOC filter configuration
In this section of the GUI it’s possible to graphically configure the ADC SOC filter configuration (L9963E register
ADCV_CONV) : the filter (average on a number of measurements) to be applied when the SOC routine is run (for
further information please see the L9963E datasheet). Please note that this parameter has an impact on the cell
voltage conversion time. To let the configuration be operative the user must follow the procedure described at the
end of Section 2.11 L9963E register management.
Figure 28. ADC SOC filter configuration
Ratiometric GPIO measurement
In this section of the GUI it’s possible to graphically activate by checkboxes GPIO ratiometric conversion with
respect to VTREF_MEAS (L9963E SPI register GPIOx_MEAS field ratio_abs_x_sel) (for further information
please see the L9963E datasheet). To let the configuration be operative the user must follow the procedure
described at the end of Section 2.11 L9963E register management.
Figure 29. Ratiometric GPIO measurement checkboxes
UM2845 - Rev 1
page 15/32
3.6 ADC voltage conversion configuration
GADG270520200957SA
GADG270520200958SA
GADG270520200959SA
In this section of the GUI it’s possible to graphically configure the different fields of the L9963E ADCV_CONV
register that is used to configure the ADC voltage conversion, for further information please refer to the L9963E
datasheet. To let the configuration be operative the user must follow the procedure described at the end of
Section 2.11 L9963E register management.
Figure 30. ADCV_CONV L9963E register graphical checkboxes
The user may use these checkboxes to manually start a one-shot conversion. It’s not necessary to configure
these checkboxes during cyclic conversion.
UM2845
ADC voltage conversion configuration
3.7 Coulomb counter enabling
In this section of the GUI it’s possible to graphically activate the Coulomb counter routine controlling the
CoulombCounter_en bit of the L9963E SPI register CSA_GPIO_MASK (for further information please see the
L9963E datasheet). To let the configuration be operative the user must follow the procedure described at the end
of Section 2.11 L9963E register management. By activating this checkbox, the Coulomb counter section of the
GUI, described in Section 3.7 Coulomb counter enabling of this user manual, becomes operative.
Figure 31. Coulomb counter enabling checkbox
3.8
L9963E communication timeout disabling
The L9963E has a function, called communication timeout, that monitors the communication between the L9963E
and MC. In case the communication with MCU is missing for a certain time, as defined in the L9963E datasheet,
the L9963E will go in sleep mode. In this section of the GUI it’s possible to graphically disable the communication
timeout controlling the comm_timeout_dis bit of the L9963E SPI register Bal_1 (for further information please see
the L9963E datasheet). To let the configuration be operative the user must follow the procedure described at the
end of Section 2.11 L9963E register management.
Figure 32. L9963E communication timeout disabling checkbox
UM2845 - Rev 1
page 16/32
3.9 PCB open wire diagnostic
GADG270520201000SA
GADG270520201002SA
This section of the GUI implements the procedure that allows to detect the loss of the cell wire at the PCB
connector. The detailed procedure is described in the L9963E datasheet.
By clicking on the “PCB open wire” button, the user will start the procedure for the loss of the cell wire at the PCB
connector detection. When the button is pressed, if the operation has been correctly accomplished the ACK LED
will be green, otherwise it will turn red. In case an open wire is detected on a cell, the corresponding LED will turn
red, otherwise it will be green.
UM2845
PCB open wire diagnostic
Figure 33. PCB open wire diagnostic
3.10 Cyclic wake up and sleep mode operation
The L9963E has the possibility of executing cyclic wake up measurements. In this section of the GUI it is possible
to configure all the related registers.
Figure 34. Cyclic wake up and sleep mode operation
By using the checkboxes and cursors it is possible to configure the fields of the L9963E registers related to the
cyclic wake up measurement: ADCV_CONV, NCYCLE_PROG_1, NCYCLE_PROG_2 on (for further information
please see the L9963E datasheet). The user can configure the parameters and then click on “Enter sleep mode”
button to send the “enter the sleep mode” set of command to the L9963E. When the button is pressed, if the
operation has been correctly accomplished the ACK LED will be green, otherwise it will turn red. If the L9963E is
in sleep mode, the LED D13 on EVAL_L9963E_MCU board will turn OFF.
UM2845 - Rev 1
page 17/32
4 Diagnostic information tab
GADG270520201003SA
GADG270520201005SA
The STSW-L9963E GUI allows the user to check the diagnostic of the L9963E. The diagnostic-information tab
is divided in two parts: one fixed with some synthetic information on cells status and another composed by five
sub-tabs.
Figure 35. Diagnostic information tab structure
UM2845
Diagnostic information tab
4.1
Synthetic cells information
The downmost part of the diagnostic information tab is a table that synthetizes some information on cells voltage.
This part of the GUI, like all the diagnostic related parts of the GUI, is operative when the user presses
the “Diagnostic once” button or checks the continuous diagnostic check box (please Section 2.9 Diagnostic
activation).
Figure 36. Synthetic cell voltage information
Figure 36. Synthetic cell voltage information it is reported the table that contains the following information:
In
• The maximum cell voltage value registered among all the cells in the measurement cycle and the cell index
where it’s measured
• The minimum cell voltage value registered among all the cells in the measurement cycle and the cell index
where it’s measured
• The maximum voltage value registered on the single cell in the measurement cycle (orange row)
• The minimum voltage value registered on the single cell in the measurement cycle (cyan row)
UM2845 - Rev 1
page 18/32
4.2 General diagnostic tab
GADG270520201006SA
GADG270520201009SA
The status of the general diagnostics of the L9963E is reported in this tab. Each LED represents a bit field of the
L9963E diagnostic registers (for further details please see the L9963E datasheet).
UM2845
General diagnostic tab
Figure 37. General diagnostic sub tab
4.3 Cell diagnostic tab
This tab reports the status of the diagnostics of the L9963E related to cells status. Each LED represents a bit field
of the L9963E diagnostic registers related to cells status. The Tab is divided in:
• Cell open diagnostics
• Cell balancing under voltage
• Balancing resistor/MOSFET open load
• Balancing resistor/MOSFET short diagnostic
For further details please see the L9963E datasheet.
Figure 38. Cells diagnostic sub tab
UM2845 - Rev 1
page 19/32
4.4 BIST results tab
GADG270520201010SA
GADG270520201011SA
This tab reports the results of the BIST operations of the L9963E. Each LED represents a bit field of the L9963E
diagnostic registers related to BIST. The tab is divided in:
• Open BIST
• Mux BIST
• BIST related to balancing comparator
• BIST related to GPIO
• The BIST related to the internal regulators’ comparators
For further details please check the L9963E datasheet.
UM2845
BIST results tab
Figure 39. BIST results sub tab
4.5 GPIO diagnostics tab
This tab reports the status of the diagnostics of the L9963E related to GPIO status. Each LED represents a bit
field of the L9963E diagnostic registers related to GPIO (for further details please see the L9963E datasheet).
Figure 40. GPIO diagnostics sub tab
UM2845 - Rev 1
page 20/32
4.6 Histogram tab
GADG270520201012SA
In this tab it’s possible to represent the cells and GPIOs voltages value in a histogram representation.
UM2845
Histogram tab
Figure 41. Cells and GPIO voltages histogram representation
The user can select the voltage to represent in the chart by selecting it in the bottom-right selector box. It’s
possible to represent all the measured cells voltage values and GPIO voltage values. In order to start the
measurement, the user has to select the checkbox “Histogram on”. In the upper-right part the progressive number
of measures are registered in the textbox marked with “#”. Minimum value, maximum value and average are
registered.
UM2845 - Rev 1
page 21/32
5 Diagnostic raw upstream frame
GADG270520201013SA
GADG270520201014SA
This tab represents with LED all the fields of raw upstream data from burst commands (0x78, 0x7A, 0x7B)’s
feedback. For further information please check the L9963E datasheet.
Figure 42. Raw upstream data of burst commands 0x78 and 0x7A (frames 1 and 2)
UM2845
Diagnostic raw upstream frame
Figure 43. Raw upstream data of burst command 0x7A (frames 3 to 8)
UM2845 - Rev 1
page 22/32
GADG270520201015SA
GADG270520201016SA
Diagnostic raw upstream frame
Figure 44. Raw upstream data of burst command 0x7A (frames 9 to 13)
UM2845
Figure 45. Raw upstream data of burst command 0x7B
UM2845 - Rev 1
page 23/32
6 STSW GUI usage example
GADG270520201017SA
In this section an example of GUI usage will be described.
6.1 HW settings
In order to follow this example, the user will need the following HW settings:
• EVAL-L9963E-MCU
• USB cable
• Power supply:
– At least 3 output 0 – 30 V (if possible 60 V):
◦ 1 output to power L9963E (0:60 V)
◦ 1 output to simulate cells common mode voltage (0:60 V)
◦ 1 output to simulate cell voltage (0:5 V)
UM2845
STSW GUI usage example
Figure 46. HW setup
6.2
UM2845 - Rev 1
In order to simulate some cells with power supply, it is necessary to follow the setup as per Figure 46. HW setup.
For further information on the set-up of the EVAL-L9963E-MCU, please see the EVAL-L9963E-MCU user manual.
GUI connection setup
In order to connect the STSW-L9963E GUI on your PC to the EVAL-L9963E-MCU you have to follow these steps:
1. Select the COM port according to your device manager. The COM led will become green.
2. Press on the “get firmware version” button to check the communication with μC and the firmware version.
The version should be 1.5.
3. In the “ID assignment” text box , it is necessary to write 1 because you are using one L9963E then press
“Configure IDs Button”, the ACK LED will become green. If the D13 LED on the board is switched OFF it will
be switched ON and will not switch OFF anymore.
page 24/32
Figure 47. GUI connection to EVAL-L9963E-MCU
GADG270520201018SA
GADG270520201144SA
UM2845
Thresholds configuration
6.3 Thresholds configuration
In order to correctly configure the cells voltage thresholds, the user has to follow these steps:
1. Go to configuration tab.
2. Select Cell overvoltage and undervoltage. i.e. UV 2.8 V and OV 4.250 V.
3. The VCELL_THRESH_UV_OV register will be automatically updated.
4. Select dev ID 1.
5. Select Write.
6. Press on the “Single write/read” button.
7. If communication with the L9963E is ok the ACK LED will become green.
Figure 48. Cell voltage thresholds configuration
UM2845 - Rev 1
page 25/32
For battery thresholds please follow these steps:
GADG270520201145SA
1. Select Battery overvoltage and undervoltage. i.e. UV 39.2 V and OV 59.5 V.
2. The VBAT_SUM_TH register will be automatically updated.
3. Select Dev ID 1.
4. Select Write.
5. Press on the “Single write/read” button.
6. If communication with the L9963E is ok the ACK LED will become green.
Figure 49. Battery voltage thresholds configuration
UM2845
Measure enabling
6.4
Measure enabling
In order to enable the measurement, the user should follow these steps:
1. Select cell voltage gauge with the EN check box. At least cells 1, 2, 13, 14 must be selected.
2. The VCELLS_EN register will be automatically updated.
3. Select dev ID 1.
4. Select write.
5. Press on the “Single write/read” button.
6. If the communication with the L9963E is ok the ACK LED will become green.
UM2845 - Rev 1
page 26/32
Figure 50. Measurement enabling
GADG270520201146SA
GADG270520201150SA
UM2845
Measurement starting
6.5 Measurement starting
In order to start measurement, the user should follow these steps:
1. Select time interval. i.e. 100 ms. This is the refresh rate of the GUI measurement.
2. Press on the “Time interval” button to apply setting. The ACK LED will became green.
3. Check the diagnostic checkbox to start the measurement.
Figure 51. Measurement starting
UM2845 - Rev 1
page 27/32
GADG270520201151SA
Measurement starting
If all the setup is correctly done the user should see the results as in Figure 52. Expected results.
Figure 52. Expected results
UM2845
At this point the user can explore other tabs, for example, the diagnostics, described in the above paragraphs.
UM2845 - Rev 1
page 28/32
Revision history
UM2845
Table 1. Document revision history
Date Revision Changes
03-Mar-2021 1 Initial release.
UM2845 - Rev 1
page 29/32
UM2845
Contents
Contents
1 Preliminary actions ................................................................2
2 GUI description....................................................................3
2.1 Voltage, current and temperature indicators ........................................3
2.1.1 IC temperature ..........................................................4
2.1.2 Configurable GPIO voltage values ...........................................5
2.1.3 Coulomb counter.........................................................5
2.1.4 Manual balancing ........................................................5
2.2 Devices ID configuration ........................................................6
2.3 GUI communication time interval configuration ......................................6
2.4 Automatic device configuration ...................................................7
2.5 Firmware version...............................................................7
2.6 Data logger ...................................................................8
2.7 Transceiver selection ..........................................................10
2.8 COM port communication.......................................................10
2.9 Diagnostic activation...........................................................11
2.10 Stop the GUI .................................................................11
2.11 L9963E register management ...................................................12
3 Configuration, PCB open wire diagnostic and sleep mode tab .....................14
3.1 GPIO thresholds configuration...................................................14
3.2 Cells and battery thresholds configuration .........................................14
3.3 Current thresholds configuration .................................................15
3.4 ADC SOC filter configuration ....................................................15
3.5 Ratiometric GPIO measurement .................................................15
3.6 ADC voltage conversion configuration ............................................16
3.7 Coulomb counter enabling ......................................................16
3.8 L9963E communication timeout disabling .........................................16
3.9 PCB open wire diagnostic ......................................................17
3.10 Cyclic wake up and sleep mode operation.........................................17
4 Diagnostic information tab........................................................18
UM2845 - Rev 1
page 30/32
UM2845
Contents
4.1 Synthetic cells information ......................................................18
4.2 General diagnostic tab .........................................................19
4.3 Cell diagnostic tab.............................................................19
4.4 BIST results tab...............................................................20
4.5 GPIO diagnostics tab ..........................................................20
4.6 Histogram tab ................................................................21
5 Diagnostic raw upstream frame ...................................................22
6 STSW GUI usage example ........................................................24
6.1 HW settings ..................................................................24
6.2 GUI connection setup ..........................................................24
6.3 Thresholds configuration .......................................................25
6.4 Measure enabling .............................................................26
6.5 Measurement starting ..........................................................27
Revision history .......................................................................29
UM2845 - Rev 1
page 31/32
UM2845
IMPORTANT NOTICE – PLEASE READ CAREFULLY
STMicroelectronics NV and its subsidiaries (“ST”) reserve the right to make changes, corrections, enhancements, modifications, and improvements to ST
products and/or to this document at any time without notice. Purchasers should obtain the latest relevant information on ST products before placing orders. ST
products are sold pursuant to ST’s terms and conditions of sale in place at the time of order acknowledgement.
Purchasers are solely responsible for the choice, selection, and use of ST products and ST assumes no liability for application assistance or the design of
Purchasers’ products.
No license, express or implied, to any intellectual property right is granted by ST herein.
Resale of ST products with provisions different from the information set forth herein shall void any warranty granted by ST for such product.
ST and the ST logo are trademarks of ST. For additional information about ST trademarks, please refer to www.st.com/trademarks. All other product or service
names are the property of their respective owners.
Information in this document supersedes and replaces information previously supplied in any prior versions of this document.
© 2021 STMicroelectronics – All rights reserved
UM2845 - Rev 1
page 32/32
Loading...