TapHome
Community Beta Integrazione HVAC

Vaillant aroTHERM plus + sensoCOMFORT VRC 720 (eBUS, micro-ebusd)

Template della community per la pompa di calore Vaillant aroTHERM plus con il regolatore sensoCOMFORT VRC 720 tramite l'adattatore eBUS Adapter Shield o Stick C6 con micro-ebusd. TapHome legge temperature, pressione dell'acqua, potenza ed energia della pompa di calore tramite l'API HTTP locale dell'adattatore e imposta il setpoint ambiente e dell'acqua calda, le modalità di funzionamento e una carica singola dell'acqua calda.

VaillantPacket Parser → HTTP13 dispositiviRevisione 1.3 Ultimo aggiornamento: 16 novembre 2026

Inviato da Martin Keller

Vaillant aroTHERM plus + sensoCOMFORT VRC 720 (eBUS, micro-ebusd)

Importa nell'app TapHomeHardware › Packet Parser › Aggiungi da modello

Scarica template
In questa pagina

Richiede gateway esterno

eBUS Adapter (ebusd.eu) eBUS Adapter Shield or Stick C6 with micro-ebusd (HTTP JSON API, port 80) — pagina prodotto

Indirizzo di rete

TapHome raggiunge il dispositivo all'indirizzo inserito durante l'importazione. Assegna al dispositivo un indirizzo fisso — una prenotazione IP nel router, oppure il suo nome mDNS se lo supporta —, altrimenti l'integrazione smette di funzionare quando il router cambia l'indirizzo.

Preparazione della rete

Guida all'integrazione

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

  1. Aggiorna l’adattatore al firmware più recente (adapter.ebusd.eu).
  2. 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.
  3. 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

ParametroValore predefinitoDescrizione
ADAPTER_IP(vuoto)Indirizzo IP dell’adattatore eBUS
CONTROLLER_CIRCUITctlv2Nome del circuito del regolatore da /api/v1/ebus/list, ad esempio ctlv2 per il VRC 720 o 700 per il VRC 700
HEAT_SOURCE_CIRCUIThmuNome 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, manual con il firmware micro-ebusd da aprile 2026, off, auto, day, night con 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 servizioDescrizione
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 operativoStato 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 QuickVetoHours non si applica. Il setpoint della zona 1 e la temperatura esterna provengono dai messaggi precedenti Z1ActualRoomTempDesired e DisplayedOutsideTemp.

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.

Dispositivi disponibili 13

Questi dispositivi compaiono in TapHome dopo l'importazione.

sensoCOMFORT VRC 720 (ctlv2) Modulo

Controller (sensoCOMFORT VRC 720 / multiMATIC VRC 700)

Lettura (modulo)
# CurrentError in the ebusd definitions micro-ebusd uses since firmware 2026-04-22, Currenterror in older firmware
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/CurrentError/get?from=1");
VAR found := false;
IF response.IsSuccess
  found := !ISNULL(PARSEJSON(response.Content, "data.fields.error", true));
END
IF !found
  response :=SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Currenterror/get?from=1");
END
IF response.IsSuccess
  VAR e0 := PARSEJSON(response.Content, "data.fields.error", true);
  VAR e1 := PARSEJSON(response.Content, "data.fields.error_1", true);
  VAR e2 := PARSEJSON(response.Content, "data.fields.error_2", true);
  VAR e3 := PARSEJSON(response.Content, "data.fields.error_3", true);
  VAR e4 := PARSEJSON(response.Content, "data.fields.error_4", true);
  IF !ISNULL(e0)
    IF e0 != 0
      ADDERROR(0, "Controller error code: " + e0);
    END
  END
  IF !ISNULL(e1)
    IF e1 != 0
      ADDERROR(1, "Controller error_1 code: " + e1);
    END
  END
  IF !ISNULL(e2)
    IF e2 != 0
      ADDERROR(2, "Controller error_2 code: " + e2);
    END
  END
  IF !ISNULL(e3)
    IF e3 != 0
      ADDERROR(3, "Controller error_3 code: " + e3);
    END
  END
  IF !ISNULL(e4)
    IF e4 != 0
      ADDERROR(4, "Controller error_4 code: " + e4);
    END
  END
END
Temperatura esterna Sensore di temperatura Solo lettura

Temperatura esterna come la mostra il regolatore VRC 720

numeric Unità: °C

Temperatura esterna

Lettura temperatura
# OutsideTemp in the ebusd definitions micro-ebusd uses since firmware 2026-04-22, DisplayedOutsideTemp in older firmware
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/OutsideTemp/get?from=1");
IF response.IsSuccess
  VAR v := PARSEJSON(response.Content, "data.fields.value", true);
  IF !ISNULL(v)
    RETURN(v);
  END
END
response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/DisplayedOutsideTemp/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Termostato zona 1 Termostato Lettura e scrittura

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
Variabile: QuickVetoHours

Termostato zona 1

Lettura temperatura
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1RoomTemp/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Lettura temperatura desiderata
# Z1TempDesired in the ebusd definitions micro-ebusd uses since firmware 2026-04-22, Z1ActualRoomTempDesired in older firmware
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1TempDesired/get?from=1");
IF response.IsSuccess
  VAR v := PARSEJSON(response.Content, "data.fields.value", true);
  IF !ISNULL(v)
    RETURN(v);
  END
END
response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1ActualRoomTempDesired/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Scrittura temperatura desiderata
# Quick veto: the VRC 720 starts it only when the duration is written after the temperature.
# QuickVetoHours (0.5 to 12 h in steps of 0.5) sets how long the setpoint holds; then the time programme takes over again.
VAR hours := MAX(0.5, MIN(12, ROUND(QuickVetoHours * 2) / 2));
VAR body := "{\"fields\":{\"value\":" + Se + "}}";
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1QuickVetoTemp/set", "PUT", body, "Content-Type: application/json");
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1QuickVetoDuration/set", "PUT", "{\"fields\":{\"value\":" + hours + "}}", "Content-Type: application/json");
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1QuickVetoTemp/get?from=2");
Modalità di funzionamento zona 1 Interruttore multivalore Lettura e scrittura

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

Modalità di funzionamento zona 1

Lettura stato interruttore
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1OpMode/get?from=1");
IF response.IsSuccess
  # micro-ebusd returns the name of the value from the ebusd definition (off, auto, day, night or off, auto, manual); a number is accepted too
  VAR v := TOSTRING(PARSEJSON(response.Content, "data.fields.value", true));
  IF v = "off" OR v = "0"
    RETURN(0);
  END
  IF v = "auto" OR v = "1"
    RETURN(1);
  END
  IF v = "day" OR v = "manual" OR v = "2"
    RETURN(2);
  END
  IF v = "night" OR v = "3"
    RETURN(3);
  END
END
RETURN(NaN);
Scrittura stato interruttore
# Names from the ebusd definition the adapter answers with: off, auto, day, night in micro-ebusd firmware before
# 2026-04-22, off, auto, manual (no night) since then. The value list comes with every answer (fields[].values).
VAR def := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1OpMode/get?from=1");
VAR older := false;
IF def.IsSuccess
  older := INDEXOF(def.Content, "\"night\"") >= 0 OR INDEXOF(def.Content, "\"day\"") >= 0;
END
VAR name := SWITCH(Mu, 0, "off", 1, "auto", 2, IF(older, "day", "manual"), 3, IF(older, "night", ""), "");
IF name != ""
  SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1OpMode/set", "PUT", "{\"fields\":{\"value\":\"" + name + "\"}}", "Content-Type: application/json");
  # Read back from the bus: a write the controller ignored shows the real mode at the next read
  SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1OpMode/get?from=2");
END
Termostato acqua calda sanitaria Termostato Lettura e scrittura

Temperatura del bollitore e setpoint dell'acqua calda, regolabile da 35 a 75 °C

numeric Unità: °C

Termostato acqua calda sanitaria

Lettura temperatura
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcStorageTemp/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Lettura temperatura desiderata
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcTempDesired/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Scrittura temperatura desiderata
VAR body := "{\"fields\":{\"value\":" + Se + "}}";
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcTempDesired/set", "PUT", body, "Content-Type: application/json");
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcTempDesired/get?from=2");
Modalità acqua calda sanitaria Interruttore multivalore Lettura e scrittura

Modalità di funzionamento del circuito dell'acqua calda — Spento, Auto, Giorno o Notte

enum numeric
Valori / Stati: Spento · Auto · Giorno · Notte

Modalità acqua calda sanitaria

Lettura stato interruttore
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcOpMode/get?from=1");
IF response.IsSuccess
  # micro-ebusd returns the name of the value from the ebusd definition (off, auto, day, night or off, auto, manual); a number is accepted too
  VAR v := TOSTRING(PARSEJSON(response.Content, "data.fields.value", true));
  IF v = "off" OR v = "0"
    RETURN(0);
  END
  IF v = "auto" OR v = "1"
    RETURN(1);
  END
  IF v = "day" OR v = "manual" OR v = "2"
    RETURN(2);
  END
  IF v = "night" OR v = "3"
    RETURN(3);
  END
END
RETURN(NaN);
Scrittura stato interruttore
# Names from the ebusd definition the adapter answers with: off, auto, day, night in micro-ebusd firmware before
# 2026-04-22, off, auto, manual (no night) since then. The value list comes with every answer (fields[].values).
VAR def := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcOpMode/get?from=1");
VAR older := false;
IF def.IsSuccess
  older := INDEXOF(def.Content, "\"night\"") >= 0 OR INDEXOF(def.Content, "\"day\"") >= 0;
END
VAR name := SWITCH(Mu, 0, "off", 1, "auto", 2, IF(older, "day", "manual"), 3, IF(older, "night", ""), "");
IF name != ""
  SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcOpMode/set", "PUT", "{\"fields\":{\"value\":\"" + name + "\"}}", "Content-Type: application/json");
  # Read back from the bus: a write the controller ignored shows the real mode at the next read
  SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcOpMode/get?from=2");
END
Carica singola acqua calda Interruttore Lettura e scrittura

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

Carica singola acqua calda

Lettura stato interruttore
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcSFMode/get?from=1");
IF response.IsSuccess
  VAR v := TOSTRING(PARSEJSON(response.Content, "data.fields.value", true));
  IF v = "load" OR v = "6"
    RETURN(1);
  END
  RETURN(0);
END
RETURN(NaN);
Scrittura stato interruttore
# load = one-time hot water charge; the controller returns to auto by itself when the tank is charged
VAR name := IF(St, "load", "auto");
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcSFMode/set", "PUT", "{\"fields\":{\"value\":\"" + name + "\"}}", "Content-Type: application/json");
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcSFMode/get?from=2");
Temperatura di mandata Sensore di temperatura Solo lettura

Temperatura di mandata dell'impianto (mandata del riscaldamento) indicata dal regolatore VRC 720

numeric Unità: °C

Temperatura di mandata

Lettura temperatura
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/SystemFlowTemp/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Pressione dell'acqua Variabile Solo lettura

Pressione dell'acqua dell'impianto di riscaldamento in bar

numeric Unità: bar

Pressione dell'acqua

Lettura
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/WaterPressure/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Contatore elettrico della pompa di calore Variabile Solo lettura

Potenza elettrica (kW) e consumo totale di elettricità (kWh) della aroTHERM plus; coefficiente di prestazione, resa termica e stato della pompa di calore come attributi di servizio

numeric Unità: kW / kWh

Contatore elettrico della pompa di calore

Lettura
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Hc1HeatCurve/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Scrittura
# Heating curve of heating circuit 1 (VRC 720: 0.1 to 4.0). The controller keeps its own limits; the read-back shows
# the value it accepted.
VAR v := ROUND(MAX(0.1, MIN(4, Va)) * 100) / 100;
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Hc1HeatCurve/set", "PUT", "{\"fields\":{\"value\":" + v + "}}", "Content-Type: application/json");
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Hc1HeatCurve/get?from=2");
Hot Water Charge Hysteresis Variabile

Hot Water Charge Hysteresis

Lettura
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/CylinderChargeHyst/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Scrittura
# Hysteresis of the hot water cylinder charge in K. The controller rejects a value outside its range; the read-back
# shows the value it kept.
VAR v := Va;
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/CylinderChargeHyst/set", "PUT", "{\"fields\":{\"value\":" + v + "}}", "Content-Type: application/json");
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/CylinderChargeHyst/get?from=2");
Cooling Minimum Flow Temperature Variabile

Cooling Minimum Flow Temperature

Lettura
# Hc1CoolingFlowTempMin in the ebusd definitions micro-ebusd uses since firmware 2026-04-22, Hc1MinCoolingTempDesired in
# older firmware. The newer definitions offer it only when cooling is enabled for heating circuit 1.
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Hc1CoolingFlowTempMin/get?from=1");
IF response.IsSuccess
  VAR v := PARSEJSON(response.Content, "data.fields.value", true);
  IF !ISNULL(v)
    RETURN(v);
  END
END
response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Hc1MinCoolingTempDesired/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Scrittura
# Lowest flow water temperature in cooling (VRC 720: 7 to 24 °C); the dew point monitoring of the controller can raise it.
VAR probe := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Hc1CoolingFlowTempMin/get?from=1");
VAR name := IF(probe.IsSuccess, "Hc1CoolingFlowTempMin", "Hc1MinCoolingTempDesired");
VAR v := MAX(7, MIN(24, Va));
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/" + name + "/set", "PUT", "{\"fields\":{\"value\":" + v + "}}", "Content-Type: application/json");
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/" + name + "/get?from=2");
Heating Minimum Flow Temperature Variabile

Heating Minimum Flow Temperature

Lettura
# Hc1HeatingFlowTempMin in the VRC 720 definitions micro-ebusd uses since firmware 2026-04-22, Hc1MinFlowTempDesired in
# older firmware and on the VRC 700.
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Hc1HeatingFlowTempMin/get?from=1");
IF response.IsSuccess
  VAR v := PARSEJSON(response.Content, "data.fields.value", true);
  IF !ISNULL(v)
    RETURN(v);
  END
END
response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Hc1MinFlowTempDesired/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Scrittura
# Lowest flow water temperature in heating. The controller heats to the higher of its heating curve and this value, so with
# a low heating curve the value written here is the flow water temperature (for example from the Equithermic regulation smart
# rule); the maximum flow temperature of the controller still caps it. The controller keeps the value in its permanent memory:
# the value is rounded to a whole degree and written only when it changes.
VAR probe := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Hc1HeatingFlowTempMin/get?from=1");
VAR name := IF(probe.IsSuccess, "Hc1HeatingFlowTempMin", "Hc1MinFlowTempDesired");
VAR v := MAX(15, MIN(80, ROUND(Va)));
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/" + name + "/set", "PUT", "{\"fields\":{\"value\":" + v + "}}", "Content-Type: application/json");
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/" + name + "/get?from=2");
Zone 1 Cooling Mode Interruttore multivalore
Valori / Stati: Off · Auto · Manual

Zone 1 Cooling Mode

Lettura stato interruttore
# Z1CoolingOpMode in the VRC 720 definitions micro-ebusd uses since firmware 2026-04-22, only when cooling is enabled for
# heating circuit 1; Z1OpModeCooling (off, auto, day, night) on the VRC 700. Older VRC 720 firmware has neither: no value.
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1CoolingOpMode/get?from=1");
IF !response.IsSuccess
  response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1OpModeCooling/get?from=1");
END
IF response.IsSuccess
  VAR v := TOSTRING(PARSEJSON(response.Content, "data.fields.value", true));
  IF v = "off" OR v = "0"
    RETURN(0);
  END
  IF v = "auto" OR v = "1"
    RETURN(1);
  END
  IF v = "manual" OR v = "day" OR v = "2"
    RETURN(2);
  END
END
RETURN(NaN);
Scrittura stato interruttore
# VRC 720: Z1CoolingOpMode off, auto, manual. VRC 700: Z1OpModeCooling off, auto, day (Manual = day).
VAR probe := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1CoolingOpMode/get?from=1");
VAR msg := IF(probe.IsSuccess, "Z1CoolingOpMode", "Z1OpModeCooling");
VAR name := SWITCH(Mu, 0, "off", 1, "auto", 2, IF(probe.IsSuccess, "manual", "day"), "");
IF name != ""
  SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/" + msg + "/set", "PUT", "{\"fields\":{\"value\":\"" + name + "\"}}", "Content-Type: application/json");
  # Read back from the bus: a write the controller ignored shows the real mode at the next read
  SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/" + msg + "/get?from=2");
END
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.

Parametri di importazione

Inserisci questi valori quando importi l'XML.

Richiesto nell'appPredefinito
eBUS Adapter IP AddressDa inserire all'importazione
Controller circuit name (e.g. ctlv2 for VRC 720, 700 for VRC 700)ctlv2
Heat source circuit name (e.g. hmu for aroTHERM plus)hmu

Fonti

  • micro-ebusd HTTP JSON API (get, set, list, from=0/1/2, token)
    token.ebusd.eu 2026-11-04
  • ebusd message definitions — Vaillant sensoCOMFORT VRC 720 (15.ctlv2.csv)
    ebus.github.io 2026-11-04
  • ebusd message definitions — Vaillant aroTHERM plus outdoor unit (08.hmu.csv)
    ebus.github.io 2026-11-04
  • ebusd configuration — Vaillant index
    ebus.github.io 2026-11-04
  • micro-ebusd MQTT documentation
    token.ebusd.eu 2026-11-04
  • aroTHERM plus and VRC 720 with ebusd — community integration (R91g/arotherm-genia-ebusd)
    github.com 2026-11-04

Hai trovato un problema con questo template?

Dicci cosa non funziona, cosa manca o come dovrebbe comportarsi il template. Il tuo feedback ci aiuta a mantenere il catalogo accurato.

Modello · portale TapHome Vaillant aroTHERM plus + sensoCOMFORT VRC 720 (eBUS, micro-ebusd) Apri questo template nel Customer Portal per applicarlo a una delle tue case, o crea una proposta di modifica e inviala al catalogo. Packet Parser → HTTP Vedi nel portale TapHome