!Außeneinheit einer Wärmepumpe an einer weißen Hauswand vor blauem Himmel

„None of the published maps fits, not even with an offset.“ So steht es in der Registerdokumentation, die ComicSans im Sommer 2026 für eine LG Therma V R290 Monobloc auf GitHub veröffentlicht hat (Hydro-Einheit HN1639HC.NK0, Firmware 3.07.2a). Gemeint sind die Registerlisten aus der LG-Anleitung, aus der LG-Folie „Open MODBUS“ und aus dem Wiki des Home-Assistant-Projekts von basti242. Der Autor hat danach 4096 einzelne Leseanfragen abgeschickt, um herauszufinden, was seine Anlage überhaupt beantwortet. Ergebnis: 38 Datenpunkte, alle unterhalb von Adresse 32.

Wer die LG Therma V in Home Assistant holen will, steht damit vor einer Gabelung, die in den meisten Anleitungen fehlt. Es gibt zwei gut dokumentierte Wege, und sie sprechen nicht dieselbe Sprache. Dieser Artikel sortiert, welcher zu welchem Gerät passt, und sagt dazu, was belegt ist und was offen bleibt.

Vorab: Wir haben keine LG-Wärmepumpe an einem Modbus-Adapter betrieben. Alles Folgende stammt aus den genannten GitHub-Repositories, aus Home-Assistant-Dokumentation und aus Forenbeiträgen, jeweils mit Stand 27. Oktober 2026 gelesen.

Die Kurzfassung

  • Modbus TCP über ein Gateway (Projekt von basti242): Waveshare-RS485-zu-Ethernet-Adapter an die Wärmepumpe, YAML-Paket in Home Assistant. Getestet mit einem Therma V Monoblock 9 kW, per Forenbeitrag auch an einer R32.
  • ESP32 mit ESPHome (Projekt von ComicSans): Modbus RTU direkt vom Mikrocontroller, ohne Gateway. Gemessen an genau einer R290-Monoblock-Anlage.
  • LG ThinQ (offizielle Integration): läuft über die LG-Cloud, kein lokaler Weg.
  • SG Ready über zwei Kontakte: der Notausgang, wenn Modbus gar nicht antwortet.
Die Wahl hängt weniger am Kältemittel, als man denkt. Dazu gleich mehr.

Weg 1: Modbus TCP mit Waveshare-Gateway

Das Projekt „LG Therma V ↔ Home Assistant (Modbus)“ von basti242 gibt es seit Februar 2023, der letzte Commit stammt vom 29. September 2026, die Konfigurationsdatei trägt den Vermerk „last update: 2026-05-05 (for Homeassistant update 2026.05)“. Rund 75 Nutzer haben das Repository mit einem Stern markiert. Die README verspricht: keine Cloud, keine Herstellerbrücke, nur ein Modbus-TCP-Gateway und ein Konfigurationspaket.

Die Hardware: ein RS485-zu-Ethernet-Adapter von Waveshare. Die README listet drei getestete Varianten, einen Tischadapter, eine Hutschienenversion und ein Modell mit WLAN. Im Gerät sitzt ein Anschluss mit der Aufschrift „3RD PARTY CONTROLLER“, dort gehören die Adern auf A (+) und B (-).

Dazu zwei Einstellungen, die laut README für Geräte der vierten Generation gelten:

  • Auf der Hauptplatine SW1, Schalter 1 auf ON: Die Wärmepumpe arbeitet als Modbus-Slave.
  • SW1, Schalter 2 auf ON: offenes Protokoll.
Zusätzlich muss am Bedienteil (RS3) die Modbus-Option für Fremdregler aktiviert werden. Danach legen Sie die Datei modbus_lg_heatpump.yaml in einen Ordner integrations, binden diesen in configuration.yaml als Package ein, tragen IP, Port 502 und Slave-Adresse in die secrets.yaml ein und starten Home Assistant neu.

Was Sie dafür bekommen, ist ordentlich: Betriebsart (Kühlen, Auto, Heizen), Regelungsart, Warmwasser-Solltemperatur, Sollwerte der Heizkreise, Flüstermodus und der Energiezustand-Eingang (SG Ready) lassen sich schreiben, Temperaturen, Drücke, Durchfluss und Verdichterstatus lesen. Die Datei enthält 76 Adressangaben. Für das Dashboard braucht man die HACS-Karten Mushroom, card-mod und Multiple Entity Row.

Am Ende der README steht ein Hinweis: Die Registertabelle im Wiki enthalte „a few known transcription errors“, ein falsch beschriftetes Maß und eine doppelte Zeilenbeschreibung. Wo Tabelle und Gerät sich widersprochen haben, folgt die YAML-Datei dem am echten Gerät bestätigten Wert. Das ist ehrlich und zugleich eine Warnung: Die Tabelle taugt als Orientierung, nicht als Wahrheit.

Weg 2: ESP32 mit ESPHome, ohne Gateway

ComicSans, Repository lg-therma-v-esphome-modbus, angelegt am 30. Juli 2026, letzter Push am 5. Oktober 2026, vier Sterne. Es ist ein junges, kleines Projekt, aber eines mit ungewöhnlich sauberer Beweisführung. Zu jedem Register steht dort, woran er es erkannt hat: ein Wert, der in derselben Minute am Bedienteil abgelesen wurde, oder eine Flanke, die mit einem beobachtbaren Ereignis zusammenfällt.

Die Eckdaten laut README:

Hydro-EinheitHN1639HC.NK0
KältemittelR290 (Propan)
Firmware3.07.2a
AnschlussTerminal Block 2, Klemme 21 (A) und 22 (B)
BusModbus RTU, Slave 1, 9600 Baud, 8N1
HardwareWaveshare ESP32-S3-RS485-CAN
VoraussetzungESPHome 2026.9.0 oder neuer
Die Stolpersteine, die im Repository ausdrücklich beschrieben werden, sind genau die, an denen man sonst Stunden verliert:
  1. Klemme 28/29 ist ebenfalls mit A/B beschriftet, führt aber zur Außeneinheit. Dort antwortet nichts.
  2. Der DIP-Schalter SW1-2 muss hier auf OFF stehen. Mit SW1-2 auf ON, also dem „offenen Protokoll“ laut Handbuch, blieb die Anlage stumm: 247 Adressen mal sechs Baudraten, viermal gemessen, kein einziges Byte. Der Schalter wird nur beim Booten gelesen.
  3. Slave-Adresse 1, auch wenn das Bedienteil als zentrale Adresse 33 anzeigt.
  4. flow_control_pin ist Pflicht. Der RS485-Treiber der Platine schaltet die Senderichtung nicht von selbst um.
Beachten Sie Punkt 2. Bei basti242 steht SW1-2 auf ON, bei ComicSans auf OFF. Woran das liegt, sagt keine der beiden Quellen. Es können Gerätegeneration, Firmware oder Anschlussart sein. Genau diese Unklarheit ist der Kern des Problems.

Ein Zyklus über alle 38 Datenpunkte dauert rund 22 Sekunden, weil jede Anfrage etwa 590 Millisekunden braucht. Mehr Register bedeuten ein längeres Intervall.

Dieselbe Wärmepumpe, andere Adressen

Hier lohnt der direkte Vergleich. Die Zahlen stammen aus der YAML-Datei von basti242 und aus der Registerkarte von ComicSans, jeweils als Protokolladresse (nullbasiert, wie sie auch ESPHome und Home Assistant verwenden):

Größebasti242 (YAML)ComicSans (R290, FW 3.07.2a)
FehlercodeInput 0in keinem Register
Wasseraustritt/-eintrittInput 3 („outlet temp“) und Input 2 („inlet temp“)Vorlauf Input 16, Rücklauf Input 15
WarmwassertemperaturInput 5Input 25
Warmwasser-SollHolding 8Holding 29
BetriebsartHolding 0Holding 26
Energiezustand (SG Ready)Holding 9nicht erreichbar
Ein/AusCoil 0nicht erreichbar
FlüstermodusCoil 2 (laut Wiki-Tabelle)Coil 2
Der Flüstermodus auf Coil 2 ist die einzige Stelle, an der beide Karten übereinstimmen. ComicSans hält das ausdrücklich fest: Von der offiziellen LG-Karte gelte nur dieser Punkt. Ein/Aus (Coil 0), Betriebsart (Holding 0) und Energiezustand (Holding 9) seien an seiner Anlage gar nicht erreichbar. Die Betriebsart liegt dort auf Holding 26, mit den Werten 0 (Aus/nur Warmwasser), 1 (Kühlen), 2 (Heizen), 3 (Auto).

Was folgt daraus? Kopieren Sie keine Registeradressen aus einem Forenbeitrag in Ihre Konfiguration, solange Sie nicht wissen, welches Modell und welche Firmware dahinter steckt.

R32 oder R290: Was die Quellen hergeben

Die naheliegende Annahme wäre: R32-Geräte folgen der LG-Dokumentation, R290-Geräte einer eigenen Karte. Belegt ist das nicht. Was die Quellen tatsächlich zeigen:

  • Das Projekt von basti242 nennt als Testgerät einen „Therma V Monoblock 9 kW“, ohne das Kältemittel zu erwähnen.
  • Im GitHub-Diskussionsstrang #13 schreibt ein Nutzer (fposch84, 31. Dezember 2024), er habe mit dieser Lösung die „LG Therma V R32“ per Modbus an Home Assistant gekoppelt, angebunden über ein Waveshare-RS232/485-Gateway per WLAN.
  • ComicSans misst an einer R290-Anlage, bei der die veröffentlichten Karten nicht passen, und schreibt selbst: Ob das Layout bei anderen Modellen oder Firmwareständen gleich aussehe, sei offen. Gesucht seien Messungen an anderen Therma-V-Serien und anderen Firmwareversionen.
Eine Aussage der Form „R290 braucht Weg 2“ lässt sich daraus nicht ableiten. Möglich ist, dass es am Kältemittel liegt, an der Gerätegeneration, an der Firmware oder an einer Mischung. Die belastbare Formulierung lautet: Für die R32-Anlage aus dem Forum und das 9-kW-Gerät von basti242 funktioniert die Gateway-Lösung. Für die eine vermessene R290-Anlage passte sie nicht.

So finden Sie heraus, was Ihre Anlage spricht

Das Praktischste, was man aus dem ESP32-Projekt mitnehmen kann, ist der Gedanke dahinter: erst scannen, dann zuordnen. Die README beschreibt einen Adress-Scan, der nichts schreibt. Dazu ein paar Beobachtungen aus der Registerdokumentation:

  • Gruppenabfragen verschlucken Register. Fragt man vier Register auf einmal ab und eines davon existiert nicht, lehnt die Einheit die ganze Gruppe ab. Der erste Gruppenscan fand 32 Punkte, erst Einzelabfragen brachten die übrigen. Von sieben Coils meldete der Gruppenscan nur zwei.
  • Der Bedienteil-Wert ist Ihr Referenzwert. Das Display zeigt dieselben Rohwerte wie der Bus („Kältemittel 12000“ entspricht dort Input 13). Wer ein Register einzeln abfragt und den Displaywert im selben Moment abliest, kann es zuordnen.
  • Der Außentemperaturfühler der Einheit lügt im Stand. Der Sensor sitzt im besonnten Gehäuse und lag bei Stillstand tagsüber bis zu 12,9 Kelvin über drei unabhängigen Referenzsensoren. Wer damit rechnet, braucht einen zweiten Fühler.
Und Vorsicht beim Schreiben. In der Wiki-Tabelle von basti242 liegen auf den Coil-Adressen 3, 4 und 5 (nullbasiert) die Auslösung des Desinfektionsbetriebs, der Notaus und der Auslöser für den Notbetrieb, direkt neben dem Flüstermodus. ComicSans warnt deshalb, Coil 5 an seiner Anlage nur passiv zu beobachten: Die Karte gilt für sein Gerät nachweislich nicht, die Bedeutung der Adresse ist dort offen. Eine Zeile Schreibzugriff auf die falsche Adresse ist mehr als ein Schönheitsfehler.

Was nach dem Anschluss in Home Assistant zu beachten ist

Aus den beiden Projekten lassen sich drei Eigenheiten ablesen, die bei der Automation zählen.

Was der Sollwert bedeutet, hängt am Bedienteil. Laut ComicSans bezieht sich das Heizkreis-Soll-Register (bei ihm Holding 24) je nach eingestellter Regelungsart auf Vorlauf, Rücklauf oder Raum, getrennt pro Betriebsart. Diese Einstellung lässt sich per Modbus nicht auslesen. Bei seiner Anlage gilt Vorlauf beim Heizen und Rücklauf beim Kühlen. Im Automatikbetrieb ist der Wert nach seinen Angaben gar keine Temperatur, sondern eine Heizkurvenverschiebung: 19 entspricht 0, 20 entspricht +1, Bereich 16 bis 22. Eine Automation, die dort „30 Grad“ schreibt, verschiebt dann die Kurve, statt eine Vorlauftemperatur vorzugeben.

Verdichter-Anläufe lassen sich austricksen, mit Aufwand. Im Diskussionsstrang beschreibt fposch84, wie er beim Anfahren die Soll-Vorlauftemperatur so weit anhebt, dass die Anlage in den typischen 15 Minuten Anlaufphase nicht über die Hysterese kommt, und danach alle zwei Minuten um ein Grad auf den Zielwert (zum Beispiel 30 Grad) zurückgeht. Sein Kommentar: „Klappt 1A.“ Ob das Verfahren zu Ihrem Gerät passt, steht nirgends. Der Haftungsausschluss im ComicSans-Repository weist darauf hin, dass ein Eingriff Gewährleistungsansprüche gegenüber LG oder dem Installateur gefährden kann.

Fehlercodes gehen nicht überall mit. An der R290-Anlage stand das Bedienteil am 1. August 2026 mit dem Fehler CH03 (Kommunikationsfehler zwischen Bedienteil und Hauptplatine) 76 Minuten still, während Modbus ohne Lücke weiter antwortete. Der Code steht in keinem Register. Die Diagnose-Indikatoren im ESP32-Projekt prüfen deshalb die Wirkung einer Störung, nicht ihre Nummer. Wer sich auf eine Fehlercode-Entität verlässt, sollte das wissen. In der Gateway-Variante von basti242 gibt es dagegen ein Register „hp_error_code“, ob es bei Ihrem Modell Werte liefert, zeigt nur der Versuch.

Was nicht geht

Die Repositories sagen es offen:

  • Kein Durchfluss, kein COP. Am ESP32-Projekt fehlt der Volumenstrom. Ohne ihn lässt sich keine Heizleistung und damit keine Leistungszahl berechnen. Die Lösung dort: ein eigener Durchflusssensor im Heizkreis oder ersatzweise die Energie pro Kelvin Speicherhub.
  • Heizkreis 2 nicht erreichbar (ComicSans: in keiner Form). Der Autor nennt zwei Auswege: das LG-Gateway PMBUSB00A mit Therma V auf der Kompatibilitätsliste (dreistelliger Preis) oder SG Ready über zwei Kontakte.
  • Cloud-Gateway nicht verwendbar. Die Leitung des LG-Cloud-Gateways spricht laut ComicSans kein Modbus, sondern vermutlich LGAP, das proprietäre Protokoll von LG.

Und die Cloud?

Die offizielle LG-ThinQ-Integration von Home Assistant gibt es seit Version 2024.11, laut Seite wird sie von 4,9 Prozent der aktiven Installationen genutzt. Ihre IoT-Klasse ist „Cloud Push“, es braucht Internetverbindung und ein Personal Access Token aus dem LG-ThinQ-Konto. In der Geräteliste (Stand 27. Oktober 2026) stehen unter anderem Klimageräte, Water Heater und System Boiler. Eine Wärmepumpe führt die Liste als eigene Kategorie nicht auf. Wer lokal und ohne Konto arbeiten will, kommt an Modbus nicht vorbei.

Wer vorher noch nie eine Wärmepumpe angebunden hat, findet im Überblick Wärmepumpe in Home Assistant einbinden die Grundlagen zu SG Ready und den Cloud-Alternativen. Wie derselbe Konflikt aus lokalem Zugriff und Firmware bei anderen Herstellern aussieht, beschreiben die Artikel zu Daikin Altherma, Buderus und Bosch und Luxtronik.

Welcher Weg passt zu Ihnen

Nach dem, was die Quellen hergeben:

  1. Sie wollen es ohne Löten und ohne Firmware-Bau. Waveshare-Gateway und YAML-Paket von basti242. Rechnen Sie damit, dass einzelne Adressen bei Ihnen abweichen können, und lesen Sie erst, bevor Sie schreiben.
  2. Sie haben eine R290-Monoblock-Anlage oder das Paket von basti242 liefert nur „unavailable“. Dann ist das ESP32-Projekt der dokumentiertere Weg, samt Adress-Scan, der nichts schreibt. Messberichte zu anderen Modellen und Firmwareständen sind dort ausdrücklich erwünscht.
  3. Beide Wege bleiben stumm. Prüfen Sie DIP-Schalter, Klemmen und Slave-Adresse in der Reihenfolge, die ComicSans beschreibt, bevor Sie an der Software zweifeln. Hilft nichts, bleibt SG Ready über zwei Kontakte: weniger Daten, aber ohne Protokollarbeit.
  4. Sie brauchen nur ein paar Sensoren und keine Steuerung. Die ThinQ-Cloud kann reichen, wenn Ihr Gerät dort erscheint. Sicher ist das nicht.
Arbeiten an der Elektroinstallation der Wärmepumpe gehören nach dem Haftungsausschluss des ESP32-Projekts in die Hände einer Elektrofachkraft. Die Klemmen liegen im Gerät, und die Anlage heizt Ihr Haus.

Unser Fazit

Am auffälligsten ist, dass sich die beiden Projekte widersprechen. Das eine Repository kommt auf 75 Sterne, das andere auf vier, aber das kleinere ist das einzige, das offen sagt, wo seine Gültigkeit endet. Ob ein Modbus-Paket zu Ihrer Wärmepumpe passt, entscheidet nicht der Name „Therma V“, sondern Modell, Firmware und eine Schalterstellung, deren Wirkung zwischen den beiden Projekten gegensätzlich ausfällt. Starten Sie mit einem Scan, der nichts schreibt, und melden Sie Modell, Firmware und Scan-Ergebnis an das passende Repository.

Quellen (Stand: 27. Oktober 2026)

  • GitHub, basti242/homeassistant_lg_therma_v_modbus: README, modbus_lg_heatpump.yaml (Vermerk „last update: 2026-05-05“), Wiki „LG Register documentation“; letzter Commit 29.09.2026
  • GitHub, basti242/homeassistant_lg_therma_v_modbus, Discussion #13 (Beitrag von fposch84, 31.12.2024, R32)
  • GitHub, ComicSans/lg-therma-v-esphome-modbus: README, docs/register-map.md, docs/hardware.md (angelegt 30.07.2026, letzter Push 05.10.2026)
  • Home Assistant, Integration LG ThinQ: home-assistant.io/integrations/lg_thinq/ (abgerufen am 27.10.2026)