产品概要
描述
The STSW‑L9988‑DRV package provides the firmware device driver for the L9988 battery management IC, including:
- High‑level configuration and measurement APIs covering all main BMS features: cell monitoring, current sensing, Coulomb counter, balancing, safety thresholds, diagnostics and watchdog.
- A SPI communication layer implementing the L9988‑specific 40‑bit protocol (operation, address, frame counter, data, CRC) with error handling and unified error codes.
- An MCU wrapper abstracting hardware resources (SPI, GPIO, PWM, FCCU, delay), enabling easy migration to different microcontroller platforms while keeping the high‑level logic unchanged.
- A SW_utils module with macros and helper functions for bitfield manipulation, sign extension and measurement code interpretation, reused across the whole stack.
The driver has been developed using the SPC582B50E1 MCU as reference platform, but the separate module architecture makes the software portable to other architectures, preserving:
-
- A coherent configuration interface (thresholds in mV, currents in μV, temperatures in °C).
- Fine‑grained fault, masking and diagnostics control, suitable for automotive BMS applications.
-
性能一览
- Complete FW driver for L9988 battery management IC:
- configuration and read-out of cells, VBS, VPP, SUM, NTC, CS, CC, SC, OVC
- cell balancing management (modes, timer, cooldown, OVC during balancing)
- Modular and portable architecture:
- high-level driver module
- L9988 SPI communication module with 40‑bit frame and CRC handling
- MCU wrapper for SPI, GPIO, PWM, FCCU, delay
- utility module for bitfield handling and numeric conversions
- BMS integration and functional safety support:
- UV/OV/DEEP‑UV thresholds for cell and pack sum
- VBS/VPP, VBS‑SUM, VBS‑VPP thresholds and supply diagnostics
- current protections: OVC, SC in charge/discharge, CC‑based wake‑up
- configurable and monitored QeA/PRN watchdog
- FCCU interface supporting multiple modes (dual‑rail, time‑switch, bistable)
- CS/CC and temperature cross‑check functions
- Integrated NVM management:
- functions for NVM upload/download
- NVM upload counter and power‑down upload information
- Power state and FSM control:
- power‑up sequences through IGN/WAKE pins
- special commands SW_RST, GO2STBY, GO2SLEEP, watchdog counter reset
- Easy portability to other MCUs:
- porting limited to the L9988MCU_wrapper module (SPI/GPIO/PWM/FCCU/delay)
- usage examples for cell configuration and measurement readout
- Complete FW driver for L9988 battery management IC: