TapHome

Moes Smart Switch

Packet Parser → MQTT
Trimis de
Ultima actualizare: 03. 2026

Necesită gateway extern

tasmota zigbee2tasmota-gateway — pagina produsului

Moes Smart Switch

Acest dispozitiv comunică prin Zigbee printr-un gateway Tasmota. Înainte de a continua, asigurați-vă că ați importat șablonul Zigbee2Tasmota Gateway și ați împerecheat dispozitivul.

Moes Smart Switch (seria ZTS-EU) este un întrerupător tactil Zigbee de perete, cu panou din sticlă, conceput pentru montarea în doze de aparataj de tip european. TapHome îl controlează prin MQTT, prin gateway-ul Zigbee2Tasmota, și asigură pornirea/oprirea sarcinilor conectate.

Moes face parte din ecosistemul Tuya — întrerupătorul folosește un chipset Tuya TS0601 și este disponibil pe moeshouse.com și Aliexpress. Seria ZTS-EU există în variante cu 1, 2 și 3 canale; acest șablon acceptă modelul cu 1 canal.

Fiind alimentat de la rețea, întrerupătorul funcționează ca router Zigbee — întărește rețeaua mesh Zigbee și extinde raza de acoperire pentru dispozitivele cu baterie din apropiere.

Configurare

Împerecherea întrerupătorului
  1. Asigurați-vă că Zigbee2Tasmota Gateway este configurat și comutatorul Permit Join este ON în TapHome
  2. Țineți apăsat butonul tactil 10 secunde sau mai mult (sau comutați rapid întrerupătorul fizic de 5 ori) până când LED-ul indicator clipește rapid
  3. Întrerupătorul intră în modul de împerechere — LED-ul clipește pentru confirmare
  4. Notați Device ID-ul (de ex. 0x1234) din atributele de service ale gateway-ului
Parametrii de import ai șablonului

Șablonul dispozitivului necesită 4 parametri:

ParametruDescriereExemplu
MQTT Broker IP AddressAdresa IP a brokerului dvs. MQTT192.168.1.10
MQTT Broker PortPortul brokerului (implicit 1883)1883
Gateway nameTopicul MQTT Tasmota (același ca la șablonul gateway-ului)tasmota_XXXXX
Device IDAdresa scurtă Zigbee de la împerechere0x1234

După import, în TapHome apare un singur dispozitiv Comutator pentru pornire/oprire.

Funcțiile dispozitivului

Controlul comutatorului

Șablonul creează un dispozitiv Comutator care citește și scrie câmpul Power:

  • Citire: Modulul ascultă pe topicul tele/{GWname}/SENSOR mesajele ZbReceived.{ID}.Power. Când apăsați butonul tactil fizic, întrerupătorul publică noua stare.
  • Scriere: TapHome trimite o comandă ZbSend cu Power: true (ON) sau Power: false (OFF), pentru a controla releul de la distanță.

Întrerupătorul răspunde atât la atingerile fizice, cât și la comenzile TapHome, iar TapHome afișează întotdeauna starea curentă — indiferent de modul în care a fost comutat întrerupătorul.

Atribute de service

Modulul pune la dispoziție informații de diagnosticare prin atribute de service:

  • Adresă IEEE — adresa IEEE Zigbee (identificator unic de 64 de biți)
  • ID model — identificatorul de model Zigbee (de obicei TS0601)
  • Producător — șirul cu numele producătorului Zigbee
  • Endpointuri — endpointuri Zigbee active
  • Config — șirul de configurație al dispozitivului
Funcții suplimentare

Moes ZTS-EU acceptă și controlul modului LED-ului indicator (oprit, urmează starea întrerupătorului, arată poziția, înghețat) și configurarea comportamentului la pornire (oprit, pornit, starea anterioară). Aceste funcții sunt disponibile în Zigbee2MQTT, dar în prezent nu sunt mapate în șablonul TapHome.

Rezolvarea problemelor

Întrerupătorul nu răspunde la comenzile TapHome
  1. Verificați dacă Device ID-ul din șablon corespunde adresei scurte Zigbee atribuite la împerechere
  2. Verificați dacă numele gateway-ului este același în șablonul gateway-ului și în acest șablon de dispozitiv
  3. Testați butonul tactil fizic — dacă acesta comută releul, dar TapHome nu se actualizează, problema poate fi pe calea de citire (topicul SENSOR)
  4. Verificați în consola Tasmota mesajele ZbReceived la comutarea întrerupătorului
Starea întrerupătorului nu este sincronizată
  1. Dacă TapHome afișează o altă stare a întrerupătorului decât poziția reală a releului, apăsați butonul fizic pentru a declanșa raportarea stării
  2. Șablonul nu interoghează activ starea întrerupătorului — se bazează pe raportarea schimbărilor de către dispozitiv. Dacă întrerupătorul pierde pentru scurt timp conectivitatea, starea poate rămâne neactualizată până la următoarea comutare fizică
Comportamentul LED-ului indicator

LED-ul indicator de pe panoul întrerupătorului este controlat de firmware-ul Tuya. Implicit, acesta poate urma starea întrerupătorului sau poate rămâne stins. Șablonul TapHome nu controlează indicatorul — dacă este necesar, folosiți Zigbee2MQTT sau aplicația Tuya pentru a schimba modul indicatorului.

Cum se instalează în TapHome

Cerințe preliminare

  • Gateway Zigbee cu firmware Tasmota (de ex. Sonoff ZBBridge, eWeLink ZB-GW03)
  • Broker MQTT care rulează în rețeaua dvs. locală (brokerul integrat TapHome sau unul extern)
  • TapHome CCU în aceeași rețea

TapHome are un broker MQTT integrat — activați-l în Setări → Hardware → MQTT Broker. Nu este necesar niciun software suplimentar.

Pasul 1 — Configurați gateway-ul Zigbee Tasmota

  1. Încărcați firmware-ul Tasmota pe un coordonator Zigbee acceptat (de ex. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Conectați gateway-ul la rețeaua dvs. Wi-Fi prin interfața web Tasmota
  3. Accesați Configuration → Configure MQTT și setați:
    • Host: adresa IP a brokerului dvs. MQTT (de ex. 192.168.1.10)
    • Port: 1883
    • Topic: notați numele topicului (de ex. tasmota_XXXXX) — veți avea nevoie de el la importul șablonului

Pentru instrucțiuni detaliate, consultați documentația Tasmota Zigbee.

Pasul 2 — Importați șablonul gateway-ului în TapHome

  1. Descărcați șablonul gateway-ului de pe pagina de compatibilitate Zigbee2Tasmota Gateway
  2. În TapHome, accesați Setări → Hardware → Packet Parser → Import
  3. Importați șablonul cu acești parametri:
    • MQTT Broker IP Address: adresa IP a brokerului dvs. (de ex. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: topicul MQTT Tasmota de la pasul 1 (de ex. tasmota_XXXXX)

După import veți vedea două dispozitive: Permit Join (comutator) și Dispozitive găsite (contor).

Pasul 3 — Împerecheați un dispozitiv Zigbee

  1. În TapHome, porniți comutatorul Permit Join — se deschide o fereastră de împerechere de 60 de secunde
  2. Pe dispozitivul Zigbee, porniți procedura de împerechere (de obicei țineți apăsat butonul de resetare 5 secunde, până când LED-ul clipește)
  3. Urmăriți contorul Dispozitive găsite — crește când se conectează un dispozitiv nou
  4. Verificați atributele de service ale gateway-ului pentru a vedea ID-ul noului dispozitiv (de ex. 0x1234), producătorul și modelul
  5. Modul de împerechere se dezactivează automat după expirarea timpului

Pasul 4 — Importați șablonul dispozitivului

  1. Descărcați șablonul specific dispozitivului de pe pagina de compatibilitate corespunzătoare
  2. Importați șablonul cu acești parametri:
    • MQTT Broker IP Address: aceeași ca la gateway
    • MQTT Broker Port: 1883
    • Gateway name: același topic MQTT Tasmota ca mai sus
    • Device ID: adresa scurtă de la împerechere (de ex. 0x1234)

Dispozitive disponibile

Moes Smart Switch Modul
Atribute de service
Adresă IEEEAdresa IEEE Zigbee (identificator unic de 64 de biți)
ID modelIdentificatorul de model Zigbee raportat de dispozitiv
ProducătorȘirul cu numele producătorului Zigbee raportat de dispozitiv
EndpointuriEndpointuri Zigbee active pe dispozitiv
ConfigȘirul de configurație Zigbee al dispozitivului
Variabile personalizate
GWname (string)Numele topicului MQTT Tasmota al gateway-ului Zigbee (se găsește în Configuration → MQTT → Topic)
ID (string)Adresa scurtă Zigbee a întrerupătorului Moes Smart Switch (atribuită la împerechere)
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

Ascultător
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
Atribute de service
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Comutator Comutator

Releu de pornire/oprire controlat prin comanda ZbSend Power

boolean
Valori / Stări: ON · OFF

Comutator

Scrierea stării comutatorului
MQTTPUBLISH("cmnd/" + GWname+ "/ZbSend", 
    "{\"device\":\" " + ID + 
    "\",\"send\":{\"Power\":" + St + "}}")
Ascultător
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
Conexiune: Packet Parser → MQTT
Îmbunătățiri posibile (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

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.

Verificat de TapHome

Doriți să folosiți acest șablon în TapHome Core?

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.

Deschideți în portal