Home Assistant Integration

Aqua-Scope WLAN-Geräte können direkt in Home Assistant eingebunden werden. Die Integration basiert auf MQTT und nutzt die MQTT-Discovery-Funktion von Home Assistant – einmal aktiviert, erscheinen alle Sensoren, Aktoren und Alarme automatisch im Dashboard.

Voraussetzungen

• Eine laufende Home Assistant Installation (z.B. Home Assistant OS auf Raspberry Pi)
• Lokale IP-Adresse des Home Assistant Systems
• Aqua-Scope Gerät mit eingerichteter WLAN-Anbindung

IP-Adresse herausfinden

Falls die IP-Adresse des Home Assistant Systems nicht bekannt ist, kann das „Local IP"-Add-on aus dem Home Assistant Add-on Store installiert werden. Es zeigt die aktuelle IP-Adresse direkt im Dashboard an.

Schritt 1: Mosquitto MQTT-Broker installieren

Home Assistant benötigt einen MQTT-Broker, über den die Aqua-Scope Geräte kommunizieren. Empfohlen wird das offizielle Mosquitto broker Add-on.

1. Öffnen Sie in Home Assistant Einstellungen → Add-ons → Add-on Store
2. Suchen Sie nach „Mosquitto broker"
3. Klicken Sie auf Installieren
4. Aktivieren Sie nach der Installation die Option „Start beim Booten"
5. Klicken Sie auf Start

Schritt 2: MQTT-Benutzer anlegen

Die Aqua-Scope Geräte melden sich beim Broker mit Benutzername und Passwort an. Legen Sie dafür einen dedizierten Benutzer an.

1. Öffnen Sie Einstellungen → Personen (bzw. Benutzer)
2. Klicken Sie auf Person hinzufügen bzw. Benutzer hinzufügen
3. Tragen Sie als Anzeigename und Benutzername z.B. mqtt-user ein
4. Vergeben Sie ein sicheres Passwort und bestätigen Sie es
5. Klicken Sie auf Erstellen

Passwort merken

Notieren Sie sich Benutzername und Passwort – beides wird in Schritt 4 und Schritt 5 erneut benötigt.

Schritt 3: Home Assistant neu starten

Damit der neu angelegte Benutzer vom MQTT-Broker erkannt wird, ist ein Neustart erforderlich:

Einstellungen → System → Hardware → Neustart

Schritt 4: MQTT-Integration konfigurieren

Nach dem Neustart wird die MQTT-Integration mit dem neuen Benutzer verbunden.

1. Öffnen Sie Einstellungen → Geräte & Dienste
2. Suchen Sie nach MQTT und klicken Sie auf Konfigurieren (oder fügen Sie die Integration neu hinzu)
3. Tragen Sie folgende Daten ein:

Feld	Wert
Broker	core-mosquitto
Port	1883
Benutzername	mqtt-user
Passwort	das in Schritt 2 vergebene Passwort

4. Klicken Sie auf Absenden

Die Integration sollte nun als „Konfiguriert" angezeigt werden und das Mosquitto Add-on den Status „Läuft".

Schritt 5: Aqua-Scope Gerät mit dem Broker verbinden

Damit das Aqua-Scope Gerät seine Daten an Home Assistant sendet, müssen die MQTT-Verbindungsdaten im Gerät hinterlegt werden.

1. Öffnen Sie die Aqua-Scope App
2. Wählen Sie das gewünschte Gerät aus
3. Navigieren Sie zu Konfiguration → Kommunikationsoptionen
4. Aktivieren Sie MQTT und tragen Sie ein:

Parameter	Wert
Server	IP-Adresse Ihres Home Assistant Systems (z.B. 192.168.1.42)
Port	1883
Benutzername	mqtt-user
Passwort	das in Schritt 2 vergebene Passwort

Details zu den MQTT-Parametern finden Sie auf der Seite MQTT.

Schritt 6: Home Assistant Support aktivieren

1. In der Aqua-Scope App das Gerät weiterhin geöffnet halten
2. Unter Konfiguration die Option „Home Assistant Support" aktivieren
3. Speichern

Nach der Aktivierung sendet das Gerät automatisch die MQTT-Discovery-Nachrichten an den Broker. Home Assistant erkennt das Gerät und legt alle Entitäten selbstständig an – ein Eintrag in der configuration.yaml ist nicht erforderlich.

Automatisch erkannte Entitäten

Sobald der Home Assistant Support aktiv ist, erscheinen je nach Gerätetyp folgende Entitäten:

Sensoren

Sensor	Geräte
Temperatur	Alle Geräte
Wasserdruck	AQS, AQX, PRE
Wasserverbrauch	AQM, AQX
Regenmenge	RAN
Luftfeuchtigkeit	FLO, CLP
Batteriestatus	Alle batteriebetriebenen Geräte

Aktoren

Aktor	Geräte
Ventil Auf/Zu	BVS, KFR (über Monitor)

Alarme

Alle Alarmmeldungen des Gerätes (Leckage, Überdruck, Frost, etc.) stehen als MQTT-Events zur Verfügung und können in Automationen verwendet werden.

Jede Alarmmeldung enthält ein Feld source:

• source: 0 – Alarm vom Hauptgerät
• source: 1 oder höher – Alarm von einem angelernten Untergerät (z.B. Flutsensor oder Motor)

Beispiel-Automation

Bei einem Flutalarm eine Mobile-Benachrichtigung senden und das Kellerlicht einschalten:

automation:
  - alias: "Aqua-Scope Flutalarm"
    trigger:
      - platform: mqtt
        topic: "/AQS/12345678/alarm"
    condition:
      - condition: template
        value_template: "{{ trigger.payload_json.alarm == 'flood' }}"
    action:
      - service: notify.mobile_app
        data:
          message: >
            Wasseralarm! Flutsensor hat Wasser erkannt.
            (Quelle: {{ trigger.payload_json.source }})
      - service: light.turn_on
        target:
          entity_id: light.keller

Ersetzen Sie 12345678 durch die 8-stellige Geräte-ID Ihres Aqua-Scope Gerätes (auf dem Gerät aufgedruckt).

Tipps & Fehlerbehebung

Mehrere Geräte

Jedes Aqua-Scope Gerät hat eine eindeutige Geräte-ID. Beliebig viele Geräte können parallel an denselben Broker angebunden werden und erscheinen als separate Geräte in Home Assistant.

Verbindung schlägt fehl

Bleibt das Gerät offline in Home Assistant, prüfen Sie:

• Stimmt die IP-Adresse des Home Assistant Systems in der App?
• Wurde Home Assistant nach dem Anlegen des MQTT-Benutzers neu gestartet?
• Stimmen Benutzername und Passwort?
• Erlaubt die Firewall den Zugriff auf Port 1883?

Verschlüsselte Verbindung

Für eine TLS-verschlüsselte Verbindung verwenden Sie Port 8883. Details siehe MQTT-Seite.

Unterstützte Geräte

Home Assistant Discovery wird von allen WLAN-fähigen Aqua-Scope Geräten unterstützt:

• AQMWIE01 – Ultraschall-Durchflussmesser
• AQSWIE02 / AQXWIE02 – Leckageschutz-Monitor
• RANWIE01 – Regenmesser
• CLPWIE01 – Pipe Clip
• KFRWIE01 – KFR-Motor (WLAN)
• PREWIE02 – Drucksensor
• MCLWIE01 – WLAN-Konnektor