--- title: "eBUS Adapter Shield C6 Stick" description: "eBUS Adapter Shield C6 Stick od john30 podłączony do TapHome przez MQTT. Monitoruje stan adaptera — sygnał eBUS, demon ebusd, temperaturę chipu i uptime." url: "https://taphome.com/pl/compatibility/ebus-adapter-shield-c6-stick/" language: pl lastmod: 2026-11-04 generator: hugo ai: topics: ["mqtt","gateway","ebus","heating-system","adapter-monitoring"] questions: ["Jak zintegrować eBUS Adapter Shield C6 Stick z TapHome?","Co monitoruje szablon eBUS Adapter Shield C6 Stick w TapHome?","Jak podłączyć eBUS Adapter do TapHome przez MQTT?","Jak rozwiązać problem utraty sygnału eBUS w TapHome?","Czy TapHome może odczytywać dane systemu grzewczego przez eBUS Adapter?"] --- # eBUS Adapter Shield C6 Stick Komunikacja: Packet Parser → MQTT - [Strona produktowa eBUS Adapter Shield C6 Stick](https://adapter.ebusd.eu/v5-c6/stick.en.html) - [Dokumentacja MQTT micro-ebusd](https://token.ebusd.eu/mqtt) 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](https://adapter.ebusd.eu/v5-c6/firmware.en.html) 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) > [!TIP] > 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 > [!NOTE] > 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. Dla Vaillant aroTHERM plus z sensoCOMFORT VRC 720 istnieje [szablon społeczności](https://taphome.com/pl/compatibility/vaillant-ebus-micro-ebusd-http/), który odczytuje dane ogrzewania przez HTTP API micro-ebusd na tym adapterze. ## Dostępne urządzenia eBUS Adapter Shield C6 Stick Moduł Zmienne niestandardowe Sygnał eBUS Kontakt reed Tylko do odczytu Stan sygnału eBUS — raportuje OK gdy adapter wykrywa prawidłowy sygnał eBUS, alarm gdy sygnał zostanie utracony boolean string Demon ebusd Kontakt reed Tylko do odczytu Stan połączenia demona ebusd — raportuje OK gdy demon jest połączony, alarm gdy rozłączony boolean string Czujnik temperatury Czujnik temperatury Tylko do odczytu Temperatura chipu ESP32-C6 — monitoruje wewnętrzną temperaturę adaptera w celu wykrycia przegrzania w zamkniętych instalacjach numeric Jednostka: °C Uptime (h) Zmienna Tylko do odczytu Czas pracy adaptera w godzinach od ostatniego restartu — nagły reset do zera wskazuje na restart adaptera numeric Jednostka: h **Połączenie:** Packet Parser → MQTT Możliwe ulepszenia (3) - Error Reporting — JSON payload with source and error fields. Could surface adapter/bus errors in TapHome. - Scan Status — Reports 'OK', 'running', or 'finished'. Could track eBUS scan progress. - Heating System Data — Actual heating system readings (temperatures, modes, pressures). Requires separate templates per heating system model. ## Źródła - eBUS Adapter Shield C6 Stick Edition — Product Page [adapter.ebusd.eu](https://adapter.ebusd.eu/v5-c6/stick.en.html) 2026-03-15 - eBUS Adapter Shield C6 — Setup Guide [adapter.ebusd.eu](https://adapter.ebusd.eu/v5-c6/steps.en.html) 2026-03-15 - micro-ebusd MQTT Topic Documentation [token.ebusd.eu](https://token.ebusd.eu/mqtt) 2026-03-15 - ebusd MQTT Integration Wiki [github.com](https://github.com/john30/ebusd/wiki/MQTT-integration) 2026-03-15 ## Powiązana dokumentacja - [MQTT Integration](https://taphome.com/pl/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/pl/docs/integration/packet-parser/) - [Funkcje Packet parser](https://taphome.com/pl/docs/script/packet-parser/) - [Funkcje parsowania](https://taphome.com/pl/docs/script/parsing-functions/) - [Broker MQTT](https://taphome.com/pl/docs/integration/packet-parser/mqtt-broker/) - [Skrypty listener](https://taphome.com/pl/docs/script/listener-scripts/)