Zigbee kétcsatornás kapcsoló: amikor nem működik külön a két lámpa

1. Mit oldunk meg ebben az útmutatóban?

A falon két gomb van, mögöttük két külön világítási kör. Kézzel minden rendben, a Home Assistantban mégis együtt kapcsol a két lámpa, csak az egyik reagál, vagy a kapcsoló ikonja rögtön visszaugrik. Ilyenkor könnyű bekötési hibára, rossz Zigbee-jelre vagy hibás automatizálásra gondolni. A tünet azonban még nem mondja meg, melyik rétegben van az eltérés.

Ez az útmutató azt segít eldönteni, hogy a fizikai kimenetek, a szoftveres entitások, a csatornák megfeleltetése vagy az automatizálás célzása okozza-e a gondot. Egy valós, kétcsatornás kapcsolókkal szerzett tapasztalatból indulunk ki, de a megoldást nem másoljuk át ellenőrzés nélkül más eszközre.

A cél egy egyszerű, visszaellenőrizhető állítás: az A entitás csak az A lámpát, a B entitás csak a B lámpát vezérli, és mindkettő állapotát helyesen látjuk. Ehhez először adatot gyűjtünk, majd külön vizsgáljuk a parancsot, a fizikai reakciót és a visszajelzést.

2. Előkészület: legyen biztonságos a vizsgálat

Válassz olyan időpontot, amikor egy rövid világítási próba nem zavar másokat, nem veszélyezteti a közlekedést, és valaki látja a két érintett lámpát. Készíts mentést a módosítandó konfigurációról. Jegyezd fel a Home Assistant verzióját, a kapcsoló modelljét, az integráció nevét és a jelenlegi entitásokat.

A cikk szoftveres hibakeresésről szól. Hálózati feszültségű kapcsolót ne bonts meg a leírás alapján. Melegedés, égett szag, szikrázás, bizonytalan kézi működés vagy bekötési kétség esetén szakember vizsgálata szükséges. A helyesnek tűnő szoftveres állapot nem villamos biztonsági mérés.

A mostani cikk készítésekor csak konfigurációt és nyilvántartási adatokat olvastunk. Nem kapcsoltunk lámpát, nem indítottunk automatizálást, és nem változtattunk az otthoni rendszeren. Az alábbi kapcsolási próbák az olvasó számára javasolt, előre egyeztetendő ellenőrzések; nem frissen végrehajtott helyszíni tesztek.

3. Négy fogalom, amelyet érdemes különválasztani

A két gomb nem feltétlenül jelent pontosan két látható kapcsolóentitást. Lehetnek letiltott entitások, csoportok, átalakított light entitások vagy korábbi konfigurációból megmaradt vezérlők is. Ugyanannak a kimenetnek két külön kártyája még nem két külön relé.

A barátságos név csak felirat. Az „első csatorna”, „bal oldal” vagy „konyha” elnevezés nem helyettesíti a megfeleltetés ellenőrzését. A következő lépésekben ezért semleges A és B jelölést használunk, és megfigyeléssel kapcsoljuk hozzájuk a valódi lámpákat.

4. A saját esetünk: mit tudunk biztosan?

A korábbi projektben két, kétcsatornás kapcsoló négy világítási kört szolgált ki. A régi hibakeresés ZHA-környezetből indult: a két kimenet külön vezérlése és a visszaugró felületi állapot is gondot okozott. A dokumentált megoldásban külön MQTT switch-entitások adtak külön vezérlést a relékhez. A korabeli helyszíni próba igazolta az egyik lámpa kapcsolását a másik változása nélkül.

A 2026. október 18-i olvasási ellenőrzés négy világítási automatizálás célját vizsgálta. Mind a négy cél switch típusú, MQTT-platformhoz tartozó, nem letiltott entitás. A hozzájuk kapcsolt eszközbejegyzésekben TS0012 modell és azonos gyártóazonosító szerepel. A két kültéri cél közös eszközbejegyzéshez tartozik; a két beltéri cél külön bejegyzés alatt található.

Ez nyilvántartási tény, nem friss bekötési vagy rádiós mérés. A külön beltéri eszközbejegyzésekből nem következik, hogy két külön fizikai kapcsoló van ott. Az MQTT-platform pedig önmagában nem bizonyít Zigbee2MQTT-re költöztetett hálózatot: közvetítő megoldás is létrehozhat MQTT-entitásokat.

A tanulság az, hogy a történeti ZHA-tapasztalatot és a jelenlegi MQTT-felületet külön kell kezelni. Nem állítjuk, hogy ma is közvetlenül a ZHA által létrehozott entitásokat használják az automatizálások.

5. Első lépés: leltározd a tényleges vezérlőket

A Home Assistant Beállítások, Eszközök és szolgáltatások felületén keresd meg a kapcsolót, majd nézd meg a hozzá rendelt entitásokat. A menüpontok felirata nyelvtől és verziótól függhet. Az entitás részleteinél rögzítsd a teljes azonosítót, az integrációt, a tartományt és azt, hogy engedélyezett-e.

Vizsgáld meg a letiltott entitásokat is, de ne engedélyezz mindent egyszerre. Először értsd meg, melyik funkció hiányzik. Keresd meg az azonos nevű régi kapcsolókat, a csoportokat és a light megjelenítésű változatokat. Ha egy switch fényként jelenik meg, a hozzá tartozó szolgáltatás és célzás eltérhet a régi mintától.

Készíts rövid leltárt két sorral: A jelölt entitás, B jelölt entitás. Melléjük írd a jelenleg feltételezett lámpát, a platformot és az utolsó megbízható próba idejét. A „feltételezett” szó itt hasznos: megakadályozza, hogy egy régi feliratot véletlenül bizonyított bekötési rajznak tekints.

6. Fizikai alappróba és a megfeleltetési táblázat

Ha a kézi használat biztonságos, a helyszíni megfigyelő először a falon lévő két gombot próbálja ki külön. A Home Assistantban közben csak figyeld az állapotokat. Az első kérdés az, hogy a két lámpa kézzel valóban külön működik-e; a második, hogy ezt a rendszer külön jelzi-e vissza.

Ezután a felületen egyetlen jelölt entitást kapcsolj egyértelműen be, majd ki. Ne egy területet, eszközcsoportot vagy több elemet tartalmazó kártyát válassz. Minden lépés után várd meg és jegyezd fel a fizikai reakciót. Csak azután térj át a másik entitásra.

A táblázat minta, nem a saját otthonunk mostani mérési eredménye. Ha a fizikai próba is összekapcsolt működést mutat, ne próbáld azt szoftveres parancsokkal „kijavítani”. Előbb a készülék működési módját és szükség esetén a villamos kialakítást kell tisztázni.

7. A nyers állapot ellenőrzése kapcsolás nélkül

A Fejlesztői eszközök állapotlistájában nézd meg a két tényleges entitást. A switch állapota a felületi magyar címke helyett például on, off, unknown vagy unavailable lehet. A legutóbbi állapotváltozás ideje segít időrendbe tenni a történteket, de önmagában nem igazolja, hogy a lámpa világít.

Az alábbi sablon csak olvas. A két példanevet a saját, már azonosított entitásodra kell cserélni, és a sablonszerkesztőben lehet értékelni. Nem kapcsol relét, nem módosít állapotot.

A entitás állapota: {{ states('switch.pelda_csatorna_a') }}
B entitás állapota: {{ states('switch.pelda_csatorna_b') }}
A elérhetőnek látszik: {{ has_value('switch.pelda_csatorna_a') }}
B elérhetőnek látszik: {{ has_value('switch.pelda_csatorna_b') }}

A has_value azt jelzi, hogy az állapot nem unknown vagy unavailable. Nem rádiós jelerősségmérés, és nem fizikai reléteszt. Ha rossz példanevet hagysz a sablonban, az eredmény a hiányzó entitásról szól, nem a kapcsoló meghibásodásáról.

Az Állapot beállítása funkcióval ne próbáld megjavítani az eszközt. A Home Assistant állapotának átírása nem helyettesíti a fizikai vezérlőparancsot, és félrevezető képet adhat az automatizálásoknak.

8. ZHA esetén a csatornatámogatást vizsgáld

Ha a tényleges entitás ZHA-ból származik, az eszköz támogatása, végpontjai és integrációs megfeleltetése a fontos. Jegyezd fel a pontos modellt és gyártóazonosítót, ne csak a doboz márkanevét. Ugyanazon kereskedelmi név mögött eltérő változatok is lehetnek; más kapcsolóhoz készült javítást nem érdemes vakon átvenni.

A ZHA hivatalos leírása külön foglalkozik az eszköztámogatással, a gyártóspecifikus eltéréseket kezelő quirks megoldásokkal, a csoportokkal és a hibajelentéssel. Ezek vizsgálati irányok, nem automatikusan alkalmazandó javítások. Elsőként azt tisztázd, hogy a második kimenethez van-e külön, használható entitás, és melyik végponthoz tartozik.

Ne kezdj általános végpont- vagy klaszterparancsok küldésébe egy másik modell internetes példája alapján. Ha a támogatás hiányosnak tűnik, a pontos, anonimizált eszközadat és egy megismételhető próba többet ér a találgatásnál. Egyéni quirk telepítése vagy firmware-csere már külön, mentést és visszaállítási tervet igénylő feladat.

9. Zigbee2MQTT esetén az Exposes az iránytű

Ha igazoltan Zigbee2MQTT kezeli az eszközt, annak saját eszközoldalán és Exposes nézetében nézd meg a rendelkezésre álló funkciókat. Ez mutatja meg, milyen tulajdonságokat kínál az adott támogatás, és melyek olvashatók vagy állíthatók. Ne a Home Assistant feliratából következtesd ki az üzenet szerkezetét.

A Zigbee2MQTT TS0012 eszközlapja külön left és right végponti kapcsolót, valamint state_left és state_right állapottulajdonságot dokumentál. Ez hasznos összehasonlítási alap a modellcsaládhoz, de nem bizonyítja, hogy a mi MQTT-entitásaink mögött ez a program vagy ugyanez a tulajdonságkészlet működik. A tényleges rendszer Exposes nézetét kell egyeztetni.

A bal és jobb elnevezést helyszíni próbával rendeld a lámpákhoz. A kijelzőn balra látható vezérlő nem feltétlenül a bal oldali fizikai billentyű. Ebben a cikkben szándékosan nincs bemásolható MQTT kapcsolóparancs: a nem igazolt topic vagy csatornanév rossz kimenetet célozhatna.

10. MQTT esetén válaszd külön a parancsot és az állapotot

Az MQTT switch működésének két fontos része a kiküldött vezérlés és a visszaérkező állapot. Egy sikeres üzenetküldés még nem bizonyítja a relé működését. A felületi állapot pedig lehet visszaigazolt vagy optimista: utóbbinál a kapcsoló a parancs után már a feltételezett állapotot mutathatja.

A saját konfigurációdban olvasással ellenőrizd a két csatorna parancsútját és állapotértékelését. Nem elég, hogy két külön entitásnév létezik: ha mindkettő ugyanazt a kimenetet címezi, ugyanaz történik a falban. Fordítva, a két relé jól kapcsolhat, miközben a visszajelzést mindkét entitás ugyanabból az értékből olvassa.

Figyelj az induláskor visszakapott, megőrzött állapotokra is. Egy korábbi MQTT-üzenet nem feltétlenül friss kapcsolási bizonyíték. A próbában időbélyeggel együtt rögzítsd a kérést, a fizikai reakciót és a következő állapotjelentést. Az MQTT-hitelesítő adatokat és a belső topicneveket ne tedd nyilvánossá.

11. Amikor a kapcsoló visszaugrik

A visszaugró ikon több különböző helyzetet takarhat. Lehet, hogy a parancs nem jut el a végpontig. Lehet, hogy a relé kapcsol, de a régi visszajelzés felülírja a felületet. Máskor egy automatizálás kapcsolja vissza a lámpát, vagy az entitás átmenetileg elérhetetlenné válik.

Jegyezd fel, hogy a visszaugrás előtt hallható vagy látható-e fizikai reakció. Ha a lámpa végig változatlan, először a célzást és a parancsutat vizsgáld. Ha a lámpa jó állapotban marad, de az ikon változik, a visszajelzés az első gyanús réteg. Ha a lámpa is rögtön visszakapcsol, keress második parancsot az időrendben.

A gyors újrakattintás elrejtheti a sorrendet. Egy parancs, egy megfigyelés és egy rögzített időpont alapján dolgozz. A toggle különösen félrevezető lehet bizonytalan kezdeti állapotnál; diagnosztikához az egyértelmű be és ki művelet könnyebben értelmezhető.

12. Csoport, terület, jelenet vagy közvetlen kötés?

Ha két lámpa mindig együtt változik, nézd meg, valóban egyetlen entitást választottál-e. A területre, eszközre vagy csoportra célzó művelet több kimenetet is érinthet. A műszerfal gombja mögött jelenet vagy script is állhat, miközben a felirat csak egy lámpát említ.

A Zigbee-csoport és a Home Assistantban létrehozott csoport nem ugyanaz a réteg. ZHA esetén közvetlen binding is szerepet kaphat. Egy ilyen kapcsolatot ne törölj próbaképpen anélkül, hogy tudnád, milyen kézi vezérlés függ tőle. Először a meglétét és célját dokumentáld.

A hibakeresés során a közvetlen entitáspróba és a műszerfali gomb összehasonlítása különösen értékes. Ha az entitás külön működik, de a gomb mindkettőt kapcsolja, valószínűleg a gomb mögötti célzásnál kell keresni. Ezt még nem szükséges párosítási hibának tekinteni.

13. Automatizálásból rossz? Nézd meg az egyetlen célpontot

Ha a közvetlen próba jó, de a mozgásvezérlés nem, keresd meg a friss futás nyomkövetését. Ellenőrizd a ténylegesen végrehajtott műveletet és a feloldott célokat. Egy régi vagy átnevezett entitásazonosító könnyen bent maradhat a konfigurációban, miközben a műszerfal már az újat használja.

Az alábbi YAML csak egy műveletrészlet, nem teljes automatizálás. Átírás után valódi lámpát kapcsolhat, ezért olvasási ellenőrzéshez ne futtasd. A lényeg az egyetlen, konkrét switch entitás, nem egy csoport vagy terület.

action: switch.turn_on
target:
  entity_id: switch.pelda_csatorna_a

Ugyanebben az automatizálásban keresd meg a későbbi kikapcsolást is. Gyakori szerkesztési hiba, hogy a bekapcsolás már A-ra, a kikapcsolás még B-re mutat. Az elágazások, várakozások és hibakezelések céljait is nézd át, ne csak az első műveletet.

A „műveletek futtatása” nem azonos a valódi indító teljes próbájával. Egy sikeres kézi futás után is hibás lehet az indító vagy a feltétel. Ezt részletesen a Ring-mozgásvezérlés hibakeresési útmutatójában bontjuk szét.

14. Keresd meg, ki küldte a második parancsot

Egy relét több automatizálás, jelenet, script, hangvezérlés vagy másik felület is kezelhet. A tünet ilyenkor eszközhibának látszik, pedig egymásnak ellentmondó kérések érkeznek. Keress rá az entitásazonosítóra a kapcsolódó automatizálásokban, és vesd össze a naplóbejegyzéseket a saját próba idejével.

Ha a vizsgálathoz ideiglenes szüneteltetés szükséges, előbb készíts pontos listát az érintett automatizálásokról és eredeti állapotukról. Csak az egyeztetett világítási kört érintsd, ne kapcsold ki az egész otthon vezérlését. A próba végén ugyanebből a listából ellenőrizd a visszaállítást.

A mostani cikk készítésénél nem szüneteltettünk semmit. A nyilvántartás olvasása azt mutatja meg, mi van beállítva; a versengő parancsok kizárásához helyszíni, időben követhető vizsgálat kell. Egyetlen aktuális off állapotból nem mondható meg, melyik automatizálás volt korábban felelős.

15. Rádiós hiba vagy rossz megfeleltetés?

A bizonytalan rádiós kapcsolat jellemzően időszakos kimaradásokkal, késéssel vagy elérhetetlenséggel járhat. A következetesen rossz csatornát kapcsoló parancs viszont inkább a célzás vagy megfeleltetés vizsgálatát indokolja. Ez munkahipotézis, nem végleges diagnózis: a megfigyeléseket kell összevetni.

Az LQI érték önmagában nem bizonyítja a helyes kimenet működését, és két külön eszköz értéke sem feltétlenül hasonlítható egyszerűen össze. Előbb rögzítsd, hogy a parancs melyik lámpát célozta és melyik reagált. Ezután keress összefüggést a kimaradások, az elérhetőség és a hálózati események között.

A koordinátor környezetének, az interferenciának és a hálózati lefedettségnek az áttekintése későbbi vizsgálati irány lehet. Ne változtass egyszerre csatornát, koordinátor-elhelyezést és entitáskonfigurációt: elveszne annak bizonyítéka, hogy melyik változtatás segített. A hálózati átalakítás külön tervet érdemel.

16. Miért nem az újrapárosítás az első lépés?

Az újrapárosítás megváltoztathatja a rendszer nyilvántartását és megtörheti a régi hivatkozásokat. Előtte mentsd a konfigurációt, az entitáslistát, a kapcsolódó automatizálásokat és a csatornák megfeleltetését. Egy elveszett név vagy új entitás miatt a korábban jó automatizálás is hibásnak tűnhet.

A párosítást akkor érdemes külön feladatként mérlegelni, ha már van bizonyíték arra, hogy az eszköz felvétele vagy támogatása hiányos. Ugyanez igaz az integráció újrakonfigurálására, a firmware-frissítésre és az egyéni javítás telepítésére. Nem mindegyik művelet szükséges, és nem minden modell viselkedik azonosan.

Egy Zigbee-eszköz egyszerre egy Zigbee-hálózathoz csatlakozik. A ZHA és a Zigbee2MQTT közötti váltást ezért ne kezeld egyszerű nézetváltásként, és ugyanazt a rádiós adaptert ne próbáld két aktív kezelőből használni. Először a jelenlegi parancsutat értsd meg; a költözés már külön migrációs munka.

17. Az ellenőrző próba végén legyen elfogadási feltétel

A siker nem az, hogy egyszer felkapcsolt valamelyik lámpa. A megfeleltetés akkor használható, ha A be- és kikapcsolása nem változtat B-n, B próbája pedig nem változtat A-n. A felületi állapotnak mindkét esetben követnie kell a megfigyelt reakciót, vagy dokumentálni kell az ismert visszajelzési korlátot.

Egy egyeztetett próbasor végén ellenőrizd a két kimenet egymás utáni használatát és a kézi vezérlés megmaradását. Ezután jöhet az érintett automatizálás valódi indítóval végzett próbája. Ne egyetlen sikeres kattintásból következtesd ki az egész esti mozgásvezérlés megbízhatóságát.

Próba ideje és megfigyelő:
A entitás -> megfigyelt A lámpa:
B entitás -> megfigyelt B lámpa:
A külön be/ki; B változatlan:
B külön be/ki; A változatlan:
Állapot-visszajelzés követi:
Automatizálás célja és friss nyomkövetése:
Ideiglenes változtatások visszaállítva:
Fennmaradó eltérés:

A jegyzőkönyvben a sikertelen lépés is értékes eredmény. Ha például a két kimenet már külön kapcsol, de B állapota még hibás, a vezérlési és visszajelzési problémát külön feladatként lehet folytatni. Így nem kell minden alkalommal a teljes hibakeresést elölről kezdeni.

18. Bizonyítékok és korlátok a saját rendszerünkből

A történeti tapasztalat és a mai állapot között lehetett további változtatás. Ezért nem közlünk kész, saját otthonból kimásolt topicokat, végpontszámokat vagy kapcsolási konfigurációt. Ezek a teljes közvetítő megértése nélkül félrevezetők lennének.

A következő indokolt saját vizsgálat a parancsút dokumentálása és egy egyeztetett, fizikai megfigyeléssel kísért A/B próba lenne. A cikk mostani frissítése ezt nem végezte el, és nem állítja, hogy a teljes rendszer friss működési minősítését adja.

19. Így kérj segítséget, hogy használható választ kapj

A „nem működik a két kapcsoló” helyett írd le a pontos eltérést: A felületi vezérlő mindkét lámpát kapcsolja, vagy csak az ikon ugrik vissza, miközben a lámpa helyes állapotban marad. Mellékeld a verziót, a modellt, a használt integrációt és a kitöltött próbatáblázat anonimizált változatát.

Modell és gyártói változat:
Home Assistant és érintett integráció verziója:
Közvetlen vezérlés vagy automatizálás hibás:
Várt reakció:
Megfigyelt fizikai reakció:
Megfigyelt entitásállapot:
Próba időpontja, kapcsolódó napló vagy nyomkövetés:
Már ellenőrzött lépések:

A diagnosztikai exportot megosztás előtt nézd át. Töröld a személyes neveket, címeket, belső elérhetőségeket, egyedi rádiós azonosítókat és hitelesítő adatokat. A teljes konfiguráció helyett az adott hibához szükséges részletet add meg, a csatornaneveket következetesen A és B jelölésre cserélve.

Az OkosHorizont közösségében a jelenség és a megfigyelés leírásával tudsz a legtöbbet segíteni. A villamos bekötés megítélése továbbra is helyszíni szakfeladat; egy fórumválasz nem helyettesíti azt.

20. Források és kapcsolódó útmutatók

A hivatalos leírásokat 2026. október 18-án ellenőriztük. A menük és az eszköztámogatás változhatnak; az adott rendszerben látható modelladat és támogatott funkció az irányadó. A szöveg saját szerkesztésű hibakeresési útmutató, a hivatkozások a technikai ellenőrzéshez használhatók.

1. Home Assistant – ZHA, támogatás, csoportok és hibakeresés ↗
2. Home Assistant – Switch állapotok és műveletek ↗
3. Home Assistant – MQTT Switch és állapot-visszajelzés ↗
4. Home Assistant – Állapot és állapotobjektum ↗
5. Home Assistant – Automatizálások hibakeresése ↗
6. Zigbee2MQTT – TS0012 eszközlap ↗
7. Zigbee2MQTT – Exposes funkcióleírás ↗

Az OkosHorizonton a Ring-kamera mozgásvezérlésének hibakeresése a jelzéstől a lámpáig követi a láncot. A Ring-világítás esettanulmánya a teljes működési történetet mutatja be, a Home Assistant biztonsági mentéséről szóló útmutató pedig a későbbi változtatások előkészítésében segít. Ezeket az oldal alján található kapcsolódó útmutatók között is eléred.