Geräteprofil · Verschiedenes

JUDO ZEWA i-SAFE / PROM-i-SAFE (Leckageschutz)

Hinweis: Dieses Profil ist nach der offiziellen JUDO-Dokumentation (JUDO REST API – Geräte und Kommandos, RESTAPI_Kommandos.pdf, und Handbuch JUDO Smart Home 1702574, Kapitel 7) erstellt.

Voraussetzungen

1. JUDO ZEWA i-SAFE (Gerätetyp 0x44) mit JUDO Connectivity-Modul (LAN oder WLAN). ZEWA i-SAFE FILT und PROM-i-SAFE melden denselben Gerätetyp; ihre Seite in der JUDO-Kommandotabelle führt die Lesebefehle 6800 (Leckageeinstellungen) und 6900 (Leckageschutz-Status) aber nicht auf. Ob sie dort funktionieren, ist ungeprüft.
2. Connectivity-Modul mit mindestens Software 3.20 / Hardware 4.0 (Voraussetzung von JUDO für die REST API)
3. Das Modul ist im Heimnetz erreichbar; die lokale REST API ist per HTTP Basic Auth geschützt, Zugangsdaten wie im Web-Interface des Moduls (Werkseinstellung admin / Connectivity)
4. Enthärtungsanlagen (i-soft SAFE+ usw.) verwenden andere Kommandos – z. B. ist 5100 dort „Wunschwasserhärte lesen“, bei der ZEWA i-SAFE dagegen „Leckageschutz schließen“. Dieses Profil daher nur mit einer ZEWA i-SAFE / PROM-i-SAFE verwenden (für Enthärter siehe Profil judo_isoft).

Einrichtung

1. Dem Connectivity-Modul eine feste IP-Adresse geben (Web-Interface → Netzwerk oder DHCP-Reservierung im Router)
2. Skills → Add-ons: Profil importieren
3. Gerät anlegen und IP-Adresse des Connectivity-Moduls eintragen; Port 80, Benutzer und Passwort nur ändern, wenn sie im Web-Interface geändert wurden
4. Optional im Web-Interface den Haken Verbindung zum Portal-Server herstellen entfernen, dann arbeitet das Modul nur noch lokal

Datenbereich

Abgefragt wird per HTTP GET http://<ip>/api/rest/<Kommando>; das Modul antwortet mit {"data":"<Hex-Bytes>"}, mehrbytige Werte kommen LSB first.

• Leckageschutz-Status (6900, alle 30 s, Intervall änderbar), 32-Bit-Statuswort:
  • Wasser offen (state, Bit 14 „Ventil offen“)
  • Kugelventil: Offen / Geschlossen / Öffnet / Schließt (Bits 12–15)
  • Leckage erkannt (malfunction): Wassermenge, Durchfluss oder Entnahmezeit überschritten, Leckage, Kleinleckage (Bits 3–6, 8, 9)
  • Leckagegrund (Bits 3–6, 8, 9)
  • Status (status): Normalbetrieb, Urlaubsmodus, Sleepmodus, Lernmodus, Sonderregelung, Ventil öffnet/schließt, geschlossen (manuell/U3/Eingang), Leckagegründe, kein Durchfluss seit 15 Tagen. Sind mehrere Bits gesetzt, gewinnt das mit der höchsten Bitnummer (z. B. Sleepmodus vor Leckage); den Leckagegrund zeigt deshalb zusätzlich der eigene Wert Leckagegrund.
  • Urlaubsmodus aktiv, Sleepmodus aktiv (auch über Eingang), Lernmodus aktiv, kein Durchfluss seit 15 Tagen
  • Statuswort roh (ausgeblendet)
• Gesamtwassermenge in m³ (2800, alle 60 s)
• Einstellungen (alle 10 min): Urlaubsmodus-Typ Aus/U1/U2/U3, max. Volumenstrom (l/h), max. Entnahmemenge (l), max. Entnahmedauer (min) (6800), Sleepmodus-Dauer (h) (6600)
• Gerätestatus (stündlich, ausgeblendet): Gerätetyp (FF00), Gerätenummer (0600)
• Erreichbarkeit (reachable): aus dem Erfolg der HTTP-Abfragen

Schreibbar (alle Befehle sind HTTP GET):

• Wasser offen (state): ein = Leckageschutz öffnen (/api/rest/5200), aus = schließen (/api/rest/5100)
• Meldung zurücksetzen (6300), Mikroleckageprüfung starten (5C00)
• Sleepmodus starten / beenden (5400 / 5500), Sleepmodus-Dauer 1 … 10 h (5300<h>)
• Urlaubsmodus starten / beenden (5700 / 5800), Urlaubsmodus-Typ Aus/U1/U2/U3 (5600<Typ>)

Hinweise

• Nach einem Schaltbefehl zeigt nomos den neuen Ventilzustand erst mit der nächsten Statusabfrage (spätestens nach dem eingestellten Intervall, Standard 30 s). Während der Fahrt des Kugelventils meldet das Gerät Öffnet / Schließt, Wasser offen ist dann aus.
• Der Urlaubsmodus U3 schließt das Wasser. Ist das Wasser wegen U3 oder einer Leckage geschlossen, kann ein Öffnen je nach Gerätelogik erst nach Meldung zurücksetzen bzw. dem Beenden des Urlaubsmodus wirken – das ist am echten Gerät noch zu prüfen.
• Die Grenzwerte (Volumenstrom, Entnahmemenge, Entnahmedauer) sind nur lesbar. JUDO schreibt sie nur gemeinsam mit dem Urlaubsmodus in einem Befehl (50), das ist im Profil nicht abgebildet.
• Das Connectivity-Modul bearbeitet nur eine Anfrage gleichzeitig und antwortet bei Überlast mit 429 Too Many Requests. Das Profil hält deshalb 2 s Abstand zwischen zwei Anfragen. Eine abgelehnte Anfrage setzt reachable kurz auf nein, bis die nächste Abfrage gelingt. Das kann auch passieren, wenn gleichzeitig die JUDO-App oder eine andere Steuerung auf das Modul zugreift.
• Lehnt das Gerät 6900 ab (z. B. ältere Firmware oder FILT/PROM-Variante ohne diesen Befehl), bleiben alle Statuswerte leer und reachable wechselt bei jeder Statusabfrage kurz auf nein. Dann bitte melden.
• Einen aktuellen Durchfluss liefert die ZEWA i-SAFE über die lokale API nicht; er ist im Profil nicht enthalten.
• Nicht abgebildet: Lernmodus starten/quittieren, Abwesenheitszeiten und -limits, Mikroleckage-Einstellung, Datum/Uhrzeit, Wasserstatistiken.
• Datengrundlage: JUDO RESTAPI_Kommandos.pdf (https://judo.eu/ftp-upload/download/REST-API/RESTAPI_Kommandos.pdf, Seite „Leckageschutzgerät ZEWA i-SAFE“) und Handbuch 1702574 (Ausgabe 2026/01, Kapitel 7); abgeglichen mit https://github.com/tach2004/JUDO-ZEWA-iSafe-Rest-API.