All devices

Victron Energy · Battery monitor

SmartShunt 500 A / 1000 A / 2000 A and BMV-700 / BMV-702 / BMV-712 battery monitors (battery service on a GX device) Modbus register map

Default configuration

Protocol
Modbus TCP
Port
502
Unit ID
1
Addressing
0-based
Byte order
Big endian
Word order
High word first

Register map

AddressCountNameTypeUnitScaleAccess
2562
Battery power
Int32W1R
2591
Battery voltage
UInt16V DC0.01R
2601
Starter battery voltage
UInt16V DC0.01R
2611
Current
Postive: battery begin charged. Negative: battery being discharged
Int16A DC0.1R
2621
Battery temperature
In degrees Celsius
Int16°C0.1R
2631
Mid-point voltage of the battery bank
UInt16V DC0.01R
2641
Mid-point deviation of the battery bank
UInt16%0.01R
2651
Consumed Amphours
Always negative (to have the same sign as the current).
UInt16Ah-0.1R
2661
State of charge
UInt16%0.1R
2671
Alarm
0=No alarm;2=Alarm 2015-01-19: Deprecated for CCGX. Value is always 0.
UInt16-1R
2681
Low voltage alarm
0=No alarm;2=Alarm
UInt16-1R
2691
High voltage alarm
0=No alarm;2=Alarm
UInt16-1R
2701
Low starter-voltage alarm
0=No alarm;2=Alarm
UInt16-1R
2711
High starter-voltage alarm
0=No alarm;2=Alarm
UInt16-1R
2721
Low State-of-charge alarm
0=No alarm;2=Alarm
UInt16-1R
2731
Low temperature alarm
0=No alarm;2=Alarm
UInt16-1R
2741
High temperature alarm
0=No alarm;2=Alarm
UInt16-1R
2751
Mid-voltage alarm
0=No alarm;2=Alarm
UInt16-1R
2761
Low fused-voltage alarm
0=No alarm;2=Alarm 2014-12-13: Deprecated because over-engineered. Value is always 0.
UInt16-1R
2771
High fused-voltage alarm
0=No alarm;2=Alarm 2014-12-13: Deprecated because over-engineered. Value is always 0.
UInt16-1R
2781
Fuse blown alarm
0=No alarm;2=Alarm
UInt16-1R
2791
High internal-temperature alarm
0=No alarm;2=Alarm
UInt16-1R
2801
Relay status
0=Open;1=Closed Not supported by CAN.Bus BMS batteries.
UInt16-1RW
2811
Deepest discharge
Not supported by CAN.Bus BMS batteries.
UInt16Ah-0.1R
2821
Last discharge
Not supported by CAN.Bus BMS batteries.
UInt16Ah-0.1R
2831
Average discharge
Not supported by CAN.Bus BMS batteries.
UInt16Ah-0.1R
2841
Charge cycles
Not supported by CAN.Bus BMS batteries.
UInt16-1R
2851
Full discharges
Not supported by CAN.Bus BMS batteries.
UInt16-1R
2861
Total Ah drawn
Not supported by CAN.Bus BMS batteries.
UInt16Ah-0.1R
2871
Minimum voltage
Not supported by CAN.Bus BMS batteries.
UInt16V DC0.01R
2881
Maximum voltage
Not supported by CAN.Bus BMS batteries.
UInt16V DC0.01R
2891
Time since last full charge
Not supported by CAN.Bus BMS batteries.
UInt16s100R
2901
Automatic syncs
Not supported by CAN.Bus BMS batteries.
UInt16-1R
2911
Low voltage alarms
Not supported by CAN.Bus BMS batteries.
UInt16-1R
2921
High voltage alarms
Not supported by CAN.Bus BMS batteries.
UInt16-1R
2931
Low starter voltage alarms
Not supported by CAN.Bus BMS batteries.
UInt16-1R
2941
High starter voltage alarms
Not supported by CAN.Bus BMS batteries.
UInt16-1R
2951
Minimum starter voltage
Not supported by CAN.Bus BMS batteries.
UInt16V DC0.01R
2961
Maximum starter voltage
Not supported by CAN.Bus BMS batteries.
UInt16V DC0.01R
2971
Low fused-voltage alarms
2014-12-13: Deprecated because over-engineered. Value is always 0.
UInt16-1R
2981
High fused-voltage alarms
2014-12-13: Deprecated because over-engineered. Value is always 0.
UInt16-1R
2991
Minimum fused voltage
2014-12-13: Deprecated because over-engineered. Value is always 0.
UInt16V DC0.01R
3001
Maximum fused voltage
2014-12-13: Deprecated because over-engineered. Value is always 0.
UInt16V DC0.01R
3011
Discharged Energy
Not supported by CAN.Bus BMS batteries.
UInt16kWh0.1R
3021
Charged Energy
Not supported by CAN.Bus BMS batteries.
UInt16kWh0.1R
3031
Time to go
Special value: 0 = charging. Not supported by CAN.Bus BMS batteries.
UInt16s100R
3041
State of health
Not supported by all Victron products. Supported by third-party CAN.Bus batteries and Lynx NG.
UInt16%0.1R
3051
Max charge voltage
Not supported by all Victron products. Supported by third-party CAN.Bus batteries and Lynx NG.
UInt16V DC0.1R
3061
Min discharge voltage
Not supported by all Victron products. Supported by third-party CAN.Bus batteries and Lynx NG.
UInt16V DC0.1R
3071
Max charge current
Not supported by all Victron products. Supported by third-party CAN.Bus batteries and Lynx NG.
UInt16A DC0.1R
3081
Max discharge current
Not supported by all Victron products. Supported by third-party CAN.Bus batteries and Lynx NG.
UInt16A DC0.1R
3091
Capacity
UInt16Ah0.1R
3102
Diagnostics; 1st last error timestamp
Int32-1R
3122
Diagnostics; 2nd last error timestamp
Int32-1R
3142
Diagnostics; 3rd last error timestamp
Int32-1R
3162
Diagnostics; 4th last error timestamp
Int32-1R
3181
Minimum cell temperature
Int16°C0.1R
3191
Maximum cell temperature
Int16°C0.1R
3201
High charge current alarm
0=No alarm;2=Alarm
UInt16-1R
3211
High discharge current alarm
0=No alarm;2=Alarm
UInt16-1R
3221
Cell imbalance alarm
0=No alarm;2=Alarm
UInt16-1R
3231
Internal failure alarm
0=No alarm;2=Alarm
UInt16-1R
3241
High charge temperature alarm
0=No alarm;2=Alarm
UInt16-1R
3251
Low charge temperature alarm
0=No alarm;2=Alarm
UInt16-1R
3261
Low cell voltage alarm
0=No alarm;1=Almost discharged;2=Alarm
UInt16-1R
3271
BMS Cable alarm
0=No alarm;1=Warning;2=Alarm Supported only by Lynx BMS
UInt16-1R
3281
BMS contactor resistance alarm
0=No alarm;1=Warning;2=Alarm Supported only by Lynx BMS
UInt16-1R
3291
BMS High current alarm
0=No alarm;1=Warning;2=Alarm Supported only by Lynx BMS
UInt16-1R

Read this device live with Modbus Connect, free for Windows, macOS and Linux

Related guides

Notes

A SmartShunt or BMV battery monitor has no network port: it is read as the com.victronenergy.battery service on the Modbus TCP server of the GX device (Cerbo GX, Ekrano GX, Venus GX), which the shunt reaches over VE.Direct. Addresses are the decimal addresses of Victron's CCGX Modbus TCP register list (version 3.81, the vendor-hosted workbook linked on the supplier page), used unchanged as wire addresses, and the list's 'Scalefactor' column is a divisor, so the factors here are the equivalent multipliers. The unit ID is a declared placeholder. The list's Unit ID mapping sheet has no row for this service: its only 225 is the CAN-bus BMS service, and its VE.Direct rows (226 for the Cerbo GX VE.Direct port 1, 224 for port 2, 223 for port 3, 229 and 230 for the EasySolar-II/MultiPlus-II GX, 245/243/247 and 231-239 for the older GX models and USB adapters) depend on which port the shunt is plugged into. The sheet also notes that since Venus OS 2.60 a service's unit ID normally equals its device instance and is assigned dynamically, so read the ID from Settings > Integrations > Modbus TCP server > Available services on the GX device. Left out: the older 16-bit battery-power duplicate at 258, the 32-bit consumed-Ah duplicate at 330 of register 265, the Lynx BMS / SmartLithium block from 1282 (contactor and module diagnostics that a SmartShunt or BMV never serves), and the Custom Name string at 1336. The deprecated rows 267, 276-277 and 297-300 are kept with the list's own 'Value is always 0' remark. The diagnostics rows 310-316 are 32-bit timestamps, which is why every second address is absent. The list prints no byte or word order for its 32-bit values, so HighFirst is the Modbus convention, as in the library's other Victron seeds; if a two-register reading looks word-swapped, switch the device to LowFirst. Source: Victron Energy 'CCGX-Modbus-TCP-register-list-3.81.xlsx' — version 3.81, whose 'Document versions' sheet ends at Rev 54 — on victronenergy.com.

Related devices