Dieses Repository ist das Legacy-Modbus-TCP-Proxy-Nebenprodukt des Luxtronik-2.0-Integrationsprojekts. Es wird nicht mehr aktiv gepflegt und ist auf GitHub archiviert (schreibgeschützt).
→ Stattdessen luxtronik2-hass verwenden — die aktiv gepflegte Home-Assistant-HACS-Integration ist der unterstützte Weg für Luxtronik-2.0-Wärmepumpen.
Der Proxy bleibt für Nischenanwendungen verfügbar (roher Modbus-Zugriff aus Nicht-HA-Tools wie evcc standalone), erhält jedoch keine Updates, Fehlerbehebungen oder Support.
Read in English: README.md
Zwei Nutzungswege — such dir den passenden aus:
- Home Assistant HACS-Integration (empfohlen für die meisten) — Installation in 2 Minuten über HACS, IP eingeben, fertig. Zeigt Sensoren, steuert Heiz-/Warmwassermodus/SG-Ready, sichert Parameter. Kein Modbus-Proxy nötig.
- Standalone Modbus-TCP-Proxy — für evcc, Grafana oder jedes andere Modbus-fähige Tool. Läuft als Docker-Container oder systemd-Dienst.
Funktioniert mit Alpha Innotec, Novelan, Buderus, Nibe, Roth, Elco und Wolf Wärmepumpen mit Luxtronik-2.0-Regler — tausende Geräte ohne Firmware-Upgrade-Pfad.
Du brauchst KEIN Modbus, KEIN evcc, nichts. Die HACS-Integration spricht direkt mit deiner Wärmepumpe und stellt alles als native HA-Entitäten bereit.
| Kategorie | Entitäten |
|---|---|
| Temperaturen | Außen, Vorlauf, Rücklauf, Warmwasser, Sole Ein/Aus (6 Sensoren) |
| Status | Betriebsmodus, EVU-Sperre, Status-Dauer, Kompressor, Pumpen |
| Pumpen | Heizungs-Umwälzpumpe (HUP), Warmwasser-Umwälzpumpe (BUP), Zirkulationspumpe (ZIP), Zusatz-Umwälzpumpe (ZUP), Solepumpe (VBO), Mischer HK1 |
| Betriebsstunden | Wärmepumpe gesamt, Verdichter, Heizkreis, Warmwasser |
| Steuerung | Heizmodus, Warmwassermodus, SG-Ready, Warmwasser-Solltemperatur, Heizkurven-Verschiebung |
| Sicherung | Ein-Klick Parameter-Sicherung als JSON-Datei |
| Erweiterbar | +1.367 zusätzliche Parameter über die HA-Entitätsverwaltung aktivierbar |
Alle Entity-Namen und Übersetzungen auf Deutsch und Englisch (weitere Sprachen willkommen).
- HACS öffnen → Integrationen → ⋮ → Benutzerdefinierte Repositories
https://github.com/notDIRK/luxtronik2-modbus-proxyals Typ Integration hinzufügen- Integration herunterladen, Home Assistant neu starten
- Einstellungen → Geräte & Dienste → Integration hinzufügen → "Luxtronik 2 Modbus Proxy"
- IP-Adresse der Wärmepumpe eingeben. Fertig.
Ein fertiges Dashboard-YAML liegt unter docs/examples/dashboard-waermepumpe.yaml — kopiere es in den Raw-Konfigurationseditor eines neuen Dashboards und du bekommst den obigen Screenshot.
Wenn du die Wärmepumpe mit evcc, Grafana oder einem anderen Modbus-TCP-Client ohne Home Assistant nutzen willst, starte den Standalone-Proxy.
┌─────────────────────┐ ┌──────────────────────────┐
│ Luxtronik 2.0 │ │ luxtronik2-modbus-proxy │
│ Wärmepumpe │ <────> │ │ <── evcc
│ Regler │ │ Modbus-TCP-Server │
│ Port 8889 │ │ Port 502 │ <── Grafana / andere
└─────────────────────┘ └──────────────────────────┘
proprietäres Protokoll Standard-Modbus-TCP
Connect → Read/Write → Disconnect (läuft parallel zur HA-Integration)
cp config.example.yaml config.yaml
# config.yaml bearbeiten: luxtronik_host auf die IP der Wärmepumpe setzen
docker compose up -d- Modbus-TCP-Server mit Unterstützung für FC3, FC4, FC6, FC16
- Connect-and-Release-Polling (läuft parallel zur HA-BenPru-Integration und zur HACS-Integration oben)
- SG-Ready-Virtualregister für die Wärmepumpensteuerung mit evcc
- 1.126 Luxtronik-Parameter per Name konfigurierbar
- Konfiguration per YAML mit Überschreibung durch Umgebungsvariablen
- Docker- und systemd-Deployment
- Schreibratenbegrenzung zum Schutz des Regler-NAND-Flash
- Schnellstart — Projekt klonen und starten
- Benutzerhandbuch — Installation und Konfiguration (Docker)
- systemd-Dienst — Linux-Service-Installation
- evcc-Integration — Wärmepumpensteuerung mit evcc
- Parallelbetrieb mit HA — Betrieb neben Home Assistant
| Hersteller | Luxtronik 2.0 Regler | Anmerkung |
|---|---|---|
| Alpha Innotec | ✅ Ja | Getestet mit MSW 14 (Sole/Wasser) |
| Novelan | ✅ Ja | Gleiche Reglerplattform |
| Buderus | ✅ Ja | Ältere Luxtronik-Modelle |
| Nibe | ✅ Ja | Nur Luxtronik-basierte Modelle |
| Roth, Elco, Wolf | ✅ Ja | Gleiche Reglerplattform |
Voraussetzung: Luxtronik-2.0-Firmware auf Port 8889.
Dies ist ein öffentliches Repository. Ein Pre-Commit-Hook scannt jeden Commit auf sensible Muster (echte IPs, Hostnames, Tokens) und blockiert den Commit im Treffer-Fall. Beiträge willkommen — bitte gleiches Prinzip beachten.
MIT. Siehe LICENSE.