TapHome

Moes Smart Switch

Packet Parser → MQTT
Pridal
Posledná aktualizácia: 03. 2026

Vyžaduje externú bránu

tasmota zigbee2tasmota-gateway — stránka produktu

Moes Smart Switch

Toto zariadenie komunikuje cez Zigbee prostredníctvom Tasmota gateway. Uistite sa, že máte importovanú šablónu Zigbee2Tasmota Gateway a vaše zariadenie je spárované.

Moes Smart Switch (séria ZTS-EU) je Zigbee nástenný dotykový spínač so skleneným panelom, určený pre inštaláciu v EU štýle. TapHome ho ovláda cez MQTT prostredníctvom Zigbee2Tasmota gateway a poskytuje zapínanie/vypínanie pripojených záťaží.

Moes je súčasťou ekosystému Tuya — spínač používa čipset Tuya TS0601 a je dostupný na moeshouse.com a Aliexpress. Séria ZTS-EU je dostupná v 1, 2 a 3 gangových variantoch; táto šablóna podporuje 1-gangový model.

Ako zariadenie napájané zo siete funguje spínač ako Zigbee router — posilňuje Zigbee mesh sieť a rozširuje dosah pre blízke batériové zariadenia.

Konfigurácia

Spárovanie spínača
  1. Uistite sa, že Zigbee2Tasmota Gateway je nastavený a prepínač Permit Join je v TapHome zapnutý
  2. Podržte dotykové tlačidlo 10+ sekúnd (alebo rýchlo 5-krát prepnite fyzický spínač), kým LED indikátor nezačne rýchlo blikať
  3. Spínač prejde do režimu párovania — LED bliká na potvrdenie
  4. Zaznamenajte si Device ID (napr. 0x1234) zo servisných atribútov gateway
Parametre importu šablóny

Šablóna zariadenia vyžaduje 4 parametre:

ParameterPopisPríklad
MQTT Broker IP AddressIP adresa vášho MQTT brokera192.168.1.10
MQTT Broker PortPort brokera (predvolene 1883)1883
Gateway nameTasmota MQTT topic (rovnaký ako v šablóne gateway)tasmota_XXXXX
Device IDZigbee krátka adresa z párovania0x1234

Po importe sa v TapHome objaví jedno zariadenie Spínač na ovládanie zapnutia/vypnutia.

Schopnosti zariadenia

Ovládanie spínača

Šablóna vytvorí jedno zariadenie Spínač, ktoré číta a zapisuje pole Power:

  • Čítanie: Modul počúva na topicu tele/{GWname}/SENSOR správy ZbReceived.{ID}.Power. Keď stlačíte fyzické dotykové tlačidlo, spínač publikuje svoj nový stav.
  • Zápis: TapHome odošle príkaz ZbSend s Power: true (ZAP) alebo Power: false (VYP) na diaľkové ovládanie relé.

Spínač reaguje na fyzické dotyky aj príkazy z TapHome a TapHome vždy zobrazuje aktuálny stav — bez ohľadu na to, ako bol spínač prepnutý.

Servisné atribúty

Modul poskytuje diagnostické informácie cez servisné atribúty:

  • IEEE Address — Zigbee IEEE adresa (64-bitový unikátny identifikátor)
  • Model ID — Zigbee identifikátor modelu (typicky TS0601)
  • Manufacturer — Zigbee reťazec výrobcu
  • Endpoints — aktívne Zigbee endpointy
  • Config — konfiguračný reťazec zariadenia
Ďalšie možnosti

Moes ZTS-EU podporuje aj ovládanie režimu indikačnej LED (vypnutá, sleduje stav spínača, zobrazuje polohu, zmrazenie) a konfiguráciu správania po zapnutí (vypnutý, zapnutý, predchádzajúci stav). Tieto funkcie sú dostupné v Zigbee2MQTT, ale v TapHome šablóne nie sú momentálne mapované.

Riešenie problémov

Spínač nereaguje na príkazy z TapHome
  1. Overte, že Device ID v šablóne zodpovedá Zigbee krátkej adrese pridelenej počas párovania
  2. Skontrolujte, že názov gateway sa zhoduje medzi šablónou gateway a šablónou tohto zariadenia
  3. Vyskúšajte fyzické dotykové tlačidlo — ak prepína relé, ale TapHome sa neaktualizuje, môže byť problém v ceste čítania (SENSOR topic)
  4. Skontrolujte Tasmota konzolu, či sa pri prepínaní spínača zobrazujú správy ZbReceived
Stav spínača nie je synchronizovaný
  1. Ak spínač zobrazuje v TapHome iný stav ako skutočná poloha relé, stlačte fyzické tlačidlo na vyvolanie hlásenia stavu
  2. Šablóna aktívne nedotazuje stav spínača — spolieha sa na hlásenie zmien zo zariadenia. Ak spínač krátko stratí pripojenie, stav môže byť neaktuálny do ďalšieho fyzického prepnutia
Správanie indikačnej LED

Indikačná LED na paneli spínača je riadená firmvérom Tuya. Štandardne môže sledovať stav spínača alebo zostať vypnutá. TapHome šablóna neovláda indikátor — na zmenu režimu indikátora použite Zigbee2MQTT alebo aplikáciu Tuya.

Ako nainštalovať v TapHome

Predpoklady

  • Zigbee brána s firmvérom Tasmota (napr. Sonoff ZBBridge, eWeLink ZB-GW03)
  • MQTT broker bežiaci vo vašej lokálnej sieti (vstavaný TapHome broker alebo externý)
  • TapHome CCU v rovnakej sieti

TapHome má vstavaný MQTT broker — aktivujte ho v Nastavenia → Hardware → MQTT Broker. Nie je potrebný žiadny ďalší softvér.

Krok 1 — Nastavte Tasmota Zigbee bránu

  1. Nahrajte firmvér Tasmota na podporovaný Zigbee koordinátor (napr. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Pripojte bránu k vašej Wi-Fi sieti cez webové rozhranie Tasmota
  3. Prejdite na Configuration → Configure MQTT a nastavte:
    • Host: IP adresa vášho MQTT brokera (napr. 192.168.1.10)
    • Port: 1883
    • Topic: zapíšte si názov topicu (napr. tasmota_XXXXX) — budete ho potrebovať pri importe šablóny

Podrobné pokyny nájdete v dokumentácii Tasmota Zigbee.

Krok 2 — Importujte šablónu brány v TapHome

  1. Stiahnite si šablónu brány zo stránky kompatibility Zigbee2Tasmota Gateway
  2. V TapHome prejdite na Nastavenia → Hardware → Packet Parser → Import
  3. Importujte šablónu s týmito parametrami:
    • MQTT Broker IP Address: IP adresa vášho brokera (napr. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: Tasmota MQTT topic z kroku 1 (napr. tasmota_XXXXX)

Po importe uvidíte dve zariadenia: Permit Join (prepínač) a Devices Found (počítadlo).

Krok 3 — Spárujte Zigbee zariadenie

  1. V TapHome zapnite prepínač Permit Join — otvorí sa 60-sekundové okno pre párovanie
  2. Na Zigbee zariadení spustite proces párovania (zvyčajne podržte tlačidlo reset 5 sekúnd, kým LED nezačne blikať)
  3. Sledujte počítadlo Devices Found — zvýši sa, keď sa pripojí nové zariadenie
  4. Skontrolujte Service Attributes brány, kde uvidíte ID nového zariadenia (napr. 0x1234), výrobcu a model
  5. Režim párovania sa automaticky deaktivuje po uplynutí časového limitu

Krok 4 — Importujte šablónu zariadenia

  1. Stiahnite si šablónu konkrétneho zariadenia z príslušnej stránky kompatibility
  2. Importujte šablónu s týmito parametrami:
    • MQTT Broker IP Address: rovnaká ako pre bránu
    • MQTT Broker Port: 1883
    • Gateway name: rovnaký Tasmota MQTT topic ako vyššie
    • Device ID: krátka adresa z párovania (napr. 0x1234)

Dostupné zariadenia

Moes Smart Switch Modul
Servisné atribúty
IEEE AddressZigbee IEEE adresa (64-bitový unikátny identifikátor)
Model IDZigbee identifikátor modelu hlásený zariadením
ManufacturerZigbee reťazec výrobcu hlásený zariadením
EndpointsAktívne Zigbee endpointy na zariadení
ConfigKonfiguračný reťazec Zigbee zariadenia
Vlastné premenné
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

Listener
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
Servisné atribúty
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Spínač Prepínač

On/off relé ovládané príkazom ZbSend Power

boolean
Hodnoty / Stavy: ON · OFF

Spínač

Zápis stavu prepínača
MQTTPUBLISH("cmnd/" + GWname+ "/ZbSend", 
    "{\"device\":\" " + ID + 
    "\",\"send\":{\"Power\":" + St + "}}")
Listener
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
Pripojenie: Packet Parser → MQTT
Možné vylepšenia (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

Zdroje