EAS 3-MQTT-Gateway

Das EAS 3-MQTT-Gateway ist eine NodeJS-Anwendung, die den Zustand (z.B. Heizraumtemperatur oder Abbrandstatus) einer elektronischen Abbrandsteuerung vom Typ "Brunner EAS 3" bei einem MQTT-Broker veröffentlicht. Dadurch können diese Daten in einem Home-Automation-System wie Home Assistant verwendet werden.

Dieses Projekt hat keine Verbindung zur Ulrich Brunner GmbH und wird von dieser auch nicht unterstützt. Der Hersteller veröffentlicht keine Dokumentation des verwendeten Protokolls und das Gateway beruht auf Analysen des Verhaltens des Geräts.

Funktionsweise

Wenn die EAS 3 mit dem WLAN verbunden ist, sendet sie sekündlich UDP-Broadcast-Pakete auf Port 45454, die alle fünf Sekunden den aktuellen Status enthalten. Das Gateway horcht auf diese Pakete, parst sie und gibt dann die enthaltenen Informationen per MQTT auf dem Topic stove/eas3_X/sensors wieder aus. Außerdem werden per MQTT Autodiscovery-Informationen ausgegeben, damit Home Assistant die Daten besser visualisieren kann.

X im Topic entspricht der Nummer des EAS 3-Geräts, wie es intern konfiguriert wurde. Wenn nur ein Gerät vorhanden ist, ist dies 0. Bei mehreren Geräten werden dann weitere Nummern verwenden.

Das Gateway ist undirektional und nur lesend, weshalb das Gateway keinesfalls die Steuerung beeinflussen sollte, d.h.:

• Es werden nur Daten vom EAS 3 ausgelesen.
• Es ist nicht möglich, Konfigurationswerte am EAS 3 zu ändern.

Unterstützte Informationen:

• Heizraum-Temperatur (in °C)
• Abbrand-Status (Aus, Tür offen, Abbrand Start, Abbrand Stufe 1, Abbrand Stufe 2, Abbrand Stufe 3, Abbrand Stufe 4, Abbrand Ende, Fehler)
• Verlängerter Abbrand (an / aus)
• Öko-Modus (an / aus)
• Drosselklappen-Betrieb (an / aus)
• Nachlege-Hinweis (0-4)

Zur Bedeutung dieser Informationen, siehe das EAS 3-Benutzerhandbuch.

Kompatibilität

Das Gateway wurde mit der EAS 3-Firmware 3.44 getestet.

Voraussetzungen

• Es wird NodeJS 20 benötigt.
• Die EAS 3 muss bereits über die BRUNNEREAS3-App mit dem WLAN verbunden worden sein und in der App müssen Daten angezeigt werden.
• Es muss ein MQTT-Broker laufen und fertig konfiguriert sein.

Ausführen

Einfaches Starten

1. Die Dependencies mit npm ci installieren.
2. Das Gateway konfigurieren.
3. Das Gateway mit npm start starten.

Als Daemon mit ps2 ausführen

Mit der oben angeführten Methode, wird das Gateway nicht erneut gestartet, wenn es durch einen Absturz oder Reboot der Maschine beendet wurde. Um dies sicherzustellen, kann beispielsweise pm2 verwendet werden:

1. npm install pm2 -g (einmalig).
2. Die Dependencies mit npm ci installieren (einmalig).
3. Das Gateway konfigurieren.
4. pm2 start src/eas3.js

Das Gateway läuft dann als daemon und wird dann 24/7 ausgeführt.

Folgende Kommandos können z.B. verwendet werden, um den Daemon zu kontrollieren:

• pm2 ps - Zeigt die aktuell laufenden pm2-Prozesse an
• pm2 log eas3 - Zeigt das Log an (über mehrere Ausführungen hinweg).
• pm2 stop eas3 - Stoppt den Prozess mit dem Namen eas3. Wenn pm2 ps einen anderen Namen ausgegeben hat, muss dieser stattdessen verwendet werden.
• pm2 delete eas3 - Löscht den Prozess mit dem Namen eas3. Wenn pm2 ps einen anderen Namen ausgegeben hat, muss dieser stattdessen verwendet werden.

Konfiguration

Das Gateway kann über folgende Umgebungsvariablen konfiguriert werden:

Die Umgebungsvariablen können in einer .env-Datei liegen oder normal als Umgebungsvariablen übergeben werden. Es gibt eine Beispiel-.env-Datei unter example.env.

Wenn die .env-Datei verwendet werden soll:

1. example.env in .env kopieren.
2. Die Konfigurationswerte in .env enstprechend den eigenen Bedingungen anpassen.
3. Das Gateway ohne weitere Parameter starten.

Wenn die Umgebungsvariablen per CLI übergeben werden sollen (Linux):

• Das Gateway per MQTT_HOST=localhost MQTT_USERNAME=myusername npm start starten.

Debugging

Das Gateway verwendet das NPM-Package debug, um Debug-Informationen auszugeben. Diese können angezeigt werden, indem die Anwendung mit der Umgebungsvariable DEBUG=eas3-mqtt-gateway gestart wird (Linux):

DEBUG=eas3-mqtt-gateway npm start

Dann wird die Debug-Ausgabe des Gateways selber angezeigt. Es könnena auch die Ausgaben anderer Package angezeigt werden. Dafür DEBUG=* setzen.

Beispiel-Automation in Home Assistant

Die folgende Home Assistant-Automation drosselt die Soll-Temperatur der Heizkörperthermostate im Wohnzimmer, wenn der Ofen geheizt wird, damit die Zentralheizung ausgeschaltet wird und der Raum nicht überheizt. Nach zwei Stunden wird die normale Soll-Temperatur eingestellt, damit die Zentralheizung nahtlos übernimmt, wenn der Ofen nach einigen Stunden abkühlt.

alias: Kachelofen an -> Heizung aus
description: ""
triggers:
  - trigger: numeric_state
    entity_id:
      - sensor.eas_3_heizraum_temperatur
    for:
      hours: 0
      minutes: 0
      seconds: 30
    above: 40
conditions:
  - condition: state
    entity_id: sensor.kachelofen_eas_3_abbrand_status
    state: Abbrand Start
actions:
  - action: climate.set_temperature
    metadata: {}
    data:
      temperature: 15
    target:
      device_id: <ID_DES_RAUMES>
  - delay:
      hours: 2
      minutes: 0
      seconds: 0
      milliseconds: 0
  - action: climate.set_temperature
    metadata: {}
    data:
      temperature: 21.5
    target:
      device_id: <ID_DES_RAUMES>
mode: single

Beschränkungen

Die EAS 3 sendet Broadcast-Pakete, deren Bedeutung aktuell unbekannt ist, und die deshalb ignoriert werden. Das EAS 3 scheint von der BRUNNEREAS3-App per Remote Procedure Call aufgerufen zu werden. Was hier genau passiert ist unbekannt, weshalb die Features der App nicht verwendet werden können.

Quellen / Anerkennung

Das Gateway beruht auf den Informationen aus dem Thread #761 des ioBroker GitHub Issue Tracker von JR-Home und Draygv2.

Die Liste der Heizeinsätze wurde dem EAS 3-Benutzerhandbuch entnommen.