MQTT-Anbindung
Alle Aqua-Scope WLAN-Geräte unterstützen MQTT zur Integration in Smart-Home-Systeme, eigene Dashboards oder Automatisierungsplattformen wie Home Assistant, Node-RED oder ioBroker.
MQTT aktivieren
MQTT kann auf zwei Wegen aktiviert werden:
Beim Erstsetup (Konfigurationsseite)
Während der WLAN-Einrichtung können Sie unter „Advanced" die MQTT-Verbindungsdaten direkt eingeben.
Nachträglich über die App
- Öffnen Sie die Aqua-Scope App
- Wählen Sie das Gerät aus
- Navigieren Sie zu Konfiguration → Kommunikationsoptionen
- Tragen Sie die MQTT-Verbindungsdaten ein
Konfigurationsparameter
| Parameter | Beschreibung |
|---|---|
server | Hostname oder IP-Adresse des MQTT-Brokers |
port | Port des Brokers (Standard: 1883, TLS: 8883) |
login | Benutzername (optional) |
password | Passwort (optional) |
enable | Dienst aktivieren (1) oder deaktivieren (0) |
Beispiel JSON-Downlink zur MQTT-Konfiguration:
{
"mqtt": {
"enable": "1",
"server": "mein-broker.example.com",
"port": 1883,
"login": "benutzername",
"password": "passwort"
}
}
MQTT über TLS
Aqua-Scope Geräte unterstützen MQTT über TLS für verschlüsselte Verbindungen. Verwenden Sie Port 8883 (oder den von Ihrem Broker konfigurierten TLS-Port). Die Geräte validieren das Server-Zertifikat automatisch.
MQTT Topics
Alle Topics verwenden die 8-stellige Geräte-ID (auf dem Gerät aufgedruckt). Beispiel mit Geräte-ID 12345678:
| Topic | Richtung | Beschreibung |
|---|---|---|
/AQS/12345678/stat | Gerät → Broker | Regelmäßige Statusmeldungen |
/AQS/12345678/alarm | Gerät → Broker | Alarmmeldungen |
/AQS/12345678/cmnd | Broker → Gerät | Steuerbefehle an das Gerät |
Nachrichtenformat
Alle MQTT-Nachrichten verwenden JSON. Die Werte entsprechen dem gleichen Format wie beim JSON-Webhook-Dienst.
Statusmeldung (stat)
Beispiel einer regelmäßigen Statusmeldung:
{
"uptime": 12345,
"temperature": 22.5,
"pressure": 3200,
"battery": 3.1
}
Die enthaltenen Felder variieren je nach Gerätetyp (z.B. rainlevel beim Regenmesser, pressure beim Drucksensor).
Alarmmeldung (alarm)
{
"alarm": "flood",
"state": 1,
"source": 0,
"value": 0
}
| Feld | Beschreibung |
|---|---|
alarm | Alarmtyp (z.B. flood, overpressure, underpressure, temperature) |
state | 1 = Alarm aktiv, 0 = Alarm gelöscht |
source | 0 = Hauptgerät, 1 oder höher = Untergerät (z.B. angelernter Flutsensor oder Motor) |
value | Aktueller Sensorwert, der den Alarm ausgelöst hat (z.B. Druck in mBar bei Unterdruck-Alarm, Temperatur bei Frost-Alarm). Nicht bei allen Alarmtypen vorhanden. |
Steuerbefehle (cmnd)
Beispiel – Ventil schließen:
{"valve": "0"}
Beispiel – Ventil öffnen:
{"valve": "100"}
Unterstützte Geräte
MQTT wird von allen WLAN-fähigen Aqua-Scope Geräten unterstützt: