--- layout: default title: Victron MQTT open source specification --- {% assign device_type_keys = "|" %} {% assign device_types = "" %} {% for topic in site.data.victron_mqtt.topics %} {% assign device_type = topic.short_id | split: '_' | first %} {% assign device_type_token = device_type | append: "|" | prepend: "|" %} {% unless device_type_keys contains device_type_token %} {% assign device_type_keys = device_type_keys | append: device_type | append: "|" %} {% if device_types == "" %} {% assign device_types = device_type %} {% else %} {% assign device_types = device_types | append: "," | append: device_type %} {% endif %} {% endunless %} {% endfor %} {% assign device_type_list = device_types | split: "," | sort %} {% assign device_type_enum = site.data.victron_mqtt.enums | where: "name", "DeviceType" | first %}

Open source protocol reference

Victron MQTT topics, clearly mapped.

Explore the MQTT topics, measurements, value types, and enums published by Victron GX devices. Search the complete specification and quickly find the data your integration needs.

Explore topics View on GitHub
{{ site.data.victron_mqtt.topics | size }} Documented topics
{{ device_type_list | size }} Device types
{{ site.data.victron_mqtt.enums | size }} Value enums
GX Gateway based

Protocol overview

How it works

Victron devices publish real-time energy data through an MQTT broker, making it available to automation, monitoring, and energy management systems.

Connect through a broker

GX devices connect to Venus OS MQTT or another compatible broker and act as the gateway for connected products.

Subscribe to topics

Standard topic paths expose voltages, currents, operating states, alarms, and other measurements.

Interpret payloads

Payloads contain numbers, strings, or JSON objects. Metric metadata and enums describe how each value should be handled.

Supported Victron devices

A GX device is required. Cerbo GX, Venus GX, and Color Control GX devices expose data from connected Victron products through MQTT. Inverters, solar controllers, and battery monitors do not expose MQTT directly.

  • Cerbo GX / Venus GX / Color Control GXRequired gateways for MQTT access.
  • MultiPlus / MultiPlus-II / Quattro / Multi RS SolarInverter-charger product families, including Multi RS Solar 48/6000.
  • EasySolar / EasySolar-II / PhoenixInverter and integrated power solutions.
  • SmartSolar / BlueSolar MPPTVictron solar charge controllers, including MPPT 75/10 through 250/100 models.
  • BMV battery monitorsBMV-600/700 series, BMV-702, BMV-712, and similar models.
  • SmartShuntSmartShunt 500A, 1000A, and related variants.
  • Lynx power componentsLynx Shunt, Lynx Distributor, and related Lynx modules.
  • VE.Direct / VE.Can devicesMPPTs and other products connected through supported GX interfaces.
  • GX accessories and connectivityGX Touch, Smart Battery Sense, GlobalLink, GX LTE, and other peripherals.
  • Third-party devices via GXDevices bridged through VE.Bus, VE.Can, or VE.Direct.
victron/+/Dc/0/Voltage DC voltage readings
victron/+/Ac/ActiveIn/L1/Power AC input power
victron/+/Soc Battery state of charge
victron/+/Alarms/LowVoltage Low voltage alarm status

Data catalogue

MQTT topics

Search every field or combine filters to narrow the specification. Your current search is stored in the page URL so it can be shared.

Advanced filters
Columns
Showing {{ site.data.victron_mqtt.topics | size }} of {{ site.data.victron_mqtt.topics | size }} topics
{% for topic in site.data.victron_mqtt.topics %} {% assign device_type_id = topic.short_id | split: "_" | first %} {% assign device_type_member_name = device_type_enum.EnumValues | where: "value", device_type_id | map: "name" | first | default: "" %} {% capture device_type_label %} {% if device_type_member_name != "" and device_type_member_name != "" %} {{ device_type_member_name }} {% else %} {% case device_type_id %} {% when "acsystem" %}AC system {% when "auxiliary" %}Auxiliary battery {% when "charge" %}Battery charging {% when "multiplus" %}MultiPlus {% when "switchable" %}Switchable output {% when "transfer" %}Transfer switch {% else %}{{ device_type_id | replace: "_", " " | capitalize }} {% endcase %} {% endif %} {% endcapture %} {% endfor %}
Topic Device Type Short ID Name Description Unit Message Type Metric Type Metric Nature Value Type Precision Enum Min Max
{{ topic.topic }}
{{ device_type_label | strip }} {{ topic.short_id }} {{ topic.name }} {% if topic.description %}{{ topic.description }}{% else %}—{% endif %}
{% if topic.unit_of_measurement %}{{ topic.unit_of_measurement }}{% endif %} {% if topic.enum %} {% assign topic_enum_name = topic.enum | split: "." | last %} {% elsif topic.unit_of_measurement == nil or topic.unit_of_measurement == "" %} — {% endif %}
{% if topic.message_type %}{{ topic.message_type | split: "." | last }}{% else %}—{% endif %} {% if topic.metric_type %}{{ topic.metric_type | split: "." | last }}{% else %}—{% endif %} {% if topic.metric_nature %}{{ topic.metric_nature | split: "." | last }}{% else %}—{% endif %} {% if topic.value_type %}{{ topic.value_type | split: "." | last }}{% else %}—{% endif %} {% if topic.precision != nil %}{{ topic.precision }}{% else %}—{% endif %} {% if topic.enum %}{{ topic.enum | split: "." | last }}{% else %}—{% endif %} {% if topic.min != nil %}{{ topic.min }}{% else %}—{% endif %} {% if topic.max != nil %}{{ topic.max }}{% else %}—{% endif %}
No topics match these filters.
Try a broader search or clear the active filters.

Value reference

Enums

Enums translate numeric MQTT payloads into operating modes, alarm states, relay statuses, and other human-readable values.

{{ site.data.victron_mqtt.enums | size }} enums
{% for enum in site.data.victron_mqtt.enums %}
{{ enum.name }} {{ enum.EnumValues | size }} values
{% for member in enum.EnumValues %} {% endfor %}
ID Value Display Name Description
{{ member.id }} {{ member.value }} {{ member.name }} {% if member.description %}{{ member.description }}{% else %}—{% endif %}
{% endfor %}
No enums match that search.

Enum values

 {% for enum in site.data.victron_mqtt.enums %} {% endfor %}