Der HomEvap Humidifier ist ein kanalmontierter adiabatischer Luftbefeuchter von HomEvap B.V. (Niederlande). Er sitzt im Zuluftkanal hinter einem Lüftungsgerät mit Wärmerückgewinnung (HRV) und verdunstet LegioSafe-gefiltertes Frischwasser über eine Glasfasermatte in den Luftstrom. Dieselbe Platine und Registerkarte werden mit den Geschwistervarianten HomEvap Cooler, Combi Comfort (All Season) und Direct geteilt, sodass das Template auch als Referenz für diese Geräte dient.

Das Gerät spricht Modbus RTU über RS-485 (auf demselben Bus läuft auch BACnet MS/TP). Das TapHome-Template ist ein ModbusTcpCCU, daher ist ein RTU-to-TCP-Gateway erforderlich — empfohlen wird das TapHome Modbus RTU Gateway. Über diese Verbindung liest TapHome den eingebauten Kanalsensor (SHC80 — Feuchte und Temperatur), schreibt die Kanaltemperatur- und -feuchte-Sollwerte, steuert das primäre SystemMode-Register (Auto / Befeuchten / Kühlen / Aus) und stellt die Telemetrie des Funk-Hygrometer-Zubehörs bereit.

Hardware-Anschluss#

Die HomEvap-Hauptplatine führt ein einzelnes 2-drahtiges RS-485-Paar auf Klemmleiste TB1 heraus. Derselbe physische Bus trägt Modbus RTU oder BACnet MS/TP — das Protokoll wird über DIP-Schalter ausgewählt (siehe Modbus-Kommunikation aktivieren unten), nicht über die Verdrahtung.

Verlege eine geschirmte verdrillte Zweidrahtleitung (z. B. ein spezielles RS-485-Kabel) von den Schrauben TB1 am HomEvap zu den Klemmen A/B des Modbus-RTU-Gateways. Verbinde das Gateway per Ethernet mit demselben lokalen Netzwerk wie den TapHome Core. Das Gateway stellt den HomEvap dann auf Modbus-TCP-Port 502 unter der am Gerät eingestellten Slave-Adresse bereit.

Verdrahtungsplan

Für die TapHome-Integration relevante Klemmen:

Der HomEvap hat weder Ethernet- noch WLAN-Port — es ist ausschließlich ein RS-485-Gerät. Ein Modbus RTU-to-TCP-Gateway ist zwingend erforderlich; TapHome kann das Gerät nicht direkt erreichen.

Modbus-Kommunikation aktivieren#

Modbus wird ausschließlich über den DS2-DIP-Block auf der Hauptplatine aktiviert und adressiert. Er ist vollständig unabhängig vom DS1-Block (der die lokale Steuerquelle konfiguriert).

1. Bus aktivieren: setze DS2.8 = ON. Damit wechselt die RS-485-Schnittstelle an TB1 von BACnet MS/TP auf Modbus RTU und der Protokoll-Handler wird aktiv.
2. Eindeutige Slave-Adresse setzen: die Schalter DS2.1 bis DS2.7 bilden die Slave-Adresse als 7-Bit-Binärwert (LSB = DS2.1). Jedes in Reihe geschaltete Gerät benötigt eine eigene Adresse.
   • Gerät #1: DS2.1 ON, DS2.8 ON → Adresse 1
   • Gerät #2: DS2.1 OFF, DS2.2 ON, DS2.8 ON → Adresse 2
3. Verkehr prüfen: sobald das Gateway zu pollen beginnt, blinken die grünen LD2 / LD3 (TXD / RXD) LEDs neben TB1 bei jeder erfolgreichen Anfrage.

Die Standard-Seriellparameter sind 8N2 bei AutoBaud — der Controller wählt automatisch zwischen 9600, 19200, 38400 und 57600. Die meisten RTU-to-TCP-Gateways arbeiten am besten mit einer festen Baudrate; konfiguriere das Gateway auf 9600 8N2 (oder 8N1 — das Gerät ist tolerant, wie das Community-ESPHome-Bridge bestätigt).

Der HomEvap unterstützt die Funktionscodes 0x03 Read Holding Registers, 0x06 Write Single Register und 0x10 Write Multiple Registers. Alle Adressen im Template sind Holding Register (H:*).

Das Schreiben des Werts 0 in Register 0x01 (BaudRate) reaktiviert AutoBaud am Gerät. Nimm dieses Register nicht in ein BMS-Polling oder in eine Schreibschleife auf — fixiere die Baudrate stattdessen im Gateway.

RS-485-Bus terminieren

Aktiviere den 120-Ω-Abschlusswiderstand und die Fail-Safe-Vorspann-Widerstände nur an den zwei physischen Enden des RS-485-Busses. Bei einer kurzen Punkt-zu-Punkt-Verbindung mit einem einzigen HomEvap bedeutet das Terminierung am Gateway und am TB1-Ende des HomEvap; beim Verketten mehrerer HomEvap-Geräte nur am ersten und letzten Gerät der Leitung terminieren.

Konfiguration#

Gib beim Importieren des Templates in TapHome an:

• IP Address — die IP-Adresse des RTU-to-TCP-Gateways im lokalen Netzwerk
• Slave ID — die Modbus-Slave-Adresse, die am HomEvap über DS2.1–DS2.7 eingestellt ist (Standard 1)

Der HomEvap selbst hat keine IP-Adresse. Weise dem Gateway in der DHCP-Reservierungsliste des Routers eine statische IP zu, damit sie sich nach einem Neustart nicht ändert.

Gerätefunktionen#

Das Template stellt die folgenden Geräte bereit, alle auf Holding Register H:15 — H:108 abgebildet:

Kanalsensor-Messwerte

• Kanaltemperatur / -feuchte — liest den eingebauten SHC80-Sensor im Zuluftkanal. Die Temperatur kommt aus H:16 (LocalDuctTemperature, Faktor 10) und die Feuchte aus H:15 (LocalDuctHumidity). Der Kanalsensor ist außerdem der interne Hochfeuchte-Begrenzer des Geräts (Abschaltung bei 78 %RH).

Sollwerte

• Kanaltemperatur-Sollwert — Thermostat, der die aktuelle Kanaltemperatur (H:16) mit dem beschreibbaren Kanaltemperatur-Sollwert (H:45 DuctTempSetPoint, Faktor 10, Bereich 1–50 °C, Standard 18 °C) koppelt.
• Kanalfeuchte-Sollwert — beschreibbarer Kanalfeuchte-Sollwert (H:55 DuctHumidifSetPoint, spezifikationsgemäß Faktor 10 %RH, Bereich 0–90 %RH, Standard 78 %RH), als ModbusDimmer auf der 0–1-Skala bereitgestellt.
• Raumfeuchte-Sollwert — beschreibbarer Raumfeuchte-Sollwert (H:54 RoomHumidifSetPoint, spezifikationsgemäß Faktor 10 %RH, Bereich 5–90 %RH, Standard 45 %RH), ebenfalls als 0–1-Dimmer bereitgestellt.

Skalierungshinweis. Die Registerkarte des Herstellers definiert die Feuchteregister (H:15, H:54, H:55) mit Faktor 10 (raw / 10 = %RH). Die TapHome-XML teilt stattdessen durch 1000, damit diese Register sauber auf die Gerätemodelle ModbusDimmer / ModbusTemperatureSensor abgebildet werden, die eine 0–1-Skala statt 0–100 %RH erwarten. Das ist eine absichtliche Umskalierung, kein Fehler — der Wert in TapHome ist einfach %RH / 100.

Betriebsart-Steuerung

• System Mode — Multi-Value-Schalter auf dem primären Steuerregister H:88 (SystemMode). Die Hersteller­spezifikation definiert vier Modi: 1 = Auto, 2 = Humidify, 3 = Cool, 4 = Off. Das Template reserviert zusätzliche Platzhalter-Slots (Werte 0 und 5–9), die auf die Rohwerte 64 und 69–73 abgebildet sind — diese sind in der aktuellen Firmware ungenutzt und existieren, damit neue Modi künftiger Firmware-Versionen ohne Neuerstellung des Templates verfügbar gemacht werden können.

Funk-Hygrometer-Telemetrie

Der HomEvap wird mit einem optionalen 868-MHz-Funk-Hygrometer-Controller-Zubehör geliefert. Das Template stellt dessen Messwerte und Sollwerte über Register außerhalb der veröffentlichten v3_03-Tabelle bereit:

• Funk-Hygrometer Temperatur / Feuchte — Temperatur (H:91, Faktor 100) und Feuchte (H:94) vom Funk-Zubehör. Sowohl Int16- als auch UInt16-Varianten sind als separate Geräte enthalten, damit je nach Firmware-Verhalten vor Ort die richtige gewählt werden kann.
• Funk-Hygrometer Temperatur-/Feuchte-Sollwert — Temperatur-Sollwert (H:92) und Feuchte-Sollwert (H:95).
• Funk-Hygrometer Feuchte-Sollwert — dedizierte, nur lesbare Ansicht von H:95 in roher %RH-Einheit (Faktor 10), nützlich, wenn das andere Gerät im Template denselben Register als 0–1-Dimmer-Wert liest.
• Funk-Hygrometer Modus — nur lesbare Betriebsart aus H:108. Die Wertezuordnung entspricht SystemMode (1=Auto, 2=Humidify, 3=Cool, 4=Off).
• Funk-Hygrometer Batterie — Rohbatteriestatus / -stand aus H:97.

Undokumentierte Register. H:91, H:92, H:94, H:95, H:97 und H:108 sind nicht in der offiziellen HomEvap-v3_03-Registertabelle aufgeführt. Sie wurden per Reverse Engineering aus realen Geräten ermittelt und funktionieren nachweislich im Feld (sowohl über das TapHome-Template als auch über die Community-ESPHome-Modbus-Bridge). HomEvap kann sie in zukünftigen Firmware-Updates neu zuweisen — überprüfe die Messwerte nach jedem Controller-Firmware-Upgrade vor Ort.

Wenn die Funkverbindung zwischen HomEvap und seinem drahtlosen Controller unzuverlässig ist (dicke Wände, große Entfernungen), installiere stattdessen den optionalen T8-Rückluftkanalsensor an Klemme TB9. Am lokalen Controller ersetzt er die Messwerte des Funk-Hygrometers; der Kanalsensor (SHC80) bleibt der interne Hochfeuchte-Begrenzer.

Fehlerbehebung#

Keine Modbus-Kommunikation

1. Prüfe auf der HomEvap-Hauptplatine DS2.8 = ON — sonst ist der TB1-Bus im BACnet-Modus.
2. Stelle sicher, dass die Slave-Adresse an DS2.1–DS2.7 mit der Slave ID im TapHome-Template übereinstimmt.
3. Beobachte die TXD / RXD LEDs (LD2 / LD3) auf der Platine während des Pollings — bleiben sie dunkel, erreicht die Anfrage das Gerät nicht (Polarität an A+/B−, Gateway-Verdrahtung oder Massebezug).
4. Fixiere das Gateway auf eine feste Baudrate (empfohlen 9600 8N2), statt auf AutoBaud zu setzen.
5. Stelle sicher, dass das RTU-to-TCP-Gateway vom TapHome Core erreichbar ist (Ping auf die Gateway-IP, Test von Port 502).

Feuchtewert zeigt 0,45 statt 45 %RH

Das ist erwartetes Verhalten. Die ModbusDimmer- / ModbusTemperatureSensor-Feuchte-Eingänge in TapHome nutzen eine 0–1-Skala, daher teilt die XML den Rohwert (spezifikationsgemäß mit Faktor 10) durch 1000 (raw 780 → 0.78). Zeige ihn in der App als Prozentsatz an, indem du mit 100 multiplizierst, oder nutze den numerischen Wert direkt in Smart Rules.

Moduswrite hat keine Wirkung

Prüfe den lokalen Alarmzustand des Geräts. Wenn die Alarm-LED an der Unterseite leuchtet (M OFF auf dem Controller-Display), ist der potenzialfreie Kontakt der Hauptfreigabe an TB3 Pin 4 offen und das Gerät ist unabhängig von Modbus-Befehlen verriegelt. Stelle den Freigabe-Kontakt wieder her und der Schreibvorgang wirkt beim nächsten SystemMode-Update.

SystemMode liefert einen unerwarteten Wert

Die XML stellt 10 Slots (Value0–Value9) bereit, aber nur 1 = Auto, 2 = Humidify, 3 = Cool, 4 = Off sind in der v3_03-Spezifikation definiert. Liest das Register 64 oder einen Wert im Bereich 69–73 zurück, hat das Gerät einen der Platzhalter-Werte gemeldet — behandle diese als „undefiniert / reserviert" und prüfe den tatsächlichen Zustand am Controller-Display.

Sporadische Wassermangel- oder Abflussalarme

Dauerhafte Alarme bilden sich auf System_status2 Bits 10–15 ab — Drain Blocked, Airflow Switch, No Airflow, No Water, Heater Default, Service Alarm — und werden zusätzlich durch das Blinkmuster der Alarm-LED an der Unterseite des Geräts signalisiert (3× = Sensor, 9× = Wasser, 11× = kein Luftstrom, 15× = Heizung, 17× = Luftstrom, 19× = T2). Folge bei der Behebung der Fehlertabelle im Installationshandbuch; um einen verriegelten Alarm zurückzusetzen, ziehe den Netzstecker, warte 10 s und stecke ihn wieder ein.