victron_mqtt

Victron MQTT Documentation

victron_mqtt (C) 2025, tomer-w (https://github.com/tomer-w). For more information see https://github.com/tomer-w/victron_mqtt. This file is part of victron_mqtt. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Victron MQTT Protocol Overview

The Victron MQTT protocol is used by Victron Energy devices to publish and subscribe to real-time data over an MQTT broker. This protocol enables seamless integration of Victron devices—such as inverters, chargers, battery monitors, and solar controllers—into home automation, monitoring, and energy management systems.

How It Works

• MQTT Broker: Victron devices connect to a central MQTT broker (such as Venus OS MQTT or a third-party broker).
• Topics: Each device publishes its data (voltages, currents, states, alarms, etc.) to specific MQTT topics, usually under a common prefix (e.g., victron/).
• Payloads: Data is typically sent as simple values (numbers, strings) or JSON objects, depending on the topic.
• Discovery: Devices and their metrics can be discovered by subscribing to wildcard topics (e.g., victron/+/+/...).

Supported Victron Devices

Note: To use the Victron MQTT protocol, you must have a Cerbo GX, Venus GX, or Color Control GX device (collectively known as GX devices). These GX devices act as gateways, exposing data from connected Victron products via MQTT. Other Victron devices (such as inverters, solar controllers, and battery monitors) do not expose MQTT directly—they must be connected to a GX device, which then publishes their data to the MQTT broker.

• Cerbo GX / Venus GX / Color Control GX (required for MQTT access)
• MultiPlus / Quattro Inverter-Chargers (via GX device)
• BlueSolar / SmartSolar MPPT Solar Charge Controllers (via GX device)
• BMV / SmartShunt Battery Monitors (via GX device)
• Lynx Shunt / Power Distribution Systems (via GX device)
• Other compatible Victron devices (via GX device)

Common MQTT Topics

Each device type publishes to a set of standardized topics. For example:

• victron/+/Dc/0/Voltage – DC voltage readings
• victron/+/Ac/ActiveIn/L1/Power – AC input power
• victron/+/Soc – State of charge
• victron/+/Alarms/LowVoltage – Low voltage alarm status
• ...and many more, as detailed in the table below.

MQTT Topics

Topic	Short ID	Name	Unit	Message Type	Metric Type	Metric Nature	Device Type	Value Type	Precision	Enum	Min	Max
				<ALL> BINARY_SENSOR NUMBER SELECT SENSOR SWITCH	<ALL> CURRENT ELECTRIC_STORAGE_CAPACITY ENERGY FREQUENCY HEADING LIQUID_VOLUME LOCATION NONE PERCENTAGE POWER SPEED TEMPERATURE TIME VOLTAGE	<ALL> CUMULATIVE INSTANTANEOUS NONE	<ALL> Battery Charger (Orion/Alternator) DC Load EV Charging Station Gps Grid Inverter Liquid Tank Multi RS Solar PV Inverter Solar Charger Switch System Temperature	<ALL> ENUM FLOAT INT INT_DEFAULT_0 STRING		<ALL> DESSErrorCode DESSReactiveStrategy DESSRestrictions DESSStrategy ESSMode EvChargerMode FluidType GenericOnOff InverterMode InverterOverloadAlarmEnum InverterState MultiState SolarChargerState TemperatureStatus TemperatureType
N/+/system/+/Ac/Grid/NumberOfPhases	system_grid_phases	Grid phases		SENSOR	NONE	INSTANTANEOUS	Grid	INT_DEFAULT_0
N/+/grid/+/Ac/{phase}/Voltage	grid_voltage_{phase}	Grid voltage on {phase}	V	SENSOR	VOLTAGE	INSTANTANEOUS	Grid	FLOAT	1
N/+/grid/+/Ac/{phase}/Current	grid_current_{phase}	Grid current on {phase}	A	SENSOR	CURRENT	INSTANTANEOUS	Grid	FLOAT	1
N/+/grid/+/Ac/{phase}/Power	grid_power_{phase}	Grid power on {phase}	W	SENSOR	POWER	INSTANTANEOUS	Grid	FLOAT	1
N/+/grid/+/Ac/{phase}/Energy/Forward	grid_energy_forward_{phase}	Grid consumption on {phase}	kWh	SENSOR	ENERGY	CUMULATIVE	Grid	FLOAT	1
N/+/grid/+/Ac/{phase}/Energy/Reverse	grid_energy_reverse_{phase}	Grid feed-in on {phase}	kWh	SENSOR	ENERGY	CUMULATIVE	Grid	FLOAT	1
N/+/grid/+/Ac/PENVoltage	grid_voltage_pen	Grid voltage on PEN	V	SENSOR	VOLTAGE	INSTANTANEOUS	Grid	FLOAT	1
N/+/grid/+/Ac/N/Current	grid_current_n	Grid current on N	A	SENSOR	CURRENT	INSTANTANEOUS	Grid	FLOAT	1
N/+/grid/+/Ac/Frequency	grid_frequency	Grid frequency	Hz	SENSOR	FREQUENCY	INSTANTANEOUS	Grid	FLOAT	2
N/+/grid/+/Ac/{phase}/VoltageLineToLine	grid_voltage_{phase}_{next_phase}	Grid voltage {phase} to {next_phase}	V	SENSOR	VOLTAGE	INSTANTANEOUS	Grid	FLOAT	1
N/+/grid/+/Ac/Voltage	grid_voltage	Grid voltage	V	SENSOR	VOLTAGE	INSTANTANEOUS	Grid	FLOAT	1
N/+/grid/+/Ac/Current	grid_current	Grid current	A	SENSOR	CURRENT	INSTANTANEOUS	Grid	FLOAT	1
N/+/grid/+/Ac/Power	grid_power	Grid power	W	SENSOR	POWER	INSTANTANEOUS	Grid	FLOAT	1
N/+/grid/+/Ac/Energy/Forward	grid_energy_forward	Grid consumption	kWh	SENSOR	ENERGY	CUMULATIVE	Grid	FLOAT	1
N/+/grid/+/Ac/Energy/Reverse	grid_energy_reverse	Grid feed-in	kWh	SENSOR	ENERGY	CUMULATIVE	Grid	FLOAT	1
N/+/solarcharger/+/Dc/0/Voltage	solarcharger_dc_voltage	DC (Batt) Bus voltage	V	SENSOR	VOLTAGE	INSTANTANEOUS	Solar Charger	FLOAT	3
N/+/solarcharger/+/Dc/0/Current	solarcharger_dc_current	DC (Batt) Bus current	A	SENSOR	CURRENT	INSTANTANEOUS	Solar Charger	FLOAT	2
N/+/solarcharger/+/Load/I	solarcharger_load_current	Load Bus current	A	SENSOR	CURRENT	INSTANTANEOUS	Solar Charger	FLOAT	2
N/+/solarcharger/+/Pv/V	solarcharger_voltage	PV Bus Voltage	V	SENSOR	VOLTAGE	INSTANTANEOUS	Solar Charger	FLOAT	2
N/+/solarcharger/+/State	solarcharger_state	Solar Charger State		SENSOR	NONE	NONE	Solar Charger	ENUM		SolarChargerState
N/+/system/+/Dc/Pv/Power	solarcharger_power	PV Power	W	SENSOR	POWER	INSTANTANEOUS	Solar Charger	FLOAT	1
N/+/system/+/PV/Current	solarcharger_current	PV Bus current	A	SENSOR	CURRENT	INSTANTANEOUS	Solar Charger	FLOAT	2
N/+/solarcharger/+/Yield/Power	solarcharger_yield_power	PV Yield Power	W	SENSOR	POWER	INSTANTANEOUS	Solar Charger	FLOAT	1
N/+/solarcharger/+/Yield/User	solarcharger_yield_total	Total Yield	kWh	SENSOR	ENERGY	CUMULATIVE	Solar Charger	FLOAT	1
N/+/solarcharger/+/History/Daily/0/Yield	solarcharger_yield_today	Yield Today	kWh	SENSOR	ENERGY	CUMULATIVE	Solar Charger	FLOAT	1
N/+/solarcharger/+/History/Daily/1/Yield	solarcharger_yield_yesterday	Yield Yesterday	kWh	SENSOR	ENERGY	CUMULATIVE	Solar Charger	FLOAT	1
N/+/solarcharger/+/History/Daily/0/MaxPower	solarcharger_max_power_today	Max Power Today	W	SENSOR	POWER	INSTANTANEOUS	Solar Charger	FLOAT	1
N/+/solarcharger/+/History/Daily/1/MaxPower	solarcharger_max_power_yesterday	Max Power Yesterday	W	SENSOR	POWER	INSTANTANEOUS	Solar Charger	FLOAT	1
N/+/solarcharger/+/Load/State	solarcharger_load_state	Solar Charger Load State		BINARY_SENSOR	NONE	NONE	Solar Charger	ENUM		GenericOnOff
N/+/solarcharger/+/Mode	solarcharger_mode	Solar Charger Mode		SWITCH	NONE	NONE	Solar Charger	ENUM		GenericOnOff
N/+/solarcharger/+/MppOperationMode	solarcharger_mppt_operation_mode	Solar Charger MPPT Operation Mode		SENSOR	NONE	NONE	Solar Charger	ENUM		MultiState
N/+/solarcharger/+/Relay/0/State	solarcharger_relay_state	Solar Charger Relay State		SWITCH	NONE	NONE	Solar Charger	ENUM		GenericOnOff
N/+/battery/+/Dc/0/Voltage	battery_voltage	DC Bus voltage	V	SENSOR	VOLTAGE	INSTANTANEOUS	Battery	FLOAT	3
N/+/battery/+/Dc/0/Current	battery_current	DC Bus current	A	SENSOR	CURRENT	INSTANTANEOUS	Battery	FLOAT	1
N/+/battery/+/Dc/0/Power	battery_power	Battery power	W	SENSOR	POWER	INSTANTANEOUS	Battery	FLOAT	1
N/+/battery/+/Dc/0/Temperature	battery_temperature	Battery temperature	°C	SENSOR	TEMPERATURE	INSTANTANEOUS	Battery	FLOAT	1
N/+/battery/+/History/DischargedEnergy	battery_discharged_energy	Discharged energy	kWh	SENSOR	ENERGY	CUMULATIVE	Battery	FLOAT	1
N/+/battery/+/History/ChargedEnergy	battery_charged_energy	Charged energy	kWh	SENSOR	ENERGY	CUMULATIVE	Battery	FLOAT	1
N/+/battery/+/History/AutomaticSyncs	battery_automatic_syncs	Automatic syncs	count	SENSOR	NONE	CUMULATIVE	Battery	INT
N/+/battery/+/Capacity	battery_capacity	Battery capacity	Ah	SENSOR	ELECTRIC_STORAGE_CAPACITY	INSTANTANEOUS	Battery	FLOAT	1
N/+/battery/+/InstalledCapacity	battery_installed_capacity	Battery installed capacity	Ah	SENSOR	ELECTRIC_STORAGE_CAPACITY	INSTANTANEOUS	Battery	FLOAT	1
N/+/battery/+/Soc	battery_soc	Battery charge	%	SENSOR	PERCENTAGE	INSTANTANEOUS	Battery	FLOAT	1
N/+/battery/+/System/MinCellVoltage	battery_min_cell_voltage	Battery minimum cell voltage	V	SENSOR	VOLTAGE	INSTANTANEOUS	Battery	FLOAT	3
N/+/battery/+/System/MaxCellVoltage	battery_max_cell_voltage	Battery maximum cell voltage	V	SENSOR	VOLTAGE	INSTANTANEOUS	Battery	FLOAT	3
N/+/battery/+/TimeToGo	battery_time_to_go	Battery time to go	s	SENSOR	TIME	INSTANTANEOUS	Battery	INT
N/+/battery/+/Info/ChargeMode	charge_mode	Battery charge mode		SENSOR	NONE	NONE	Battery	STRING
N/+/battery/+/ConsumedAmphours	battery_consumed_amphours	Battery consumed amp-hours	Ah	SENSOR	ELECTRIC_STORAGE_CAPACITY	INSTANTANEOUS	Battery	FLOAT	1
N/+/battery/+/Voltages/Cell{cell_id(1-4)}	battery_cell_{cell_id}_voltage	Battery cell {cell_id} voltage	V	SENSOR	VOLTAGE	INSTANTANEOUS	Battery	FLOAT	3
N/+/vebus/+/Mode	inverter_mode	Inverter mode		SELECT	NONE	NONE	Inverter	ENUM		InverterMode
N/+/vebus/+/State	inverter_state	Inverter state		SENSOR	NONE	NONE	Inverter	ENUM		InverterState
N/+/vebus/+/Ac/ActiveIn/{phase}/V	inverter_input_voltage_{phase}	Inverter input voltage {phase}	V	SENSOR	VOLTAGE	INSTANTANEOUS	Inverter	FLOAT	1
N/+/vebus/+/Ac/ActiveIn/{phase}/P	inverter_input_power_{phase}	Inverter input power {phase}	W	SENSOR	POWER	INSTANTANEOUS	Inverter	FLOAT	1
N/+/vebus/+/Ac/ActiveIn/{phase}/F	inverter_input_frequency_{phase}	Inverter input frequency {phase}	Hz	SENSOR	FREQUENCY	INSTANTANEOUS	Inverter	FLOAT	1
N/+/vebus/+/Ac/ActiveIn/{phase}/S	inverter_input_apparent_power_{phase}	Inverter input apparent power {phase}	VA	SENSOR	POWER	INSTANTANEOUS	Inverter	FLOAT	1
N/+/vebus/+/Ac/Out/{phase}/P	inverter_output_power_{phase}	Inverter output power {phase}	W	SENSOR	POWER	INSTANTANEOUS	Inverter	FLOAT	1
N/+/vebus/+/Ac/Out/{phase}/F	inverter_output_frequency_{phase}	Inverter output frequency {phase}	Hz	SENSOR	FREQUENCY	INSTANTANEOUS	Inverter	FLOAT	1
N/+/vebus/+/Ac/Out/{phase}/S	inverter_output_apparent_power_{phase}	Inverter output apparent power {phase}	VA	SENSOR	POWER	INSTANTANEOUS	Inverter	FLOAT	1
N/+/vebus/+/Connected	inverter_connected	Inverter connected		BINARY_SENSOR	NONE	NONE	Inverter	ENUM		GenericOnOff
N/+/vebus/+/Alarms/Overload	inverter_alarm_overload	Inverter overload alarm		SENSOR	NONE	NONE	Inverter	ENUM		InverterOverloadAlarmEnum
N/+/vebus/+/Ac/ActiveIn/CurrentLimit	inverter_current_limit	Inverter current limit	A	NUMBER	CURRENT	INSTANTANEOUS	Inverter	INT			0	16
N/+/system/+/Ac/ConsumptionOnOutput/{phase}/Power	system_critical_loads_{phase}	Critical loads on {phase}	W	SENSOR	POWER	INSTANTANEOUS	System	FLOAT	1
N/+/system/+/Ac/ConsumptionOnInput/{phase}/Power	system_ac_loads_{phase}	AC loads on {phase}	W	SENSOR	POWER	INSTANTANEOUS	System	FLOAT	1
N/+/system/+/Dc/System/Power	system_dc_consumption	DC Consumption	W	SENSOR	POWER	INSTANTANEOUS	System	FLOAT	1
N/+/system/+/Dc/Battery/Soc	system_dc_battery_soc	DC Battery Charge	%	SENSOR	PERCENTAGE	INSTANTANEOUS	System	FLOAT	1
N/+/system/+/Dc/Battery/Power	system_dc_battery_power	DC Battery Power	W	SENSOR	POWER	INSTANTANEOUS	System	FLOAT	1
N/+/system/+/Dc/Battery/Voltage	system_dc_battery_voltage	DC Battery Voltage	V	SENSOR	VOLTAGE	INSTANTANEOUS	System	FLOAT	3
N/+/system/+/Dc/Battery/Current	system_dc_battery_current	DC Battery Current	A	SENSOR	CURRENT	INSTANTANEOUS	System	FLOAT	1
N/+/system/+/Relay/{relay}/State	system_relay_{relay}	Relay {relay} state		SWITCH	NONE	NONE	System	ENUM		GenericOnOff
N/+/system/+/DynamicEss/Available	system_dynamicess_available	Dynamic ESS Available		BINARY_SENSOR	NONE	NONE	System	ENUM		GenericOnOff
N/+/system/+/DynamicEss/Active	system_dynamicess_active	Dynamic ESS Active		SWITCH	NONE	NONE	System	ENUM		GenericOnOff
N/+/system/+/DynamicEss/AllowGridFeedIn	system_dynamicess_allow_gridfeedin	Dynamic ESS Allow Grid Feed In		BINARY_SENSOR	NONE	NONE	System	ENUM		GenericOnOff
N/+/system/+/DynamicEss/AvailableOverhead	system_dynamicess_available_overhead	Dynamic ESS Available Overhead	W	SENSOR	POWER	INSTANTANEOUS	System	FLOAT	1
N/+/system/+/DynamicEss/ErrorCode	system_dynamicess_error	Dynamic ESS Error		SWITCH	NONE	NONE	System	ENUM		DESSErrorCode
N/+/system/+/DynamicEss/NumberOfSchedules	system_dynamicess_schedule_count	Dynamic ESS Number Of Schedules		SENSOR	NONE	INSTANTANEOUS	System	INT
N/+/system/+/DynamicEss/TargetSoc	system_dynamicess_target_soc	Dynamic ESS Target SOC	%	SENSOR	PERCENTAGE	INSTANTANEOUS	System	FLOAT	0
N/+/system/+/DynamicEss/MinimumSoc	system_dynamicess_minimum_soc	Dynamic ESS Minimum SOC	%	SENSOR	PERCENTAGE	INSTANTANEOUS	System	FLOAT	0
N/+/system/+/DynamicEss/Restrictions	system_dynamicess_restrictions	Dynamic ESS Restrictions		SENSOR	NONE	NONE	System	ENUM		DESSRestrictions
N/+/system/+/DynamicEss/Strategy	system_dynamicess_strategy	Dynamic ESS Strategy		SENSOR	NONE	NONE	System	ENUM		DESSStrategy
N/+/system/+/DynamicEss/ReactiveStrategy	system_dynamicess_reactive_strategy	Dynamic ESS Reactive Strategy		SENSOR	NONE	NONE	System	ENUM		DESSReactiveStrategy
N/+/system/+/Ac/Genset/{phase}/Power	system_generator_load_{phase}	Genset Load {phase}	W	SENSOR	POWER	INSTANTANEOUS	System	FLOAT	1
N/+/system/+/Ac/Grid/{phase}/Power	system_grid_power_{phase}	Grid Power {phase}	W	SENSOR	POWER	INSTANTANEOUS	System	FLOAT	1
N/+/evcharger/+/Mode	evcharger_mode	EV charger mode		SELECT	NONE	NONE	EV Charging Station	ENUM		EvChargerMode
N/+/evcharger/+/StartStop	evcharger_charge	EV charger charge		SWITCH	NONE	NONE	EV Charging Station	ENUM		GenericOnOff
N/+/evcharger/+/Connected	evcharger_connected	EV charger connected		BINARY_SENSOR	NONE	NONE	EV Charging Station	ENUM		GenericOnOff
N/+/evcharger/+/Current	evcharger_current	EV charger current	A	SENSOR	CURRENT	INSTANTANEOUS	EV Charging Station	FLOAT	1
N/+/evcharger/+/Ac/{phase}/Power	evcharger_power_{phase}	EV charger power {phase}	W	SENSOR	POWER	INSTANTANEOUS	EV Charging Station	FLOAT	1
N/+/evcharger/+/SetCurrent	evcharger_set_current	EV charger set current	A	NUMBER	CURRENT	INSTANTANEOUS	EV Charging Station	INT			0	16
N/+/pvinverter/+/Ac/{phase}/Voltage	pvinverter_voltage_{phase}	Voltage {phase}	V	SENSOR	VOLTAGE	INSTANTANEOUS	PV Inverter	FLOAT	1
N/+/pvinverter/+/Ac/{phase}/Current	pvinverter_current_{phase}	Current {phase}	A	SENSOR	CURRENT	INSTANTANEOUS	PV Inverter	FLOAT	1
N/+/pvinverter/+/Ac/Power	pvinverter_power_total	Power Total	W	SENSOR	POWER	INSTANTANEOUS	PV Inverter	FLOAT	1
N/+/pvinverter/+/Ac/{phase}/Power	pvinverter_power_{phase}	Power {phase}	W	SENSOR	POWER	INSTANTANEOUS	PV Inverter	FLOAT	1
N/+/pvinverter/+/Ac/Energy/Forward	pvinverter_yield_total	Total Yield	kWh	SENSOR	ENERGY	CUMULATIVE	PV Inverter	FLOAT	1
N/+/pvinverter/+/Ac/{phase}/Energy/Forward	pvinverter_yield_{phase}	Yield {phase}	kWh	SENSOR	ENERGY	CUMULATIVE	PV Inverter	FLOAT	1
N/+/temperature/+/Temperature	temperature_temperature	Temperature	°C	SENSOR	TEMPERATURE	INSTANTANEOUS	Temperature	FLOAT	1
N/+/temperature/+/Status	temperature_status	Temperature sensor status		SENSOR	NONE	NONE	Temperature	ENUM		TemperatureStatus
N/+/temperature/+/TemperatureType	temperature_type	Temperature sensor type		SENSOR	NONE	NONE	Temperature	ENUM		TemperatureType
N/+/temperature/+/Offset	temperature_offset	Temperature offset	°C	NUMBER	TEMPERATURE	INSTANTANEOUS	Temperature	FLOAT	1
N/+/temperature/+/Scale	temperature_scale	Temperature scale factor		NUMBER	NONE	INSTANTANEOUS	Temperature	FLOAT	2
N/+/tank/+/Level	tank_level	Level	%	SENSOR	PERCENTAGE	INSTANTANEOUS	Liquid Tank	INT
N/+/tank/+/Remaining	tank_remaining	Remaining	m3	SENSOR	LIQUID_VOLUME	INSTANTANEOUS	Liquid Tank	FLOAT	2
N/+/tank/+/Temperature	tank_temperature	Temperature	°C	SENSOR	TEMPERATURE	INSTANTANEOUS	Liquid Tank	FLOAT	1
N/+/tank/+/FluidType	tank_fluid_type	Fluid Type		SENSOR	NONE	NONE	Liquid Tank	ENUM		FluidType
N/+/multi/+/Ac/NumberOfPhases	multirssolar_phases	Phases		SENSOR	NONE	INSTANTANEOUS	Multi RS Solar	INT
N/+/multi/+/Ac/In/1/{phase}/V	multirssolar_acin_voltage_{phase}	Voltage on {phase}	V	SENSOR	VOLTAGE	INSTANTANEOUS	Multi RS Solar	FLOAT	1
N/+/multi/+/Ac/In/1/{phase}/I	multirssolar_acin_current_{phase}	Current {phase}	A	SENSOR	CURRENT	INSTANTANEOUS	Multi RS Solar	FLOAT	1
N/+/multi/+/Ac/In/1/{phase}/P	multirssolar_acin_power_{phase}	Power on {phase}	W	SENSOR	POWER	INSTANTANEOUS	Multi RS Solar	FLOAT	1
N/+/multi/+/Ac/Out/{output}/{phase}/V	multirssolar_acout_{output}_voltage_{phase}	AC Out {output} Voltage on {phase}	V	SENSOR	VOLTAGE	INSTANTANEOUS	Multi RS Solar	FLOAT	1
N/+/multi/+/Ac/Out/{output}/{phase}/I	multirssolar_acout_{output}_current_{phase}	AC Out {output} Current on {phase}	A	SENSOR	CURRENT	INSTANTANEOUS	Multi RS Solar	FLOAT	1
N/+/multi/+/Ac/Out/{output}/{phase}/P	multirssolar_acout_{output}_power_{phase}	AC Out {output} Power on {phase}	W	SENSOR	POWER	INSTANTANEOUS	Multi RS Solar	FLOAT	1
N/+/multi/+/State	multirssolar_state	State		SENSOR	NONE	NONE	Multi RS Solar	ENUM		InverterState
N/+/multi/+/Pv/{mpptnumber}/V	multirssolar_mppt_{mpptnumber}_voltage	MPPT {mpptnumber} PV Voltage	V	SENSOR	VOLTAGE	INSTANTANEOUS	Multi RS Solar	FLOAT	1
N/+/multi/+/Pv/{mpptnumber}/P	multirssolar_mppt_{mpptnumber}_power	MPPT {mpptnumber} Power	W	SENSOR	POWER	INSTANTANEOUS	Multi RS Solar	FLOAT	1
N/+/multi/+/Pv/{mpptnumber}/MppOperationMode	multirssolar_mppt_{mpptnumber}_state	MPPT {mpptnumber} state		SENSOR	NONE	NONE	Multi RS Solar	ENUM		MultiState
N/+/multi/+/Yield/Power	multirssolar_pv_power_total	PV Power Total	W	SENSOR	POWER	INSTANTANEOUS	Multi RS Solar	FLOAT	1
N/+/multi/+/Yield/User	multirssolar_total_pv_yield	Total PV Yield	kWh	SENSOR	ENERGY	CUMULATIVE	Multi RS Solar	FLOAT	1
N/+/multi/+/Settings/Ess/Mode	multirssolar_ess_mode	ESS Mode		SENSOR	NONE	NONE	Multi RS Solar	ENUM		ESSMode
N/+/multi/+/Ess/AcPowerSetpoint	multirssolar_ess_ac_power_set_point	ESS AC Power Setpoint	W	SENSOR	POWER	INSTANTANEOUS	Multi RS Solar	FLOAT	1
N/+/multi/+/Ess/InverterPowerSetpoint	multirssolar_inverter_power_setpoint	Inverter Power Setpoint	W	SENSOR	POWER	INSTANTANEOUS	Multi RS Solar	FLOAT	1
N/+/alternator/+/Dc/0/Voltage	alternator_dc_voltage	DC Output Voltage	V	SENSOR	VOLTAGE	INSTANTANEOUS	Charger (Orion/Alternator)	FLOAT	3
N/+/alternator/+/Dc/0/Current	alternator_dc_current	DC Output Current	A	SENSOR	CURRENT	INSTANTANEOUS	Charger (Orion/Alternator)	FLOAT	2
N/+/alternator/+/Dc/0/Power	alternator_dc_power	DC Output Power	W	SENSOR	POWER	INSTANTANEOUS	Charger (Orion/Alternator)	FLOAT	1
N/+/alternator/+/In/V	alternator_input_voltage	Input Voltage	V	SENSOR	VOLTAGE	INSTANTANEOUS	Charger (Orion/Alternator)	FLOAT	2
N/+/alternator/+/In/I	alternator_input_current	Input Current	A	SENSOR	CURRENT	INSTANTANEOUS	Charger (Orion/Alternator)	FLOAT	2
N/+/alternator/+/In/P	alternator_input_power	Input Power	W	SENSOR	POWER	INSTANTANEOUS	Charger (Orion/Alternator)	FLOAT	1
N/+/settings/+/Settings/CGwacs/AcPowerSetPoint	system_ac_power_set_point	AC Power Setpoint	W	NUMBER	POWER	INSTANTANEOUS	System	INT			-10000	10000
N/+/settings/+/Settings/CGwacs/OvervoltageFeedIn	system_settings_overvoltage_feedin	PV DC Overvoltage FeedIn		SWITCH	NONE	NONE	System	ENUM		GenericOnOff
N/+/settings/+/Settings/CGwacs/BatteryLife/MinimumSocLimit	system_ess_min_soc_limit	ESS min SOC limit	%	NUMBER	PERCENTAGE	INSTANTANEOUS	System	INT
N/+/settings/+/Settings/SystemSetup/MaxChargeCurrent	system_ess_max_charge_current	ESS max charge current	A	NUMBER	CURRENT	INSTANTANEOUS	System	INT
N/+/settings/+/Settings/SystemSetup/MaxChargeVoltage	system_ess_max_charge_voltage	ESS max charge voltage	V	NUMBER	VOLTAGE	INSTANTANEOUS	System	INT
N/+/dcload/+/Dc/0/Voltage	dcload_voltage	DC load voltage	V	SENSOR	VOLTAGE	INSTANTANEOUS	DC Load	FLOAT	3
N/+/dcload/+/Dc/0/Current	dcload_current	DC load current	A	SENSOR	CURRENT	INSTANTANEOUS	DC Load	FLOAT	1
N/+/dcload/+/Dc/0/Power	dcload_power	DC load power	W	SENSOR	POWER	INSTANTANEOUS	DC Load	FLOAT	1
N/+/switch/+/SwitchableOutput/output_{output(1-4)}/State	switch_{output}_state	Switch {output} State		SWITCH	NONE	NONE	Switch	ENUM		GenericOnOff
N/+/switch/+/SwitchableOutput/output_{output(1-4)}/Dimming	switch_{output}_dimming	Switch {output} Dimming		NUMBER	NONE	NONE	Switch	INT			0	100
N/+/gps/+/Altitude	gps_altitude	GPS Altitude		SENSOR	NONE	INSTANTANEOUS	Gps	FLOAT
N/+/gps/+/Connected	gps_connected	GPS Connected		BINARY_SENSOR	NONE	NONE	Gps	ENUM		GenericOnOff
N/+/gps/+/Course	gps_course	GPS Course		SENSOR	HEADING	INSTANTANEOUS	Gps	FLOAT	2
N/+/gps/+/Fix	gps_fix	GPS Fix		BINARY_SENSOR	NONE	NONE	Gps	ENUM		GenericOnOff
N/+/gps/+/Speed	gps_speed	GPS Speed		SENSOR	SPEED	INSTANTANEOUS	Gps	FLOAT	2
N/+/gps/+/NrOfSatellites	gps_nrofsatellites	GPS Nr Of Satellites		SENSOR	NONE	INSTANTANEOUS	Gps	INT
N/+/gps/+/Position/Latitude	gps_latitude	GPS Latitude		SENSOR	LOCATION	INSTANTANEOUS	Gps	FLOAT
N/+/gps/+/Position/Longitude	gps_longitude	GPS Longitude		SENSOR	LOCATION	INSTANTANEOUS	Gps	FLOAT
N/+/settings/+/Settings/CGwacs/MaxDischargePower	system_ess_max_inverter_power_limit	ESS max inverter power limit	W	NUMBER	POWER	INSTANTANEOUS	System	INT

Enums

Enums represent the possible states or values for certain device properties, such as operational modes, alarm states, or relay statuses. These are useful for interpreting numeric codes in MQTT payloads.

DESSErrorCode

Id	Value	Display Name
NO_ERROR	0	No Error
NO_ESS	1	No ESS
ESS_MODE	2	ESS Mode
NO_SCHEDULE	3	No Matching Schedule
SOC_LOW	4	SOC low
BATTRY_CAPACITY_NOT_CONFIGURED	5	Battery Capacity Not Configured

DESSReactiveStrategy

Id	Value	Display Name
SCHEDULED_SELFCONSUME	1	Scheduled Self-Consume
SCHEDULED_CHARGE_ALLOW_GRID	2	Scheduled Charge Allow Grid
SCHEDULED_CHARGE_ENHANCED	3	Scheduled Charge Enhanced
SELFCONSUME_ACCEPT_CHARGE	4	Self-Consume Accept Charge
IDLE_SCHEDULED_FEEDIN	5	Idle Scheduled Feed-In
SCHEDULED_DISCHARGE	6	Scheduled Discharge
SELFCONSUME_ACCEPT_DISCHARGE	7	Self-Consume Accept Discharge
IDLE_MAINTAIN_SURPLUS	8	Idle Maintain Surplus
IDLE_MAINTAIN_TARGETSOC	9	Idle Maintain Target SOC
SCHEDULED_CHARGE_SMOOTH_TRANSITION	10	Scheduled Charge Smooth Transition
SCHEDULED_CHARGE_FEEDIN	11	Scheduled Charge Feed-In
SCHEDULED_CHARGE_NO_GRID	12	Scheduled Charge No Grid
SCHEDULED_MINIMUM_DISCHARGE	13	Scheduled Minimum Discharge
SELFCONSUME_NO_GRID	14	Self-Consume No Grid
IDLE_NO_OPPORTUNITY	15	Idle No Opportunity
UNSCHEDULED_CHARGE_CATCHUP_TARGETSOC	16	Unscheduled Charge Catch-Up Target SOC
SELFCONSUME_INCREASED_DISCHARGE	17	Self-Consume Increased Discharge
KEEP_BATTERY_CHARGED	18	Keep Battery Charged
SCHEDULED_DISCHARGE_SMOOTH_TRANSITION	19	Scheduled Discharge Smooth Transition
DESS_DISABLED	92	DESS Disabled
SELFCONSUME_UNEXPECTED_EXCEPTION	93	Self-Consume Unexpected Exception
SELFCONSUME_FAULTY_CHARGERATE	94	Self-Consume Faulty Charge Rate
UNKNOWN_OPERATING_MODE	95	Unknown Operating Mode
ESS_LOW_SOC	96	ESS Low SOC
SELFCONSUME_UNMAPPED_STATE	97	Self-Consume Unmapped State
SELFCONSUME_UNPREDICTED	98	Self-Consume Unpredicted
NO_WINDOW	99	No Window

DESSRestrictions

Id	Value	Display Name
NO_RESTRICTIONS	0	No Restrictions between battery and the grid
GRID_TO_BATTERY_RESTRICTED	1	Grid to battey energy flow restricted
BATTERY_TO_GRID_RESTRICTED	2	Battery to grid energy flow restricted
NO_FLOW	3	No energy flow between battery and grid

DESSStrategy

Id	Value	Display Name
TARGETSOC	0	Target SOC
SELFCONSUME	1	Self-Consume
PROBATTERY	2	Pro Battery
PROGRID	3	Pro Grid

DeviceType

Id	Value	Display Name
UNKNOWN	unknown	Unknown Device
SYSTEM	system	System
SOLAR_CHARGER	solarcharger	Solar Charger
INVERTER	inverter	Inverter
BATTERY	battery	Battery
GRID	grid	Grid
VEBUS	vebus	VE.Bus
EVCHARGER	evcharger	EV Charging Station
PVINVERTER	pvinverter	PV Inverter
TEMPERATURE	temperature	Temperature
GENERATOR	generator	Generator
TANK	tank	Liquid Tank
MULTI_RS_SOLAR	multi	Multi RS Solar
CGWACS	CGwacs	Carlo Gavazzi Wired AC Sensors
DC_LOAD	dcload	DC Load
ALTERNATOR	alternator	Charger (Orion/Alternator)
SWITCH	switch	Switch
GPS	gps	Gps
SYSTEM_SETUP	SystemSetup	System Setup

ESSMode

Id	Value	Display Name
SelfConsumptionBatterylife	0	self consumption (batterylife)
SelfConsumption	1	self consumption
KeepCharged	2	keep charged
ExternalControl	3	External control

EvChargerMode

Id	Value	Display Name
Manual	0	Manual
Auto	1	Auto
ScheduledCharge	2	Scheduled Charge

FluidType

Id	Value	Display Name
Fuel	0	Fuel
FreshWater	1	Fresh Water
WasteWater	2	Waste Water
LiveWell	3	Live Well
Oil	4	Oil
BlackWater	5	Black water (sewage)
Gasoline	6	Gasoline
Diesel	7	Diesel
LPG	8	Liquid Petroleum Gas (LPG)
LNG	9	Liquid Natural Gas (LNG)
HydraulicOil	10	Hydraulic oil
RawWater	11	Raw water

GenericOnOff

Id	Value	Display Name
Off	0	Off
On	1	On

InverterMode

Id	Value	Display Name
ChargerOnly	1	Charger Only
InverterOnly	2	Inverter Only
On	3	On
Off	4	Off

InverterOverloadAlarmEnum

Id	Value	Display Name
NoAlarm	0	No Alarm
Warning	1	Warning
Alarm	2	Alarm

InverterState

Id	Value	Display Name
Off	0	Off
LowPower	1	Low Power
Fault	2	Fault
Bulk	3	Bulk
Absorption	4	Absorption
Float	5	Float
Storage	6	Storage
Equalize	7	Equalize
Passthrough	8	Passthrough
Inverting	9	Inverting
PowerAssist	10	Power Assist
PowerSupply	11	Power Supply
Sustain	244	Sustain
ExternalControl	252	External Control

MultiState

Id	Value	Display Name
Off	0	Off
VoltageCurrentLimited	1	Voltage/current limited
MPPTActive	2	MPPT active
NotAvailable	255	Not available

SolarChargerState

Id	Value	Display Name
Off	0	Off
Fault	2	Fault
Bulk	3	Bulk
Absorption	4	Absorption
Float	5	Float
Storage	6	Storage
Equalize	7	Equalize
ExternalControl	252	External control

TemperatureStatus

Id	Value	Display Name
Ok	0	Ok
Disconnected	1	Disconnected
ShortCircuited	2	Short circuited
ReversePolarity	3	Reverse polarity
Unknown	4	Unknown

TemperatureType

Id	Value	Display Name
Battery	0	Battery
Fridge	1	Fridge
Generic	2	Generic
Room	3	Room
Outdoor	4	Outdoor
WaterHeater	5	Water Heater
Freezer	6	Freezer

VictronDeviceEnum

Id	Value	Display Name

Generated by victron-mqtt project © 2025
Not affiliated with Victron Energy. For official documentation, visit Victron Energy Live.

This site is open source. Improve this page.