Temperature inputs

Temperature inputs on the BMS are labeled TS1, TS2, and so on. The number of inputs depends on the BMS type. For proper temperature reading, the BMS must be configured for a proper number of used inputs and their type. Also, there are several build-in temperature sensors.

info

• All mentioned variables are located in folder /driver/temp/.

TS type configuration

Each TS input has its on folder with configuration - ts1Conf/.

Using parameter /ts1Conf/conf you can configure the type of the sensor.

conf	Description
0	Disable TS input
2	Reading an all the limitation is in ohms
3	10k NTC with reading in celsius

For proper temperature reading, the Bconst parameter must be set. Check for the correct value in the datasheet of the used NTC.

warning

At least one TS input must be with conf=3. Otherwise, the BMS will go to the error state with hw_error = -4. See hardware status.

note

If a configured sensor produces an invalid reading (e.g. disconnected NTC), it is treated as overtemperature - the BMS limits the current and enters the PROTECT state. This is a fail-safe behavior.

Temperature reading

Each temperature sensor has its own reading in the folder /driver/temp/. The reading depends on the configuration of the TS input. Also, build in temperature sensors are in this folder. The raw resistance reading of each TS input is available as state R inside its configuration folder (e.g. /driver/temp/ts1Conf/R).

tip

Rule of thumb: If the variable is not present in the folder, the sensor is not present on your BMS.

Each sensor has a role which decides what happens when it is overtemperature (see temperature limitation):

• Battery sensors (ts1, ts2, ...) - limit the current and turn off the ports (PROTECT reason 0x0400)
• Switch sensors (mcu, switchptc) - limit the current and turn off the ports (PROTECT reason 0x0200)
• Balancer sensors (balmcu, ptcBal) - pause balancing only

Reading	Description	Reading in	Role
ts1	Reading of TS1 input	Celsius, ohms	Battery
ts2	Reading of TS2 input	Celsius, ohms	Battery
...	...		Battery
balmcu	Reading of balancer MCU temperature sensor	Celsius	Balancer
ptcBal	Reading of balancer limiting PTC sensor	Ohms	Balancer
mcu	Reading of main MCU temperature sensor	Celsius	Switch
switchptc	Reading of switch PTC sensor	Ohms	Switch