HomEvap Humidifier è un umidificatore adiabatico montato a canale prodotto da HomEvap B.V. (Paesi Bassi). Si installa nel canale dell’aria di mandata a valle di un’unità di ventilazione con recupero di calore (HRV) e fa evaporare acqua fresca filtrata LegioSafe nel flusso d’aria attraverso una cassetta con matrice in fibra di vetro. La stessa scheda e la stessa mappatura dei registri sono condivise con le varianti sorelle HomEvap Cooler, Combi Comfort (All Season) e Direct, quindi il template può essere usato anche come riferimento per queste unità.

Il dispositivo parla Modbus RTU su RS-485 (sullo stesso bus viaggia anche BACnet MS/TP). Il template TapHome è un ModbusTcpCCU, quindi è necessario un gateway RTU-to-TCP — il ponte consigliato è il TapHome Modbus RTU Gateway. Attraverso questo collegamento TapHome legge il sensore di canale integrato (SHC80 per umidità e temperatura), scrive i setpoint di temperatura e umidità del canale, controlla il registro primario SystemMode (Auto / Umidifica / Raffredda / Off) ed espone la telemetria dell’accessorio igrometro wireless.

Collegamento hardware#

La scheda principale HomEvap espone una singola coppia RS-485 a 2 fili sulla morsettiera TB1. Lo stesso bus fisico trasporta Modbus RTU o BACnet MS/TP — il protocollo si seleziona con le impostazioni dei DIP switch (vedi Abilitazione della comunicazione Modbus più sotto), non dal cablaggio.

Porta un doppino schermato intrecciato (ad es. un cavo RS-485 dedicato) dalle viti TB1 dell’HomEvap ai morsetti A/B del gateway Modbus RTU. Collega il gateway alla stessa rete locale del TapHome Core tramite Ethernet. Il gateway espone quindi l’HomEvap su Modbus TCP porta 502 con l’indirizzo slave configurato sul dispositivo.

Schema di cablaggio

Morsetti chiave per l’integrazione TapHome:

HomEvap non ha porta Ethernet o Wi-Fi — è un dispositivo solo RS-485. Un gateway Modbus RTU-to-TCP è obbligatorio; TapHome non può raggiungere direttamente l’unità.

Abilitazione della comunicazione Modbus#

Modbus viene abilitato e indirizzato interamente tramite il blocco DIP DS2 sulla scheda principale. È totalmente indipendente dal blocco DS1 (che configura la sorgente di controllo locale).

1. Abilita il bus: imposta DS2.8 = ON. L’interfaccia RS-485 sul TB1 passa così da BACnet MS/TP a Modbus RTU e si attiva il gestore del protocollo.
2. Imposta un indirizzo slave univoco: gli switch da DS2.1 a DS2.7 formano l’indirizzo slave come valore binario a 7 bit (LSB = DS2.1). Ogni unità in catena deve avere il proprio indirizzo.
   • Unità #1: DS2.1 ON, DS2.8 ON → indirizzo 1
   • Unità #2: DS2.1 OFF, DS2.2 ON, DS2.8 ON → indirizzo 2
3. Verifica il traffico: non appena il gateway inizia il polling, i LED verdi LD2 / LD3 (TXD / RXD) accanto al TB1 lampeggiano a ogni richiesta riuscita.

I parametri seriali predefiniti sono 8N2 con AutoBaud — il controller seleziona automaticamente tra 9600, 19200, 38400 e 57600. La maggior parte dei gateway RTU-to-TCP funziona meglio a una baud rate fissa; configura il gateway su 9600 8N2 (oppure 8N1 — il dispositivo è tollerante, come confermato dal bridge ESPHome della community).

HomEvap supporta i codici funzione 0x03 Read Holding Registers, 0x06 Write Single Register e 0x10 Write Multiple Registers. Tutti gli indirizzi nel template sono holding register (H:*).

Scrivere il valore 0 nel registro 0x01 (BaudRate) riabilita AutoBaud sul dispositivo. Non includere questo registro in un polling BMS o in un ciclo di scrittura — blocca la baud rate sul gateway.

Terminazione del bus RS-485

Abilita la resistenza di terminazione da 120 Ω e le resistenze di polarizzazione fail-safe solo alle due estremità fisiche del bus RS-485. Su una tratta punto-punto corta con una singola unità HomEvap significa terminare sul gateway e all’estremità TB1 dell’HomEvap; in catene con più unità HomEvap termina solo sul primo e sull’ultimo dispositivo della linea.

Configurazione#

Quando importi il template in TapHome, fornisci:

• IP Address — l’indirizzo IP del gateway RTU-to-TCP sulla rete locale
• Slave ID — l’indirizzo slave Modbus configurato sull’HomEvap tramite DS2.1–DS2.7 (default 1)

L’HomEvap stesso non ha un indirizzo IP. Assegna al gateway un IP statico nella lista delle riserve DHCP del router, in modo che non cambi dopo un riavvio.

Funzionalità del dispositivo#

Il template espone i seguenti dispositivi, tutti mappati sui holding register H:15 — H:108:

Letture dal sensore di canale

• Temperatura / umidità del canale — legge il sensore SHC80 integrato montato nel canale di mandata. La temperatura arriva da H:16 (LocalDuctTemperature, fattore 10) e l’umidità da H:15 (LocalDuctHumidity). Il sensore di canale è anche il limitatore interno di alta umidità dell’unità (taglio a 78 %RH).

Setpoint

• Setpoint temperatura canale — termostato che abbina la temperatura di canale corrente (H:16) al setpoint di temperatura del canale scrivibile (H:45 DuctTempSetPoint, fattore 10, intervallo 1–50 °C, default 18 °C).
• Setpoint umidità canale — setpoint di umidità del canale scrivibile (H:55 DuctHumidifSetPoint, da specifica fattore 10 %RH, intervallo 0–90 %RH, default 78 %RH), esposto come ModbusDimmer su scala 0–1.
• Setpoint umidità ambiente — setpoint di umidità ambiente scrivibile (H:54 RoomHumidifSetPoint, da specifica fattore 10 %RH, intervallo 5–90 %RH, default 45 %RH), esposto anch’esso come dimmer 0–1.

Nota sulla scalatura. La tabella dei registri del produttore definisce i registri di umidità (H:15, H:54, H:55) con fattore 10 (raw / 10 = %RH). Il file XML TapHome divide invece per 1000, in modo che questi registri si mappino in modo pulito sui modelli di dispositivo ModbusDimmer / ModbusTemperatureSensor, che si aspettano una scala 0–1 invece di 0–100 %RH. È una riscalatura intenzionale, non un bug — il valore in TapHome è semplicemente %RH / 100.

Controllo della modalità operativa

• System Mode — selettore multi-valore sul registro di controllo primario H:88 (SystemMode). La specifica del produttore definisce quattro modalità: 1 = Auto, 2 = Humidify, 3 = Cool, 4 = Off. Il template riserva ulteriori slot placeholder (valori 0 e 5–9) che si mappano sui valori raw 64 e 69–73 — non sono utilizzati nel firmware attuale ed esistono perché eventuali nuove modalità aggiunte in versioni future del firmware possano essere esposte senza ricreare il template.

Telemetria dell’igrometro wireless

HomEvap è fornito con un accessorio opzionale: un igrometro-controller wireless a 868 MHz. Il template espone le sue letture e i suoi setpoint tramite registri al di fuori della tabella pubblicata v3_03:

• Temperatura / umidità igrometro wireless — temperatura (H:91, fattore 100) e umidità (H:94) dall’accessorio wireless. Sono incluse come dispositivi separati sia la variante Int16 sia quella UInt16, in modo da poter scegliere sul campo quella corretta in base al comportamento del firmware.
• Setpoint temperatura / umidità igrometro wireless — setpoint di temperatura (H:92) e setpoint di umidità (H:95).
• Setpoint umidità igrometro wireless — vista dedicata di sola lettura di H:95 in unità raw %RH (fattore 10), utile quando l’altro dispositivo del template legge lo stesso registro come valore dimmer 0–1.
• Modalità igrometro wireless — modalità operativa di sola lettura da H:108. La mappa dei valori coincide con SystemMode (1=Auto, 2=Humidify, 3=Cool, 4=Off).
• Batteria igrometro wireless — stato / livello raw della batteria da H:97.

Registri non documentati. H:91, H:92, H:94, H:95, H:97 e H:108 non sono elencati nella tabella ufficiale dei registri HomEvap v3_03. Sono stati ricavati tramite reverse engineering da dispositivi reali e funzionano sul campo (sia tramite il template TapHome sia tramite il bridge Modbus ESPHome della community). HomEvap potrebbe riassegnarli in aggiornamenti firmware futuri — verifica le letture sul campo dopo qualsiasi aggiornamento firmware del controller.

Se il collegamento radio tra HomEvap e il suo controller wireless è inaffidabile (pareti spesse, grandi distanze), installa invece il sensore opzionale T8 nel canale di ripresa sul morsetto TB9. Sul controller locale sostituisce le misurazioni dell’igrometro wireless; il sensore di canale (SHC80) rimane il limitatore interno di alta umidità.

Risoluzione dei problemi#

Nessuna comunicazione Modbus

1. Verifica sulla scheda principale HomEvap che DS2.8 = ON — altrimenti il bus TB1 resta in modalità BACnet.
2. Verifica che l’indirizzo slave su DS2.1–DS2.7 coincida con Slave ID inserito nel template TapHome.
3. Osserva durante il polling i LED TXD / RXD (LD2 / LD3) sulla scheda — se restano spenti, la richiesta non raggiunge l’unità (polarità A+/B−, cablaggio del gateway o riferimento di massa).
4. Blocca il gateway su una baud rate fissa (consigliato 9600 8N2) invece di affidarti ad AutoBaud.
5. Verifica che il gateway RTU-to-TCP sia raggiungibile dal TapHome Core (ping all’IP del gateway, test della porta 502).

L’umidità mostra 0,45 invece di 45 %RH

È il comportamento previsto. Gli input di umidità ModbusDimmer / ModbusTemperatureSensor in TapHome usano una scala 0–1, quindi l’XML divide il valore raw con fattore 10 della specifica per 1000 (raw 780 → 0.78). Visualizzalo come percentuale nell’app moltiplicando per 100, oppure usa il valore numerico direttamente nelle smart rule.

La scrittura della modalità non ha effetto

Controlla lo stato di allarme locale dell’unità. Se il LED di allarme sul fondo è acceso (M OFF sul display del controller), il contatto a potenziale pulito Main Enable sul pin 4 di TB3 è aperto e l’unità è bloccata indipendentemente dai comandi Modbus. Ripristina il contatto di abilitazione e la scrittura avrà effetto al prossimo aggiornamento di SystemMode.

SystemMode restituisce un valore inatteso

L’XML espone 10 slot (Value0–Value9) ma nella specifica v3_03 sono definite solo 1 = Auto, 2 = Humidify, 3 = Cool, 4 = Off. Se il registro restituisce 64 o un valore nell’intervallo 69–73, l’unità sta riportando uno dei valori placeholder — trattali come “indefinito / riservato” e verifica lo stato reale sul display del controller.

Falsi allarmi di mancanza d’acqua o scarico bloccato

Gli allarmi persistenti si mappano su System_status2 bit 10–15 — Drain Blocked, Airflow Switch, No Airflow, No Water, Heater Default, Service Alarm — e sono indicati anche dal pattern di lampeggio del LED di allarme sul fondo dell’unità (3× = sensore, 9× = acqua, 11× = nessun flusso d’aria, 15× = riscaldatore, 17× = flusso d’aria, 19× = T2). Per il ripristino segui la tabella dei guasti del manuale di installazione; per cancellare un allarme bloccato stacca la spina, attendi 10 s e ricollegala.