{
  "$schema": "https://raw.githubusercontent.com/nobrega8/mbmap-library/main/schema/mbmap-2.schema.json",
  "mbmap": 2,
  "vendor": "Victron Energy",
  "model": "GX inverter",
  "vendor_website": "victronenergy.com",
  "description": "Phoenix inverters, read through a GX device",
  "revision": 2,
  "revised": "2026-10-14",
  "firmware": "Venus OS; register list 3.81",
  "source": "Victron Energy, CCGX Modbus TCP register list 3.81",
  "sources": [
    {
      "title": "CCGX Modbus TCP register list",
      "version": "3.81",
      "url": "https://www.victronenergy.com/upload/documents/CCGX-Modbus-TCP-register-list-3.81.xlsx",
      "note": "Field list, service com.victronenergy.inverter"
    }
  ],
  "notes": [
    "Registers of the com.victronenergy.inverter service of the GX Modbus TCP server (Settings > Integrations > Modbus TCP server).",
    "Each device on the GX has its own unit ID. Since Venus OS 2.60 they are assigned dynamically: see the list of available services on the GX device.",
    "All registers are holding registers (FC03; FC06/FC16 for the writable ones)."
  ],
  "protocol": "tcp",
  "port": 502,
  "byte_order": "big",
  "word_order": "big",
  "address_base": 0,
  "x_status": "official",
  "registers": [
    {"name": "Output current", "area": "holding", "address": 3100, "type": "int16", "scale": 0.1, "unit": "A", "description": "D-Bus /Ac/Out/L1/I"},
    {"name": "Output voltage", "area": "holding", "address": 3101, "type": "uint16", "scale": 0.1, "unit": "V", "description": "D-Bus /Ac/Out/L1/V"},
    {"name": "Output power", "area": "holding", "address": 3102, "type": "int16", "scale": 10, "unit": "W", "description": "D-Bus /Ac/Out/L1/P"},
    {"name": "Battery voltage", "area": "holding", "address": 3105, "type": "uint16", "scale": 0.01, "unit": "V", "description": "D-Bus /Dc/0/Voltage"},
    {"name": "Battery current", "area": "holding", "address": 3106, "type": "int16", "scale": 0.1, "unit": "A", "description": "D-Bus /Dc/0/Current"},
    {"name": "High temperature alarm", "area": "holding", "address": 3110, "type": "uint16", "enum": {"0": "No alarm", "1": "Warning", "2": "Alarm"}, "description": "D-Bus /Alarms/HighTemperature"},
    {"name": "High battery voltage alarm", "area": "holding", "address": 3111, "type": "uint16", "enum": {"0": "No alarm", "1": "Warning", "2": "Alarm"}, "description": "D-Bus /Alarms/HighVoltage"},
    {"name": "High AC-Out voltage alarm", "area": "holding", "address": 3112, "type": "uint16", "enum": {"0": "No alarm", "1": "Warning", "2": "Alarm"}, "description": "D-Bus /Alarms/HighVoltageAcOut"},
    {"name": "Low temperature alarm", "area": "holding", "address": 3113, "type": "uint16", "enum": {"0": "No alarm", "1": "Warning", "2": "Alarm"}, "description": "D-Bus /Alarms/LowTemperature"},
    {"name": "Low battery voltage alarm", "area": "holding", "address": 3114, "type": "uint16", "enum": {"0": "No alarm", "1": "Warning", "2": "Alarm"}, "description": "D-Bus /Alarms/LowVoltage"},
    {"name": "Low AC-Out voltage alarm", "area": "holding", "address": 3115, "type": "uint16", "enum": {"0": "No alarm", "1": "Warning", "2": "Alarm"}, "description": "D-Bus /Alarms/LowVoltageAcOut"},
    {"name": "Overload alarm", "area": "holding", "address": 3116, "type": "uint16", "enum": {"0": "No alarm", "1": "Warning", "2": "Alarm"}, "description": "D-Bus /Alarms/Overload"},
    {"name": "Ripple alarm", "area": "holding", "address": 3117, "type": "uint16", "enum": {"0": "No alarm", "1": "Warning", "2": "Alarm"}, "description": "D-Bus /Alarms/Ripple"},
    {"name": "Firmware version", "area": "holding", "address": 3125, "type": "uint16", "description": "D-Bus /FirmwareVersion"},
    {"name": "Inverter on/off/eco", "area": "holding", "address": 3126, "type": "uint16", "enum": {"1": "Charger only,2=Inverter only", "3": "On", "4": "Off", "5": "Low Power/Eco", "251": "Passthrough", "252": "Standby", "253": "Hibernate"}, "access": "RW", "description": "D-Bus /Mode"},
    {"name": "Inverter model", "area": "holding", "address": 3127, "type": "uint16", "description": "D-Bus /ProductId"},
    {"name": "Inverter state", "area": "holding", "address": 3128, "type": "uint16", "enum": {"0": "Off", "1": "Low power mode (search mode)", "2": "Fault", "9": "Inverting (on)"}, "description": "D-Bus /State"},
    {"name": "Energy from battery to AC-out", "area": "holding", "address": 3130, "type": "uint32", "scale": 0.01, "unit": "kWh", "description": "D-Bus /Energy/InverterToAcOut"},
    {"name": "Energy from AC-out to battery", "area": "holding", "address": 3132, "type": "uint32", "scale": 0.01, "unit": "kWh", "description": "D-Bus /Energy/OutToInverter"},
    {"name": "Energy from solar to AC-out", "area": "holding", "address": 3134, "type": "uint32", "scale": 0.01, "unit": "kWh", "description": "D-Bus /Energy/SolarToAcOut"},
    {"name": "Energy from solar to battery", "area": "holding", "address": 3136, "type": "uint32", "scale": 0.01, "unit": "kWh", "description": "D-Bus /Energy/SolarToBattery"},
    {"name": "PV voltage (for single tracker units)", "area": "holding", "address": 3138, "type": "uint16", "scale": 0.1, "unit": "V", "description": "D-Bus /Pv/V"},
    {"name": "PV voltage for tracker 0", "area": "holding", "address": 3140, "type": "uint16", "scale": 0.1, "unit": "V", "description": "D-Bus /Pv/0/V"},
    {"name": "PV voltage for tracker 1", "area": "holding", "address": 3141, "type": "uint16", "scale": 0.1, "unit": "V", "description": "D-Bus /Pv/1/V"},
    {"name": "PV voltage for tracker 2", "area": "holding", "address": 3142, "type": "uint16", "scale": 0.1, "unit": "V", "description": "D-Bus /Pv/2/V"},
    {"name": "PV voltage for tracker 3", "area": "holding", "address": 3143, "type": "uint16", "scale": 0.1, "unit": "V", "description": "D-Bus /Pv/3/V"},
    {"name": "Yield today for today on tracker 0", "area": "holding", "address": 3148, "type": "uint16", "scale": 0.1, "unit": "kWh", "description": "D-Bus /History/Daily/0/Pv/0/Yield"},
    {"name": "Yield today for today on tracker 1", "area": "holding", "address": 3149, "type": "uint16", "scale": 0.1, "unit": "kWh", "description": "D-Bus /History/Daily/0/Pv/1/Yield"},
    {"name": "Yield today for today on tracker 2", "area": "holding", "address": 3150, "type": "uint16", "scale": 0.1, "unit": "kWh", "description": "D-Bus /History/Daily/0/Pv/2/Yield"},
    {"name": "Yield today for today on tracker 3", "area": "holding", "address": 3151, "type": "uint16", "scale": 0.1, "unit": "kWh", "description": "D-Bus /History/Daily/0/Pv/3/Yield"},
    {"name": "Yield today for yesterday on tracker 0", "area": "holding", "address": 3152, "type": "uint16", "scale": 0.1, "unit": "kWh", "description": "D-Bus /History/Daily/1/Pv/0/Yield"},
    {"name": "Yield today for yesterday on tracker 1", "area": "holding", "address": 3153, "type": "uint16", "scale": 0.1, "unit": "kWh", "description": "D-Bus /History/Daily/1/Pv/1/Yield"},
    {"name": "Yield today for yesterday on tracker 2", "area": "holding", "address": 3154, "type": "uint16", "scale": 0.1, "unit": "kWh", "description": "D-Bus /History/Daily/1/Pv/2/Yield"},
    {"name": "Yield today for yesterday on tracker 3", "area": "holding", "address": 3155, "type": "uint16", "scale": 0.1, "unit": "kWh", "description": "D-Bus /History/Daily/1/Pv/3/Yield"},
    {"name": "Maximum power for today on tracker 0", "area": "holding", "address": 3156, "type": "uint16", "unit": "W", "description": "D-Bus /History/Daily/0/Pv/0/MaxPower"},
    {"name": "Maximum power for today on tracker 1", "area": "holding", "address": 3157, "type": "uint16", "unit": "W", "description": "D-Bus /History/Daily/0/Pv/1/MaxPower"},
    {"name": "Maximum power for today on tracker 2", "area": "holding", "address": 3158, "type": "uint16", "unit": "W", "description": "D-Bus /History/Daily/0/Pv/2/MaxPower"},
    {"name": "Maximum power for today on tracker 3", "area": "holding", "address": 3159, "type": "uint16", "unit": "W", "description": "D-Bus /History/Daily/0/Pv/3/MaxPower"},
    {"name": "Maximum power for yesterday on tracker 0", "area": "holding", "address": 3160, "type": "uint16", "unit": "W", "description": "D-Bus /History/Daily/1/Pv/0/MaxPower"},
    {"name": "Maximum power for yesterday on tracker 1", "area": "holding", "address": 3161, "type": "uint16", "unit": "W", "description": "D-Bus /History/Daily/1/Pv/1/MaxPower"},
    {"name": "Maximum power for yesterday on tracker 2", "area": "holding", "address": 3162, "type": "uint16", "unit": "W", "description": "D-Bus /History/Daily/1/Pv/2/MaxPower"},
    {"name": "Maximum power for yesterday on tracker 3", "area": "holding", "address": 3163, "type": "uint16", "unit": "W", "description": "D-Bus /History/Daily/1/Pv/3/MaxPower"},
    {"name": "PV power for tracker 0", "area": "holding", "address": 3164, "type": "uint16", "unit": "W", "description": "D-Bus /Pv/0/P"},
    {"name": "PV power for tracker 1", "area": "holding", "address": 3165, "type": "uint16", "unit": "W", "description": "D-Bus /Pv/1/P"},
    {"name": "PV power for tracker 2", "area": "holding", "address": 3166, "type": "uint16", "unit": "W", "description": "D-Bus /Pv/2/P"},
    {"name": "PV power for tracker 3", "area": "holding", "address": 3167, "type": "uint16", "unit": "W", "description": "D-Bus /Pv/3/P"},
    {"name": "Low SOC alarm", "area": "holding", "address": 3168, "type": "uint16", "enum": {"0": "No alarm", "1": "Warning", "2": "Alarm"}, "description": "D-Bus /Alarms/LowSoc"},
    {"name": "MPP operation mode tracker 1", "area": "holding", "address": 3169, "type": "uint16", "enum": {"0": "Off", "1": "Voltage/current limited", "2": "MPPT active", "255": "Not available"}, "description": "D-Bus /Pv/0/MppOperationMode"},
    {"name": "MPP operation mode tracker 2", "area": "holding", "address": 3170, "type": "uint16", "enum": {"0": "Off", "1": "Voltage/current limited", "2": "MPPT active", "255": "Not available"}, "description": "D-Bus /Pv/1/MppOperationMode"},
    {"name": "MPP operation mode tracker 3", "area": "holding", "address": 3171, "type": "uint16", "enum": {"0": "Off", "1": "Voltage/current limited", "2": "MPPT active", "255": "Not available"}, "description": "D-Bus /Pv/2/MppOperationMode"},
    {"name": "MPP operation mode tracker 4", "area": "holding", "address": 3172, "type": "uint16", "enum": {"0": "Off", "1": "Voltage/current limited", "2": "MPPT active", "255": "Not available"}, "description": "D-Bus /Pv/3/MppOperationMode"},
    {"name": "Tracker 1 enabled", "area": "holding", "address": 3173, "type": "uint16", "enum": {"0": "Disabled", "1": "Enabled"}, "description": "D-Bus /Pv/0/Enabled; Only available on Inverter RS"},
    {"name": "Tracker 2 enabled", "area": "holding", "address": 3174, "type": "uint16", "enum": {"0": "Disabled", "1": "Enabled"}, "description": "D-Bus /Pv/1/Enabled"},
    {"name": "Tracker 3 enabled", "area": "holding", "address": 3175, "type": "uint16", "enum": {"0": "Disabled", "1": "Enabled"}, "description": "D-Bus /Pv/2/Enabled"},
    {"name": "Tracker 4 enabled", "area": "holding", "address": 3176, "type": "uint16", "enum": {"0": "Disabled", "1": "Enabled"}, "description": "D-Bus /Pv/3/Enabled"},
    {"name": "Custom Name", "area": "holding", "address": 3180, "type": "string", "length": 8, "access": "RW", "description": "D-Bus /CustomName"}
  ]
}