Update victron_mqtt to 2026.6.3 (#433)

## Changes

- Rename multi AC Input sensors to distinguish from AC Output (#423)
- Set precision=2 on solarcharger total yield and clarify MQTT Explorer docs (#431)

## Contributors

@github-actions[bot], @tomer-w

Co-authored-by: tomer-w <57483589+tomer-w@users.noreply.github.com>

Author: github-actions[bot]

custom_components/victron_mqtt/_vendor/__init__.py

@@ -1,3 +1,3 @@
 """Vendored third-party packages."""
 
-VICTRON_MQTT_VERSION = "2026.6.1"
+VICTRON_MQTT_VERSION = "2026.6.3"

custom_components/victron_mqtt/_vendor/victron_mqtt/__init__.py

@@ -19,6 +19,7 @@
     DigitalInputInputState,
     DigitalInputState,
     DigitalInputType,
+    DVCCMode,
     ErrorCode,
     ESSMode,
     ESSModeHub4,
@@ -74,6 +75,7 @@
     "DESSReactiveStrategy",
     "DESSRestrictions",
     "DESSStrategy",
+    "DVCCMode",
     "Device",
     "DeviceType",
     "DigitalInputInputState",

custom_components/victron_mqtt/_vendor/victron_mqtt/_victron_enums.py

@@ -33,6 +33,7 @@ class DeviceType(VictronDeviceEnum):
     SWITCH = ("switch", "switch", "Switch")
     GPS = ("gps", "gps", "GPS")
     SYSTEM_SETUP = ("SystemSetup", "system_setup", "System setup", "system")  # Should be mapped to SYSTEM
+    SERVICES = ("Services", "services", "<Not used>", "system")  # Should be mapped to SYSTEM
     TRANSFER_SWITCH = ("TransferSwitch", "transfer_switch", "Transfer switch")
     DIGITAL_INPUT = ("digitalinput", "digital_input", "Digital input")
     DC_SYSTEM = ("dcsystem", "dc_system", "DC system")
@@ -53,6 +54,20 @@ class DeviceType(VictronDeviceEnum):
     DCDC = ("dcdc", "dcdc", "DC/DC charger")  # Orion XS 1400 in battery to battery charging mode.
 
 
+class DVCCMode(VictronEnum):
+    """DVCC (Distributed Voltage and Current Control) mode.
+
+    Bit 0: DVCC enabled (0=off, 1=on)
+    Bit 1: Forced by system/BMS (0=user-controllable, 1=forced)
+    See https://github.com/victronenergy/dbus-systemcalc-py delegates/dvcc.py
+    """
+
+    OFF = (0, "off", "Off")
+    ON = (1, "on", "On")
+    FORCED_OFF = (2, "forced_off", "Forced off")
+    FORCED_ON = (3, "forced_on", "Forced on")
+
+
 class GenericOnOff(VictronEnum):
     """On/Off Enum"""
 

custom_components/victron_mqtt/_vendor/victron_mqtt/_victron_formulas.py

@@ -4,7 +4,15 @@
 
 from typing import TYPE_CHECKING
 
-from ._victron_enums import ChargeSchedule, ESSModeHub4, ESSState, ESSUserMode, GenericOnOff, PreferRenewableEnergyEnum
+from ._victron_enums import (
+    ChargeSchedule,
+    DVCCMode,
+    ESSModeHub4,
+    ESSState,
+    ESSUserMode,
+    GenericOnOff,
+    PreferRenewableEnergyEnum,
+)
 from .constants import MetricType
 from .data_classes import GpsLocation
 from .formula_common import left_riemann_sum_internal
@@ -93,6 +101,50 @@ def schedule_charge_enabled_set(
     return enabled, None
 
 
+def dvcc_enabled(
+    depends_on: dict[str, Metric], _transient_state: FormulaTransientState | None
+) -> tuple[GenericOnOff | None, None]:
+    """Derive DVCC on/off from Settings/Services/Bol (bit 0 = enabled)."""
+    metric = next(iter(depends_on.values()))
+    if metric.value is None:
+        return None, None
+    code = metric.value.code if isinstance(metric.value, DVCCMode) else int(metric.value)
+    return (GenericOnOff.ON if code & 1 else GenericOnOff.OFF), None
+
+
+def dvcc_enabled_set(
+    value: str, depends_on: dict[str, Metric], _transient_state: FormulaTransientState | None
+) -> tuple[GenericOnOff, None]:
+    """Toggle DVCC by writing 0 or 1 to the hidden Bol SELECT.
+
+    When the system/BMS has forced DVCC (bit 1 set), the write is ignored
+    and the current forced state is returned unchanged.
+    """
+    enabled = value if isinstance(value, GenericOnOff) else GenericOnOff.from_id_or_string(value)
+    assert enabled is not None, "Failed to determine DVCC enabled state"
+    metric = next(iter(depends_on.values()))
+    assert isinstance(metric, WritableMetric), "Expected WritableMetric for dvcc_enabled_set"
+    # Do not override BMS/system-forced state (FORCED_OFF=2, FORCED_ON=3)
+    current_code = metric.value.code if isinstance(metric.value, DVCCMode) else int(metric.value or 0)
+    if current_code & 2:
+        # Forced by system — return current state without writing
+        return (GenericOnOff.ON if current_code & 1 else GenericOnOff.OFF), None
+    metric.set(DVCCMode.ON if enabled == GenericOnOff.ON else DVCCMode.OFF)
+    return enabled, None
+
+
+def dvcc_state(
+    depends_on: dict[str, Metric], _transient_state: FormulaTransientState | None
+) -> tuple[DVCCMode | None, None]:
+    """Pass through the full DVCC state (Off, On, Forced off, Forced on)."""
+    metric = next(iter(depends_on.values()))
+    if metric.value is None:
+        return None, None
+    if isinstance(metric.value, DVCCMode):
+        return metric.value, None
+    return DVCCMode.from_code(int(metric.value)), None
+
+
 def ess_batterylife_state(
     depends_on: dict[str, Metric], _transient_state: FormulaTransientState | None
 ) -> tuple[ESSState | None, None]:

custom_components/victron_mqtt/_vendor/victron_mqtt/_victron_topics.py

@@ -18,6 +18,7 @@
     DigitalInputInputState,
     DigitalInputState,
     DigitalInputType,
+    DVCCMode,
     ErrorCode,
     ESSMode,
     ESSModeHub4,
@@ -276,6 +277,15 @@
         enum=GenericAlarmEnum,
         metric_type=MetricType.PROBLEM,
     ),
+    TopicDescriptor(
+        topic="N/{installation_id}/battery/{device_id}/Alarms/HighCellVoltage",
+        message_type=MetricKind.SENSOR,
+        short_id="battery_high_cell_voltage",
+        name="High cell voltage",
+        value_type=ValueType.ENUM,
+        enum=GenericAlarmEnum,
+        metric_type=MetricType.PROBLEM,
+    ),
     TopicDescriptor(
         topic="N/{installation_id}/battery/{device_id}/Alarms/HighChargeCurrent",
         message_type=MetricKind.SENSOR,
@@ -302,6 +312,15 @@
         value_type=ValueType.ENUM,
         enum=GenericAlarmEnum,
     ),
+    TopicDescriptor(
+        topic="N/{installation_id}/battery/{device_id}/Alarms/HighVoltage",
+        message_type=MetricKind.SENSOR,
+        short_id="battery_high_voltage",
+        name="High voltage",
+        value_type=ValueType.ENUM,
+        enum=GenericAlarmEnum,
+        metric_type=MetricType.PROBLEM,
+    ),
     TopicDescriptor(
         topic="N/{installation_id}/battery/{device_id}/Alarms/InternalFailure",
         message_type=MetricKind.SENSOR,
@@ -329,6 +348,24 @@
         enum=GenericAlarmEnum,
         metric_type=MetricType.PROBLEM,
     ),
+    TopicDescriptor(
+        topic="N/{installation_id}/battery/{device_id}/Alarms/LowSoc",
+        message_type=MetricKind.SENSOR,
+        short_id="battery_low_soc",
+        name="Low state of charge",
+        value_type=ValueType.ENUM,
+        enum=GenericAlarmEnum,
+        metric_type=MetricType.PROBLEM,
+    ),
+    TopicDescriptor(
+        topic="N/{installation_id}/battery/{device_id}/Alarms/LowVoltage",
+        message_type=MetricKind.SENSOR,
+        short_id="battery_low_voltage",
+        name="Low voltage",
+        value_type=ValueType.ENUM,
+        enum=GenericAlarmEnum,
+        metric_type=MetricType.PROBLEM,
+    ),
     TopicDescriptor(
         topic="N/{installation_id}/battery/{device_id}/Capacity",
         message_type=MetricKind.SENSOR,
@@ -1564,21 +1601,21 @@
         topic="N/{installation_id}/multi/{device_id}/Ac/In/1/{phase}/I",
         message_type=MetricKind.SENSOR,
         short_id="multi_acin_current_{phase}",
-        name="Current {phase}",
+        name="Input current on {phase}",
         metric_type=MetricType.CURRENT,
     ),
     TopicDescriptor(
         topic="N/{installation_id}/multi/{device_id}/Ac/In/1/{phase}/P",
         message_type=MetricKind.SENSOR,
         short_id="multi_acin_power_{phase}",
-        name="Power on {phase}",
+        name="Input power on {phase}",
         metric_type=MetricType.POWER,
     ),
     TopicDescriptor(
         topic="N/{installation_id}/multi/{device_id}/Ac/In/1/{phase}/V",
         message_type=MetricKind.SENSOR,
         short_id="multi_acin_voltage_{phase}",
-        name="Voltage on {phase}",
+        name="Input voltage on {phase}",
         metric_type=MetricType.VOLTAGE,
     ),
     TopicDescriptor(
@@ -2344,6 +2381,36 @@
         name="Relay {relay} custom name",
         value_type=ValueType.STRING,
     ),
+    # DVCC (Distributed Voltage and Current Control)
+    # Hidden SELECT receives the raw Settings/Services/Bol value (0-3).
+    # Two formula metrics expose it as a writable SWITCH (on/off) and a read-only SENSOR (all 4 states).
+    TopicDescriptor(
+        topic="N/{installation_id}/settings/{device_id}/Settings/Services/Bol",
+        message_type=MetricKind.SELECT,
+        short_id="system_dvcc_raw",
+        name="DVCC (raw)",
+        value_type=ValueType.ENUM,
+        enum=DVCCMode,
+        hidden=True,
+    ),
+    TopicDescriptor(
+        topic="$$func/system/dvcc_enabled:dvcc_enabled_set",
+        depends_on=["system_dvcc_raw"],
+        message_type=MetricKind.SWITCH,
+        short_id="system_dvcc",
+        name="DVCC",
+        value_type=ValueType.ENUM,
+        enum=GenericOnOff,
+    ),
+    TopicDescriptor(
+        topic="$$func/system/dvcc_state",
+        depends_on=["system_dvcc_raw"],
+        message_type=MetricKind.SENSOR,
+        short_id="system_dvcc_state",
+        name="DVCC state",
+        value_type=ValueType.ENUM,
+        enum=DVCCMode,
+    ),
     # System Setup topics
     TopicDescriptor(
         topic="N/{installation_id}/settings/{device_id}/Settings/SystemSetup/AcInput1",
@@ -2638,6 +2705,7 @@
         short_id="solarcharger_yield_total",
         name="Total yield",
         metric_type=MetricType.ENERGY,
+        precision=2,
     ),
     # Switch topics based on SwitchableOutput
     TopicDescriptor(

custom_components/victron_mqtt/_vendor/victron_mqtt/metric.py

@@ -271,7 +271,12 @@ def _handle_message(
         self._value = value
 
         # In case of non-zero update frequency, respect the update frequency limit only for numerical values
-        if not force and self._hub._update_frequency_seconds is not None and isinstance(value, float | int):
+        if (
+            not force
+            and self._hub._update_frequency_seconds is not None
+            and isinstance(value, float | int)
+            and not isinstance(value, bool)  # bool is a subclass of int, but we only want real numeric sensor values.
+        ):
             elapsed = now - self._last_notified
             if elapsed < self._hub._update_frequency_seconds:
                 _LOGGER.debug(

custom_components/victron_mqtt/_vendor/victron_mqtt/writable_metric.py

@@ -158,12 +158,18 @@ def _is_dynamic_dropdown(self) -> bool:
 
     @property
     def metric_kind(self) -> MetricKind:
-        """Returns the metric kind, resolved dynamically when DYNAMIC."""
+        """Returns the metric kind, resolved dynamically when DYNAMIC.
+
+        DYNAMIC is used for SwitchableOutput State, which is always on/off (0/1)
+        regardless of output type. For dropdown outputs (Type=6 with labels),
+        it resolves to SELECT; otherwise it stays SWITCH.
+
+        Note: dimmable outputs (Type=2) have a separate Dimming topic that is
+        hardcoded as MetricKind.NUMBER — State itself is still a switch.
+        """
         if self._descriptor.message_type == MetricKind.DYNAMIC:
             if self._is_dynamic_dropdown:
                 return MetricKind.SELECT
-            if self._output_type == SwitchableOutputType.DIMMABLE:
-                return MetricKind.NUMBER
             return MetricKind.SWITCH
         return super().metric_kind