eBUS Adapter Shield C6 Stick este un bridge compact în format de stick USB (42x16 mm), care conectează sistemele de încălzire cu magistrală eBUS la rețelele IP. Este construit pe ESP32-C6 și rulează firmware-ul integrat micro-ebusd, care decodifică protocolul eBUS și publică datele prin MQTT. Șablonul TapHome monitorizează chiar stickul adaptor — calitatea semnalului, conectivitatea daemonului, temperatura de pe placă și timpul de funcționare — nu datele sistemului de încălzire care trec prin el.

Adaptorul acceptă Wi-Fi (antenă pe placă), USB-C și, opțional, Ethernet (modulul USR-ES1 W5500). Consumă mai puțin de 120 mA la 5 V și nu preia deloc energie de pe linia eBUS (clasa 0, izolație galvanică completă).

Configurare#

Prefixul MQTT

Șablonul TapHome folosește prefixul fix de topic stick-c6/. Adaptorul publică datele de stare cu acest prefix când micro-ebusd rulează cu MQTT activat. Dacă adaptorul dvs. folosește un alt prefix MQTT, actualizați corespunzător topicurile din scripturile listener TapHome.

Configurarea șablonului

După importul șablonului în TapHome:

1. Deschideți modulul eBUS Adapter Shield C6 Stick
2. Setați MQTT Broker IP și Port (implicit 1883)
3. Verificați dacă prefixul de topic din scripturile listener corespunde configurației MQTT a adaptorului

Modulul se abonează la cele patru topicuri stick-c6/ și le asociază cu dispozitivele de monitorizare din TapHome.

Configurarea adaptorului

Înainte ca șablonul TapHome să poată primi date, adaptorul trebuie configurat:

1. Încărcați firmware-ul — folosiți instrumentul web de încărcare de pe adapter.ebusd.eu
2. Conectați-l la Wi-Fi — la prima pornire, adaptorul creează un punct de acces cu SSID-ul „EBUS” (fără parolă); conectați-vă și configurați-l la http://192.168.4.1
3. Activați micro-ebusd — obțineți un token din fila Configuration a adaptorului, apoi selectați opțiunea de protocol micro-ebusd
4. Configurați MQTT — setați adresa și portul brokerului MQTT în setările adaptorului
5. Conectați eBUS — conectați cablul eBUS cu 2 fire la borna detașabilă de 3,5 mm (polaritatea nu contează)

Adaptorul acceptă modul WPS cu buton pentru configurarea Wi-Fi. Apăsați butonul o dată când LED-ul roșu luminează continuu, pentru conectarea automată.

Funcțiile dispozitivului#

Semnal eBUS

Dispozitivul Semnal eBUS este un contact reed care raportează dacă adaptorul detectează un semnal eBUS valid pe magistrală:

• "true" → OK (semnal prezent)
• "false" → Alarmă (semnal pierdut)

Acesta este principalul indicator al conectivității fizice eBUS. Un semnal pierdut înseamnă că adaptorul nu primește date de la sistemul de încălzire.

Daemon ebusd

Dispozitivul Daemon ebusd este un contact reed care monitorizează dacă daemonul micro-ebusd (sau o instanță ebusd externă) rulează și este conectat:

• "true" → OK (daemon conectat)
• "false" → Alarmă (daemon deconectat)

Dacă dispozitivul Daemon ebusd arată Alarmă în timp ce semnalul eBUS este OK, problema ține de software-ul ebusd, nu de conexiunea fizică.

Senzor de temperatură

Senzorul de temperatură de pe placă citește temperatura cipului ESP32-C6. Aceasta este temperatura internă a adaptorului, nu o temperatură a sistemului de încălzire. Se poate folosi pentru monitorizarea supraîncălzirii adaptorului montat în carcase închise.

Valoarea este publicată ca șir numeric pe stick-c6/temp și convertită în double în scriptul listener TapHome.

Timp de funcționare (h)

Dispozitivul Timp de funcționare urmărește cât timp a funcționat adaptorul de la ultima repornire. Payloadul MQTT brut este în secunde; scriptul listener TapHome îl convertește în ore, pentru o citire mai ușoară.

O revenire bruscă a timpului de funcționare la zero indică faptul că adaptorul a repornit — util pentru diagnosticarea problemelor intermitente de conectivitate.

Funcții suplimentare

Adaptorul publică și alte topicuri MQTT, pe care acest șablon nu le acoperă:

• Raportarea erorilor ({prefix}/error) — payload JSON cu sursa și descrierea erorii
• Starea scanării ({prefix}/scan) — raportează „OK”, „running” sau „finished” în timpul scanării dispozitivelor eBUS
• Datele sistemului de încălzire ({prefix}/circuit/name) — valorile eBUS decodificate efectiv (temperaturi, presiuni, moduri de funcționare) de la echipamentele de încălzire conectate. Integrarea acestor date în TapHome ar necesita șabloane separate, adaptate modelului concret al sistemului de încălzire.

Rezolvarea problemelor#

Nu există date în TapHome

1. Verificați dacă adaptorul este conectat la Wi-Fi — urmăriți activitatea LED-ului RGB și a LED-ului verde eBUS
2. Verificați dacă micro-ebusd este activat și MQTT este activat în pagina de configurare a adaptorului
3. Verificați dacă adresa și portul brokerului MQTT coincid în setările adaptorului și în configurația modulului TapHome
4. Folosiți un client MQTT (de exemplu, MQTT Explorer) pentru abonarea la stick-c6/# și verificați dacă adaptorul publică mesaje

Alarmă la Semnal eBUS

1. Verificați conexiunea fizică a cablului eBUS atât la borna de 3,5 mm a adaptorului, cât și la sistemul de încălzire
2. Verificați LED-ul verde eBUS — dacă este stins, nu se detectează tensiune eBUS; dacă clipește, adaptorul primește date
3. Asigurați-vă că linia eBUS nu este supraîncărcată — adaptorul este de clasa 0 (consum zero), dar alte dispozitive eBUS pot depăși capacitatea magistralei

Alarmă la Daemon ebusd cu semnal OK

1. Dacă folosiți micro-ebusd, verificați dacă tokenul este valid și opțiunea de protocol este selectată corect
2. Dacă folosiți ebusd extern, verificați dacă șirul de conectare al dispozitivului folosește prefixul pentru modul enhanced ens: (de exemplu, ens:192.168.0.50:9999)
3. Verificați jurnalele ebusd pentru erori de conexiune

Acest șablon monitorizează numai starea stickului adaptor eBUS. Pentru citirea datelor reale ale sistemului de încălzire (temperaturi, moduri de funcționare, presiuni) aveți nevoie de ebusd configurat cu definițiile de mesaje CSV potrivite pentru sistemul dvs. de încălzire și de șabloane TapHome suplimentare care să se aboneze la aceste topicuri.