Skip to main content

BMS2xx settings

Device settings​

SectionSettingDescriptionSchema values
GeneralConfig versionStructure version; read only.0–255
GeneralSerial numberUser-defined serial number.String, 32 bytes
GeneralDevice nameUser-defined device name.String, 64 bytes
LoggerEnableLog data to non-volatile memory.On / off
LoggerPeriodInterval between log entries.10–120 s
LoggerPack dataInclude sensor readings in the log.On / off
LoggerState dataInclude BMS state in the log.On / off
CAN 1 and CAN 2EnableEnable the interface independently for each bus.On / off
CAN 1 and CAN 2BaudrateCommunication speed.Auto; 125 / 250 / 500 / 800 / 1000 kbit/s
CAN 1 and CAN 2ModeBus role and protocol type.BMS; Truck; Inverter; Charger
CAN 1 and CAN 2Truck protocolProtocol used in Truck mode.Off; Noblelift V1; Noblelift V2; Noblelift V3; JAC; EP; Linde
Auto ShutdownEnableAutomatic device shutdown.On / off
Auto ShutdownIdle current thresholdCurrent below which the pack is idle.0.1–10 A
Auto ShutdownLow SOC level 1 thresholdSOC that starts the level 1 timer.0–100 %
Auto ShutdownLow SOC level 1 timeoutDelay before level 1 shutdown.60–86 400 s
Auto ShutdownLow SOC level 2 thresholdSOC that starts the critical level 2 timer.0–100 %
Auto ShutdownLow SOC level 2 timeoutDelay before level 2 shutdown.60–86 400 s
NetworkEnableEnable the network module.On / off
NetworkSNTP enableSynchronize time via SNTP.On / off
NetworkSNTP serverTime server hostname.String, 64 bytes
BLEBLE enableEnable or disable Bluetooth Low Energy interface.On / off
BLEBLE device nameBluetooth Low Energy advertised device name. Visible during BLE scanning.String, 32 bytes
Wi-FiWi-Fi enableEnable or disable Wi-Fi interface.On / off
Wi-FiWi-Fi modeWi-Fi operating mode: station (connect to AP) or softAP (host AP).Station; SoftAP
Wi-FiSSIDWi-Fi network name to connect to for cloud communication.String, 32 bytes
Wi-FiPasswordPassword for the Wi-Fi network.String, 64 bytes
Wi-FiIP addressStatic IPv4 address for the Wi-Fi interface (used when DHCP is disabled).IPv4
Wi-FiSubnet maskSubnet mask for the Wi-Fi interface.IPv4
Wi-FiGatewayDefault gateway for the Wi-Fi interface.IPv4
Wi-FiDHCPEnable DHCP to obtain IP address automatically. When enabled, static IP settings are ignored.On / off
Wi-FimDNSEnable mDNS responder on the Wi-Fi interface.On / off
Wi-FiTCP serverEnable TCP server for the BMS protocol on the Wi-Fi interface.On / off
Wi-FiHost nameHost name without .local, used for mDNS and DHCP on the Wi-Fi interface.String, 64 bytes
Wi-FiTCP portTCP port for the BMS protocol on the Wi-Fi interface.1–65 535
CellularCellular enableEnable or disable cellular interface.On / off
CellularCellular APNAccess Point Name (APN) for cellular data connection.String, 32 bytes
CellularAPN usernameUsername for APN authentication (if required by carrier).String, 32 bytes
CellularAPN passwordPassword for APN authentication (if required by carrier).String, 32 bytes
EthernetEnableEnable or disable Ethernet interface.On / off
EthernetIP addressStatic IPv4 address of the Ethernet interface.IPv4
EthernetSubnet maskSubnet mask for the Ethernet interface.IPv4
EthernetGatewayDefault gateway for the Ethernet interface.IPv4
EthernetDHCPEnable DHCP to obtain IP address automatically. When enabled, static IP settings are ignored.On / off
EthernetmDNSEnable mDNS responder on the Ethernet interface.On / off
EthernetTCP serverEnable TCP server for the BMS protocol on the Ethernet interface.On / off
EthernetHost nameHost name without .local, used for mDNS and DHCP on the Ethernet interface.String, 64 bytes
EthernetTCP portTCP port for the BMS protocol on the Ethernet interface.1–65 535
CloudCloud enableEnable or disable cloud connectivity.On / off
CloudCloud publish periodInterval between data publications to the cloud.1–3600 s
CloudMQTT broker hostHostname or IP address of the MQTT broker for cloud connectivity.String, 64 bytes
CloudMQTT broker portTCP port of the MQTT broker.1–65 535
CloudMQTT device IDMQTT client identifier, the device UID. Set by the device. Read only.String, 64 bytes
CloudMQTT secretSecret for MQTT broker authentication.String, 64 bytes
CloudDevice UUIDDevice UUID (UUIDv4 canonical form). Binds the device to a cloud account.String, 37 bytes
BMSEnableMain BMS function; read only.On / off
BMSLow SOC broadcast thresholdSOC for a low-charge warning over CAN.0–100 %
BMSVery low SOC broadcast thresholdSOC for an urgent low-charge warning over CAN.0–100 %
BMSBeep on startupStartup sound; read only.On / off

BMS settings​

SectionSettingDescriptionSchema values
GeneralConfiguration versionStructure version; read only.0–255
GeneralCell voltage sensor countNumber of cell-voltage channels used by the algorithms.1–32
GeneralTemperature sensor countNumber of temperature channels used by the algorithms.0–6
GeneralTemperature sensor typeNTC model for converting resistance to temperature.TDK B57164K0103J000 (10k, B4300); TDK B57164K0104J000 (100k, B4600); Vishay CM-0603X103F3380FB (100k, B3380)
ModelModel nameBattery model name; read only.String, 16 bytes
ModelNominal capacityCell capacity for the model and state estimation.0–10 000 Ah
ModelDischarge efficiencyCoulombic efficiency during discharge.0–100 %
ModelCharge efficiencyCoulombic efficiency during charge.0–100 %
ModelOCV-SOC table entry countNumber of active OCV–SOC table points.0–20
ModelOCV point (×20) voltageOpen-circuit voltage for OCV–SOC point.0–5000 mV
ModelOCV point (×20) SOCState-of-charge value for OCV–SOC point.0–100 %
ModelOCV point (×20) temp correctionTemperature correction coefficient for OCV–SOC point.−10–10 mV/K
ModelReference temperatureReference temperature for the model and OCV–SOC table.−40–85 °C
ModelOhmic resistanceCell ohmic resistance in the model.0–1000 mOhm
ModelDiffusion capacitanceDiffusion-branch capacitance in the model.0–4000 F
ModelDiffusion resistanceDiffusion-branch resistance in the model.0–1000 mOhm
ModelPolarization decay ratePolarization decay coefficient.0–100 %
ModelBase hysteresis voltageBase hysteresis voltage in the model.−1000–1000 mV
ModelHysteresis gainHysteresis gain in the model.−1000–1000 mV
ModelLower OCV boundLower OCV bound for simplified SOC estimation.0–5000 mV
ModelUpper OCV boundUpper OCV bound for simplified SOC estimation.0–5000 mV
State estimationMinimum SOC for resistance estimationMinimum SOC for resistance estimation.0–100 %
State estimationMaximum SOC for resistance estimationMaximum SOC for resistance estimation.0–100 %
State estimationResistance estimation window startStart of the sampling window.0–60 s
State estimationResistance estimation window endEnd of the sampling window.0–60 s
State estimationMaximum current delta for resistance estimationMaximum current change for a valid sample.0–1000 A
State estimationResistance estimate EMA factorExponential smoothing of the resistance estimate.0–255
State estimationMinimum resistance clampLower bound of the resistance estimate.0–1000 mOhm
State estimationMaximum resistance clampUpper bound of the resistance estimate.0–1000 mOhm
Power FlowIdle current thresholdAbsolute current below which the pack is idle.0–100 A
Protection and thermal comparatorsEnableEnable each comparator independently.On / off
Protection and thermal comparatorsTrip thresholdThreshold for entering the state.As listed below
Protection and thermal comparatorsTrip delayTime beyond the trip threshold before activation.0–3600 s
Protection and thermal comparatorsRelease thresholdThreshold for leaving the state.As listed below
Protection and thermal comparatorsRelease delayTime beyond the release threshold before clearing the state.0–3600 s
Primary and secondary protectionOvervoltageCell-voltage thresholds; independent for both protections.0–5000 mV
Primary and secondary protectionUndervoltageCell-voltage thresholds; independent for both protections.0–5000 mV
Primary and secondary protectionOvercurrent chargeIndependent primary and secondary protection comparators.−1000–1000 A
Primary and secondary protectionOvercurrent dischargeIndependent primary and secondary protection comparators.−1000–1000 A
Primary and secondary protectionOvertemperature chargeIndependent primary and secondary protection comparators.−40–125 °C
Primary and secondary protectionOvertemperature dischargeIndependent primary and secondary protection comparators.−40–125 °C
Primary and secondary protectionUndertemperature chargeIndependent primary and secondary protection comparators.−40–125 °C
Primary and secondary protectionUndertemperature dischargeIndependent primary and secondary protection comparators.−40–125 °C
Primary and secondary protectionOverpower chargeIndependent primary and secondary protection comparators.−1 000 000–1 000 000 W
Primary and secondary protectionOverpower dischargeIndependent primary and secondary protection comparators.−1 000 000–1 000 000 W
Primary and secondary protectionContactor overtemperatureIndependent primary and secondary protection comparators.−40–125 °C
Primary and secondary protectionConnector overtemperatureIndependent primary and secondary protection comparators.−40–125 °C
Thermal ManagementHeaterIndependent thermal control comparator.−40–125 °C
Thermal ManagementCoolerIndependent thermal control comparator.−40–125 °C
Thermal ManagementCondensation preventionIndependent thermal control comparator.−40–125 °C
BalancerBalancing strategyStrategy that determines when balancing starts.Off; Voltage top; Voltage bottom; Voltage any; SOC any
BalancerBalancing cell countNumber of cells managed by the balancer.1–32
BalancerBalance voltage thresholdCell-voltage threshold for starting balancing.0–5000 mV
BalancerBalance voltage difference tripCell-voltage difference that starts balancing.0–1000 mV
BalancerBalance voltage difference releaseCell-voltage difference that stops balancing.0–1000 mV
BalancerBalance SOC difference tripSOC difference that starts SOC-based balancing.0–100 %
BalancerBalance SOC difference releaseSOC difference that stops SOC-based balancing.0–100 %
ContactorsContactor topologyPower topology used by the contactor state machine.Main positive, load precharge: charge/discharge MOSFETs with one or two ports; separate bidirectional contactors with two ports; shared bidirectional contactor with one port.
ContactorsPrecharge timeoutMaximum precharge duration.0–60 s
ContactorsPrecharge completion thresholdVoltage ratio required to complete precharge.0–100 %
BMS Status FlagsLow SOC thresholdSOC threshold for the BSF_LOW_SOC flag.0–100 %
BMS Status FlagsHigh SOC thresholdSOC threshold for the BSF_HIGH_SOC flag.0–100 %
Discrete I/ODI1–DI4Function of each channel.Off; Charger connector; Load connector; Battery enclosure (lid/door); Battery power; Charger lid; Interlock; Main positive load aux; Main positive charger aux; Main positive aux; Main negative load aux; Main negative charger aux; Main negative aux; Precharge load aux; Precharge charger aux; Precharge aux; Emergency stop; External enable; PCS ready; Fire alarm
Discrete I/ODO1–DO4 / PDO1–PDO4Function of each channel.Off; BMS on; Discharge enabled; Charge enabled; Protection; Charger control; Low SOC; High SOC; Heater; Cooler
Discrete I/ODI / DO / PDOInvert each channel’s electrical level.On / off
ChargerCharge control modeControl law for limiting charger output.CC; CP; CCCV; CPCV
ChargerCharger protocolControl interface for the external charger.Off; Discrete on/off; PWM; CAN Faraday; CAN J1939; CAN GB/T 27930
ChargerMax charge currentMaximum current requested from the charger.0–1000 A
ChargerMax charge voltageMaximum voltage requested from the charger.0–1000 V
ChargerMax charge powerMaximum power requested from the charger.0–1 000 000 W
ChargerCharger timeoutMaximum time without communication or control updates.0–600 s
ChargerCV taper start cell voltageCell voltage at which CV current tapering starts.0–5000 mV
ChargerCV taper end cell voltageCell voltage at which tapering reaches minimum current.0–5000 mV
ChargerMin charge currentCurrent at the end of the taper region.0–1000 A