adbms.c File Reference

Primary logic and interface for ADBMS battery management system driver. More...

#include "adbms.h"
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include <string.h>
#include "adbms6380.h"
#include "commands.h"
#include "common/phal/spi.h"
#include "common/strbuf/strbuf.h"
#include "thermistor.h"

Functions
void	adbms_init (adbms_bms_t *bms, SPI_InitConfig_t *spi, uint8_t *tx_buf)
	Initialize the ADBMS driver instance and TX buffer.
bool	adbms_write_rega (adbms_bms_t *bms)
	Calculate and write REGA configuration to all modules.
bool	adbms_write_regb (adbms_bms_t *bms)
	Calculate and write REGB configuration to all modules.
bool	adbms_read_and_check_rega (adbms_bms_t *bms)
	Read back REGA and compare with cached configuration.
bool	adbms_read_and_check_regb (adbms_bms_t *bms)
	Read back REGB and compare with cached configuration.
void	adbms_connect (adbms_bms_t *bms)
	Perform the connect/bring-up sequence for all modules.
void	adbms_calculate_balance_cells (adbms_bms_t *bms, float min_voltage, float min_delta)
	Compute per-cell discharge flags based on pack voltage spread.
void	adbms_balance_and_update_regb (adbms_bms_t *bms, float min_voltage, float min_delta)
	Compute discharge flags and write REGB to apply balancing.
void	adbms_read_cells (adbms_bms_t *bms)
	Read all cell voltages and update module/pack statistics.
void	adbms_read_therms (adbms_bms_t *bms)
	Read all GPIO/thermistor values (voltage and calculate temperature) and update module/pack statistics.
void	adbms_periodic (adbms_bms_t *bms, float min_voltage_for_balance, float min_delta_for_balance)
	Periodic service routine for connection, measurements, and balancing.

Detailed Description

Primary logic and interface for ADBMS battery management system driver.

Author

Millan Kumar (kumar.nosp@m.798@.nosp@m.purdu.nosp@m.e.ed.nosp@m.u)

Function Documentation

adbms_balance_and_update_regb()

void adbms_balance_and_update_regb	(	adbms_bms_t *	bms,
		float	min_voltage,
		float	min_delta )

Compute discharge flags and write REGB to apply balancing.

Calls adbms_calculate_balance_cells(), writes REGB, and verifies it.

Parameters

bms	Pointer to driver state.
min_voltage	Minimum pack voltage required to allow balancing.
min_delta	Voltage delta above minimum to start discharging.

adbms_calculate_balance_cells()

void adbms_calculate_balance_cells	(	adbms_bms_t *	bms,
		float	min_voltage,
		float	min_delta )

Compute per-cell discharge flags based on pack voltage spread.

If balancing is disabled, clears all discharge flags. If the pack minimum voltage is below min_voltage, no balancing occurs. Otherwise, discharges cells above (min + delta).

Parameters

bms	Pointer to driver state.
min_voltage	Minimum pack voltage required to allow balancing.
min_delta	Voltage delta above minimum to start discharging.

adbms_connect()

void adbms_connect

(

adbms_bms_t *

bms

)

Perform the connect/bring-up sequence for all modules.

Writes REGA/REGB, verifies read-back, and starts ADCV conversions.

Parameters

bms	Pointer to driver state.

adbms_init()

void adbms_init	(	adbms_bms_t *	bms,
		SPI_InitConfig_t *	spi,
		uint8_t *	tx_buf )

Initialize the ADBMS driver instance and TX buffer.

Sets the driver state to idle, clears discharge flags (and discharged enabled), and sets the provided SPI config and TX buffer into the internal strbuf.

Parameters

bms	Pointer to driver state to initialize.
spi	SPI configuration used for ADBMS transactions.
tx_buf	Backing buffer for TX command/data packets.

adbms_periodic()

void adbms_periodic	(	adbms_bms_t *	bms,
		float	min_voltage_for_balance,
		float	min_delta_for_balance )

Periodic service routine for connection, measurements, and balancing.

If idle, attempts to connect. When connected, reads cells and thermistors, then updates balancing + REGB.

Parameters

bms	Pointer to driver state.
min_voltage_for_balance	Minimum pack voltage required to allow balancing.
min_delta_for_balance	Voltage delta above minimum to start discharging.

adbms_read_and_check_rega()

bool adbms_read_and_check_rega

(

adbms_bms_t *

bms

)

Read back REGA and compare with cached configuration.

Sets per-module and aggregated mismatch flags when the read-back does not match the cached REGA data.

Parameters

bms	Pointer to driver state.

Returns

False on SPI failure, PEC error, or when there is a mismatch; true otherwise.

adbms_read_and_check_regb()

bool adbms_read_and_check_regb

(

adbms_bms_t *

bms

)

Read back REGB and compare with cached configuration.

Sets per-module and aggregated mismatch flags when the read-back does not match the cached REGB data.

Parameters

bms	Pointer to driver state.

Returns

False on SPI failure, PEC error, or when there is a mismatch; true otherwise.

adbms_read_cells()

void adbms_read_cells

(

adbms_bms_t *

bms

)

Read all cell voltages and update module/pack statistics.

Updates per-module min/max/avg/sum and aggregated min/max/avg/sum for the full pack.

Parameters

bms	Pointer to driver state.

adbms_read_therms()

void adbms_read_therms

(

adbms_bms_t *

bms

)

Read all GPIO/thermistor values (voltage and calculate temperature) and update module/pack statistics.

Updates per-module min/max/avg for thermistor temperatures and aggregated min/max/avg for the full pack.

Parameters

bms	Pointer to driver state.

adbms_write_rega()

bool adbms_write_rega

(

adbms_bms_t *

bms

)

Calculate and write REGA configuration to all modules.

Parameters

bms	Pointer to driver state.

Returns

True on successful SPI transfer, false on failure.

adbms_write_regb()

bool adbms_write_regb

(

adbms_bms_t *

bms

)

Calculate and write REGB configuration to all modules.

Computes REGB with OV/UV thresholds and discharge flags, then writes the configuration to all modules.

Parameters

bms	Pointer to driver state.

Returns

True on successful SPI transfer, false on failure.