eBUS Adapter Shield C6 Stick kompaktni je pristupnik u obliku USB sticka (42 × 16 mm) koji sabirničke sustave grijanja eBUS povezuje s IP mrežama. Temelji se na čipu ESP32-C6 i pokreće ugrađeni firmver micro-ebusd, koji dekodira protokol eBUS i objavljuje podatke preko MQTT-a. Predložak TapHome prati sam adapter (kvalitetu signala, povezanost daemona, temperaturu na pločici i vrijeme rada), a ne podatke sustava grijanja koji kroz njega prolaze.

Adapter podržava Wi-Fi (antena na pločici), USB-C i opcionalno Ethernet (modul USR-ES1 W5500). Troši manje od 120 mA pri 5 V, a iz linije eBUS ne uzima nikakvu snagu (Class 0, potpuna galvanska izolacija).

Konfiguracija#

Prefiks MQTT

Predložak TapHome koristi fiksni prefiks teme stick-c6/. Adapter na taj prefiks objavljuje podatke o stanju kada micro-ebusd radi s uključenim MQTT-om. Ako vaš adapter koristi drugi prefiks MQTT, prilagodite nazive tema u skriptama za primanje (listener) u sustavu TapHome.

Postavljanje predloška

Nakon uvoza predloška u TapHome:

1. Otvorite modul eBUS Adapter Shield C6 Stick
2. Postavite MQTT Broker IP i Port (zadano 1883)
3. Provjerite odgovara li prefiks teme u skriptama za primanje konfiguraciji MQTT vašeg adaptera

Modul se pretplaćuje na četiri teme stick-c6/ i povezuje ih s uređajima za praćenje u sustavu TapHome.

Postavljanje adaptera

Prije nego što predložak TapHome može primati podatke, adapter treba konfigurirati:

1. Učitajte firmver — koristite web alat za učitavanje firmvera na adapter.ebusd.eu
2. Spojite se na Wi-Fi — pri prvom pokretanju adapter stvara pristupnu točku sa SSID-om „EBUS” (bez lozinke); spojite se na nju i konfigurirajte adapter na http://192.168.4.1
3. Uključite micro-ebusd — na kartici Configuration adaptera nabavite token, a zatim odaberite protokol micro-ebusd
4. Konfigurirajte MQTT — u postavkama adaptera postavite adresu i port MQTT brokera
5. Spojite eBUS — dvožilni kabel eBUS spojite na utičnu stezaljku od 3,5 mm (polaritet nije bitan)

Adapter za postavljanje Wi-Fi mreže podržava način WPS tipke. Pritisnite tipku jednom kada crvena LED dioda stalno svijetli i adapter će se automatski povezati.

Mogućnosti uređaja#

eBUS signal

Uređaj eBUS signal je reed kontakt (Reed Contact) koji javlja otkriva li adapter valjan signal eBUS na sabirnici:

• "true" → OK (signal postoji)
• "false" → Alarm (signal je izgubljen)

To je glavni pokazatelj fizičke povezanosti sa sabirnicom eBUS. Izgubljen signal znači da adapter ne prima podatke iz sustava grijanja.

ebusd daemon

Uređaj ebusd daemon je reed kontakt (Reed Contact) koji prati radi li daemon micro-ebusd (ili vanjska instanca ebusd) i je li povezan:

• "true" → OK (daemon je povezan)
• "false" → Alarm (daemon je odspojen)

Ako ovaj uređaj javlja alarm, a signal eBUS je OK, problem je u softveru ebusd, a ne u fizičkoj vezi.

Senzor temperature

Senzor temperature na pločici očitava temperaturu čipa ESP32-C6. To je unutarnja temperatura adaptera, a ne očitanje temperature sustava grijanja. Može se koristiti za praćenje pregrijavanja adaptera pri ugradnji u zatvorena kućišta.

Vrijednost se objavljuje kao numerički niz znakova na stick-c6/temp i u skripti za primanje u sustavu TapHome pretvara se u broj s pomičnim zarezom (double).

Vrijeme rada (h)

Uređaj Vrijeme rada prati koliko dugo adapter radi od posljednjeg ponovnog pokretanja. Sirova vrijednost u MQTT poruci izražena je u sekundama, a skripta za primanje u sustavu TapHome pretvara je u sate radi lakšeg čitanja.

Nagli pad vremena rada na nulu znači da se adapter ponovno pokrenuo, što je korisno za dijagnostiku povremenih problema s povezivanjem.

Dodatne mogućnosti

Adapter objavljuje i dodatne MQTT teme koje ovaj predložak ne obuhvaća:

• Javljanje pogrešaka ({prefix}/error) — JSON poruka s izvorom i opisom pogreške
• Stanje pretraživanja ({prefix}/scan) — javlja „OK”, „running” ili „finished” tijekom pretraživanja uređaja eBUS
• Podaci sustava grijanja ({prefix}/circuit/name) — stvarna dekodirana očitanja eBUS (temperature, tlakovi, načini rada) iz spojenih uređaja za grijanje. Za integraciju tih podataka u TapHome bili bi potrebni zasebni predlošci prilagođeni određenom modelu sustava grijanja.

Rješavanje problema#

Nema podataka u sustavu TapHome

1. Provjerite je li adapter spojen na Wi-Fi — provjerite aktivnost RGB LED diode i zelene LED diode eBUS
2. Provjerite je li micro-ebusd aktiviran i MQTT uključen na stranici za konfiguraciju adaptera
3. Provjerite podudaraju li se adresa i port MQTT brokera u postavkama adaptera i u konfiguraciji modula TapHome
4. MQTT klijentom (npr. MQTT Explorer) pretplatite se na stick-c6/# i provjerite objavljuje li adapter poruke

Alarm uređaja eBUS signal

1. Provjerite fizički spoj kabela eBUS na stezaljki od 3,5 mm na adapteru i na sustavu grijanja
2. Provjerite zelenu LED diodu eBUS — ako ne svijetli, napon eBUS nije otkriven; ako treperi, adapter prima podatke
3. Provjerite da linija eBUS nije preopterećena — adapter je Class 0 (ne troši snagu), ali drugi uređaji eBUS mogu premašiti kapacitet sabirnice

Alarm uređaja ebusd daemon uz signal OK

1. Ako koristite micro-ebusd, provjerite je li token valjan i je li ispravno odabran protokol
2. Ako koristite vanjski ebusd, provjerite koristi li oznaka uređaja (device string) prefiks proširenog načina ens: (npr. ens:192.168.0.50:9999)
3. U zapisima ebusd-a potražite pogreške povezivanja

Ovaj predložak prati samo stanje samog adaptera eBUS. Za čitanje stvarnih podataka sustava grijanja (temperature, načini rada, tlakovi) potreban je ebusd konfiguriran s odgovarajućim CSV definicijama poruka za vaš sustav grijanja te dodatni predlošci TapHome koji se pretplaćuju na te teme.