IMCInter Module Communication
v5.5.11

BMS Data

BmsData ID 2042
Payload
≥ 57 bytes, variable
Packet
≥ 79 bytes
Source
vehicle
Category
Sensors

Battery management system data returned in response to a QueryBmsData request. One message is sent per battery pack. Fields that are not applicable to the requested operation are set to zero.

#Fields

Offset FieldTypeUnitRangeDescription
0 #originalOriginal Message message<any> – –

The message that originated the request.

var #req_statusRequest Status uint8_t Enumerated –

Outcome of the request.

0BST_SUCCESSSuccess
1BST_FAILUREFailure
2BST_NOT_SUPPORTEDNot Supported
3BST_INVALID_PACKInvalid Pack
var #pack_idxPack Index uint8_t – –

Battery pack index (0-based).

var #temperatureTemperature fp32_t °C –

Pack temperature in degrees Celsius.

var #voltageVoltage fp32_t V –

Pack voltage.

var #currentCurrent fp32_t A –

Pack current (positive = charging).

var #rsocRelative State of Charge uint8_t % –

Relative state of charge.

var #asocAbsolute State of Charge uint8_t % –

Absolute state of charge.

var #sohState of Health uint8_t % –

State of health.

var #remaining_capacityRemaining Capacity uint16_t mAh –

Remaining battery capacity.

var #full_charge_capacityFull Charge Capacity uint16_t mAh –

Full charge capacity at current conditions.

var #cycle_countCycle Count uint16_t – –

Number of charge/discharge cycles.

var #time_to_emptyTime to Empty uint16_t min –

Estimated time to empty.

var #time_to_fullTime to Full uint16_t min –

Estimated time to full charge.

var #battery_statusBattery Status uint16_t Bitfield –

Raw SBS battery status register.

11 flags
0x8000BST_OCAOvercharged Alarm
0x4000BST_TCATerminate Charge Alarm
0x1000BST_OTAOvertemperature Alarm
0x0800BST_TDATerminate Discharge Alarm
0x0200BST_RCARemaining Capacity Alarm
0x0100BST_RTARemaining Time Alarm
0x0080BST_INITInitialization
0x0040BST_DSGDischarging or Rest
0x0020BST_FCFully Charged
0x0010BST_FDFully Discharged
0x0007BST_ECError Code
var #serial_numberSerial Number uint16_t – –

BMS serial number.

var #fet_statusFET Status uint16_t Bitfield –

Host FET control register state.

0x01FET_CHGCharge FET
0x02FET_DSGDischarge FET
0x04FET_PCHGPre-Charge FET
var #safety_statusSafety Status uint32_t Bitfield –

Safety Status register bitfield from the battery gauge IC.

18 flags
0x00100000SS_OCOvercharge
0x00040000SS_CTOCharge Timeout
0x00010000SS_PTOPrecharge Timeout
0x00004000SS_OCDLOvercurrent During Discharge Latch
0x00002000SS_OTFOvertemperature Fault
0x00001000SS_AFE_OVRDAFE Alert
0x00000800SS_UTDUndertemperature During Discharge
0x00000400SS_UTCUndertemperature During Charge
0x00000200SS_OTDOvertemperature During Discharge
0x00000100SS_OTCOvertemperature During Charge
0x00000080SS_ASCDLShort Circuit During Discharge Latch
0x00000040SS_ASCDShort Circuit During Discharge
0x00000020SS_AOLDLOverload During Discharge Latch
0x00000010SS_AOLDOverload During Discharge
0x00000008SS_OCDOvercurrent During Discharge
0x00000004SS_OCCOvercurrent During Charge
0x00000002SS_COVCell Overvoltage
0x00000001SS_CUVCell Undervoltage
var #pf_statusPF Status uint32_t Bitfield –

Permanent Failure Status register bitfield from the battery gauge IC.

18 flags
0x00020000PF_DFWData Flash Wearout Failure
0x00010000PF_IFCInstruction Flash Checksum Failure
0x00008000PF_SOTFSafety Overtemperature FET Failure
0x00004000PF_TS3Open Thermistor TS3 Failure
0x00002000PF_TS2Open Thermistor TS2 Failure
0x00001000PF_TS1Open Thermistor TS1 Failure
0x00000800PF_AFE_XRDYAFE XREADY Failure
0x00000400PF_AFE_OVRDAFE Override Failure
0x00000200PF_AFECAFE Communication Failure
0x00000100PF_AFERAFE Register Failure
0x00000080PF_DFETFDischarge FET Failure
0x00000040PF_CFETFCharge FET Failure
0x00000020PF_VIMRVoltage Imbalance At Rest Failure
0x00000010PF_SOTSafety Overtemperature Cell Failure
0x00000008PF_SOCDSafety Overcurrent in Discharge
0x00000004PF_SOCCSafety Overcurrent in Charge
0x00000002PF_SOVSafety Cell Overvoltage Failure
0x00000001PF_SUVSafety Cell Undervoltage Failure
var #operation_statusOperation Status uint32_t Bitfield –

Operation Status register bitfield from the battery gauge IC.

26 flags
0x80000000OS_KEYINKEYIN
0x10000000OS_CBCell Balancing
0x08000000OS_SLPCCCC Measurement in SLEEP
0x04000000OS_SLPADADC Measurement in SLEEP
0x01000000OS_INITInitialization After Full Reset
0x00800000OS_SLEEPMSLEEP Mode
0x00400000OS_XL400-kHz SMBus Mode
0x00200000OS_CAL_OFFSETCalibration Output CC
0x00100000OS_CALCalibration Output ADC and CC
0x00040000OS_AUTHAuthentication In Progress
0x00020000OS_LEDLED Display
0x00010000OS_SDMSHUTDOWN Via Command
0x00008000OS_SLEEPSLEEP Conditions Met
0x00004000OS_XCHGCharging Disabled
0x00002000OS_XDSGDischarging Disabled
0x00001000OS_PFPermanent Failure Mode
0x00000800OS_SAFE_MODESafety Mode
0x00000400OS_SDVShutdown Via Low Voltage
0x00000200OS_SEC1Security Mode SEC1
0x00000100OS_SEC0Security Mode SEC0
0x00000020OS_SAFESAFE Pin
0x00000010OS_HCFETHost FET Control
0x00000008OS_PCHGPrecharge FET
0x00000004OS_DSGDSG FET
0x00000002OS_CHGCHG FET
0x00000001OS_PRESSystem Present Low
var #charging_statusCharging Status uint16_t Bitfield –

Charging Status register bitfield from the battery gauge IC.

10 flags
0x8000CS_VCTCharge Termination
0x2000CS_SUCharge Suspend
0x1000CS_INCharge Inhibit
0x0200CS_FCHGFast Charge Mode
0x0100CS_PCHGPre-Charge Mode
0x0010CS_OTOvertemperature Region
0x0008CS_HTHigh Temperature Region
0x0004CS_STStandard Temperature Region
0x0002CS_LTLow Temperature Region
0x0001CS_UTUndertemperature Region
var #gauging_statusGauging Status uint16_t Bitfield –

Gauging Status register bitfield from the battery gauge IC.

13 flags
0x8000GS_VDQDischarge Qualified for Learning
0x4000GS_EDV2End-of-Discharge Voltage Level 2
0x2000GS_EDV1End-of-Discharge Voltage Level 1
0x0400GS_FCCXFull Charge Capacity Updated
0x0100GS_RESTRest
0x0080GS_CFCondition Flag
0x0040GS_DSGDischarge or Relax
0x0020GS_EDV0End-of-Discharge Voltage Level 0
0x0010GS_BAL_OKCell Balancing Possible
0x0008GS_TCTerminate Charge
0x0004GS_TDTerminate Discharge
0x0002GS_FCFully Charged
0x0001GS_FDFully Discharged
var #cell_voltagesCell Voltages message-list<BmsCellVoltage> – –

Individual cell voltages (populated for READ_CELL_VOLTAGES and READ_ALL).

var #registersRegisters message-list<BmsRegister> – –

Arbitrary SBS register values. Each entry carries a register address and its raw value, allowing the handler to expose new registers without protocol changes. Populated alongside the typed fields for READ_TELEMETRY, READ_STATUS and READ_ALL; always populated for READ_RAW.

var #dataData rawdata – –

Raw response data for READ_RAW / WRITE_RAW operations.