Page 1
Quick Start Guide STSW-L9961BMS Software package for the STEVAL-L99615C kit - L9961 industrial battery management system ST Confidential...
Page 2
STSW-L9961BMS Software package ST Confidential...
Page 3
Key topics of the STSW-L9961BMS Software package • Software package specifically designed for the STEVAL-L99615C kit to demonstrate the capabilities of the L9961 industrial BMS IC • Includes the L9961 driver component, along with its register map and related basic APIs •...
Page 4
STSW-L9961BMS Software Architecture Main SW functional layers are: 1. Hardware abstraction divided in Applications & Battery status monitoring Coulomb counting • STM32CubeG0 HAL and LL Hardware demonstration (voltage, current and temperature) Abstraction Layer for the STM32G0 microcontroller Board Support L9961...
Page 5
STSW-L9961BMS: BSP drivers The Board Support Package comprises the following drivers: • the L9961 component device, including the register map of the device, the basic functions to manage registers at bit level, the write/read functions (single-register and multi-registers), and the APIs to configure the device and manage its functionalities (i.e.
Page 6
STSW-L9961BMS Application Demos ST Confidential...
Page 7
Application Demos • The STSW-L9961BMS package contains some application demos that, when running within the STEVAL-L99615C, allow for the evaluation of the features and performances of the L9961 • The Application Demos are: − App Demo #1 - Battery status monitoring −...
Page 8
STSW-L9961BMS output data viewers • Different viewer layouts allow live monitoring of the acquired data and elaborated data. For the viewer selection, you may use the keyboard 1, 2 and 3 keys or press the Nucleo blue button for a long time.
Page 9
Application User source and header files of the project • The project directory, in the Documentation sub-directory, contains the STSW-L9961BMS.chm Doxygen file • The Doxy file enriches the code with relevant information about STSW-L9961BMS firmware architecture and...
Page 11
FW driver and application examples STSW-L99615C SW GUI : the GUI contained in the STSW-L96615C is exclusive to the FW contained in the same SW package and cannot be used with the one of the STSW-L9961BMS packages. ST Confidential...
Page 12
STEVAL-L99615C at a glance! STEVAL-L99615CX L9961 NUCLEO-G071RB (top view) 5-cell BMS IC ST-Link V2 On-board embedded Battery simulation programmer stage Cells connector STM32G071RB application MCU STEVAL-L99615CX (bottom view) HS and LS pack relays Battery pack connector Morpho connectors ST Confidential...
Page 13
Application Demo #1: Battery status monitoring ST Confidential...
Page 14
STSW-L9961BMS: Application Demo #1 • The Application Demo #1 demonstrates the L9961's capability to monitor the characteristics of a 5-cell battery pack, both as a whole and for each individual cell Application • The Demo acquires: Core, User and Startup files •...
Page 15
To set up the demo and run the application with the evaluation kit, the following items are required: • a STEVAL-L99615C kit • the STSW-L9961BMS software package • a USB Type-A to Micro-B cable • a portable power supply (for example, up to 20 V,...
Page 16
Application Demo #1: jumpers' setup • Verify that the setting of the STEVAL-L99615C jumpers respects the configuration depicted in the picture and reported in the following Table ST Confidential...
Page 17
Thus, the Application Demo 1 acquires the voltages on each resistance representing the Cell voltages (Vcell1, …, Vcell5) • To enable the internal 5-cell emulation network, verify the headers are fit on the J5 jumpers in the STEVAL-L99615C expansion board ST Confidential...
Page 18
• Vice versa, the increase of the resistance value corresponding to the acquired voltage decrease refers to the temperature decrease R15 variable resistor emulating an • This mechanism also enables the demonstration of over/under temperature detection operation carried out by the L9961 L9961 ST Confidential...
Page 19
Connect the NUCLEO board of the STEVAL-L99615C kit to the laptop through the USB cable • Drag and drop the Demo1 binary file of the STSW-L9961BMS application firmware , from the origin folder to the NUCLEO that has been mapped by the laptop OS as an external peripheral •...
Page 20
Connect the power supply terminals to the B+ and B- pins of the battery pack connector (CN2), and power on the appliance (in the example, the power supply has been set 12 V, 1 A as test rating) ST Confidential...
Page 21
Application Demo #1: running • Once programmed and set-up the serial communication console (COM speed: 115200) to display the output data, select the proper viewer layout ST Confidential...
Page 22
(in our example VB is the power supply voltage). Battery current Current is the current flowing from/on the battery pack (null when no load connected) • Temperature is dually expressed, by the external NTC and by the Die Temperature DIE internal sensor (DieTemp) ST Confidential...
Page 23
• Application Demo 1 has been set to release an Alert message when relevant events occur (for example, when the NTC OverTemperature Threshold is exceeded) • In fact, turning the NTC screw clockwise, its value decreases and when it reaches 900mV, the demo releases a Fault message indicating the cause (NTC_OT), while the Fault character becomes F ST Confidential...
Page 24
Application Demo #1: Output messages in Fault acquisition (2/2) • Turning counterclockwise, till the NTC value exceeds the 900mV, a new message indicating the fault cleaned is released and the Fault character goes back to N ST Confidential...
Page 25
Application Demo #2: Coulomb counting ST Confidential...
Page 26
STSW-L9961BMS: Application Demo #2 • The Application Demo #2 utilizes the Coulomb counting mechanism integrated in the L9961 device, to measure the charges flowing through the five cells composing a battery pack • This demo estimates the initial residual charge of the...
Page 27
To set up the demo and run the application with the evaluation kit, the following items are required: • a STEVAL-L99615C kit • the STSW-L9961BMS software package; • a USB Type-A to Micro-B cable • a battery pack composed of five 18650 cells and related connecting cables •...
Page 28
Application Demo #2: jumpers' setup • Verify that the setting of the STEVAL-L99615C jumpers respects the configuration depicted in the picture and reported in the following Table ST Confidential...
Page 29
J17 and J18 headers with jumpers to 1-2 load switches position • Moreover, it’s necessary to open all the jumpers from J5 headers to exclude the internal passive network that emulates the battery cells on the expansion board ST Confidential...
Page 30
Connect the NUCLEO board of the STEVAL-L99615C kit to the laptop through the USB cable • Drag and drop the Demo2 binary file of the STSW-L9961BMS application firmware , from the origin folder to the NUCLEO that has been mapped by the laptop OS as an external peripheral •...
Page 31
(and set COM speed @ 115200) : to properly run the demo measuring a significant amount of current (at least 10mA), it is suggested to connect to the battery holder CN3 connector a resistance of 2,2kΩ. Otherwise an electronic load is suggested. ST Confidential...
Page 32
: this demo was run with the battery holder board hosting five LG Chem INR18650-MJ1 cells, and a programmable electronic load connected to its CN3 connector, sinking 500mA : The L9961 Coulomb counting mechanism is described in all its components in paragraph 3.5.2 of the DS14012 datasheet. ST Confidential...
Need help?
Do you have a question about the STSW-L9961BMS and is the answer not in the manual?
Questions and answers