Geräteprofil · Wärmepumpen

Daikin Altherma / ROTEX über ESPAltherma

Hinweis: Dieses Profil beruht auf dem Quelltext von ESPAltherma selbst (include/mqtt.h, include/converters.h) und auf der Definitionsdatei ALTHERMA(LT_CA_CB_04-08KW).h des Projekts.

ESPAltherma ist ein ESP32 am Serviceanschluss (X10A) der Wärmepumpe. Er liest die internen Werte aus und veröffentlicht sie per MQTT. nomos liest diese Werte mit.

Voraussetzungen

1. Ein ESP32 mit ESPAltherma, verbunden mit dem X10A-Anschluss der Wärmepumpe, und ein MQTT-Broker, den auch nomos nutzt.

2. ⚠️ Zwei Einstellungen in src/setup.h vor dem Flashen — ohne sie bleibt das Gerät in nomos leer:

   #define ONEVAL_ONETOPIC
   #define MQTT_OneTopic "espaltherma/OneATTR/"
   

   Warum das nötig ist, steht unter Hinweise.

3. In der Definitionsdatei include/def/ALTHERMA(LT_CA_CB_04-08KW).h die Zeilen auskommentieren, die dieses Profil liest (siehe nächster Abschnitt). Für die 11–16-kW-Geräte gilt dieselbe Datei mit dem Zusatz 11-16KW.

Welche Werte freigeschaltet werden müssen

In der Definitionsdatei die // vor diesen Zeilen entfernen. Drei Namen kommen doppelt vor — dann gilt die hier genannte Zeile, nicht die andere:

{0x10,0,217,1,-1,"Operation Mode"},
{0x10,1,304,1,-1,"Defrost Operation"},
{0x20,0,105,2,1,"R1T-Outdoor air temp."},
{0x30,0,152,1,-1,"INV frequency (rps)"},
{0x60,2,315,1,-1,"I/U operation mode"},
{0x60,2,303,1,-1,"Thermostat ON/OFF"},
{0x60,3,204,1,-1,"Error Code"},
{0x60,5,203,1,-1,"Error type"},
{0x60,7,105,2,1,"DHW setpoint"},
{0x60,9,105,2,1,"LW setpoint (main)"},
{0x60,12,306,1,-1,"3way valve(On:DHW_Off:Space)"},
{0x61,2,105,2,1,"Leaving water temp. before BUH (R1T)"},
{0x61,8,105,2,1,"Inlet water temp.(R4T)"},
{0x61,10,105,2,1,"DHW tank temp. (R5T)"},
{0x62,5,105,2,1,"RT setpoint"},

Wer mehr auskommentiert, schadet nichts — nomos liest nur die Werte, die es kennt. Wer weniger freischaltet, hat die entsprechenden Zeilen in nomos leer.

Einrichtung

1. Skills → Add-ons: das Profil importieren

2. Gerät anlegen und als MQTT-Topic espaltherma eintragen

   Die Topics der Firmware sind fest einprogrammiert; espaltherma ist deshalb immer richtig, solange die beiden Zeilen oben unverändert übernommen wurden.

Datenbereich

Die Werte kommen, sobald ESPAltherma sie veröffentlicht – es wird nichts abgefragt.

• Betriebsart (mode) und Thermostat fordert Wärme (heating_active, zusätzlich als active)
• Abtauen (defrosting)
• Außentemperatur (R1T)
• Vorlauf (R1T vor der Zusatzheizung), Rücklauf (R4T) und Vorlauf-Soll
• Raum-Solltemperatur
• Warmwasser: Temperatur (R5T) und Solltemperatur
• Fehlercode und Fehlertyp (letzterer ausgeblendet)
• Verdichterfrequenz, Dreiwegeventil und die Betriebsart der Inneneinheit (ausgeblendet)
• Erreichbar (reachable) aus dem Lebenszeichen von ESPAltherma

Schaltbar sind das Thermostat-Relais von ESPAltherma und die Smart-Grid-Vorgabe (frei laufend, gesperrt, empfohlen ein, erzwungen ein). Der Sicherheitseingang ist ausgeblendet verfügbar.

Hinweise

• Warum der Ein-Topic-Modus Pflicht ist. In der Voreinstellung veröffentlicht ESPAltherma alle Werte als ein JSON-Dokument. nomos spricht einen Wert darin über einen Pfad an, der am Punkt getrennt wird — und die wichtigsten Labels enthalten Punkte: DHW tank temp. (R5T), R1T-Outdoor air temp., Inlet water temp.(R4T). Diese Werte wären so nicht erreichbar. Im Ein-Topic-Modus steht jeder Wert auf seinem eigenen Topic, und der Punkt stört dort nicht.
• Die Labels sind die Topics. Ändert eine neuere Version von ESPAltherma die Schreibweise eines Labels, ändert sich das Topic mit, und der Wert bleibt in nomos leer. Beim Aktualisieren der Firmware also die Definitionsdatei vergleichen.
• Was die Wärmepumpe liefert, hängt vom Modell ab. Die Definitionsdatei deckt die LT-Baureihe CA/CB ab; andere Baureihen haben eigene Dateien im Projekt und dort teils andere Labels — dann bleiben einzelne Zeilen leer.
• ESPAltherma schreibt keine Sollwerte. Temperaturen und Betriebsarten der Wärmepumpe lassen sich über diesen Weg nur lesen. Geschaltet werden kann nur, was der ESP selbst bedient: sein Thermostat-Relais, die Smart-Grid-Kontakte und der Sicherheitseingang.
• Das Relais ersetzt keinen Raumthermostat. Es schaltet den Kontakt, den der ESP32 bedient; was die Wärmepumpe daraus macht, bestimmt ihre eigene Konfiguration.
• Nicht im Profil enthalten: die serielle Durchreiche (serialTX/serialRX), die Werte der M5Stick-Hardware (Akku, WLAN-Pegel, freier Speicher) und die Energieberechnung, die manche Installationen aus Strom und Frequenz ableiten.