II. Basic configuration

The goal of this page is to configure the BMS in a way that will allow operation.

The most basic diagnostic of the BMS is through the BMS state. The state variable is located in /driver/state. Later in this guide, it will be referred to this variable as state. More about state

Mininum config

note

Without this configuration, the BMS will not allow operation.

With the default parameters, the BMS stays in state INIT.

Pack S count

Set the number of series cells in the battery pack to parameter /driver/balancing/s_count.

If the s_count do not match the actual number of series cells in the battery pack, the BMS will not allow operation.

Temperature sensors configuration

The BMS requires at least one temperature sensor connected to the BMS. The temperature sensor must be 10k NTC type.

With default parameters, the TS1 and TS2 temperature inputs are configured to the 10k NTC. The only thing to configure is "B constant" of the NTC. To do that, set these parameters to your NTC sensor B constant:

• /driver/temp/ts1Conf/Bconst
• /driver/temp/ts2Conf/Bconst

Validate the minimum configuration

• Make sure, that the BMS is connected to the battery pack as was described in the previous section.
• Save the parameters
• Reboot

After the reboot, check these values:

• /driver/state should be IDLE
• /driver/balancing/cellVoltages here you shoud read the voltages of the cells in the battery pack
• /driver/temp/ts1 and /driver/temp/ts2 should show the temperature of the connected sensors
• /driver/voltage should show the voltage of the battery pack
• /driver/currentf current of the battery pack should be under 0.1A

Other configuration

BMS accesory

Using parameter /dispmode configure the BMS accessory.

Value	Description
0	No accesory
1	WS LED and button
2	OLED display and button

note

• It is necessary to reboot the BMS after changing this parameter.
• If you do not have any accessory connected, set parameter ctlmode to 192. This enables headless mode. (BMS ports will be automatically turned ON)

BEST

Battery SOC estimator. If the parameter /driver/best/P enters the number of cells in parallel. Other default settings work for most Li-ion cells. More about BEST

note

After you configure BEST, call breset command or restart the BMS. The BEST will then restart the estimation.

Undervoltage and Overvoltage thresholds

These thresholds are set with parameter /driver/balancing/limiter/cellMinVoltage and /driver/balancing/limiter/cellMaxVoltage. The default values works for Li-ion cells.

Shortcircuit protection

The short circuit protection is by parameter /driver/ishrt. Always set the shortcircuit protection higher than ipeak parameter in the controller.

Precharge current

On BMS1 you can change a precharge current value. It is done by parameter /driver/iprch.

Synchronize RTC time

The BMS1 has a built-in RTC clock. The RTC uses the battery pack as backup power. If you disconnect the pack, you need to synchronize the RTC time again.

The BMS3 does not have an RTC clock. You can synchronize the time too, but the time will drift.

To synchronize the time, call windows command sync_time.cmd. This command is distributed with the SWTools.