eBUS Adapter Shield C6 Stick je kompaktní můstek ve formě USB klíče (42×16 mm), který propojuje sběrnicové systémy vytápění eBUS s IP sítěmi. Postavený na ESP32-C6, běží na integrovaném firmwaru micro-ebusd, který dekóduje protokol eBUS a publikuje data přes MQTT. Šablona TapHome monitoruje samotný adaptér — kvalitu signálu, připojení démona, interní teplotu a uptime — nikoliv data z vytápěcího systému, která jím procházejí.

Adaptér podporuje WiFi (vestavěná anténa), USB-C a volitelný Ethernet (modul USR-ES1 W5500). Odběr je méně než 120 mA při 5 V a z linky eBUS neodebírá žádný proud (Class 0, plná galvanická izolace).

Konfigurace#

MQTT prefix

Šablona TapHome používá pevný prefix topicu stick-c6/. Adaptér publikuje zdravotní data na tento prefix, když běží micro-ebusd s povoleným MQTT. Pokud váš adaptér používá jiný MQTT prefix, aktualizujte řetězce topiců v listener skriptech TapHome.

Nastavení šablony

Po importování šablony v TapHome:

1. Otevřete modul eBUS Adapter Shield C6 Stick
2. Nastavte IP adresu MQTT brokeru a Port (výchozí 1883)
3. Ověřte, že prefix topicu v listener skriptech odpovídá MQTT konfiguraci vašeho adaptéru

Modul se přihlásí ke čtyřem topicům stick-c6/ a mapuje je na monitorovací zařízení v TapHome.

Nastavení adaptéru

Než šablona TapHome začne přijímat data, musí být adaptér nakonfigurován:

1. Nahrání firmwaru — použijte webový flasher na adapter.ebusd.eu
2. Připojení k WiFi — při prvním spuštění adaptér vytvoří AP s SSID „EBUS" (bez hesla); připojte se a nakonfigurujte na http://192.168.4.1
3. Aktivace micro-ebusd — získejte token přes záložku Configuration adaptéru, poté vyberte možnost protokolu micro-ebusd
4. Konfigurace MQTT — nastavte adresu a port MQTT brokeru v nastavení adaptéru
5. Připojení eBUS — připojte 2vodičový kabel eBUS do 3,5mm konektoru (nezáleží na polaritě)

Adaptér podporuje režim WPS push-button pro nastavení WiFi. Stiskněte tlačítko jednou, když červená LED svítí nepřerušovaně, a připojení proběhne automaticky.

Funkce zařízení#

eBUS Signal

Zařízení eBUS Signal je Reed Contact, který hlásí, zda adaptér detekuje platný signál eBUS na sběrnici:

• "true" → OK (signál přítomen)
• "false" → Alarm (signál ztracen)

Toto je hlavní indikátor fyzického připojení eBUS. Ztráta signálu znamená, že adaptér nepřijímá data z vytápěcího systému.

ebusd Daemon

Zařízení ebusd Daemon je Reed Contact, který monitoruje, zda démon micro-ebusd (nebo externí instance ebusd) běží a je připojen:

• "true" → OK (démon připojen)
• "false" → Alarm (démon odpojen)

Pokud se zobrazuje alarm, zatímco eBUS signál je OK, problém je v softwaru ebusd, nikoliv ve fyzickém připojení.

Teplotní senzor

Vestavěný teplotní senzor měří teplotu čipu ESP32-C6. Jedná se o interní teplotu adaptéru, nikoliv o měření teploty vytápěcího systému. Může sloužit k monitorování přehřívání adaptéru v uzavřených instalacích.

Hodnota se publikuje jako číselný řetězec na stick-c6/temp a v listener skriptu TapHome se konvertuje na typ double.

Uptime (h)

Zařízení Uptime sleduje, jak dlouho adaptér běží od posledního restartu. Surová MQTT data jsou v sekundách; listener skript TapHome je konvertuje na hodiny pro lepší čitelnost.

Náhlý reset uptime na nulu indikuje restart adaptéru — užitečné při diagnostice občasných problémů s konektivitou.

Další funkce

Adaptér publikuje další MQTT topicy, které tato šablona nepokrývá:

• Hlášení chyb ({prefix}/error) — JSON payload se zdrojem a popisem chyby
• Stav skenování ({prefix}/scan) — hlásí „OK", „running" nebo „finished" během skenování zařízení eBUS
• Data vytápěcího systému ({prefix}/circuit/name) — skutečné dekódované hodnoty eBUS (teploty, tlaky, provozní režimy) z připojeného vytápěcího zařízení. Integrace těchto dat do TapHome by vyžadovala samostatné šablony přizpůsobené konkrétnímu modelu vytápěcího systému.

Řešení problémů#

Žádná data v TapHome

1. Ověřte, že adaptér je připojen k WiFi — zkontrolujte RGB LED a zelenou eBUS LED, zda vykazují aktivitu
2. Potvrďte, že micro-ebusd je aktivován a MQTT povolen na konfigurační stránce adaptéru
3. Zkontrolujte, zda se adresa a port MQTT brokeru shodují mezi nastavením adaptéru a konfigurací modulu TapHome
4. Použijte MQTT klienta (např. MQTT Explorer) k přihlášení k stick-c6/# a ověřte, že adaptér publikuje zprávy

Alarm eBUS Signal

1. Zkontrolujte fyzické připojení kabelu eBUS na 3,5mm konektoru adaptéru i na vytápěcím systému
2. Zkontrolujte zelenou eBUS LED — pokud nesvítí, není detekováno napětí eBUS; pokud bliká, adaptér přijímá data
3. Ujistěte se, že linka eBUS není přetížená — adaptér je Class 0 (nulový odběr), ale jiná zařízení eBUS mohou překročit kapacitu sběrnice

Alarm ebusd Daemon při OK signálu

1. Pokud používáte micro-ebusd, zkontrolujte, zda je token platný a možnost protokolu je správně vybrána
2. Pokud používáte externí ebusd, ověřte, že device string používá prefix rozšířeného režimu ens: (např. ens:192.168.0.50:9999)
3. Zkontrolujte logy ebusd pro chyby připojení

Tato šablona monitoruje pouze zdraví eBUS adaptéru. Pro čtení skutečných dat z vytápěcího systému (teploty, provozní režimy, tlaky) potřebujete ebusd nakonfigurovaný s příslušnými CSV definicemi zpráv pro váš vytápěcí systém a další šablony TapHome pro přihlášení k těmto topicům.