ST STSW-L9961BMS User manual

ST Confidential
Quick Start Guide
for
STSW-L9961BMS
Software package for the STEVAL-L99615C kit -
L9961 industrial battery management system

ST Confidential
STSW-L9961BMS Software package

ST Confidential
• 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
• Application demos exploiting the key-features of the L9961 ICs
• Architecture compatible with STM32Cube Firmware BSP
specification
• Use of a serial communication terminal to output data
• Contains demonstration project released for:
• STM32CubeIDE v.1.13.1
• EWARM (IAR) v. 9.20
• uVision (Keil) v. 5.38
Key topics of the
STSW-L9961BMS Software package

ST Confidential
Main SW functional layers are:
1. Hardware abstraction divided in
•STM32CubeG0 HAL and LL Hardware
Abstraction Layer for the STM32G0
microcontroller
•Board Support Package (BSP) library layer
containing the drivers of:
• the L9961 component device
• the STEVAL-L99615C expansion board
• the NUCLEO-G071RB board
2. Application
•Battery status monitoring demonstrating the
acquisition of voltage, current and temperature
from a battery pack made up of 5 cells
•Coulomb counting mechanism monitoring the
charges flowing through the battery cells
STSW-L9961BMS Software Architecture
STEVAL-L99615C
STM32CubeG0 HAL / LL
Hardware
Hardware
Abstraction
Applications &
demonstration
STM32G071RB L9961
STEVAL-L99615C
BSP
L9961
Component
NUCLEO-G071RB
BSP
Board Support
Package
Battery status monitoring
(voltage, current and temperature) Coulomb counting

ST Confidential
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. Go-to-
Normal, Change Address, Enable/Disable CRC,…)
• the STEVAL-L99615C expansion board support package that
manages the configurations of the HW peripheral and GPIOs used by
the application
• the NUCLEO-G071RB Nucleo board support package containing a
set of minor functions connected to the microcontroller board
STSW-L9961BMS: BSP drivers

ST Confidential
STSW-L9961BMS
Application Demos

ST Confidential
• 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
− App Demo #2 - Coulomb counting
• Each demo is selectable through the project
compiler options and exploits the serial
communication peripheral to return specific output
data
Application Demos

ST Confidential
• 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.
STSW-L9961BMS output data viewers
VT100 User Interface
data logger
CSV format data logger

ST Confidential
•The Application Demos and their related functions are
fully described in the 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
functionalities
STSW-L9961BMS Doxy file

ST Confidential
STEVAL-L99615C
Kit Overview

ST Confidential
STSW-L99615C SW GUI
− Demonstrating L9961 BMS IC performances and
features with external 5-cell battery pack or with on-
board pack simulation
− Kit main components:
•STEVAL-L99615C:NUCLEO-G071RB development
board with STM32G071RB MCU + STEVAL-L99615CX
expansion board integrating the L9961 5-cell BMS IC
•STSW-L99615C(*)SW GUI uses the PC serial
communication to interface with the STM32
microcontroller and L9961
•STSW-L9961BMS(*)SW package, containing source
code and binaries, with standalone FW driver and
application examples
STEVAL-L99615C evaluation kit
11
STEVAL-L99615C
(*): 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
STEVAL-L99615C at a glance!
Morpho connectors
STM32G071RB
application MCU
NUCLEO-G071RB STEVAL-L99615CX
(top view)
STEVAL-L99615CX
(bottom view)
L9961
5-cell BMS IC
HS and LS
pack relays
Battery pack
connector
ST-Link V2
embedded
programmer
Cells
connector
On-board
Battery simulation
stage

ST Confidential
Application Demo #1:
Battery status monitoring

ST Confidential
•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
•The Demo acquires:
•the voltage on each cell
•the voltage on the whole battery pack
•the current flowing in the cell series
•the temperature acquired by the NTC
•the temperature measured on the die
•The demo outputs the collected data through a serial
communication terminal
STSW-L9961BMS:
Application Demo #1
Application
Core, User and
Startup files

ST Confidential
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,
1 A) to feed the STEVAL-L99615C kit(**)(in case
real batteries are not available)
•a laptop with the serial communication terminal
already installed (Tera Term console, for example)
Application Demo #1 setup
(*): to run the Application Demo #1, it is assumed to use the 5-cell battery emulating circuitry embedded in the expansion board, coupled with the external
power supply that simulates the battery voltage.
(**): to facilitate the connection of the power supply, equip it with a two or four position plug 7.62MM connector as the Wurth 691351400002 or
691351400004.

ST Confidential
•Verify that the setting of the STEVAL-L99615C jumpers respects
the configuration depicted in the picture and reported in the
following Table
Application Demo #1: jumpers' setup

ST Confidential
• Thanks to its design, the STEVAL-L99615C permits to
simulate a 5-cell battery pack simply applying a voltage, by
an external power supply, to the CN2 connector
• In fact, a network composed of a series of 5
resistance/capacitance parallel, integrated in the kit
expansion board, acts by emulating the 5 cells of a battery
pack
• When voltage is applied, it is equally distributed by the
series. 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
How the STEVAL-L99615C
emulates a 5-cell battery pack
STEVAL-L99615C expansion board
battery emulator schematic

ST Confidential
• For demonstrating how the L9961 measures the temperature of a
battery pack via NTC, the STEVAL-L99615C embeds a variable
resistor (referred to the internal LDO voltage)
• That permits to emulate how the resistor value changes (actually
through a screwdriver) to a hypothetical temperature change
• So, as a standard NTC, the decrease of electrical resistance value
(mechanically happens) corresponding to the acquired voltage
increase, may be referred to the temperature rising
• Vice versa, the increase of the resistance value corresponding to
the acquired voltage decrease refers to the temperature decrease
• This mechanism also enables the demonstration of over/under
temperature detection operation carried out by the L9961
How the STEVAL-L99615C
emulates the NTC acquisition
STEVAL-L99615C expansion board
NTC simulator schematic and on-board position
L9961
R15 variable
resistor
emulating an
NTC

ST Confidential
•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
•This operation permits to directly program the on-board STM32G071RB microcontroller of the NUCLEO-
G071RB
Application Demo #1: programming
(*): .elf file upload operation must be operated by STM32CubeProgrammer tool.

ST Confidential
Application Demo #1: power up
1. Connect the STEVAL-L99615C kit to the laptop
using the USB Type-A to Micro-B cable
2. 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)