--- title: "eBUS Adapter Shield C6 Stick" description: "eBUS Adapter Shield C6 Stick di john30 collegato a TapHome via MQTT. Monitora lo stato dell'adattatore — segnale eBUS, daemon ebusd, temperatura e uptime." url: "https://taphome.com/it/compatibility/ebus-adapter-shield-c6-stick/" language: it lastmod: 2026-11-13 generator: hugo ai: topics: ["mqtt","gateway","ebus","heating-system","adapter-monitoring"] questions: ["Come integrare l'eBUS Adapter Shield C6 Stick con TapHome?","Cosa monitora il template eBUS Adapter Shield C6 Stick in TapHome?","Come collegare l'eBUS Adapter a TapHome tramite MQTT?","Come risolvere la perdita del segnale eBUS in TapHome?","TapHome può leggere i dati del sistema di riscaldamento tramite l'eBUS Adapter?"] --- # eBUS Adapter Shield C6 Stick Comunicazione: Packet Parser → MQTT - [Pagina prodotto eBUS Adapter Shield C6 Stick](https://adapter.ebusd.eu/v5-c6/stick.en.html) - [Documentazione MQTT micro-ebusd](https://token.ebusd.eu/mqtt) > Indirizzo di rete > > Con il broker MQTT integrato in TapHome, inserisci `127.0.0.1` come indirizzo del broker in TapHome. Nel dispositivo inserisci l’indirizzo IP del TapHome Core e assegna al Core una prenotazione IP nel router. > > [Preparazione della rete](https://taphome.com/it/docs/setup/network-preparation/) ## Guida all'integrazione L'eBUS Adapter Shield C6 Stick è un bridge compatto in formato chiavetta USB (42×16 mm) che collega i sistemi bus di riscaldamento eBUS alle reti IP. Basato sull'ESP32-C6, esegue il firmware integrato micro-ebusd che decodifica il protocollo eBUS e pubblica i dati tramite MQTT. Il template TapHome monitora l'adattatore stesso — qualità del segnale, connessione del daemon, temperatura interna e uptime — non i dati del sistema di riscaldamento che lo attraversano. L'adattatore supporta WiFi (antenna integrata), USB-C ed Ethernet opzionale (modulo USR-ES1 W5500). Il consumo è inferiore a 120 mA a 5 V e non preleva corrente dalla linea eBUS (Class 0, isolamento galvanico completo). ## Configurazione ### Prefisso MQTT Il template TapHome utilizza un prefisso topic fisso `stick-c6/`. L'adattatore pubblica i dati di stato su questo prefisso quando micro-ebusd è in esecuzione con MQTT abilitato. Se il vostro adattatore usa un prefisso MQTT diverso, aggiornate le stringhe topic negli script listener di TapHome. ### Configurazione del template Dopo l'importazione del template in TapHome: 1. Aprite il modulo **eBUS Adapter Shield C6 Stick** 2. Impostate l'**IP del broker MQTT** e la **Porta** (predefinita `1883`) 3. Verificate che il prefisso topic negli script listener corrisponda alla configurazione MQTT del vostro adattatore Il modulo si iscrive ai quattro topic `stick-c6/` e li mappa sui dispositivi di monitoraggio in TapHome. ### Configurazione dell'adattatore Prima che il template TapHome possa ricevere dati, l'adattatore deve essere configurato: 1. **Flash del firmware** — utilizzate il web flasher su [adapter.ebusd.eu](https://adapter.ebusd.eu/v5-c6/firmware.en.html) 2. **Connessione WiFi** — al primo avvio l'adattatore crea un AP con SSID "EBUS" (senza password); collegatevi e configurate su `http://192.168.4.1` 3. **Attivazione micro-ebusd** — ottenete un token tramite la scheda Configuration dell'adattatore, poi selezionate l'opzione protocollo micro-ebusd 4. **Configurazione MQTT** — impostate host e porta del broker MQTT nelle impostazioni dell'adattatore 5. **Connessione eBUS** — collegate il cavo eBUS a 2 fili al morsetto estraibile da 3,5 mm (indipendente dalla polarità) > [!TIP] > L'adattatore supporta la modalità WPS push-button per la configurazione WiFi. Premete il pulsante una volta quando il LED rosso è acceso fisso per connettervi automaticamente. ## Funzionalità dei dispositivi ### eBUS Signal Il dispositivo eBUS Signal è un Reed Contact che segnala se l'adattatore rileva un segnale eBUS valido sul bus: - `"true"` → **OK** (segnale presente) - `"false"` → **Alarm** (segnale perso) Questo è l'indicatore primario della connettività fisica eBUS. Un segnale perso significa che l'adattatore non sta ricevendo dati dal sistema di riscaldamento. ### ebusd Daemon Il dispositivo ebusd Daemon è un Reed Contact che monitora se il daemon micro-ebusd (o un'istanza ebusd esterna) è in esecuzione e connesso: - `"true"` → **OK** (daemon connesso) - `"false"` → **Alarm** (daemon disconnesso) Se viene visualizzato un allarme mentre il segnale eBUS è OK, il problema è nel software ebusd, non nella connessione fisica. ### Sensore di temperatura Il sensore di temperatura integrato misura la temperatura del chip ESP32-C6. Si tratta della temperatura interna dell'adattatore, non di una lettura della temperatura del sistema di riscaldamento. Può essere utilizzato per monitorare il surriscaldamento dell'adattatore in installazioni chiuse. Il valore viene pubblicato come stringa numerica su `stick-c6/temp` e convertito in double nello script listener di TapHome. ### Uptime (h) Il dispositivo Uptime tiene traccia di quanto tempo l'adattatore è in funzione dall'ultimo riavvio. I dati MQTT grezzi sono in secondi; lo script listener di TapHome li converte in ore per una lettura più semplice. Un reset improvviso dell'uptime a zero indica un riavvio dell'adattatore — utile per diagnosticare problemi di connettività intermittenti. ### Funzionalità aggiuntive L'adattatore pubblica ulteriori topic MQTT non coperti da questo template: - **Segnalazione errori** (`{prefix}/error`) — payload JSON con fonte e descrizione dell'errore - **Stato scansione** (`{prefix}/scan`) — riporta "OK", "running" o "finished" durante la scansione dei dispositivi eBUS - **Dati del sistema di riscaldamento** (`{prefix}/circuit/name`) — i valori eBUS decodificati effettivi (temperature, pressioni, modalità operative) dall'impianto di riscaldamento collegato. L'integrazione di questi dati in TapHome richiederebbe template separati personalizzati per il modello specifico del sistema di riscaldamento. ## Risoluzione dei problemi ### Nessun dato in TapHome 1. Verificate che l'adattatore sia connesso al WiFi — controllate il LED RGB e il LED verde eBUS per verificare l'attività 2. Confermate che micro-ebusd sia attivato e MQTT abilitato nella pagina di configurazione dell'adattatore 3. Controllate l'indirizzo e la porta del broker MQTT: con il broker integrato in TapHome, nelle impostazioni dell'adattatore c'è l'indirizzo IP del TapHome Core e nel modulo TapHome `127.0.0.1`; la porta è la stessa da entrambe le parti 4. Utilizzate un client MQTT (es. MQTT Explorer) per iscrivervi a `stick-c6/#` e verificate che l'adattatore pubblichi messaggi ### Allarme eBUS Signal 1. Controllate il collegamento fisico del cavo eBUS al morsetto da 3,5 mm dell'adattatore e al sistema di riscaldamento 2. Controllate il LED verde eBUS — se è spento, non viene rilevata tensione eBUS; se lampeggia, l'adattatore sta ricevendo dati 3. Assicuratevi che la linea eBUS non sia sovraccarica — l'adattatore è Class 0 (consumo nullo), ma altri dispositivi eBUS possono superare la capacità del bus ### Allarme ebusd Daemon con segnale OK 1. Se utilizzate micro-ebusd, verificate che il token sia valido e l'opzione protocollo sia selezionata correttamente 2. Se utilizzate un ebusd esterno, verificate che il device string utilizzi il prefisso enhanced mode `ens:` (es. `ens:192.168.0.50:9999`) 3. Controllate i log di ebusd per errori di connessione > [!NOTE] > Questo template monitora solo lo stato dell'adattatore eBUS. Per leggere i dati effettivi del sistema di riscaldamento (temperature, modalità operative, pressioni), è necessario ebusd configurato con le definizioni CSV dei messaggi appropriate per il vostro sistema di riscaldamento e template TapHome aggiuntivi per iscriversi a quei topic. Per la Vaillant aroTHERM plus con sensoCOMFORT VRC 720 esiste un [template della community](https://taphome.com/it/compatibility/vaillant-ebus-micro-ebusd-http/) che legge i dati del riscaldamento tramite l'API HTTP di micro-ebusd su questo adattatore. ## Dispositivi disponibili 4 Questi dispositivi compaiono in TapHome dopo l'importazione. eBUS Adapter Shield C6 Stick Modulo Variabili personalizzate Listener ```taphome # TOPIC := RECEIVEDMSG.TOPIC; # PAYLOAD := TOSTRING(RECEIVEDMSG.PAYLOAD); ``` Segnale eBUS Contatto reed Solo lettura Stato segnale eBUS — riporta OK quando l'adattatore rileva un segnale eBUS valido, allarme quando il segnale viene perso boolean string Listener ```taphome IF RECEIVEDMSG.TOPIC = "stick-c6/signal" Rc := IF(TOSTRING(RECEIVEDMSG.PAYLOAD) = "true", 1, 0); END ``` Daemon ebusd Contatto reed Solo lettura Stato connessione daemon ebusd — riporta OK quando il daemon è connesso, allarme quando disconnesso boolean string Listener ```taphome IF RECEIVEDMSG.TOPIC = "stick-c6/connected" Rc := IF(TOSTRING(RECEIVEDMSG.PAYLOAD) = "true", 1, 0); END ``` Sensore di temperatura Sensore di temperatura Solo lettura Temperatura del chip ESP32-C6 — monitora la temperatura interna dell'adattatore per il rilevamento di surriscaldamento in installazioni chiuse numeric Unità: °C Listener ```taphome IF RECEIVEDMSG.TOPIC = "stick-c6/temp" Te := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)); END ``` Uptime (h) Variabile Solo lettura Tempo di attività dell'adattatore in ore dall'ultimo riavvio — un reset improvviso a zero indica un riavvio dell'adattatore numeric Unità: h Listener ```taphome IF RECEIVEDMSG.TOPIC = "stick-c6/uptime" Va := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)) / 60 / 60; END ``` **Connessione:** Packet Parser → MQTT Possibili miglioramenti (3) - Error Reporting — JSON payload with source and error fields. Could surface adapter/bus errors in TapHome. - Scan Status — Reports 'OK', 'running', or 'finished'. Could track eBUS scan progress. - Heating System Data — Actual heating system readings (temperatures, modes, pressures). Requires separate templates per heating system model. ## Fonti - eBUS Adapter Shield C6 Stick Edition — Product Page [adapter.ebusd.eu](https://adapter.ebusd.eu/v5-c6/stick.en.html) 2026-03-15 - eBUS Adapter Shield C6 — Setup Guide [adapter.ebusd.eu](https://adapter.ebusd.eu/v5-c6/steps.en.html) 2026-03-15 - micro-ebusd MQTT Topic Documentation [token.ebusd.eu](https://token.ebusd.eu/mqtt) 2026-03-15 - ebusd MQTT Integration Wiki [github.com](https://github.com/john30/ebusd/wiki/MQTT-integration) 2026-03-15 ## Documentazione correlata - [MQTT Integration](https://taphome.com/it/compatibility/mqtt-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/) - [Broker MQTT](https://taphome.com/it/docs/integration/packet-parser/mqtt-broker/) - [Script listener](https://taphome.com/it/docs/script/listener-scripts/)