TapHome

Moes Smart Switch

Packet Parser → MQTT
Přidal
Poslední aktualizace: 03. 2026

Vyžaduje externí bránu

tasmota zigbee2tasmota-gateway — stránka produktu

Moes Smart Switch

Toto zařízení komunikuje přes Zigbee prostřednictvím Tasmota gateway. Ujistěte se, že máte importovanou šablonu Zigbee2Tasmota Gateway a vaše zařízení je spárované.

Moes Smart Switch (řada ZTS-EU) je Zigbee nástěnný dotykový spínač se skleněným panelem, určený pro instalaci v EU stylu. TapHome ho ovládá přes MQTT prostřednictvím Zigbee2Tasmota gateway a poskytuje zapínání/vypínání připojených zátěží.

Moes je součástí ekosystému Tuya — spínač používá čipset Tuya TS0601 a je dostupný na moeshouse.com a Aliexpress. Řada ZTS-EU je dostupná v 1, 2 a 3 gangových variantách; tato šablona podporuje 1-gangový model.

Jako zařízení napájené ze sítě funguje spínač jako Zigbee router — posiluje Zigbee mesh síť a rozšiřuje dosah pro blízká bateriová zařízení.

Konfigurace

Spárování spínače
  1. Ujistěte se, že Zigbee2Tasmota Gateway je nastaven a přepínač Permit Join je v TapHome zapnutý
  2. Podržte dotykové tlačítko 10+ sekund (nebo rychle 5krát přepněte fyzický spínač), dokud LED indikátor nezačne rychle blikat
  3. Spínač přejde do režimu párování — LED bliká pro potvrzení
  4. Poznamenejte si Device ID (např. 0x1234) ze servisních atributů gateway
Parametry importu šablony

Šablona zařízení vyžaduje 4 parametry:

ParametrPopisPříklad
MQTT Broker IP AddressIP adresa vašeho MQTT brokeru192.168.1.10
MQTT Broker PortPort brokeru (výchozí 1883)1883
Gateway nameTasmota MQTT topic (stejný jako v šabloně gateway)tasmota_XXXXX
Device IDZigbee krátká adresa z párování0x1234

Po importu se v TapHome objeví jedno zařízení Spínač pro ovládání zapnutí/vypnutí.

Schopnosti zařízení

Ovládání spínače

Šablona vytvoří jedno zařízení Spínač, které čte a zapisuje pole Power:

  • Čtení: Modul naslouchá na topicu tele/{GWname}/SENSOR zprávám ZbReceived.{ID}.Power. Když stisknete fyzické dotykové tlačítko, spínač publikuje svůj nový stav.
  • Zápis: TapHome odešle příkaz ZbSend s Power: true (ZAP) nebo Power: false (VYP) pro vzdálené ovládání relé.

Spínač reaguje na fyzické dotyky i příkazy z TapHome a TapHome vždy zobrazuje aktuální stav — bez ohledu na to, jak byl spínač přepnut.

Servisní atributy

Modul poskytuje diagnostické informace přes servisní atributy:

  • IEEE Address — Zigbee IEEE adresa (64bitový unikátní identifikátor)
  • Model ID — Zigbee identifikátor modelu (typicky TS0601)
  • Manufacturer — Zigbee řetězec výrobce
  • Endpoints — aktivní Zigbee endpointy
  • Config — konfigurační řetězec zařízení
Další možnosti

Moes ZTS-EU podporuje také ovládání režimu indikační LED (vypnuto, sleduje stav spínače, zobrazuje pozici, zmrazení) a konfiguraci chování po zapnutí (vypnuto, zapnuto, předchozí stav). Tyto funkce jsou dostupné v Zigbee2MQTT, ale v TapHome šabloně nejsou momentálně mapovány.

Řešení problémů

Spínač nereaguje na příkazy z TapHome
  1. Ověřte, že Device ID v šabloně odpovídá Zigbee krátké adrese přidělené během párování
  2. Zkontrolujte, že název gateway se shoduje mezi šablonou gateway a šablonou tohoto zařízení
  3. Vyzkoušejte fyzické dotykové tlačítko — pokud přepíná relé, ale TapHome se neaktualizuje, může být problém v cestě čtení (SENSOR topic)
  4. Zkontrolujte Tasmota konzoli, zda se při přepínání spínače zobrazují zprávy ZbReceived
Stav spínače není synchronizován
  1. Pokud spínač zobrazuje v TapHome jiný stav než skutečná pozice relé, stiskněte fyzické tlačítko pro vyvolání hlášení stavu
  2. Šablona aktivně nedotazuje stav spínače — spoléhá na hlášení změn ze zařízení. Pokud spínač krátce ztratí připojení, stav může být neaktuální do dalšího fyzického přepnutí
Chování indikační LED

Indikační LED na panelu spínače je řízena firmwarem Tuya. Standardně může sledovat stav spínače nebo zůstat vypnutá. TapHome šablona neovládá indikátor — pro změnu režimu indikátoru použijte Zigbee2MQTT nebo aplikaci Tuya.

Jak nainstalovat v TapHome

Předpoklady

  • Zigbee brána s firmwarem Tasmota (např. Sonoff ZBBridge, eWeLink ZB-GW03)
  • MQTT broker běžící ve vaší lokální síti (vestavěný TapHome broker nebo externí)
  • TapHome CCU ve stejné síti

TapHome má vestavěný MQTT broker — aktivujte ho v Nastavení → Hardware → MQTT Broker. Není potřeba žádný další software.

Krok 1 — Nastavte Tasmota Zigbee bránu

  1. Nahrajte firmware Tasmota na podporovaný Zigbee koordinátor (např. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Připojte bránu k vaší Wi-Fi síti přes webové rozhraní Tasmota
  3. Přejděte na Configuration → Configure MQTT a nastavte:
    • Host: IP adresa vašeho MQTT brokeru (např. 192.168.1.10)
    • Port: 1883
    • Topic: zapište si název topicu (např. tasmota_XXXXX) — budete ho potřebovat při importu šablony

Podrobné pokyny naleznete v dokumentaci Tasmota Zigbee.

Krok 2 — Importujte šablonu brány v TapHome

  1. Stáhněte si šablonu brány ze stránky kompatibility Zigbee2Tasmota Gateway
  2. V TapHome přejděte na Nastavení → Hardware → Packet Parser → Import
  3. Importujte šablonu s těmito parametry:
    • MQTT Broker IP Address: IP adresa vašeho brokeru (např. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: Tasmota MQTT topic z kroku 1 (např. tasmota_XXXXX)

Po importu uvidíte dvě zařízení: Permit Join (přepínač) a Devices Found (počítadlo).

Krok 3 — Spárujte Zigbee zařízení

  1. V TapHome zapněte přepínač Permit Join — otevře se 60sekundové okno pro párování
  2. Na Zigbee zařízení spusťte proces párování (typicky podržte tlačítko reset 5 sekund, dokud LED nezačne blikat)
  3. Sledujte počítadlo Devices Found — zvýší se, když se připojí nové zařízení
  4. Zkontrolujte Service Attributes brány, kde uvidíte ID nového zařízení (např. 0x1234), výrobce a model
  5. Režim párování se automaticky deaktivuje po uplynutí časového limitu

Krok 4 — Importujte šablonu zařízení

  1. Stáhněte si šablonu konkrétního zařízení z příslušné stránky kompatibility
  2. Importujte šablonu s těmito parametry:
    • MQTT Broker IP Address: stejná jako pro bránu
    • MQTT Broker Port: 1883
    • Gateway name: stejný Tasmota MQTT topic jako výše
    • Device ID: krátká adresa z párování (např. 0x1234)

Dostupná zařízení

Moes Smart Switch Modul
Servisní atributy
IEEE AddressZigbee IEEE adresa (64bitový unikátní identifikátor)
Model IDZigbee identifikátor modelu hlášený zařízením
ManufacturerZigbee řetězec výrobce hlášený zařízením
EndpointsAktivní Zigbee endpointy na zařízení
ConfigKonfigurační řetězec Zigbee zařízení
Vlastní proměnné
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í atributy
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Spínač Přepínač

On/off relé ovládané příkazem ZbSend Power

boolean
Hodnoty / Stavy: ON · OFF

Spínač

Zápis stavu přepínače
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
Připojení: Packet Parser → MQTT
Možná vylepšení (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