Il template Vaillant aroTHERM plus collega TapHome a una pompa di calore aria-acqua Vaillant aroTHERM plus e al suo regolatore di sistema sensoCOMFORT VRC 720 o multiMATIC VRC 700 tramite un eBUS Adapter Shield o Stick C6 di ebusd.eu. L’adattatore è collegato all’eBUS del regolatore ed esegue micro-ebusd, che decodifica i messaggi Vaillant e li offre tramite un’API HTTP JSON locale. TapHome comunica solo con l’adattatore nella rete locale; il cloud non viene usato.
Il template legge la temperatura esterna, ambiente, di mandata e dell’acqua calda, la pressione dell’acqua, la potenza e l’energia della pompa di calore e gli errori del regolatore. Imposta il setpoint ambiente della zona 1, il setpoint dell’acqua calda, le modalità di funzionamento della zona 1 e dell’acqua calda e avvia una carica singola dell’acqua calda. Legge inoltre le temperature di mandata, di ritorno e dell’aria in ingresso, la modulazione del compressore e l’attività della pompa di calore, e imposta la curva di riscaldamento, le temperature minime di mandata in riscaldamento e in raffrescamento, la modalità di raffrescamento della zona 1 e l’isteresi di carica dell’acqua calda.
Template della community. Il template è stato generato nel portale TapHome dalla documentazione di micro-ebusd e dalle definizioni dei messaggi ebusd per il VRC 720, il VRC 700 e la aroTHERM plus; l’esperienza sul campo è benvenuta. Scarica l’XML da questa pagina o dal portale TapHome: Vaillant aroTHERM plus + VRC 720 / VRC 700 — template della community, e importalo come nuovo modulo.
Il template completa il template ufficiale TapHome eBUS Adapter Shield C6 Stick, che tramite MQTT mostra lo stato dell’adattatore stesso (segnale del bus, servizio, temperatura); i due possono funzionare insieme. Non ha nulla a che fare con il template della community per il ventilconvettore Vaillant aroVAIR, che usa Modbus RTU.
Cosa serve
- Vaillant aroTHERM plus con il regolatore sensoCOMFORT VRC 720 o multiMATIC VRC 700 sull’eBUS.
- eBUS Adapter Shield C6 o Stick C6 (adapter.ebusd.eu) con il firmware più recente e micro-ebusd attivato. micro-ebusd è una funzione a pagamento dell’adattatore, sbloccata con un token; ogni adattatore riceve una licenza di prova di 30 giorni.
- L’adattatore e il TapHome Core nella stessa rete locale.
Collegamento hardware
L’adattatore si collega ai due morsetti eBUS del regolatore (VRC 720 o VRC 700); l’eBUS non ha polarità. La aroTHERM plus comunica con il regolatore sullo stesso bus, quindi non serve alcun filo verso l’unità esterna. Prima di lavorare sui morsetti del regolatore togli l’alimentazione di rete.
Collega l’adattatore alla rete locale come descritto nella sua documentazione e riserva il suo indirizzo IP nel router, così TapHome lo raggiunge sempre.
Configurazione
Attivare micro-ebusd
- Aggiorna l’adattatore al firmware più recente (adapter.ebusd.eu).
- Ottieni un token micro-ebusd su token.ebusd.eu (una licenza di prova di 30 giorni per adattatore, poi a pagamento) e inseriscilo nell’interfaccia web dell’adattatore.
- Dopo l’attivazione l’API HTTP JSON risponde su
http://<adapter-ip>/api/v1/ebus.
Trovare i nomi dei circuiti
micro-ebusd indirizza ogni valore per circuito e nome del messaggio. Apri http://<adapter-ip>/api/v1/ebus/list nel browser: elenca i circuiti e i messaggi che l’adattatore ha trovato sul bus. Il regolatore sensoCOMFORT VRC 720 compare, a seconda della versione, come ctlv2, ctlv3 o 720, il multiMATIC VRC 700 come 700, l’unità esterna della aroTHERM plus come hmu. Il template supporta entrambi i regolatori; per il VRC 700 inserisci 700 come circuito del regolatore.
Parametri di importazione
| Parametro | Valore predefinito | Descrizione |
|---|---|---|
ADAPTER_IP | (vuoto) | Indirizzo IP dell’adattatore eBUS |
CONTROLLER_CIRCUIT | ctlv2 | Nome del circuito del regolatore da /api/v1/ebus/list, ad esempio ctlv2 per il VRC 720 o 700 per il VRC 700 |
HEAT_SOURCE_CIRCUIT | hmu | Nome del circuito dell’unità esterna della aroTHERM plus |
L’importazione crea due moduli sullo stesso adattatore: Regolatore (sensoCOMFORT VRC 720 / multiMATIC VRC 700) con tredici dispositivi e aroTHERM plus (hmu) con sei dispositivi della pompa di calore.
Funzionalità dei dispositivi
Temperature e pressione
- Temperatura esterna — temperatura esterna come la mostra il regolatore.
- Temperatura di mandata — temperatura di mandata dell’impianto (mandata del riscaldamento).
- Pressione dell’acqua — pressione dell’acqua dell’impianto di riscaldamento in bar (sola lettura).
Zona 1
- Termostato zona 1 — temperatura ambiente e il setpoint che il regolatore usa davvero. Un setpoint impostato in TapHome (5–30 °C) viene inviato come quick veto: una modifica temporanea per 3 ore (la variabile del dispositivo
QuickVetoHours, 0,5–12 h); poi torna a valere il programma orario del regolatore. Dopo la scrittura il template rilegge il valore dal bus. - Modalità di funzionamento zona 1 — Spento, Auto (programma orario), Manuale / Giorno e Notte. Il template prende i nomi dalla definizione che l’adattatore riporta:
off,auto,manualcon il firmware micro-ebusd da aprile 2026,off,auto,day,nightcon il firmware precedente. Notte esiste solo con i nomi precedenti; il VRC 720 di per sé ha Manuale, Auto e Spento. - Modalità raffrescamento zona 1 — Spento, Auto e Manuale per il raffrescamento della zona 1. Sul VRC 720 richiede il firmware micro-ebusd dal 22/04/2026 e il raffrescamento abilitato per il circuito di riscaldamento 1; con un firmware precedente il dispositivo resta senza valore. Sul VRC 700 il template usa la modalità di raffrescamento del VRC 700 e scrive Manuale come
day.
Acqua di mandata in riscaldamento e raffrescamento
- Curva di riscaldamento — curva di riscaldamento del circuito di riscaldamento 1, da 0,1 a 4,0.
- Temperatura minima di mandata riscaldamento — temperatura minima dell’acqua di mandata in riscaldamento, da 15 a 80 °C. Il regolatore riscalda al valore più alto tra la sua curva di riscaldamento e questo valore, quindi con una curva di riscaldamento bassa il valore scritto qui determina la temperatura di mandata; la temperatura massima di mandata del regolatore la limita comunque. Una smart rule come Regolazione equitermica può scrivere in questo dispositivo la temperatura di mandata che calcola. Il valore viene arrotondato al grado intero e scritto solo quando cambia. Il regolatore lo conserva nella memoria permanente: per precauzione, fai in modo che la smart rule lo modifichi al massimo circa una volta ogni 10 minuti.
- Temperatura minima di mandata raffrescamento — temperatura minima dell’acqua di mandata in raffrescamento, da 7 a 24 °C; il controllo del punto di rugiada del regolatore può aumentarla. Sul VRC 720 con il firmware micro-ebusd dal 22/04/2026 è disponibile solo quando il raffrescamento è abilitato per il circuito di riscaldamento 1.
Acqua calda
- Termostato acqua calda sanitaria — temperatura del bollitore e setpoint dell’acqua calda, regolabile da 35 a 75 °C.
- Modalità acqua calda sanitaria — Spento, Auto, Manuale / Giorno o Notte (Notte solo con il firmware precedente, vedi sopra).
- Carica singola acqua calda — l’accensione avvia la carica; a bollitore carico il regolatore torna da solo in auto e l’interruttore mostra di nuovo spento.
- Isteresi carica acqua calda — isteresi della carica dell’acqua calda in K. Il regolatore rifiuta un valore fuori dal suo intervallo; TapHome mostra poi il valore che il regolatore ha mantenuto.
Elettricità della pompa di calore
Il modulo aroTHERM plus (hmu) ha sei dispositivi. Contatore elettrico della pompa di calore è un contatore dell’unità esterna:
- Potenza — potenza elettrica attuale della pompa di calore in kW.
- Consumo totale — consumo totale di elettricità della pompa di calore in kWh. Il contatore è un numero a 16 bit (al massimo 65535 kWh), quindi su un’unità in funzione da molti anni può essere già ripartito da zero.
Mostra anche tre attributi di servizio:
| Attributo di servizio | Descrizione |
|---|---|
| COP (riscaldamento) | Coefficiente di prestazione della pompa di calore in riscaldamento |
| Resa termica totale [kWh] | Resa termica totale della pompa di calore — energia termica, non elettricità |
| Stato operativo | Stato indicato dall’unità esterna: ready, heating, cooling, heating_water o error |
Funzionamento della pompa di calore
- Temperatura di mandata pompa di calore, Temperatura di ritorno pompa di calore e Temperatura aria in ingresso — temperature misurate dall’unità esterna.
- Modulazione compressore — modulazione del compressore in %, con la velocità del compressore, le temperature in ingresso e in uscita del compressore e l’alta pressione come attributi di servizio.
- Attività pompa di calore — cosa sta facendo la pompa di calore, in base al suo codice di stato: 0 standby, 1 riscaldamento, 2 raffrescamento, 3 acqua calda, 4 sbrinamento, 5 altro (ad esempio protezione o guasto). L’attributo di servizio Codice di stato mostra il codice di stato stesso.
Errori del regolatore
Il modulo Regolatore (sensoCOMFORT VRC 720 / multiMATIC VRC 700) legge a ogni ciclo gli errori attuali del regolatore. Per ciascuno dei suoi cinque campi di errore diverso da zero, il modulo mostra un errore con il numero dell’errore, ad esempio Controller error code: 1025.
Come il template comunica con l’adattatore
Ogni valore è un messaggio della definizione ebusd. Il template lo legge con GET /api/v1/ebus/{circuit}/{message}/get?from=1, che risponde dalla cache dell’adattatore o interroga il bus, e prende data.fields.value dalla risposta. Una scrittura è PUT /api/v1/ebus/{circuit}/{message}/set con il corpo {"fields":{"value":…}}, seguita da una lettura con from=2, che interroga sempre il bus. I moduli e tutti i dispositivi leggono ogni 60 s. Il firmware micro-ebusd dal 22/04/2026 usa nomi dei messaggi più recenti (OutsideTemp, Z1TempDesired, CurrentError); il template legge prima il nome più recente e, se manca, ripiega su quello precedente.
Nessun dispositivo scrive qualcosa all’avvio del TapHome Core: prendono il loro stato dall’adattatore, non dall’ultimo valore in TapHome.
Alcune versioni del firmware del VRC 720 confermano una scrittura senza eseguirla. Poiché il template rilegge il valore dal bus dopo ogni scrittura, TapHome mostra poi il valore che il regolatore usa davvero, non quello che hai impostato.
Il multiMATIC VRC 700 ha meno messaggi del VRC 720. Non ha una temperatura minima di mandata per il raffrescamento, quindi Temperatura minima di mandata raffrescamento resta senza valore. Non ha una durata del quick veto: Termostato zona 1 scrive solo la temperatura del quick veto e
QuickVetoHoursnon si applica. Il setpoint della zona 1 e la temperatura esterna provengono dai messaggi precedentiZ1ActualRoomTempDesiredeDisplayedOutsideTemp.
Cosa il template non fa
- Gli altri parametri dell’installatore (temperatura massima di mandata e il resto delle impostazioni dell’installatore) sono esclusi di proposito — delle impostazioni dell’installatore il template modifica solo la curva di riscaldamento, le temperature minime di mandata in riscaldamento e in raffrescamento e l’isteresi di carica dell’acqua calda.
- Il setpoint di raffrescamento della zona 1, le zone 2 e 3 e il programma orario settimanale non fanno parte del template.
- La potenza termica attuale dell’unità esterna è disponibile sul bus ma non viene letta.
Risoluzione dei problemi
Nessun valore
Verifica che micro-ebusd sia attivato e che il token non sia scaduto: senza micro-ebusd l’adattatore non risponde su /api/v1/ebus. Verifica che http://<adapter-ip>/api/v1/ebus/list si apra nel browser.
I dispositivi del regolatore non mostrano alcun valore
Il nome del circuito non corrisponde. Apri http://<adapter-ip>/api/v1/ebus/list, trova il nome del regolatore (ctlv2, ctlv3 o 720 per il VRC 720, 700 per il VRC 700) e dell’unità esterna (hmu) e importa di nuovo il template con questi nomi.
Un setpoint o una modalità torna al vecchio valore
Il regolatore non ha eseguito la scrittura; TapHome mostra il valore riletto dal bus. Verifica la modalità di funzionamento della zona e il firmware del regolatore. Un setpoint da TapHome torna al programma orario anche quando il quick veto termina (QuickVetoHours).
Errore del modulo Controller error code: …
Il regolatore segnala un errore con questo numero. Cercalo nella documentazione del regolatore o della pompa di calore; l’errore del modulo scompare quando il regolatore lo cancella.
