Ochsner BWWP - Home Assistant Modbus Integration
==================================================

Modbus-Integration fuer Ochsner Brauchwasser-Waermepumpen (BWWP)
ueber einen Waveshare RS485-to-Ethernet Adapter.


HARDWARE
--------
- Ochsner Brauchwasser-Waermepumpe mit Modbus-Schnittstelle
- Waveshare RS485-to-Ethernet Adapter (oder aehnlich)
  Konfiguriert als Modbus RTU over TCP


VORAUSSETZUNGEN
---------------
- Home Assistant mit Modbus-Integration (standardmaessig vorhanden)
- RS485 Adapter erreichbar im Netzwerk (Standard: 192.168.1.132:502)


INSTALLATION
------------
1. Kopiere "ochsner_bwwp.yaml" nach "config/packages/"
2. In configuration.yaml sicherstellen dass packages aktiviert ist:
   homeassistant:
     packages: !include_dir_named packages
3. IP-Adresse und Port des RS485-Adapters anpassen (Zeile 9-10)
4. Home Assistant neu starten
5. Optional: Dashboard-Card aus "dashboard_card_bwwp.yaml" einfuegen


MODBUS REGISTER-MAP
-------------------
Read (Input Register):
  2000  Temperatur Anzeige           (x0.1 °C)
  2001  Istwert Sensor F1            (x0.1 °C)
  2002  Istwert Sensor F2            (x0.1 °C)
  2003  Istwert Sensor F3            (x0.1 °C)
  2004  Istwert Sensor F4            (x0.1 °C)
  2005  Ventilator Drehzahl          (x0.1 U/min)
  2006  Temperatur Warmwasser        (x0.1 °C)
  2007  Temperatur Verdampfer        (x0.1 °C)
  2008  Temperatur Solarthermie      (x0.1 °C)
  2009  Alarmtemperatur              (x0.1 °C)
  2010  Aktuelle Ueberschussleistung (W)
  2011  Variable Heizleistung        (%)
  2012  Totale Ueberschussleistung   (W)
  2013  Aktueller Warmwassersollwert (x0.1 °C)

Write (Holding Register):
  2200  Solltemperatur               (x0.1 °C)
  2201  Ueberschussleistung          (W, signed via 65535-Offset)
  2203  Antilegionellen-Temperatur   (x0.1 °C)
  2204  Luefterleistung              (%)


ENTHALTENE AUTOMATIONEN
-----------------------
1. PV Ueberschuss Steuerung
   Schreibt PV-Ueberschuss alle 5 Sek. zur Waermepumpe (nur bei Tageslicht).
   HINWEIS: Verwendet "sensor.sun12k_total_grid_power" - durch eigenen
   PV-Sensor ersetzen!

2. Solltemperatur setzen
   Schreibt den Wert des Schiebers "input_number.bwwp_target_temp"
   per Modbus zur Waermepumpe.

3. Antilegionellentemperatur setzen
   Schreibt den Wert des Schiebers "input_number.bwwp_antilegio_temp"
   per Modbus zur Waermepumpe.

4. Luefterleistung setzen
   Schreibt den Wert des Schiebers "input_number.bwwp_fan_speed"
   per Modbus zur Waermepumpe.


ANPASSUNGEN
-----------
- Zeile 9:   host: IP-Adresse des RS485-Adapters anpassen
- Zeile 10:  port: Port des RS485-Adapters (Standard: 502)
- Zeile 238: PV-Sensor Entity durch eigenen ersetzen
             (sensor.sun12k_total_grid_power -> euer PV-Sensor)
- Zeile 237: buffer-Wert fuer PV-Ueberschuss anpassen (Standard: 50W)
