!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.
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.
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-Einheit | HN1639HC.NK0 |
| Kältemittel | R290 (Propan) |
| Firmware | 3.07.2a |
| Anschluss | Terminal Block 2, Klemme 21 (A) und 22 (B) |
| Bus | Modbus RTU, Slave 1, 9600 Baud, 8N1 |
| Hardware | Waveshare ESP32-S3-RS485-CAN |
| Voraussetzung | ESPHome 2026.9.0 oder neuer |
- Klemme 28/29 ist ebenfalls mit A/B beschriftet, führt aber zur Außeneinheit. Dort antwortet nichts.
- 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.
- Slave-Adresse 1, auch wenn das Bedienteil als zentrale Adresse 33 anzeigt.
flow_control_pinist Pflicht. Der RS485-Treiber der Platine schaltet die Senderichtung nicht von selbst um.
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öße | basti242 (YAML) | ComicSans (R290, FW 3.07.2a) |
|---|---|---|
| Fehlercode | Input 0 | in keinem Register |
| Wasseraustritt/-eintritt | Input 3 („outlet temp“) und Input 2 („inlet temp“) | Vorlauf Input 16, Rücklauf Input 15 |
| Warmwassertemperatur | Input 5 | Input 25 |
| Warmwasser-Soll | Holding 8 | Holding 29 |
| Betriebsart | Holding 0 | Holding 26 |
| Energiezustand (SG Ready) | Holding 9 | nicht erreichbar |
| Ein/Aus | Coil 0 | nicht erreichbar |
| Flüstermodus | Coil 2 (laut Wiki-Tabelle) | Coil 2 |
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.
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.
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:
- 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.
- 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.
- 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.
- Sie brauchen nur ein paar Sensoren und keine Steuerung. Die ThinQ-Cloud kann reichen, wenn Ihr Gerät dort erscheint. Sicher ist das nicht.
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)