Skip to content

MQTT Bridge EN

Kay edited this page Apr 26, 2026 · 1 revision

MQTT Bridge

Sprache: English · Deutsch

The integration can optionally mirror all device states to a local MQTT broker. This is useful for:

  • Local automations in Node-RED or other MQTT-aware tools
  • Cross-system integrations (e.g. another smart-home platform consuming Gardena data)
  • Offline state caching independent of the Home Assistant entity registry

Note: The MQTT bridge does not eliminate the cloud dependency. Device commands are still forwarded through the Husqvarna API. The bridge provides a local event bus for consuming state updates and triggering commands from external systems.

Setup

  1. Ensure the MQTT integration is configured in Home Assistant and connected to a broker.
  2. Go to Settings → Devices & Services → Gardena Smart System → Configure.
  3. Enable MQTT bridge and configure the topic prefix (default: gardena_smart_system).

The bridge starts publishing on the next coordinator update. If the MQTT integration loads after this integration (common on cold boot), the bridge will retry up to once every 5 minutes until MQTT becomes available — no HA restart required.

Outbound Topics

Topic Direction Description
{prefix}/{device_id}/state Outbound Full device state as JSON (retained)
{prefix}/{device_id}/availability Outbound online or offline (retained)

Inbound Commands

Publish a JSON payload to {prefix}/{device_id}/command:

{"action": "start_watering", "duration": 30, "service_id": "device-uuid:1"}
Action Parameters Description
start_watering duration (minutes, default 60), service_id Start valve watering
stop_watering service_id Stop valve
turn_on duration (minutes, default 60), service_id Turn on power socket
turn_off service_id Turn off power socket
park service_id Park mower until further notice
resume service_id Resume mower schedule

service_id identifies the specific service inside a device (e.g. one valve in a multi-valve irrigation control). For single-service devices, use the format the integration logs on startup.

Disabling the Bridge

Open the integration's options again and disable MQTT bridge. Retained state and availability topics remain on the broker until you manually clear them.


See also: Configuration

Clone this wiki locally