Geräteprofil · Verschiedenes

JUDO i-soft SAFE+ / i-soft K SAFE+ (Enthärtungsanlage)

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. Byte-Reihenfolge und Beispielwerte sind an einer i-soft SAFE+ (Gerätesoftware 3.02) abgeglichen.

Voraussetzungen

1. JUDO i-soft SAFE+ oder i-soft K SAFE+ (Gerätetyp 0x33, 0x57, 0x42, 0x67) mit JUDO Connectivity-Modul (LAN oder WLAN)
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. Für die i-soft PRO-Serie und den Leckageschutz ZEWA i-SAFE gibt es eigene Kommandotabellen; diese Geräte werden von diesem Profil nicht unterstützt (für die ZEWA i-SAFE siehe Profil judo_zewa_isafe)

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.

• Wasser (alle 60 s): Gesamtwassermenge (2800) und Weichwassermenge (2900) in m³
• Salz (alle 5 min): Salzvorrat in kg und Salzreichweite in Tagen (5600); Salzmangel-Warnschwelle in Tagen (5700, ausgeblendet)
• Einstellungen (alle 5 min): Wunschwasserhärte in °dH (5100), Härteeinheit am Gerät (2300, ausgeblendet)
• Gerätestatus (stündlich, ausgeblendet): Betriebstage (2500), Gerätetyp (FF00), Gerätenummer (0600)
• Erreichbarkeit (reachable): aus dem Erfolg der HTTP-Abfragen

Schreibbar (alle Befehle sind HTTP GET):

• Leckageschutz (state): ein = Wasser offen (/api/rest/3D00), aus = Wasser geschlossen (/api/rest/3C00)
• Regeneration starten (/api/rest/350000)
• Wunschwasserhärte 1 … 18 °dH (/api/rest/30<00><Wert>, z. B. 300007 = 7 °dH)
• Salzvorrat setzen nach dem Nachfüllen, 0 … 50 kg (/api/rest/5600<Gramm LSB first>, z. B. 18,5 kg → 56004448)
• Salzmangel-Warnung ab x Tagen Reichweite, 1 … 255 (/api/rest/5700<Tage>)

Hinweise

• Der Zustand des Leckageschutz-Ventils ist über die lokale API der i-soft SAFE+ nicht lesbar. Das Profil kann das Ventil öffnen und schließen, zeigt den aktuellen Ventilzustand aber nicht an. Schließt die Anlage selbst (Leckage erkannt) oder wird sie per App/Taste geöffnet, bekommt nomos davon nichts mit. Ebenso liefert die i-soft SAFE+ lokal keinen Leckage-/Störungsstatus, keinen aktuellen Durchfluss und keine Anzeige einer laufenden Regeneration – deshalb gibt es in diesem Profil kein malfunction, status und active.
• Urlaubsmodus, Mikroleckage-Einstellungen und Leckageschutz global aus (Kommando 41) sowie die Grenzwerte max. Entnahmedauer/-menge/Volumenstrom (3E, 3F, 40) kann die i-soft SAFE+ nur schreiben, nicht zurückmelden. Kommando 41 setzt alle diese Bits auf einmal, ein Schreiben würde die in der JUDO-App gemachten Einstellungen überschreiben. Diese Funktionen sind deshalb bewusst nicht im Profil.
• Die Wunschwasserhärte wird als °dH gelesen und geschrieben (1-Byte-Variante von Kommando 30, die das Gerät in seine eingestellte Härteeinheit umrechnet). Ist am Gerät eine andere Härteeinheit eingestellt, ist ungeprüft, ob 5100 weiterhin °dH liefert.
• Der Bereich 1 … 18 °dH für die Wunschwasserhärte stammt aus der Praxis, nicht aus der JUDO-Doku.
• 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.
• Bei i-soft / i-soft K ohne SAFE+ (Gerätetyp 0x32, 0x53, 0x43, 0x54) sind alle Lesewerte identisch, aber 3C00/3D00 bedeuten dort Leckagealarm setzen/zurücksetzen – den Schalter Leckageschutz dort bitte nicht verwenden.
• Nicht abgebildet: Wasserstatistiken (Tag/Woche/Monat/Jahr), Inbetriebnahmedatum, Softwareversion, Service-Telefonnummer, Härteeinheit schreiben.
• Datengrundlage: JUDO RESTAPI_Kommandos.pdf (https://judo.eu/ftp-upload/download/REST-API/RESTAPI_Kommandos.pdf, Seite „i-soft SAFE+ / i-soft K SAFE+“) und Handbuch 1702574 (Ausgabe 2026/01, Kapitel 7); abgeglichen mit https://github.com/stephanseitz/judo_rest_api.