Black ForestSmart WorksLOGIKBAUSTEINE & APPS

ETA ETAtouch + DWD PV-Prognose

Bausteinhilfe · ID 10889 · Version 1.0.1 · Stand 21.09.2026

Der Baustein liest eine ETA-Heizung über die lokale ETAtouch-REST-Schnittstelle aus. Aus der offiziellen DWD-MOSMIX-Prognose, den Pufferwerten und einstellbaren Grenzen entscheidet er, ob ein morgendlicher Kesselstart zugunsten erwarteter PV-Energie zurückgestellt werden kann. Zusätzlich lässt sich der Kessel über einen eindeutigen Handbetrieb ein- und ausschalten. Erforderlich sind Gira HomeServer 4 sowie Experte und Firmware 4.13.

Wichtiger Sicherheitshinweis: E22 ist standardmäßig 0. Nur bei E22=1 darf der Baustein die ETA-EIN/AUS-Taste /40/10021/0/0/12080 mit 1802=Aus und 1803=Ein beschreiben. Vor jedem Schreiben prüft er varinfo, Schreibbarkeit und gültige Werte; danach wird der Zustand zurückgelesen. E24=-1 hält den Kessel ohne automatische Zeitbegrenzung ausgeschaltet.

Inbetriebnahme

  1. Projekt sichern und 10889_BFSW_ETA_ETAtouch_DWD_v1.0.1.hslz im Experten importieren.
  2. ETA-IP an E2 eintragen, E3 normalerweise auf 8080 belassen. http://ETA-IP:8080/user/api muss erreichbar sein.
  3. E1=0 und E22=0 belassen, Projekt übertragen und A39 ablesen. HomeServer-MAC mit der Geräteangabe vergleichen.
  4. Lizenz-MAC und Schlüssel an E20/E21 eintragen. E1=1, E7=0, E24=0. A1/A2 und Messwerte mit ETAtouch vergleichen.
  5. Koordinaten an E8/E9, PV-Leistung an E13 und Grenzen E15–E18 einstellen. E7=1 aktivieren und A21–A33 beobachten.
  6. Schreibbetrieb nur beaufsichtigt freigeben: E22=1. Mit E24=-1 AUS und E24=1 EIN prüfen; anschließend E24=0 für Automatik.

Wetter-, Automatik- und Handbetrieb

DWD Rad1h wird bis zur eingestellten lokalen Stunde aufsummiert und in kWh/m² umgerechnet. Die PV-Schätzung lautet: Globalstrahlung × PV-kWp × Performance Ratio. Im Automatikbetrieb E24=0 wird nur gesperrt, wenn DWD-Prognose und ETA-Kernwerte gültig sind, der Zeitpunkt vor E18 liegt, Puffer-Ladezustand und obere Temperatur mindestens E16/E17 erreichen und die PV-Prognose mindestens E15 beträgt. Bei Fehlern bleibt die Automatik freigegeben.

E24BetriebsartVerhalten
-1Handbetrieb AUSFordert 1802/Aus an. E23 gilt nicht; AUS bleibt bis zur Änderung bestehen.
0WetterautomatikEntscheidung aus DWD und Pufferwerten; E23 begrenzt eine automatische Sperre.
1Handbetrieb EINFordert 1803/Ein an, auch wenn der Kessel zuvor manuell oder extern ausgeschaltet war.

E19=1 bleibt als kompatible Sofortfreigabe erhalten und hat wie E24=1 EIN-Priorität. Ohne E22=1 werden nur Empfehlung und gewünschter Rohwert ausgegeben; es erfolgt kein Schreiben.

Eingänge

Nr.NameStandardFunktion
E1Freigabe0ETA- und DWD-Abfrage aktivieren.
E2/E3ETA-IP / Portleer / 8080Lokale ETAtouch-Verbindung.
E4/E5Intervall / Timeout30 s / 8 sETA-Abfrage 10–3600 s; Timeout 1–15 s.
E6Jetzt abfragen01-Impuls, erneuert ETA und DWD.
E7DWD-Wetterüberwachung00 aus, 1 an.
E8/E9Breiten-/Längengrad48,89 / 8,72Anlagenkoordinaten.
E10DWD Stations-IDleerLeer = nächste Station automatisch; sonst feste MOSMIX-ID.
E11/E12DWD-Intervall / Prognoseende60 min / 15 UhrWetteraktualisierung und heutiger Auswertungshorizont.
E13/E14PV-kWp / Performance Ratio24,24 / 0,75Anlagengröße und pauschaler Verlustfaktor.
E15PV-Mindestprognose8 kWhMindestenergie für automatische Sperre.
E16/E17Puffer SOC / Temperatur min.25 % / 45 °CNotwendige Pufferreserve.
E18Sperre spätestens bis10 UhrDanach automatische Freigabe.
E19Manuelle Kesselfreigabe0Kompatibilitätseingang; 1 fordert EIN an.
E20/E21MAC / LizenzleerHomeServer-MAC und vollständiger Lizenzschlüssel.
E22ETA-Schreiben aktivieren00 = nur beobachten; 1 = bestätigte Befehle schreiben.
E23Maximale automatische Sperre180 min15–720 Minuten, gilt nur bei E24=0.
E24Handbetrieb0-1=AUS, 0=Automatik, 1=EIN.

Ausgänge

Nr.GruppeBedeutung
A1–A8StatusETA-Gültigkeit, Verbindung, Abfrage, Fehler, Alter, Zeit, Zähler, API.
A9–A20ETAKessel, Abgas, Leistung, Pellets, Puffer, Außentemperatur, EIN/AUS-Rohwert und Text.
A21–A30DWDGültigkeit, Ausgabezeit, Station, Entfernung, Prognosestunden, Strahlung, Sonne, Bewölkung, PV-kWh.
A31–A33EntscheidungSperre, Freigabe und lesbarer Entscheidungsgrund.
A34/A35SchreibenAktivierung und von ETA bestätigter Schreibstatus.
A36DiagnoseTechnisches JSON; kann Heizungsdaten enthalten.
A37–A39LizenzGültigkeit, Status und lokale HomeServer-MAC.
A40–A43SteuerstatusGewünschter Rohwert, Eigentümerschaft, verbleibende Automatik-Sperrzeit, letzter Schreibbefehl.
A44/A45PelletsInhalt Pelletbehälter und Pelletlager in kg.
A46–A52FWMWarmwasser, Primär-Vorlauf/-Rücklauf, Sekundärdurchfluss, Puffer oben, Pufferpumpe und Beimischpumpe.
A53/A54HeizkreiseVorlauftemperatur FBH und Vorlauftemperatur HK.

Sicherheit

Fehlersuche

MeldungPrüfung
ETA HTTP/TimeoutIP, Port, LAN und /user/api.
Kernwert fehltURI der konkreten Anlagenkonfiguration prüfen; Automatik bleibt freigegeben.
Schreibwerte weichen ab/user/varinfo/40/10021/0/0/12080; erforderlich: isWritable=1, 1802/Aus und 1803/Ein.
Rücklesen fehlgeschlagenE22=0, Zustand am ETA-Display prüfen und dort nötigenfalls EIN schalten.
DWD ungültigInternetzugang/DNS des HomeServers prüfen.
A37=0A38 lesen, MAC aus A39 und vollständigen Schlüssel in E20/E21 prüfen; HomeServer-Uhr bei Testlizenz kontrollieren.

Lizenzierung

Die Lizenz ist an den ETA-Baustein und die tatsächliche Ethernet-MAC des HomeServers gebunden. Verfügbar sind eine auf sieben Tage begrenzte Testlizenz und eine unbefristete Dauerlizenz. Bereits mit einer früheren Bausteinversion ausgestellte unbefristete ETA-Lizenzen bleiben gültig. Eine 7-Tage-Testlizenz endet nach Ablauf des Lizenzzeitraums automatisch. Fremde BFSW-Produktschlüssel werden abgelehnt. Ohne gültige Lizenz erfolgen keine ETA-/DWD-Abfragen; die MAC-Diagnose bleibt sichtbar. Mehrere Instanzen auf demselben HomeServer sind möglich.

Kompatibilität und Prüfstand

Real getestet mit ETA PC25, ETAtouch API 1.1, Gira HomeServer 4 und Firmware/Experte 4.13: Auslesen, DWD-Prognose, Lizenzprüfung sowie 1802/Aus und 1803/Ein mit Rücklesung. Andere ETA-Anlagen mit ETAtouch-REST-Schnittstelle können grundsätzlich funktionieren; die konfigurationsabhängigen Variablenpfade müssen am Zielsystem geprüft werden. Eine pauschale Freigabe aller ETA-Modelle ist damit nicht verbunden.