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:
- Aprite il modulo eBUS Adapter Shield C6 Stick
- Impostate l’IP del broker MQTT e la Porta (predefinita
1883) - 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:
- Flash del firmware — utilizzate il web flasher su adapter.ebusd.eu
- Connessione WiFi — al primo avvio l’adattatore crea un AP con SSID “EBUS” (senza password); collegatevi e configurate su
http://192.168.4.1 - Attivazione micro-ebusd — ottenete un token tramite la scheda Configuration dell’adattatore, poi selezionate l’opzione protocollo micro-ebusd
- Configurazione MQTT — impostate host e porta del broker MQTT nelle impostazioni dell’adattatore
- Connessione eBUS — collegate il cavo eBUS a 2 fili al morsetto estraibile da 3,5 mm (indipendente dalla polarità)
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
- Verificate che l’adattatore sia connesso al WiFi — controllate il LED RGB e il LED verde eBUS per verificare l’attività
- Confermate che micro-ebusd sia attivato e MQTT abilitato nella pagina di configurazione dell’adattatore
- Controllate che l’indirizzo e la porta del broker MQTT corrispondano tra le impostazioni dell’adattatore e la configurazione del modulo TapHome
- Utilizzate un client MQTT (es. MQTT Explorer) per iscrivervi a
stick-c6/#e verificate che l’adattatore pubblichi messaggi
Allarme eBUS Signal
- Controllate il collegamento fisico del cavo eBUS al morsetto da 3,5 mm dell’adattatore e al sistema di riscaldamento
- Controllate il LED verde eBUS — se è spento, non viene rilevata tensione eBUS; se lampeggia, l’adattatore sta ricevendo dati
- 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
- Se utilizzate micro-ebusd, verificate che il token sia valido e l’opzione protocollo sia selezionata correttamente
- Se utilizzate un ebusd esterno, verificate che il device string utilizzi il prefisso enhanced mode
ens:(es.ens:192.168.0.50:9999) - Controllate i log di ebusd per errori di connessione
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.
