BMS Main 2.x - Modbus RTU-TCP Protocol (ENG)
BMS Main 2.x - Modbus RTU-TCP Protocol (ENG)
Modbus protocol
Revision 5 (24–October–2023)
Contents
General information ................................................................................................................... 3
Contacts ...................................................................................................................................... 27
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 2
General information
The BMS Main 2.x board provides the information about the battery system using
Modbus protocol. The BMS is a Modbus-server and it responds to the Modbus-client’s
commands.
Interaction with the board is performed over the RS-485 bus (Modbus RTU) or the
Ethernet network (Modbus TCP).
• baud rate, bps — 600, 1200, 2400, 4800, 9600 (by default), 19200, 38400, 57600,
115200;
• word length, bits — 8;
• parity — none;
• board address (by default) — 32.
• port — 502.
There is a description of the Input и Holding registers below. Column "Type" contains
method of parameters coding:
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 4
Input registers
Register Number of
Content Type
address registers
Hardware version:
byte 1 — major.
Firmware version:
byte 0 — patch;
0x0001-
2 byte 1 — minor; U8[4]
0x0002
byte 2 — major;
Bootloader version:
byte 0 — patch;
0x0003-
2 byte 1 — minor; U8[4]
0x0004
byte 2 — major;
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 5
Discrete input signals (bitfield):
0x2001-
2 Current, А REAL32
0x2002
0x2003-
2 External temperature, °C REAL32
0x2004
0x2005-
2 Humidity, RH% REAL32
0x2006
Errors 1 (bitfield):
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 6
bit 8 — error "Logic high temperature";
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 7
bits 30-31 – not used.
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 8
bit 18 — shutdown acknowledge;
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 9
bit 0 — error "Low CH temperature";
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 10
bits 8-15 — not used.
0x2012-
2 Board temperature, °C REAL32
0x2013
0x202A-
40 Array of cells voltages (V) REAL32[20]
0x2051
0x2052-
40 Array of cells temperatures (°C) REAL32[20]
0x2079
0x207A-
40 Array of cells SOCs (%) REAL32[20]
0x20A1
0x20A2-
40 Array of cells resistances (Ohm) REAL32[20]
0x20C9
0x2100-
2 Battery state of charge (SOC), % REAL32
0x2101
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 11
0x2102 1 Number of BMS Logic boards U16
0x2104-
2 Battery voltage, V REAL32
0x2105
0x2106-
2 Battery resistance, Ohm REAL32
0x2107
0x2108-
2 Effective capacity, A×h REAL32
0x2109
0x210A-
2 Balancing effectivity, % REAL32
0x210B
0x210C-
2 State of health, % REAL32
0x210D
0x210E-
2 Depth of discharge, A×h REAL32
0x210F
0x2110-
2 Minimum BMS Logic temperature REAL32
0x2111
0x2113-
2 Maximum BMS Logic temperature REAL32
0x2114
0x2116-
2 BMS Logic polling rate, commands pre second REAL32
0x2117
0x2118-
2 Minimum cell temperature REAL32
0x2119
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 12
Address of the BMS Logic board which is
0x211A 1 connected to the cell whose temperature is U16
minimal
0x211C-
2 Maximum cell temperature REAL32
0x211D
0x2120-
2 Minimum cell voltage REAL32
0x2121
0x2124-
2 Maximum cell voltage REAL32
0x2125
Error flag:
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 13
J1939 charger state (bitfield):
bit 4 — offline;
0x2130-
2 Energy received from the charger, W×h REAL32
0x2131
0x2132-
2 Energy consumed by the load, W×h REAL32
0x2133
0x2134-
2 Energy dissipated by the balancing resistors, W×h REAL32
0x2135
1 — mounted.
1 — no charging;
3 — recoverable error;
4 — nonrecoverable error.
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 14
0x2152 1 Eltek output current, 0,1A/bit U16
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 15
bits 18-31 — not used.
1 — connection is established.
0x2171-
2 IP-address in the Wi-Fi network U8[4]
0x2172
0x2173-
3 MAC-address of the Wi-Fi module U8[6]
0x2175
1 — online.
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 16
0x217A
0x217B-
2 Coulomb received from the charger, A×h REAL32
0x217C
0x217D-
2 Coulomb consumed by the load, A×h REAL32
0x217E
0x217F-
2 Ethernet IP-address U8[4]
0x2180
0x2181-
2 Ethernet netmask U8[4]
0x2182
0x2183-
2 Ethernet gateway U8[4]
0x2184
0x2185-
2 Current zero level, V REAL32
0x2186
1 — online.
0 — no actions;
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 17
0x218B 1 Combilift truck feedback U16
1 — online.
1 — online.
0 — no actions;
1 — starting bootloader;
0x2196 1 U16
2 — bootloader is started;
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 18
1 — online.
1 – online.
1 – online.
1 – online.
1 – online.
1 – online.
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 19
Timestamp format:
0x2204-
4 Record #2 from the errors journal U32[2]
0x2207
0x2208-
Records #3-31 from the errors journal
0x227B
0x227C-
4 Record #32 from the errors journal U32[2]
0x227F
0x2384-
4 Record data #2 from the errors journal U32[2]
0x2387
0x2388-
Records data #3-31 from the errors journal
0x23FB
0x23FC-
4 Record data #32 from the errors journal U32[2]
0x23FF
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 20
Final battery current, A
Battery state:
0 – Unknown;
1 – Charging ON;
2 – Charging OFF;
0x2410 1 U16
3 – Relaxed (after charging);
4 – Discharging ON;
5 – Discharging OFF;
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 21
Holding registers
Register Number of
Content Type
address registers
Notes:
0x4100 2 U32
1 – After the errors are acknowledged, the register
value will be set to 0.
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 22
1 – set the signal;
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 23
Software control of the "Insulation status" signal.
Allowable values:
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 24
feedback".
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 25
0 – clear the signal;
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 26
Contacts
Movicom Electric
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 27
Revision history
Movicom Electric
BMS Main 2.x – Modbus protocol. Revision 5 (24-October-2023) 28