--- title: "Vaillant aroTHERM plus + sensoCOMFORT VRC 720 (eBUS, micro-ebusd)" description: "Controlla Vaillant aroTHERM plus con sensoCOMFORT VRC 720 da TapHome via eBUS — setpoint ambiente e acqua calda, modalità, potenza ed energia, senza cloud." url: "https://taphome.com/it/compatibility/vaillant-ebus-micro-ebusd-http/" language: it lastmod: 2026-11-04 generator: hugo ai: topics: ["http","heat-pump","ebus","rest-api","gateway","wifi","dhw"] questions: ["Esiste un template TapHome per le pompe di calore Vaillant?","Qual è il modo più semplice per controllare una pompa di calore Vaillant da TapHome?","Come collegare una Vaillant aroTHERM plus con sensoCOMFORT VRC 720 a TapHome tramite eBUS?","A cosa serve il token micro-ebusd dell'adattatore eBUS C6?","Quali nomi di circuito servono al template Vaillant?","Perché un setpoint scritto da TapHome torna al vecchio valore sul VRC 720?"] --- # Vaillant aroTHERM plus + sensoCOMFORT VRC 720 (eBUS, micro-ebusd) Comunicazione: Packet Parser → HTTP - [Sito ufficiale Vaillant](https://www.vaillant.com) - [Pagina prodotto Vaillant aroTHERM plus](https://www.vaillant.com/en/products/arothermplus/) - [eBUS Adapter Shield C6 e Stick C6](https://adapter.ebusd.eu/v5-c6/) 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 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. > [!WARNING] > **Template della community — non ancora testato con TapHome su un adattatore reale.** Il template è stato generato nel portale TapHome dalla documentazione di micro-ebusd e dalle definizioni dei messaggi ebusd per il VRC 720 e la aroTHERM plus. È stato testato solo con un adattatore simulato su un TapHome Core 2025.2 locale, non con un adattatore, un regolatore o una pompa di calore reali, e l'esperienza sul campo è benvenuta. Scarica l'XML da questa pagina o dal portale TapHome: [Vaillant aroTHERM plus + VRC 720 — template della community](https://portal.taphome.com/portal/community/vaillant-ebus-micro-ebusd-http), e importalo come nuovo modulo. **[Vaillant heat pump and VRC 720 controller through the eBUS Adapter C6 with micro-ebusd (HTTP)](https://portal.taphome.com/it/portal/community/vaillant-ebus-micro-ebusd-http)** — Vaillant, HTTP. Vaillant aroTHERM plus with the sensoCOMFORT VRC 720 through the eBUS Adapter C6 running micro-ebusd: outdoor, room, flow and hot water temperatures, room setpoint as a temporary override, zone and hot water modes, hot water boost, water pressure, heat pump power and energy, controller errors. Il template completa il template ufficiale TapHome [eBUS Adapter Shield C6 Stick](https://taphome.com/it/compatibility/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** sull'eBUS. - **eBUS Adapter Shield C6 o Stick C6** ([adapter.ebusd.eu](https://adapter.ebusd.eu/v5-c6/)) 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; 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 1. Aggiorna l'adattatore al firmware più recente ([adapter.ebusd.eu](https://adapter.ebusd.eu/v5-c6/)). 2. Ottieni un token micro-ebusd su [token.ebusd.eu](https://token.ebusd.eu/) (una licenza di prova di 30 giorni per adattatore, poi a pagamento) e inseriscilo nell'interfaccia web dell'adattatore. 3. Dopo l'attivazione l'API HTTP JSON risponde su `http:///api/v1/ebus`. ### Trovare i nomi dei circuiti micro-ebusd indirizza ogni valore per circuito e nome del messaggio. Apri `http:///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`, l'unità esterna della aroTHERM plus come `hmu`. La finestra di importazione indica anche `700` per il VRC 700; il template è stato scritto sulle definizioni dei messaggi del VRC 720. ### 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` | | `HEAT_SOURCE_CIRCUIT` | `hmu` | Nome del circuito dell'unità esterna della aroTHERM plus | L'importazione crea due moduli sullo stesso adattatore: **sensoCOMFORT VRC 720 (ctlv2)** con otto dispositivi e **aroTHERM plus (hmu)** con il contatore elettrico della pompa di calore. ## Funzionalità dei dispositivi ### Temperature e pressione - **Temperatura esterna** — temperatura esterna come la mostra il VRC 720. - **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, il programma orario del regolatore resta invariato. 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 invia i nomi della definizione ebusd (`off`, `auto`, `day`, `night`). Sul VRC 720 la modalità `day` è la sua modalità manuale e il VRC 720 non ha una modalità notte. ### 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, Giorno o Notte. - **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. ### Elettricità della pompa di calore Il modulo **aroTHERM plus (hmu)** ha un solo dispositivo, **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` | ### Errori del regolatore Il modulo **sensoCOMFORT VRC 720 (ctlv2)** 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. Nessun dispositivo scrive qualcosa all'avvio del TapHome Core: prendono il loro stato dall'adattatore, non dall'ultimo valore in TapHome. > [!NOTE] > **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. ### Cosa il template non fa - I **parametri dell'installatore** (curva di riscaldamento, temperatura massima di mandata) sono esclusi di proposito — il template non modifica le impostazioni dell'installatore del regolatore. - Il raffrescamento della zona 1, le zone 2 e 3 e il programma orario settimanale non fanno parte del template. - Altri valori dell'unità esterna (temperatura dell'aria aspirata, utilizzo del compressore, potenza termica attuale) sono disponibili sul bus ma non vengono letti. ## 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:///api/v1/ebus/list` si apra nel browser. ### I dispositivi del regolatore non mostrano alcun valore Il nome del circuito non corrisponde. Apri `http:///api/v1/ebus/list`, trova il nome del regolatore (`ctlv2`, `ctlv3` o `720`) 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. ### 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. ## Dispositivi disponibili sensoCOMFORT VRC 720 (ctlv2) Modulo Temperatura esterna Sensore di temperatura Solo lettura Temperatura esterna come la mostra il regolatore VRC 720 numeric Unità: °C Termostato zona 1 Termostato Temperatura ambiente e setpoint attivo della zona 1; un nuovo setpoint viene inviato come quick veto — una modifica temporanea, il programma orario resta invariato numeric Unità: °C Modalità di funzionamento zona 1 Interruttore multivalore Modalità di funzionamento della zona 1 — Spento, Auto (programma orario), Manuale / Giorno o Notte; sul VRC 720 la modalità day è quella manuale e la modalità notte non esiste enum numeric Valori / Stati: Spento · Auto · Manuale / Giorno · Notte Termostato acqua calda sanitaria Termostato Temperatura del bollitore e setpoint dell'acqua calda, regolabile da 35 a 75 °C numeric Unità: °C Modalità acqua calda sanitaria Interruttore multivalore Modalità di funzionamento del circuito dell'acqua calda — Spento, Auto, Giorno o Notte enum numeric Valori / Stati: Spento · Auto · Giorno · Notte Carica singola acqua calda Interruttore Carica singola dell'acqua calda — l'accensione avvia la carica, a bollitore carico il regolatore torna da solo in auto boolean Valori / Stati: Active · OFF Temperatura di mandata Sensore di temperatura Solo lettura Temperatura di mandata dell'impianto (mandata del riscaldamento) indicata dal regolatore VRC 720 numeric Unità: °C Pressione dell'acqua Variabile Solo lettura Pressione dell'acqua dell'impianto di riscaldamento in bar numeric Unità: bar **Connessione:** Packet Parser → HTTP Possibili miglioramenti (5) - Cooling of zone 1 — The controller definition has cooling setpoints for the zone and the heating circuit; the template covers heating only. - Installer parameters (heat curve, maximum flow temperature) — Left out on purpose — installer settings of the controller are not changed from TapHome. - Weekly time programme — Reading and editing the weekly schedule of the zone and the hot water is not part of the template. - Further heat pump values — Air intake temperature, compressor utilisation and current heat output of the outdoor unit. - Further zones — The template covers zone 1 only. ## Fonti - micro-ebusd HTTP JSON API (get, set, list, from=0/1/2, token) [token.ebusd.eu](https://token.ebusd.eu/api) 2026-11-04 - ebusd message definitions — Vaillant sensoCOMFORT VRC 720 (15.ctlv2.csv) [ebus.github.io](https://ebus.github.io/en/vaillant/15.ctlv2.csv) 2026-11-04 - ebusd message definitions — Vaillant aroTHERM plus outdoor unit (08.hmu.csv) [ebus.github.io](https://ebus.github.io/en/vaillant/08.hmu.csv) 2026-11-04 - ebusd configuration — Vaillant index [ebus.github.io](https://ebus.github.io/en/vaillant/) 2026-11-04 - micro-ebusd MQTT documentation [token.ebusd.eu](https://token.ebusd.eu/mqtt) 2026-11-04 ## Documentazione correlata - [Integrazione Packet Parser](https://taphome.com/it/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/it/docs/integration/packet-parser/) - [Funzioni Packet parser](https://taphome.com/it/docs/script/packet-parser/) - [Funzioni di parsing](https://taphome.com/it/docs/script/parsing-functions/)