eBUS Adapter Shield C6 Stick je kompaktný mostík vo forme USB kľúča (42×16 mm), ktorý prepája zbernicové systémy vykurovania eBUS s IP sieťami. Postavený na ESP32-C6, beží na integrovanom firmvéri micro-ebusd, ktorý dekóduje protokol eBUS a publikuje dáta cez MQTT. Šablóna TapHome monitoruje samotný adaptér — kvalitu signálu, pripojenie démona, internú teplotu a uptime — nie dáta z vykurovacieho systému, ktoré cez neho prechádzajú.

Adaptér podporuje WiFi (vstavaná anténa), USB-C a voliteľný Ethernet (modul USR-ES1 W5500). Odber je menej ako 120 mA pri 5 V a z linky eBUS neodoberá žiadny prúd (Class 0, plná galvanická izolácia).

Konfigurácia

MQTT prefix

Šablóna TapHome používa pevný prefix topicu stick-c6/. Adaptér publikuje zdravotné dáta na tento prefix, keď beží micro-ebusd s povoleným MQTT. Ak váš adaptér používa iný MQTT prefix, aktualizujte reťazce topicov v listener skriptoch TapHome.

Nastavenie šablóny

Po importovaní šablóny v TapHome:

1. Otvorte modul eBUS Adapter Shield C6 Stick
2. Nastavte IP adresu MQTT brokera a Port (predvolený 1883)
3. Overte, že prefix topicu v listener skriptoch zodpovedá MQTT konfigurácii vášho adaptéra

Modul sa prihlási na štyri topicy stick-c6/ a mapuje ich na monitorovacie zariadenia v TapHome.

Nastavenie adaptéra

Pred tým, ako šablóna TapHome začne prijímať dáta, musí byť adaptér nakonfigurovaný:

1. Nahratie firmvéru — použite webový flasher na adapter.ebusd.eu
2. Pripojenie k WiFi — pri prvom spustení adaptér vytvorí AP s SSID „EBUS" (bez hesla); pripojte sa a nakonfigurujte na http://192.168.4.1
3. Aktivácia micro-ebusd — získajte token cez záložku Configuration adaptéra, potom vyberte možnosť protokolu micro-ebusd
4. Konfigurácia MQTT — nastavte adresu a port MQTT brokera v nastaveniach adaptéra
5. Pripojenie eBUS — pripojte 2-vodičový kábel eBUS do 3,5mm konektora (nezáleží na polarite)

Adaptér podporuje režim WPS push-button pre nastavenie WiFi. Stlačte tlačidlo raz, keď červená LED svieti neprerušovane, a pripojenie prebehne automaticky.

Funkcie zariadení

eBUS Signal

Zariadenie eBUS Signal je Reed Contact, ktorý hlási, či adaptér deteguje platný signál eBUS na zbernici:

• "true" → OK (signál prítomný)
• "false" → Alarm (signál stratený)

Toto je hlavný indikátor fyzického pripojenia eBUS. Strata signálu znamená, že adaptér neprijíma dáta z vykurovacieho systému.

ebusd Daemon

Zariadenie ebusd Daemon je Reed Contact, ktorý monitoruje, či démon micro-ebusd (alebo externá inštancia ebusd) beží a je pripojený:

• "true" → OK (démon pripojený)
• "false" → Alarm (démon odpojený)

Ak sa zobrazuje alarm, zatiaľ čo eBUS signál je OK, problém je v softvéri ebusd, nie vo fyzickom pripojení.

Teplotný senzor

Vstavaný teplotný senzor meria teplotu čipu ESP32-C6. Ide o internú teplotu adaptéra, nie o meranie teploty vykurovacieho systému. Môže slúžiť na monitorovanie prehrievania adaptéra v uzavretých inštaláciách.

Hodnota sa publikuje ako číselný reťazec na stick-c6/temp a v listener skripte TapHome sa konvertuje na typ double.

Uptime (h)

Zariadenie Uptime sleduje, ako dlho adaptér beží od posledného reštartu. Surové MQTT dáta sú v sekundách; listener skript TapHome ich konvertuje na hodiny pre lepšiu čitateľnosť.

Náhly reset uptime na nulu indikuje reštart adaptéra — užitočné pri diagnostike občasných problémov s konektivitou.

Ďalšie funkcie

Adaptér publikuje ďalšie MQTT topicy, ktoré táto šablóna nepokrýva:

• Hlásenie chýb ({prefix}/error) — JSON payload so zdrojom a popisom chyby
• Stav skenovania ({prefix}/scan) — hlási „OK", „running" alebo „finished" počas skenovania zariadení eBUS
• Dáta vykurovacieho systému ({prefix}/circuit/name) — skutočné dekódované hodnoty eBUS (teploty, tlaky, prevádzkové režimy) z pripojeného vykurovacieho zariadenia. Integrácia týchto dát do TapHome by vyžadovala samostatné šablóny prispôsobené konkrétnemu modelu vykurovacieho systému.

Riešenie problémov

Žiadne dáta v TapHome

1. Overte, že adaptér je pripojený k WiFi — skontrolujte RGB LED a zelenú eBUS LED, či vykazujú aktivitu
2. Potvrďte, že micro-ebusd je aktivovaný a MQTT povolený v konfiguračnej stránke adaptéra
3. Skontrolujte, či sa adresa a port MQTT brokera zhodujú medzi nastaveniami adaptéra a konfiguráciou modulu TapHome
4. Použite MQTT klienta (napr. MQTT Explorer) na prihlásenie k stick-c6/# a overte, že adaptér publikuje správy

Alarm eBUS Signal

1. Skontrolujte fyzické pripojenie kábla eBUS na 3,5mm konektore adaptéra aj na vykurovacom systéme
2. Skontrolujte zelenú eBUS LED — ak nesvieti, nie je detegované napätie eBUS; ak bliká, adaptér prijíma dáta
3. Uistite sa, že linka eBUS nie je preťažená — adaptér je Class 0 (nulový odber), ale iné zariadenia eBUS môžu prekročiť kapacitu zbernice

Alarm ebusd Daemon pri OK signáli

1. Ak používate micro-ebusd, skontrolujte, či je token platný a možnosť protokolu je správne vybraná
2. Ak používate externý ebusd, overte, že device string používa prefix rozšíreného režimu ens: (napr. ens:192.168.0.50:9999)
3. Skontrolujte logy ebusd pre chyby pripojenia

Táto šablóna monitoruje len zdravie eBUS adaptéra. Na čítanie skutočných dát z vykurovacieho systému (teploty, prevádzkové režimy, tlaky) potrebujete ebusd nakonfigurovaný s príslušnými CSV definíciami správ pre váš vykurovací systém a ďalšie šablóny TapHome na prihlásenie k týmto topicom.