Waterkotte Basic Line Air Bloc R290 – Modbus RTU Integration (Community Project)
Hi everyone,
this is a community-driven Home Assistant integration project for the
Waterkotte Basic Line Air Bloc R290 heat pump, using Modbus RTU (USB-RS485).
Project goals
- Reliable Modbus RTU integration for:
- Waterkotte Basic Line Air Bloc R290
- Focus on:
- Reading operational & diagnostic values
- Safe write access (e.g. DHW setpoint, heating curve offset)
- Typical use cases:
- PV surplus control (SMA SHM, EVCC, etc.)
- Fault diagnostics (e.g. F13 high-pressure fault)
- Dashboards & automations in Home Assistant
Current setup
- Home Assistant: Docker container
- Hardware: NanoPi R3S
- Modbus: RTU via USB-RS485
- Adapter: CH343 / CH340 / FTDI
- Wiring: RS-485 A/B connected directly to the Waterkotte controller (BMS port)
Not the HMI/panel bus - Manufacturer Modbus register list available, but:
- not published
- registers are community-verified (Observed / Verified / Safe-to-Write)
Project status
Custom HA integration (work in progress)
Initial sensors:
- Supply / return temperatures
- DHW temperatures
- Operating mode
- Fault codes (e.g. F13)
Planned write registers:
- DHW setpoint (with limits)
- Heating curve offset
Safety & legal notes
- No sharing of internal service documents
- Write access only to verified registers
- No bypassing of safety mechanisms
How to contribute
Looking for:
- Users with Basic Line Air Bloc R290
- Feedback on:
- Firmware versions
- Working registers
- Scaling & data types
- Testers for:
- USB-RS485 stability
- Modbus timing
GitHub repository:
Please use this thread for discussion and feedback. Waterkotte Basic Line Air Bloc R290 – Modbus RTU Integration (Community Project)
Hallo zusammen,
ich starte hier ein Community-Projekt zur Home-Assistant-Integration der Waterkotte Basic Line Air Bloc (R290) über Modbus RTU (USB-RS485).
Ziel des Projekts
- Stabile Modbus-RTU-Integration für:
- Waterkotte Basic Line Air Bloc R290
- Fokus auf:
- Lesen von Betriebs- und Diagnosewerten
- Sichere Setpoint-Anpassungen (z. B. WW-Soll, Heizkurven-Offset)
- Einsatzszenarien:
- PV-Überschusssteuerung (z. B. SMA SHM / EVCC)
- Fehlerdiagnose (z. B. F13 Hochdruck)
- Visualisierung & Automationen in Home Assistant
Aktueller Setup-Stand
- Home Assistant: Container (Docker)
- Hardware: NanoPi R3S
- Modbus: RTU über USB-RS485
- Adapter: CH343/CH340/FTDI (getestet)
- Verdrahtung: RS-485 A/B direkt an der Waterkotte-Steuerung (BMS-Port)
Nicht am Panel-Bus! - Hersteller-Modbus-Registerliste vorhanden, wird nicht öffentlich geteilt, sondern:
- Register werden community-validiert (Observed / Verified / Safe-to-Write)
Projektstatus
- Custom Home-Assistant Integration (in Arbeit)
- Erste Sensoren:
- Vorlauf / Rücklauf
- Warmwasser-Temperaturen
- Betriebszustand
- Fehlercode (z. B. F13)
- Erste Write-Register geplant:
- WW-Solltemperatur (mit Grenzen)
- Heizkurven-Offset
Sicherheit & Haftung
- Keine Veröffentlichung interner Service-Dokumente
- Schreibzugriffe nur auf verifizierte Register
- Keine Eingriffe in sicherheitskritische Schutzfunktionen
Mitmachen / Helfen
Sehr willkommen sind:
- Nutzer mit Basic Line Air Bloc R290
- Rückmeldungen zu:
- Firmware-Version
- Funktionierenden Registern
- Skalierung / Datentypen
- Tester für:
- USB-RS485
- Modbus-RTU-Timing / Stabilität
GitHub Repository:
Diskussion & Feedback bitte hier im Thread
Issues / Register-Beiträge gern strukturiert.