Geräteprofil · Heizkessel

ETA ETAtouch

Hinweis: Dieses Profil beruht auf der Herstellerdokumentation „ETAtouch RESTful Webservices“ (Version 1.2) und auf den Variablen-Adressen (URIs) echter Anlagen. Die schreibbaren Variablen (Version 1.1 des Profils) sind mit den Variablen-Infos (/user/varinfo) einer echten Anlage abgeglichen.

Voraussetzungen

1. ETA-Kessel (Pellets PU/PE/PC, Stückholz SH, Hackgut …) mit ETAtouch-Bedienung, Systemsoftware 1.20.0 oder neuer, feste IP-Adresse (DHCP-Reservierung)
2. Die ETAtouch ist auf www.meineta.at registriert, dort ist der LAN-Zugriff beantragt und am Touch-Display in den Systemeinstellungen aktiviert
3. Die Webservices antworten danach auf Port 8080. Test im Browser: http://<IP>:8080/user/menu zeigt den Menübaum der Anlage als XML.
4. nomos-System mit Backend 0.3.51 oder neuer (nomos-Daemon 1.2.9): Nur diese Version sendet die Schreibbefehle als HTTP POST; das Profil verlangt diese Version (minVersion).

Einrichtung

1. nomos Config Panel öffnen
2. Das ETAtouch-Profil unter Skills → Add-ons importieren
3. Gerät hinzufügen
4. IP-Adresse der ETAtouch eintragen, Port auf 8080 lassen
5. Die Variablen-Adressen (URIs) prüfen und bei Bedarf anpassen (siehe unten)

Variablen-Adressen anpassen

Jeder Wert wird einzeln über GET /user/var/<URI> gelesen und – bei den schreibbaren Werten – über POST /user/var/<URI> gesetzt. Eine URI hat die Form /<CAN-Knoten>/<Funktionsblock>/<Fkt-ID>/<IO-ID>/<Variablen-ID>. Die Variablen-ID ist bei ETA anlagenübergreifend gleich, Knoten-Nummer und teils der Funktionsblock unterscheiden sich aber je nach Anlage (z. B. Kessel auf Knoten 40, Puffer und Warmwasser auf 120; ältere Anlagen alles auf 112).

So findet man die richtige Adresse:

1. Im Browser http://<IP>:8080/user/menu öffnen
2. Den Eintrag suchen, z. B. <fub uri="/40/10021" name="Kessel"> und darin <object uri="/40/10021/0/0/12161" name="Kessel"/>
3. Den Wert von uri (ohne /user/var) in die Einstellung übernehmen
4. Gegenprobe: http://<IP>:8080/user/var/40/10021/0/0/12161 liefert <value … strValue="68" unit="°C" … scaleFactor="10" …>684</value>

Ist ein Bauteil nicht vorhanden (z. B. kein Pufferspeicher), antwortet die ETAtouch mit einer Fehlermeldung; der Wert bleibt dann einfach leer.

Datenbereich

• Kessel: Kesseltemperatur, Status im Klartext (status, in der Sprache der ETAtouch), Status-Code, Kessel heizt (active)
• System: Außentemperatur, Störung (malfunction) aus der Fehlerliste /user/errors
• Pufferspeicher: Temperatur oben und unten
• Warmwasser: Speichertemperatur, Warmwasser-Soll, „Warmwasser sofort laden“ aktiv

Status, Ein/Aus-Taste, „Sofort laden“ alle 30 Sekunden, Fehlerliste, Temperaturen und Warmwasser-Soll alle 60 Sekunden.

Schreibbar:

• Kessel Ein/Aus (boiler_power, boiler_on/boiler_off) – setzt die Ein/Aus Taste des Kessels (value=1803 Ein, value=1802 Aus), genau wie die Taste am Touch-Display. Es heißt bewusst nicht state: Ein Tipp auf die Kachel schaltet bei „Bedienung mit einem Tipp“ den Zustand state um, das würde hier den Kessel abschalten. Die Kachel ist grün, solange der Kessel heizt (active).
• Warmwasser-Soll setzen (setpoint_dhw, 20–80 °C in 1-°C-Schritten) – schreibt den Sollwert mal 10 (z. B. 55 °C → value=550)
• Warmwasser sofort laden (dhw_charge_now) – drückt die Taste Warmwasser sofort laden (value=1803); der Speicher wird einmalig auf die am Touch eingestellte Solltemperatur für ‘Sofort laden’ geladen

Jeder Schreibbefehl ist ein POST /user/var/<URI> mit dem Inhalt value=<Rohwert> (application/x-www-form-urlencoded), wie in der ETA-Dokumentation beschrieben. Die ETAtouch bestätigt mit <success uri="…"/>; der neue Wert erscheint in nomos mit der nächsten Abfrage (spätestens nach 30 bzw. 60 Sekunden).

Hinweise

• Schreiben ändert die Einstellungen der Anlage selbst: Ein Schreibbefehl wirkt wie eine Eingabe am Touch-Display und bleibt in der ETAtouch gespeichert, auch wenn nomos später nichts mehr sendet.
• Kessel Aus schaltet den Kessel über seine Ein/Aus-Taste ab: Er heizt dann nicht mehr; Puffer, Warmwasser und Heizkreise bekommen nur noch vorhandene Wärme bzw. Wärme aus anderen Quellen. Wie sich Frostschutz und Heizkreise bei ausgeschaltetem Kessel verhalten, regelt die ETAtouch selbst – vor dem Einsatz in Automationen in der ETA-Bedienungsanleitung prüfen.
• Warmwasser-Soll: Die ETAtouch erlaubt laut Variablen-Info 0–90 °C, das Add-on begrenzt den Schieberegler auf 20–80 °C. Für den Legionellenschutz die Vorgaben des Installateurs beachten.
• Schreibrechte: Die ETA-Dokumentation kennt keine eigene Schreibfreigabe – ist der LAN-Zugriff aktiv, sind die Variablen mit isWritable="1" (siehe http://<IP>:8080/user/varinfo/<URI>) auch schreibbar. Ob einzelne Anlagen oder Benutzerebenen das einschränken, ist nicht geprüft.
• Fehler beim Schreiben meldet die ETAtouch mit <error>…</error> in einer normalen Antwort (HTTP 200). nomos zeigt diese Meldung nicht an; ob ein Wert übernommen wurde, zeigt erst die nächste Abfrage des Werts.
• Kessel Ein/Aus und „Sofort laden aktiv“ gelten als Ein, wenn die Taste den Rohwert 1803 hat; jeder andere Wert ist Aus.
• Temperaturen werden als Rohwert gelesen und durch 10 geteilt, der Warmwasser-Soll wird mal 10 geschrieben (scaleFactor="10", so bei allen °C-Variablen der ETAtouch). Wird eine URI auf eine Variable mit anderem scaleFactor umgestellt, stimmt die Skalierung nicht mehr.
• Heizkreise (Betriebsart, Tag/Absenken, Kommen/Gehen) schreibt das Profil bewusst nicht: Die Tasten der Heizkreise sind voneinander abhängig, und ihre Rückmeldung ist ohne Test an einer echten Anlage nicht eindeutig.
• active ist ein, wenn der Kesselstatus einer dieser Codes ist: Pellets 2005 Zünden, 2006/2021 Heizen, 2026 Anheizen, 2037–2039 Heizen (mit Emissionsmessung); Stückholz 4009 In Betrieb, 4011 Heizen. Andere Kesseltypen (z. B. Wärmepumpen) verwenden andere Codes – dort bleibt active aus; der Klartext-Status und status_code zeigen den tatsächlichen Wert.
• malfunction ist ein, sobald die ETAtouch irgendeinen Eintrag in ihrer Fehlerliste führt – auch Warnungen und Erinnerungen wie „Aschebox leeren“.
• Wärmepumpen und Anlagen ohne Kessel-Funktionsblock brauchen eigene URIs; die Vorgaben sind auf Pellets- und Stückholzkessel ausgelegt.