TapHome

Moes Smart Switch

Packet Parser → MQTT
Beküldő
Utoljára frissítve: 03. 2026

Külső átjáró szükséges

tasmota zigbee2tasmota-gateway — termékoldal

Moes Smart Switch

Ez az eszköz Zigbee protokollon kommunikál egy Tasmota gatewayen keresztül. Győződj meg róla, hogy a Zigbee2Tasmota Gateway sablon importálva van és az eszközöd párosítva van.

A Moes Smart Switch (ZTS-EU sorozat) egy Zigbee fali érintőkapcsoló üveg panellel, EU-stílusú telepítéshez tervezve. A TapHome MQTT-n keresztül vezérli a Zigbee2Tasmota gatewayen át, és be/ki kapcsolást biztosít a csatlakoztatott terhelésekhez.

A Moes a Tuya ökoszisztéma része — a kapcsoló Tuya TS0601 chipkészletet használ, és a moeshouse.com-on valamint az Aliexpressen elérhető. A ZTS-EU sorozat 1, 2 és 3 gombos változatban kapható; ez a sablon az 1 gombos modellt támogatja.

Hálózatról táplált eszközként a kapcsoló Zigbee routerként működik — erősíti a Zigbee mesh hálózatot és kiterjeszti a hatótávolságot a közeli elemmel működő eszközök számára.

Konfiguráció

A kapcsoló párosítása
  1. Győződj meg róla, hogy a Zigbee2Tasmota Gateway be van állítva és a Permit Join kapcsoló BE van kapcsolva a TapHome-ban
  2. Tartsd nyomva az érintőgombot 10+ másodpercig (vagy kapcsold át a fizikai kapcsolót gyorsan 5-ször), amíg a LED jelző gyorsan villogni nem kezd
  3. A kapcsoló párosítási módba lép — a LED villogással jelzi
  4. Jegyezd fel a Device ID-t (pl. 0x1234) a gateway szervizattribútumaiból
Sablon import paraméterei

Az eszközsablon 4 paramétert igényel:

ParaméterLeírásPélda
MQTT Broker IP AddressAz MQTT broker IP-címe192.168.1.10
MQTT Broker PortBroker port (alapértelmezett 1883)1883
Gateway nameTasmota MQTT topic (ugyanaz mint a gateway sablonban)tasmota_XXXXX
Device IDZigbee rövid cím a párosításból0x1234

Importálás után egy Kapcsoló eszköz jelenik meg a TapHome-ban a be/ki vezérléshez.

Eszközképességek

Kapcsolóvezérlés

A sablon egy Kapcsoló eszközt hoz létre, amely a Power mezőt olvassa és írja:

  • Olvasás: A modul a tele/{GWname}/SENSOR topicon figyeli a ZbReceived.{ID}.Power üzeneteket. Amikor megnyomod a fizikai érintőgombot, a kapcsoló közzéteszi az új állapotát.
  • Írás: A TapHome ZbSend parancsot küld Power: true (BE) vagy Power: false (KI) értékkel a relé távoli vezérléséhez.

A kapcsoló reagál a fizikai érintésekre és a TapHome parancsokra is, és a TapHome mindig az aktuális állapotot mutatja — függetlenül attól, hogyan kapcsolták át.

Szervizattribútumok

A modul diagnosztikai információkat biztosít szervizattribútumokon keresztül:

  • IEEE Address — Zigbee IEEE cím (64 bites egyedi azonosító)
  • Model ID — Zigbee modellazonosító (jellemzően TS0601)
  • Manufacturer — Zigbee gyártói karakterlánc
  • Endpoints — aktív Zigbee végpontok
  • Config — eszközkonfigurációs karakterlánc
További képességek

A Moes ZTS-EU támogatja a jelző LED mód vezérlését is (ki, követi a kapcsoló állapotát, pozíciót mutat, befagyasztva) és a bekapcsolási viselkedés konfigurálását (ki, be, előző állapot). Ezek a funkciók elérhetők a Zigbee2MQTT-ben, de jelenleg nem szerepelnek a TapHome sablonban.

Hibaelhárítás

A kapcsoló nem reagál a TapHome parancsokra
  1. Ellenőrizd, hogy a sablonban lévő Device ID megegyezik a párosítás során kiosztott Zigbee rövid címmel
  2. Ellenőrizd, hogy a gateway neve megegyezik a gateway sablon és ezen eszközsablon között
  3. Próbáld ki a fizikai érintőgombot — ha kapcsolja a relét, de a TapHome nem frissül, az olvasási útvonalon (SENSOR topic) lehet a probléma
  4. Ellenőrizd a Tasmota konzolban, hogy megjelennek-e ZbReceived üzenetek a kapcsoló átkapcsolásakor
A kapcsoló állapota nincs szinkronban
  1. Ha a kapcsoló más állapotot mutat a TapHome-ban, mint a relé tényleges pozíciója, nyomd meg a fizikai gombot az állapotjelentés kiváltásához
  2. A sablon nem kérdezi le aktívan a kapcsoló állapotát — az eszköz változásjelentéseire támaszkodik. Ha a kapcsoló rövid időre elveszíti a kapcsolatot, az állapot elavulhat a következő fizikai átkapcsolásig
A jelző LED viselkedése

A kapcsoló panelén lévő jelző LED-et a Tuya firmware vezérli. Alapértelmezetten követheti a kapcsoló állapotát vagy kikapcsolva maradhat. A TapHome sablon nem vezérli a jelzőt — a jelző mód módosításához használd a Zigbee2MQTT-t vagy a Tuya alkalmazást.

Telepítés a TapHome-ban

Előfeltételek

  • Zigbee átjáró Tasmota firmware-rel (pl. Sonoff ZBBridge, eWeLink ZB-GW03)
  • MQTT broker a helyi hálózaton (TapHome beépített broker vagy külső)
  • TapHome CCU ugyanazon a hálózaton

A TapHome rendelkezik beépített MQTT brokerrel — aktiválja a Beállítások → Hardware → MQTT Broker menüpontban. Nincs szükség további szoftverre.

1. lépés — Tasmota Zigbee átjáró beállítása

  1. Telepítse a Tasmota firmware-t egy támogatott Zigbee koordinátorra (pl. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Csatlakoztassa az átjárót a Wi-Fi hálózathoz a Tasmota webes felületén
  3. Navigáljon a Configuration → Configure MQTT menüpontra és állítsa be:
    • Host: az MQTT broker IP-címe (pl. 192.168.1.10)
    • Port: 1883
    • Topic: jegyezze fel a topic nevét (pl. tasmota_XXXXX) — szükség lesz rá a sablon importálásakor

Részletes útmutatót a Tasmota Zigbee dokumentációban talál.

2. lépés — Átjáró sablon importálása a TapHome-ba

  1. Töltse le az átjáró sablont a Zigbee2Tasmota Gateway kompatibilitási oldalról
  2. A TapHome-ban lépjen a Beállítások → Hardware → Packet Parser → Import menüpontra
  3. Importálja a sablont ezekkel a paraméterekkel:
    • MQTT Broker IP Address: a broker IP-címe (pl. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: a Tasmota MQTT topic az 1. lépésből (pl. tasmota_XXXXX)

Importálás után két eszköz jelenik meg: Permit Join (kapcsoló) és Devices Found (számláló).

3. lépés — Zigbee eszköz párosítása

  1. A TapHome-ban kapcsolja be a Permit Join kapcsolót — megnyílik egy 60 másodperces párosítási ablak
  2. A Zigbee eszközön indítsa el a párosítási folyamatot (jellemzően tartsa lenyomva a reset gombot 5 másodpercig, amíg a LED villogni nem kezd)
  3. Figyelje a Devices Found számlálót — növekszik, amikor új eszköz csatlakozik
  4. Ellenőrizze az átjáró Service Attributes részét az új eszköz azonosítójának (pl. 0x1234), gyártójának és modelljének megtekintéséhez
  5. A párosítási mód automatikusan deaktiválódik az időkorlát lejártakor

4. lépés — Eszközsablon importálása

  1. Töltse le az eszközspecifikus sablont a megfelelő kompatibilitási oldalról
  2. Importálja a sablont ezekkel a paraméterekkel:
    • MQTT Broker IP Address: ugyanaz, mint az átjáróé
    • MQTT Broker Port: 1883
    • Gateway name: ugyanaz a Tasmota MQTT topic, mint fentebb
    • Device ID: a párosításból kapott rövid cím (pl. 0x1234)

Elérhető eszközök

Moes Smart Switch Modul
Szerviz attribútumok
IEEE AddressZigbee IEEE cím (64 bites egyedi azonosító)
Model IDAz eszköz által jelentett Zigbee modellazonosító
ManufacturerAz eszköz által jelentett Zigbee gyártói karakterlánc
EndpointsAktív Zigbee végpontok az eszközön
ConfigZigbee eszközkonfigurációs karakterlánc
Egyéni változók
GWname (string)Tasmota MQTT topic name of the Zigbee gateway (found in Configuration → MQTT → Topic)
ID (string)Zigbee short address of the Moes Smart Switch (assigned during pairing)
After pairing the device via Permit Join, find the device short address in the gateway's Devices Found service attribute or via Tasmota console command ZbStatus

Moes - Smart Switch

Figyelő
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
	var ZbReceived := PARSEJSON(TOSTRING(RECEIVEDMSG.Payload), "ZbReceived." + ID, true);
    var val := PARSEJSON(ZbReceived, ".LinkQuality", true);
    if(!ISNULL(val), LinkQuality := val);
    
    var deviceInfo := PARSEJSON(TOSTRING(RECEIVEDMSG.Payload), "ZbInfo." + ID, true);
    if !ISNULL(deviceInfo)
        COMPLETESERVICEATTRIBUTE("IEEEAddr", PARSEJSON(deviceInfo, "IEEEAddr"));
        COMPLETESERVICEATTRIBUTE("ModelId", PARSEJSON(deviceInfo, "ModelId"));
        COMPLETESERVICEATTRIBUTE("Manufacturer", PARSEJSON(deviceInfo, "Manufacturer"));
        COMPLETESERVICEATTRIBUTE("Endpoints", PARSEJSON(deviceInfo, "Endpoints"));
        COMPLETESERVICEATTRIBUTE("Config", PARSEJSON(deviceInfo, "Config"));
    end
end
Szerviz attribútumok
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Kapcsoló Kapcsoló

Be/ki relé vezérlése ZbSend Power paranccsal

boolean
Értékek / Állapotok: ON · OFF

Kapcsoló

Kapcsoló állapot írása
MQTTPUBLISH("cmnd/" + GWname+ "/ZbSend", 
    "{\"device\":\" " + ID + 
    "\",\"send\":{\"Power\":" + St + "}}")
Figyelő
VAR json := tostring(RECEIVEDMSG.Payload);
VAR topic := RECEIVEDMSG.Topic;

if INDEXOF(topic, "SENSOR") > 0
    var val := PARSEJSON(json, "ZbReceived." + ID + ".Power", true);
    if(!ISNULL(val), St := val);
end
Kapcsolat: Packet Parser → MQTT
Lehetséges fejlesztések (2)
  • Indicator Light — Controls LED indicator mode: off, switch (follows switch state), position (shows position), freeze
  • Power On Behavior — Controls state after power outage: off, on, previous

Források