Tobias Reithmeier

Blog

LG Therma V an Home Assistant: Modbus mit dem ESP32

Teil 3 der Serie „Smart Home in der Praxis“. Teil 2 erzählte, warum die Wärmepumpe von der Cloud an die eigene Zentrale umzieht. Hier kommt die Umsetzung; Teil 4 zeigt danach die Registersuche, Teil 5 die Diagnose.

Die gute Nachricht vorweg: Die Inneneinheit der LG Therma V hat einen Anschluss, der für externe Regler gedacht ist, und dahinter spricht sie Modbus RTU. Die schlechte: Die Anlage hält sich an keine der veröffentlichten Registerkarten, und drei unscheinbare Details entscheiden darüber, ob überhaupt ein Byte fließt. Dieser Teil führt einmal von der leeren Klemme bis zu den Werten in Home Assistant. Die komplette Firmware mit allem, was dieser Beitrag beschreibt, liegt fertig auf GitHub.

Bevor es an die Klemmen geht, in aller Deutlichkeit: Die Arbeit passiert im Inneren der Inneneinheit, auf eigene Verantwortung, und kann Garantie und Gewährleistung berühren. Die Anlage wird dafür stromlos gemacht, und die Datenklemmen liegen auf einem eigenen Klemmenblock abseits der Netzspannung. Wer sich das nicht zutraut: Fachbetrieb.

Die Einkaufsliste

  • Waveshare ESP32-S3-RS485-CAN für rund 35 Euro, ein ESP32-Board mit fertig verlötetem RS485-Wandler. Jedes andere ESP32-Board mit RS485-Transceiver geht auch.
  • Ein kurzes Adernpaar und ein USB-Netzteil.
  • ESPHome auf dem Rechner. Die Open-Source-Firmware macht aus einer YAML-Datei ein fertiges Gerät für Home Assistant.

Der Anschluss: Klemme 21 und 22, nicht 28 und 29

Der richtige Anschluss sitzt auf Terminal Block 2 der Inneneinheit und ist mit „3rd Party Controller, 5 V DC“ beschriftet: Klemme 21 ist A, Klemme 22 ist B.

Die erste Falle lauert direkt daneben: Klemme 28/29 ist ebenfalls mit A/B beschriftet, führt aber zur Außeneinheit, und dort antwortet nichts. Wer beide Beschriftungen vor sich hat, nimmt das Paar auf dem Block mit der 5-V-Beschriftung.

Dazu kommen zwei DIP-Schalter: SW1-1 auf ON, SW1-2 auf OFF. Das widerspricht der verbreiteten Empfehlung in Foren, denn ON wäre laut Handbuch das „einheitliche offene Protokoll“. Mit SW1-2 auf ON schweigt diese Anlage aber vollständig, viermal gemessen, über 247 Adressen und sechs Baudraten. Die Schalter werden nur beim Booten gelesen; nach jedem Umstellen muss die Inneneinheit einmal stromlos. Und SW1-3 hat laut Handbuch gar keine Funktion, also nicht anfassen.

Die drei Fallstricke

Drei Dinge haben zusammen mehr Zeit gekostet als der ganze Rest, deshalb stehen sie hier vor der Konfiguration:

1. flow_control_pin ist Pflicht. Der RS485-Wandler des Waveshare-Boards schaltet nicht selbst zwischen Senden und Empfangen um. Fehlt die Zeile, bleibt das Board stumm auf Empfang. Es sendet nie auch nur ein Byte, und kein Fehler weist darauf hin.

2. Die Slave-Adresse ist 1. Das Bedienteil zeigt im Menü unter Umständen 33 als Zentraladresse an. An diesem Anschluss antwortet die Anlage nur auf Adresse 1.

3. force_new_range: true an jedem Register. ESPHome fasst benachbarte Register automatisch zu Blockanfragen zusammen, und diese Gruppierung ändert sich mit jeder Änderung an der Registerliste. Bei dieser Anlage hat das Werte zwischen Nachbarregistern verschoben und wochenlang plausible, aber falsche Messwerte erzeugt. Die Geschichte dazu erzählt Teil 4; die Lehre daraus steht in jeder Registerdefinition.

Die Konfiguration

Das Grundgerüst der ESPHome-Konfiguration ist übersichtlich: UART, Modbus, ein Controller.

uart:
  tx_pin: GPIO17
  rx_pin: GPIO18
  flow_control_pin: GPIO21   # ohne diese Zeile sendet das Board nie
  baud_rate: 9600
  stop_bits: 1

modbus:

modbus_controller:
  - id: therma_v
    address: 1               # nicht die 33 aus dem Bedienteilmenü
    update_interval: 30s

Jeder Messwert folgt demselben Muster, hier die Außentemperatur aus Input-Register 12:

sensor:
  - platform: modbus_controller
    modbus_controller_id: therma_v
    name: "Außentemperatur"
    register_type: read
    address: 12
    value_type: S_WORD
    filters:
      - multiply: 0.1
    force_new_range: true    # Fallstrick 3

Die vollständige Konfiguration umfasst alle 37 antwortenden Datenpunkte, eine fertige Climate-Entität für den Betriebsmodus, die berechneten Diagnosewerte aus Teil 5 und die Kartierungswerkzeuge aus Teil 4. Geflasht wird mit einem Befehl:

esphome run therma-v.yaml

Home Assistant findet das Gerät danach von selbst; ein Lovelace-Dashboard mit Betrieb, Kältekreis und Steuerung liegt als YAML im Repository bei.

Was die Anlage hergibt und was nicht

Nach der Kartierung antworten genau 34 Datenpunkte. Die wichtigsten:

PunktBedeutungZugriff
Vorlauf, Rücklauf, Warmwasser, Raum, außenTemperaturenlesen
Sauggastemperatur, Hoch- und NiederdruckKältekreislesen
ScheinleistungVerdichterlastlesen
Betriebsmodus (aus / kühlen / heizen / auto)HR26schreiben
Soll Heizkreis und Soll WarmwasserHR24 / HR29schreiben
FlüstermodusCoil 2schreiben
Warmwasser-FreigabeCoil 6schreiben

Nicht erreichbar sind über diesen Anschluss: Heizkreis 2 in jeder Form, Wasserdruck und, besonders schade, der Durchfluss. Ohne Volumenstrom lässt sich keine thermische Leistung berechnen und damit auch keine Arbeitszahl; welchen Ersatz es dafür gibt, zeigt Teil 5.

Eine Eigenheit noch zur Buslast: Die Anlage antwortet gemächlich, rund 625 Millisekunden je Anfrage. 37 Einzelanfragen brauchen etwa 23 Sekunden. Bei 30 Sekunden Abfrageintervall ist das schon drei Viertel Dauerlast. Wer weitere Register aufnimmt, hebt das Intervall mit an.

Der Cliffhanger

Bleibt die Frage, woher man überhaupt weiß, dass Register 12 die Außentemperatur ist, wenn die Anlage sich an keine veröffentlichte Karte hält und die Doku schweigt. Die Antwort ist eine eigene Disziplin: systematisches Kartieren unbekannter Register, ohne je blind zu schreiben. Davon handelt Teil 4.

Quellen