eBUS Adapter Shield C6 Stick to kompaktowy mostek w formacie pendrive USB (42×16 mm), który łączy systemy magistrali grzewczej eBUS z sieciami IP. Zbudowany na ESP32-C6, uruchamia zintegrowane oprogramowanie micro-ebusd, które dekoduje protokół eBUS i publikuje dane przez MQTT. Szablon TapHome monitoruje sam adapter — jakość sygnału, połączenie demona, wewnętrzną temperaturę i czas pracy — a nie dane systemu grzewczego przepływające przez niego.

Adapter obsługuje WiFi (wbudowana antena), USB-C i opcjonalny Ethernet (moduł USR-ES1 W5500). Pobór prądu wynosi mniej niż 120 mA przy 5 V i nie pobiera energii z linii eBUS (Class 0, pełna izolacja galwaniczna).

Konfiguracja

Prefiks MQTT

Szablon TapHome używa stałego prefiksu topicu stick-c6/. Adapter publikuje dane o stanie na ten prefiks, gdy micro-ebusd działa z włączonym MQTT. Jeśli adapter używa innego prefiksu MQTT, zaktualizuj ciągi topiców w skryptach listener TapHome.

Konfiguracja szablonu

Po zaimportowaniu szablonu w TapHome:

1. Otwórz moduł eBUS Adapter Shield C6 Stick
2. Ustaw IP brokera MQTT i Port (domyślny 1883)
3. Sprawdź, czy prefiks topicu w skryptach listener odpowiada konfiguracji MQTT adaptera

Moduł subskrybuje cztery topici stick-c6/ i mapuje je na urządzenia monitorujące w TapHome.

Konfiguracja adaptera

Zanim szablon TapHome będzie mógł odbierać dane, adapter musi zostać skonfigurowany:

1. Wgranie firmware — użyj web flashera na adapter.ebusd.eu
2. Połączenie z WiFi — przy pierwszym uruchomieniu adapter tworzy AP z SSID „EBUS" (bez hasła); połącz się i skonfiguruj pod adresem http://192.168.4.1
3. Aktywacja micro-ebusd — uzyskaj token przez zakładkę Configuration adaptera, następnie wybierz opcję protokołu micro-ebusd
4. Konfiguracja MQTT — ustaw adres i port brokera MQTT w ustawieniach adaptera
5. Podłączenie eBUS — podłącz 2-żyłowy kabel eBUS do złącza zaciskowego 3,5 mm (niezależnie od polaryzacji)

Adapter obsługuje tryb WPS push-button do konfiguracji WiFi. Naciśnij przycisk raz, gdy czerwona dioda LED świeci ciągle, aby połączyć się automatycznie.

Funkcje urządzeń

eBUS Signal

Urządzenie eBUS Signal to Reed Contact, który raportuje, czy adapter wykrywa prawidłowy sygnał eBUS na magistrali:

• "true" → OK (sygnał obecny)
• "false" → Alarm (sygnał utracony)

To główny wskaźnik fizycznej łączności eBUS. Utracony sygnał oznacza, że adapter nie odbiera danych z systemu grzewczego.

ebusd Daemon

Urządzenie ebusd Daemon to Reed Contact, który monitoruje, czy demon micro-ebusd (lub zewnętrzna instancja ebusd) działa i jest połączony:

• "true" → OK (demon połączony)
• "false" → Alarm (demon rozłączony)

Jeśli wyświetla się alarm, podczas gdy sygnał eBUS jest OK, problem dotyczy oprogramowania ebusd, a nie połączenia fizycznego.

Czujnik temperatury

Wbudowany czujnik temperatury mierzy temperaturę chipu ESP32-C6. Jest to wewnętrzna temperatura adaptera, nie odczyt temperatury systemu grzewczego. Może służyć do monitorowania przegrzewania adaptera w zamkniętych instalacjach.

Wartość jest publikowana jako ciąg numeryczny na stick-c6/temp i konwertowana na typ double w skrypcie listener TapHome.

Czas pracy (h)

Urządzenie Uptime śledzi, jak długo adapter działa od ostatniego restartu. Surowe dane MQTT są w sekundach; skrypt listener TapHome konwertuje je na godziny dla łatwiejszego odczytu.

Nagły reset czasu pracy do zera wskazuje restart adaptera — przydatne przy diagnozowaniu sporadycznych problemów z łącznością.

Dodatkowe funkcje

Adapter publikuje dodatkowe topici MQTT, które nie są objęte tym szablonem:

• Raportowanie błędów ({prefix}/error) — payload JSON ze źródłem i opisem błędu
• Status skanowania ({prefix}/scan) — raportuje „OK", „running" lub „finished" podczas skanowania urządzeń eBUS
• Dane systemu grzewczego ({prefix}/circuit/name) — rzeczywiste zdekodowane wartości eBUS (temperatury, ciśnienia, tryby pracy) z podłączonego urządzenia grzewczego. Integracja tych danych z TapHome wymagałaby osobnych szablonów dostosowanych do konkretnego modelu systemu grzewczego.

Rozwiązywanie problemów

Brak danych w TapHome

1. Sprawdź, czy adapter jest połączony z WiFi — sprawdź diodę RGB LED i zieloną diodę eBUS LED pod kątem aktywności
2. Potwierdź, że micro-ebusd jest aktywowany i MQTT włączony na stronie konfiguracji adaptera
3. Sprawdź, czy adres i port brokera MQTT zgadzają się między ustawieniami adaptera a konfiguracją modułu TapHome
4. Użyj klienta MQTT (np. MQTT Explorer), aby zasubskrybować stick-c6/# i sprawdź, czy adapter publikuje wiadomości

Alarm eBUS Signal

1. Sprawdź fizyczne połączenie kabla eBUS na złączu 3,5 mm adaptera i na systemie grzewczym
2. Sprawdź zieloną diodę eBUS LED — jeśli nie świeci, nie wykryto napięcia eBUS; jeśli miga, adapter odbiera dane
3. Upewnij się, że linia eBUS nie jest przeciążona — adapter jest Class 0 (zerowy pobór), ale inne urządzenia eBUS mogą przekraczać pojemność magistrali

Alarm ebusd Daemon przy OK sygnale

1. Jeśli używasz micro-ebusd, sprawdź, czy token jest ważny i opcja protokołu jest prawidłowo wybrana
2. Jeśli używasz zewnętrznego ebusd, sprawdź, czy device string używa prefiksu enhanced mode ens: (np. ens:192.168.0.50:9999)
3. Sprawdź logi ebusd pod kątem błędów połączenia

Ten szablon monitoruje wyłącznie stan adaptera eBUS. Aby odczytywać rzeczywiste dane systemu grzewczego (temperatury, tryby pracy, ciśnienia), potrzebujesz ebusd skonfigurowanego z odpowiednimi definicjami wiadomości CSV dla Twojego systemu grzewczego oraz dodatkowych szablonów TapHome do subskrypcji tych topiców.