TapHome
Oficial · TapHome

eBUS Adapter Shield C6 Stick

eBUS Adapter Shield C6 Stick de la john30, conectat la TapHome prin MQTT. Monitorizează starea adaptorului — semnalul eBUS, starea daemonului ebusd, temperatura de pe placă și timpul de funcționare.

eBUS AdapterPacket Parser → MQTT4 dispozitiveRevizia 1.1 Ultima actualizare: 17 noiembrie 2026
Funcționează pe Core TapHome Next 2026.1.41766
iAm importat acest șablon în acest Core în laboratorul TapHome și toate dispozitivele sale au fost adăugate fără eroare.
eBUS Adapter Shield C6 Stick

Import în aplicația TapHomeHardware › Packet Parser › Adăugați din șablon

Descărcați șablon
Pe această pagină

Adresa în rețea

Pentru brokerul MQTT integrat în TapHome este vorba de un singur broker, accesat din două locuri. Șablonul rulează direct în TapHome Core, de aceea în TapHome adresa brokerului este 127.0.0.1 (acest calculator). Dispozitivul rulează în altă parte a rețelei, de aceea în dispozitiv introduceți adresa IP a unității TapHome Core și atribuiți unității Core o rezervare IP în router — dacă adresa Core se schimbă, dispozitivul nu mai ajunge la broker.

Pregătirea rețelei

Ghid de integrare

eBUS Adapter Shield C6 Stick este un bridge compact în format de stick USB (42x16 mm), care conectează sistemele de încălzire cu magistrală eBUS la rețelele IP. Este construit pe ESP32-C6 și rulează firmware-ul integrat micro-ebusd, care decodifică protocolul eBUS și publică datele prin MQTT. Șablonul TapHome monitorizează chiar stickul adaptor — calitatea semnalului, conectivitatea daemonului, temperatura de pe placă și timpul de funcționare — nu datele sistemului de încălzire care trec prin el.

Adaptorul acceptă Wi-Fi (antenă pe placă), USB-C și, opțional, Ethernet (modulul USR-ES1 W5500). Consumă mai puțin de 120 mA la 5 V și nu preia deloc energie de pe linia eBUS (clasa 0, izolație galvanică completă).

Configurare

Prefixul MQTT

Șablonul TapHome folosește prefixul fix de topic stick-c6/. Adaptorul publică datele de stare cu acest prefix când micro-ebusd rulează cu MQTT activat. Dacă adaptorul dvs. folosește un alt prefix MQTT, actualizați corespunzător topicurile din scripturile listener TapHome.

Configurarea șablonului

După importul șablonului în TapHome:

  1. Deschideți modulul eBUS Adapter Shield C6 Stick
  2. Setați MQTT Broker IP și Port (implicit 1883) — pentru brokerul integrat în TapHome 127.0.0.1 (șablonul rulează în Core)
  3. Verificați dacă prefixul de topic din scripturile listener corespunde configurației MQTT a adaptorului

Modulul se abonează la cele patru topicuri stick-c6/ și le asociază cu dispozitivele de monitorizare din TapHome.

Configurarea adaptorului

Înainte ca șablonul TapHome să poată primi date, adaptorul trebuie configurat:

  1. Încărcați firmware-ul — folosiți instrumentul web de încărcare de pe adapter.ebusd.eu
  2. Conectați-l la Wi-Fi — la prima pornire, adaptorul creează un punct de acces cu SSID-ul „EBUS” (fără parolă); conectați-vă și configurați-l la http://192.168.4.1
  3. Activați micro-ebusd — obțineți un token din fila Configuration a adaptorului, apoi selectați opțiunea de protocol micro-ebusd
  4. Configurați MQTT — setați adresa și portul brokerului MQTT în setările adaptorului — pentru brokerul integrat în TapHome, adresa IP a TapHome Core; atribuiți unității Core o rezervare IP în router
  5. Conectați eBUS — conectați cablul eBUS cu 2 fire la borna detașabilă de 3,5 mm (polaritatea nu contează)

Adaptorul acceptă modul WPS cu buton pentru configurarea Wi-Fi. Apăsați butonul o dată când LED-ul roșu luminează continuu, pentru conectarea automată.

Funcțiile dispozitivului

Semnal eBUS

Dispozitivul Semnal eBUS este un contact reed care raportează dacă adaptorul detectează un semnal eBUS valid pe magistrală:

  • "true" → OK (semnal prezent)
  • "false" → Alarmă (semnal pierdut)

Acesta este principalul indicator al conectivității fizice eBUS. Un semnal pierdut înseamnă că adaptorul nu primește date de la sistemul de încălzire.

Daemon ebusd

Dispozitivul Daemon ebusd este un contact reed care monitorizează dacă daemonul micro-ebusd (sau o instanță ebusd externă) rulează și este conectat:

  • "true" → OK (daemon conectat)
  • "false" → Alarmă (daemon deconectat)

Dacă dispozitivul Daemon ebusd arată Alarmă în timp ce semnalul eBUS este OK, problema ține de software-ul ebusd, nu de conexiunea fizică.

Senzor de temperatură

Senzorul de temperatură de pe placă citește temperatura cipului ESP32-C6. Aceasta este temperatura internă a adaptorului, nu o temperatură a sistemului de încălzire. Se poate folosi pentru monitorizarea supraîncălzirii adaptorului montat în carcase închise.

Valoarea este publicată ca șir numeric pe stick-c6/temp și convertită în double în scriptul listener TapHome.

Timp de funcționare (h)

Dispozitivul Timp de funcționare urmărește cât timp a funcționat adaptorul de la ultima repornire. Payloadul MQTT brut este în secunde; scriptul listener TapHome îl convertește în ore, pentru o citire mai ușoară.

O revenire bruscă a timpului de funcționare la zero indică faptul că adaptorul a repornit — util pentru diagnosticarea problemelor intermitente de conectivitate.

Funcții suplimentare

Adaptorul publică și alte topicuri MQTT, pe care acest șablon nu le acoperă:

  • Raportarea erorilor ({prefix}/error) — payload JSON cu sursa și descrierea erorii
  • Starea scanării ({prefix}/scan) — raportează „OK”, „running” sau „finished” în timpul scanării dispozitivelor eBUS
  • Datele sistemului de încălzire ({prefix}/circuit/name) — valorile eBUS decodificate efectiv (temperaturi, presiuni, moduri de funcționare) de la echipamentele de încălzire conectate. Integrarea acestor date în TapHome ar necesita șabloane separate, adaptate modelului concret al sistemului de încălzire.

Rezolvarea problemelor

Nu există date în TapHome

  1. Verificați dacă adaptorul este conectat la Wi-Fi — urmăriți activitatea LED-ului RGB și a LED-ului verde eBUS
  2. Verificați dacă micro-ebusd este activat și MQTT este activat în pagina de configurare a adaptorului
  3. Verificați adresa și portul brokerului MQTT: cu brokerul integrat în TapHome, setările adaptorului au adresa IP a TapHome Core, iar modulul TapHome are 127.0.0.1; portul este același pe ambele părți
  4. Folosiți un client MQTT (de exemplu, MQTT Explorer) pentru abonarea la stick-c6/# și verificați dacă adaptorul publică mesaje

Alarmă la Semnal eBUS

  1. Verificați conexiunea fizică a cablului eBUS atât la borna de 3,5 mm a adaptorului, cât și la sistemul de încălzire
  2. Verificați LED-ul verde eBUS — dacă este stins, nu se detectează tensiune eBUS; dacă clipește, adaptorul primește date
  3. Asigurați-vă că linia eBUS nu este supraîncărcată — adaptorul este de clasa 0 (consum zero), dar alte dispozitive eBUS pot depăși capacitatea magistralei

Alarmă la Daemon ebusd cu semnal OK

  1. Dacă folosiți micro-ebusd, verificați dacă tokenul este valid și opțiunea de protocol este selectată corect
  2. Dacă folosiți ebusd extern, verificați dacă șirul de conectare al dispozitivului folosește prefixul pentru modul enhanced ens: (de exemplu, ens:192.168.0.50:9999)
  3. Verificați jurnalele ebusd pentru erori de conexiune

Acest șablon monitorizează numai starea stickului adaptor eBUS. Pentru citirea datelor reale ale sistemului de încălzire (temperaturi, moduri de funcționare, presiuni) aveți nevoie de ebusd configurat cu definițiile de mesaje CSV potrivite pentru sistemul dvs. de încălzire și de șabloane TapHome suplimentare care să se aboneze la aceste topicuri. Pentru Vaillant aroTHERM plus cu sensoCOMFORT VRC 720 există un șablon al comunității care citește datele de încălzire prin API-ul HTTP al micro-ebusd de pe acest adaptor.

Dispozitive disponibile 4

Aceste dispozitive apar în TapHome după import.

eBUS Adapter Shield C6 Stick Modul
Variabile personalizate

eBUS Adapter Shield C6 Stick

Ascultător
# TOPIC := RECEIVEDMSG.TOPIC;
                    # PAYLOAD := TOSTRING(RECEIVEDMSG.PAYLOAD);
Semnal eBUS Contact reed Doar citire

Starea semnalului eBUS — raportează OK când adaptorul detectează un semnal eBUS valid și alarmă când semnalul se pierde

boolean string

Semnal eBUS

Ascultător
IF RECEIVEDMSG.TOPIC = "stick-c6/signal"
                            Rc := IF(TOSTRING(RECEIVEDMSG.PAYLOAD) = "true", 1, 0);
                            END
Daemon ebusd Contact reed Doar citire

Starea conexiunii daemonului ebusd — raportează OK când daemonul este conectat și alarmă când este deconectat

boolean string

Daemon ebusd

Ascultător
IF RECEIVEDMSG.TOPIC = "stick-c6/connected"
                            Rc := IF(TOSTRING(RECEIVEDMSG.PAYLOAD) = "true", 1, 0);
                            END
Senzor de temperatură Senzor de temperatură Doar citire

Temperatura cipului ESP32-C6 de pe placă — monitorizează temperatura internă a adaptorului pentru detectarea supraîncălzirii la montarea în carcase închise

numeric Unitate: °C

Senzor de temperatură

Ascultător
IF RECEIVEDMSG.TOPIC = "stick-c6/temp"
                            Te := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD));
                            END
Timp de funcționare (h) Variabilă Doar citire

Timpul de funcționare al adaptorului în ore de la ultima repornire — o revenire bruscă la zero indică faptul că adaptorul a repornit

numeric Unitate: h

Timp de funcționare (h)

Ascultător
IF RECEIVEDMSG.TOPIC = "stick-c6/uptime"
                            Va := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)) / 60 / 60;
                            END
Conexiune: Packet Parser → MQTT
Îmbunătățiri posibile (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.

Surse

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Șablon · portalul TapHome eBUS Adapter Shield C6 Stick Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog. Packet Parser → MQTT Vezi în portalul TapHome