Az eBUS Adapter Shield C6 Stick egy kompakt, USB-pendrive formájú híd (42×16 mm), amely az eBUS fűtési buszrendszereket IP-hálózatokhoz csatlakoztatja. Az ESP32-C6-ra épülve az integrált micro-ebusd firmware-t futtatja, amely dekódolja az eBUS protokollt és MQTT-n keresztül publikálja az adatokat. A TapHome sablon magát az adaptert figyeli — jelminőség, daemon-kapcsolat, belső hőmérséklet és üzemidő — nem a rajta áthaladó fűtési rendszer adatait.

Az adapter támogatja a WiFi-t (beépített antenna), USB-C-t és az opcionális Ethernetet (USR-ES1 W5500 modul). Fogyasztása kevesebb mint 120 mA 5 V-on, és az eBUS vonalról nem vesz fel áramot (Class 0, teljes galvanikus leválasztás).

Konfiguráció

MQTT prefix

A TapHome sablon fix topic prefixet használ: stick-c6/. Az adapter erre a prefixre publikálja az állapotadatokat, amikor a micro-ebusd MQTT-vel engedélyezve fut. Ha az adapter más MQTT prefixet használ, frissítse a topic sztringeket a TapHome listener szkriptekben.

Sablon beállítása

A sablon TapHome-ba történő importálása után:

1. Nyissa meg az eBUS Adapter Shield C6 Stick modult
2. Állítsa be az MQTT Broker IP-címet és a Portot (alapértelmezett 1883)
3. Ellenőrizze, hogy a listener szkriptekben lévő topic prefix megegyezik az adapter MQTT konfigurációjával

A modul feliratkozik a négy stick-c6/ topicra, és azokat TapHome monitorozó eszközökre képezi le.

Adapter beállítása

Mielőtt a TapHome sablon adatokat tudna fogadni, az adaptert konfigurálni kell:

1. Firmware feltöltése — használja a web flashert az adapter.ebusd.eu oldalon
2. WiFi csatlakozás — az első indításkor az adapter egy „EBUS" SSID-vel (jelszó nélkül) hoz létre AP-t; csatlakozzon és konfigurálja a http://192.168.4.1 címen
3. micro-ebusd aktiválása — szerezzen tokent az adapter Configuration lapján, majd válassza a micro-ebusd protokoll opciót
4. MQTT konfigurálása — állítsa be az MQTT broker címét és portját az adapter beállításaiban
5. eBUS csatlakoztatása — csatlakoztassa a 2 vezetékes eBUS kábelt a 3,5 mm-es csavaros sorkapocshoz (polaritásfüggetlen)

Az adapter támogatja a WPS push-button módot a WiFi beállításhoz. Nyomja meg egyszer a gombot, amikor a piros LED folyamatosan világít, és a csatlakozás automatikusan megtörténik.

Eszközfunkciók

eBUS Signal

Az eBUS Signal eszköz egy Reed Contact, amely jelzi, hogy az adapter érvényes eBUS jelet észlel-e a buszon:

• "true" → OK (jel jelen van)
• "false" → Alarm (jel elveszett)

Ez az eBUS fizikai csatlakozás elsődleges indikátora. Az elveszett jel azt jelenti, hogy az adapter nem kap adatokat a fűtési rendszertől.

ebusd Daemon

Az ebusd Daemon eszköz egy Reed Contact, amely figyeli, hogy a micro-ebusd daemon (vagy egy külső ebusd példány) fut-e és csatlakozva van-e:

• "true" → OK (daemon csatlakozva)
• "false" → Alarm (daemon lecsatlakozva)

Ha alarm jelenik meg, miközben az eBUS jel OK, a probléma az ebusd szoftverben van, nem a fizikai csatlakozásban.

Hőmérséklet-szenzor

A beépített hőmérséklet-szenzor az ESP32-C6 chip hőmérsékletét méri. Ez az adapter belső hőmérséklete, nem a fűtési rendszer hőmérsékletének mérése. Zárt telepítések esetén az adapter túlmelegedésének figyelésére használható.

Az érték numerikus sztringként jelenik meg a stick-c6/temp topicon, és a TapHome listener szkriptben double típusra konvertálódik.

Üzemidő (h)

Az Uptime eszköz nyomon követi, hogy az adapter mennyi ideje fut az utolsó újraindítás óta. A nyers MQTT adat másodpercben van megadva; a TapHome listener szkript órákra konvertálja a könnyebb olvashatóság érdekében.

Az üzemidő hirtelen nullára történő visszaállítása az adapter újraindítását jelzi — hasznos az időszakos kapcsolódási problémák diagnosztizálásához.

További funkciók

Az adapter további MQTT topicokat publikál, amelyeket ez a sablon nem fed le:

• Hibajelentés ({prefix}/error) — JSON payload a hiba forrásával és leírásával
• Szkennelési állapot ({prefix}/scan) — „OK", „running" vagy „finished" értéket jelent az eBUS eszközök szkennelése során
• Fűtési rendszer adatai ({prefix}/circuit/name) — a tényleges dekódolt eBUS értékek (hőmérsékletek, nyomások, üzemmódok) a csatlakoztatott fűtőberendezésből. Ezen adatok TapHome-ba integrálása külön, az adott fűtési rendszer modelljéhez igazított sablonokat igényelne.

Hibaelhárítás

Nincs adat a TapHome-ban

1. Ellenőrizze, hogy az adapter csatlakozik a WiFi-hez — nézze meg az RGB LED-et és a zöld eBUS LED-et, hogy aktívak-e
2. Győződjön meg arról, hogy a micro-ebusd aktiválva van és az MQTT engedélyezve van az adapter konfigurációs oldalán
3. Ellenőrizze, hogy az MQTT broker címe és portja megegyezik az adapter beállításai és a TapHome modul konfigurációja között
4. Használjon MQTT klienst (pl. MQTT Explorer), iratkozzon fel a stick-c6/# topicra, és ellenőrizze, hogy az adapter publikál üzeneteket

eBUS Signal alarm

1. Ellenőrizze az eBUS kábel fizikai csatlakozását az adapter 3,5 mm-es csatlakozójánál és a fűtési rendszernél
2. Nézze meg a zöld eBUS LED-et — ha nem világít, nem észlelhető eBUS feszültség; ha villog, az adapter adatokat fogad
3. Győződjön meg arról, hogy az eBUS vonal nincs túlterhelve — az adapter Class 0 (nulla fogyasztás), de más eBUS eszközök túlléphetik a busz kapacitását

ebusd Daemon alarm OK jel mellett

1. Ha micro-ebusd-t használ, ellenőrizze, hogy a token érvényes-e és a protokoll opció helyesen van kiválasztva
2. Ha külső ebusd-t használ, ellenőrizze, hogy a device string az enhanced mode prefixet ens: használja-e (pl. ens:192.168.0.50:9999)
3. Ellenőrizze az ebusd logokat csatlakozási hibák szempontjából

Ez a sablon kizárólag az eBUS adapter állapotát figyeli. A fűtési rendszer tényleges adatainak (hőmérsékletek, üzemmódok, nyomások) olvasásához szükség van a fűtési rendszeréhez megfelelő CSV üzenetdefiníciókkal konfigurált ebusd-re, valamint további TapHome sablonokra az adott topicokra való feliratkozáshoz.