{
  "spec_version": 1,
  "slug": "victron-smartshunt-bmv-battery-monitor",
  "manufacturer": "Victron Energy",
  "model": "SmartShunt 500 A / 1000 A / 2000 A and BMV-700 / BMV-702 / BMV-712 battery monitors (battery service on a GX device)",
  "category": "Battery monitor",
  "supplier_url": "https://www.victronenergy.com/support-and-downloads/technical-information",
  "default_configuration": {
    "protocol": "modbus_tcp",
    "port": 502,
    "unit_id": 1,
    "addressing": "zero_based",
    "byte_order": "BigEndian",
    "word_order": "HighFirst"
  },
  "coils": [],
  "discrete_inputs": [],
  "input_registers": [],
  "holding_registers": [
    {
      "address": 256,
      "count": 2,
      "name": "Battery power",
      "data_type": "Int32",
      "units": "W",
      "scale_factor": 1,
      "offset": 0,
      "access": "R"
    },
    {
      "address": 259,
      "count": 1,
      "name": "Battery voltage",
      "data_type": "UInt16",
      "units": "V DC",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R"
    },
    {
      "address": 260,
      "count": 1,
      "name": "Starter battery voltage",
      "data_type": "UInt16",
      "units": "V DC",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R"
    },
    {
      "address": 261,
      "count": 1,
      "name": "Current",
      "data_type": "Int16",
      "units": "A DC",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Postive: battery begin charged. Negative: battery being discharged"
    },
    {
      "address": 262,
      "count": 1,
      "name": "Battery temperature",
      "data_type": "Int16",
      "units": "°C",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "In degrees Celsius"
    },
    {
      "address": 263,
      "count": 1,
      "name": "Mid-point voltage of the battery bank",
      "data_type": "UInt16",
      "units": "V DC",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R"
    },
    {
      "address": 264,
      "count": 1,
      "name": "Mid-point deviation of the battery bank",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R"
    },
    {
      "address": 265,
      "count": 1,
      "name": "Consumed Amphours",
      "data_type": "UInt16",
      "units": "Ah",
      "scale_factor": -0.1,
      "offset": 0,
      "access": "R",
      "description": "Always negative (to have the same sign as the current)."
    },
    {
      "address": 266,
      "count": 1,
      "name": "State of charge",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R"
    },
    {
      "address": 267,
      "count": 1,
      "name": "Alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm 2015-01-19: Deprecated for CCGX. Value is always 0."
    },
    {
      "address": 268,
      "count": 1,
      "name": "Low voltage alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 269,
      "count": 1,
      "name": "High voltage alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 270,
      "count": 1,
      "name": "Low starter-voltage alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 271,
      "count": 1,
      "name": "High starter-voltage alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 272,
      "count": 1,
      "name": "Low State-of-charge alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 273,
      "count": 1,
      "name": "Low temperature alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 274,
      "count": 1,
      "name": "High temperature alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 275,
      "count": 1,
      "name": "Mid-voltage alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 276,
      "count": 1,
      "name": "Low fused-voltage alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm 2014-12-13: Deprecated because over-engineered. Value is always 0."
    },
    {
      "address": 277,
      "count": 1,
      "name": "High fused-voltage alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm 2014-12-13: Deprecated because over-engineered. Value is always 0."
    },
    {
      "address": 278,
      "count": 1,
      "name": "Fuse blown alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 279,
      "count": 1,
      "name": "High internal-temperature alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 280,
      "count": 1,
      "name": "Relay status",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0=Open;1=Closed Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 281,
      "count": 1,
      "name": "Deepest discharge",
      "data_type": "UInt16",
      "units": "Ah",
      "scale_factor": -0.1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 282,
      "count": 1,
      "name": "Last discharge",
      "data_type": "UInt16",
      "units": "Ah",
      "scale_factor": -0.1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 283,
      "count": 1,
      "name": "Average discharge",
      "data_type": "UInt16",
      "units": "Ah",
      "scale_factor": -0.1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 284,
      "count": 1,
      "name": "Charge cycles",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 285,
      "count": 1,
      "name": "Full discharges",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 286,
      "count": 1,
      "name": "Total Ah drawn",
      "data_type": "UInt16",
      "units": "Ah",
      "scale_factor": -0.1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 287,
      "count": 1,
      "name": "Minimum voltage",
      "data_type": "UInt16",
      "units": "V DC",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 288,
      "count": 1,
      "name": "Maximum voltage",
      "data_type": "UInt16",
      "units": "V DC",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 289,
      "count": 1,
      "name": "Time since last full charge",
      "data_type": "UInt16",
      "units": "s",
      "scale_factor": 100,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 290,
      "count": 1,
      "name": "Automatic syncs",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 291,
      "count": 1,
      "name": "Low voltage alarms",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 292,
      "count": 1,
      "name": "High voltage alarms",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 293,
      "count": 1,
      "name": "Low starter voltage alarms",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 294,
      "count": 1,
      "name": "High starter voltage alarms",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 295,
      "count": 1,
      "name": "Minimum starter voltage",
      "data_type": "UInt16",
      "units": "V DC",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 296,
      "count": 1,
      "name": "Maximum starter voltage",
      "data_type": "UInt16",
      "units": "V DC",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 297,
      "count": 1,
      "name": "Low fused-voltage alarms",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "2014-12-13: Deprecated because over-engineered. Value is always 0."
    },
    {
      "address": 298,
      "count": 1,
      "name": "High fused-voltage alarms",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "2014-12-13: Deprecated because over-engineered. Value is always 0."
    },
    {
      "address": 299,
      "count": 1,
      "name": "Minimum fused voltage",
      "data_type": "UInt16",
      "units": "V DC",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R",
      "description": "2014-12-13: Deprecated because over-engineered. Value is always 0."
    },
    {
      "address": 300,
      "count": 1,
      "name": "Maximum fused voltage",
      "data_type": "UInt16",
      "units": "V DC",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R",
      "description": "2014-12-13: Deprecated because over-engineered. Value is always 0."
    },
    {
      "address": 301,
      "count": 1,
      "name": "Discharged Energy",
      "data_type": "UInt16",
      "units": "kWh",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 302,
      "count": 1,
      "name": "Charged Energy",
      "data_type": "UInt16",
      "units": "kWh",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 303,
      "count": 1,
      "name": "Time to go",
      "data_type": "UInt16",
      "units": "s",
      "scale_factor": 100,
      "offset": 0,
      "access": "R",
      "description": "Special value: 0 = charging. Not supported by CAN.Bus BMS batteries."
    },
    {
      "address": 304,
      "count": 1,
      "name": "State of health",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by all Victron products. Supported by third-party CAN.Bus batteries and Lynx NG."
    },
    {
      "address": 305,
      "count": 1,
      "name": "Max charge voltage",
      "data_type": "UInt16",
      "units": "V DC",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by all Victron products. Supported by third-party CAN.Bus batteries and Lynx NG."
    },
    {
      "address": 306,
      "count": 1,
      "name": "Min discharge voltage",
      "data_type": "UInt16",
      "units": "V DC",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by all Victron products. Supported by third-party CAN.Bus batteries and Lynx NG."
    },
    {
      "address": 307,
      "count": 1,
      "name": "Max charge current",
      "data_type": "UInt16",
      "units": "A DC",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by all Victron products. Supported by third-party CAN.Bus batteries and Lynx NG."
    },
    {
      "address": 308,
      "count": 1,
      "name": "Max discharge current",
      "data_type": "UInt16",
      "units": "A DC",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Not supported by all Victron products. Supported by third-party CAN.Bus batteries and Lynx NG."
    },
    {
      "address": 309,
      "count": 1,
      "name": "Capacity",
      "data_type": "UInt16",
      "units": "Ah",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R"
    },
    {
      "address": 310,
      "count": 2,
      "name": "Diagnostics; 1st last error timestamp",
      "data_type": "Int32",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R"
    },
    {
      "address": 312,
      "count": 2,
      "name": "Diagnostics; 2nd last error timestamp",
      "data_type": "Int32",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R"
    },
    {
      "address": 314,
      "count": 2,
      "name": "Diagnostics; 3rd last error timestamp",
      "data_type": "Int32",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R"
    },
    {
      "address": 316,
      "count": 2,
      "name": "Diagnostics; 4th last error timestamp",
      "data_type": "Int32",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R"
    },
    {
      "address": 318,
      "count": 1,
      "name": "Minimum cell temperature",
      "data_type": "Int16",
      "units": "°C",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R"
    },
    {
      "address": 319,
      "count": 1,
      "name": "Maximum cell temperature",
      "data_type": "Int16",
      "units": "°C",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R"
    },
    {
      "address": 320,
      "count": 1,
      "name": "High charge current alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 321,
      "count": 1,
      "name": "High discharge current alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 322,
      "count": 1,
      "name": "Cell imbalance alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 323,
      "count": 1,
      "name": "Internal failure alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 324,
      "count": 1,
      "name": "High charge temperature alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 325,
      "count": 1,
      "name": "Low charge temperature alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;2=Alarm"
    },
    {
      "address": 326,
      "count": 1,
      "name": "Low cell voltage alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;1=Almost discharged;2=Alarm"
    },
    {
      "address": 327,
      "count": 1,
      "name": "BMS Cable alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;1=Warning;2=Alarm Supported only by Lynx BMS"
    },
    {
      "address": 328,
      "count": 1,
      "name": "BMS contactor resistance alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;1=Warning;2=Alarm Supported only by Lynx BMS"
    },
    {
      "address": 329,
      "count": 1,
      "name": "BMS High current alarm",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0=No alarm;1=Warning;2=Alarm Supported only by Lynx BMS"
    }
  ],
  "combined_registers": [],
  "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."
}
