TapHome
Oficial · TapHome Verificat Energie și contorizare

Moes Smart Switch

Întrerupător de perete inteligent Moes cu Zigbee, integrat în TapHome printr-un gateway Zigbee2Tasmota. Panou tactil din sticlă pentru pornirea/oprirea releului.

MoesPacket Parser → MQTT1 dispozitivRevizia 1.0 Ultima actualizare: 29 martie 2026
Funcționează pe Core TapHome Next 2026.1.41766
iAm importat acest șablon în acest Core în laboratorul TapHome și toate dispozitivele sale au fost adăugate fără eroare.
Moes Smart Switch

Import în aplicația TapHomeHardware › Packet Parser › Adăugați din șablon

Descărcați șablon
Pe această pagină

Necesită gateway extern

tasmota zigbee2tasmota-gateway — pagina produsului

Adresa în rețea

Pentru brokerul MQTT integrat în TapHome este vorba de un singur broker, accesat din două locuri. Șablonul rulează direct în TapHome Core, de aceea în TapHome adresa brokerului este 127.0.0.1 (acest calculator). Dispozitivul rulează în altă parte a rețelei, de aceea în dispozitiv introduceți adresa IP a unității TapHome Core și atribuiți unității Core o rezervare IP în router — dacă adresa Core se schimbă, dispozitivul nu mai ajunge la broker.

Pregătirea rețelei

Ghid de integrare

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: pentru brokerul integrat, adresa IP a unității TapHome Core (cu rezervare IP în router → Pregătirea rețelei), altfel 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: pentru brokerul integrat TapHome 127.0.0.1, altfel 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 1

Aceste dispozitive apar în TapHome după import.

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 Citire și scriere

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

Parametri de import

Introduceți aceste valori când importați XML-ul.

Solicitat în aplicațieImplicit
Mqtt Broker Adresă IP192.168.0.1
Mqtt Broker port1883
Gateway name (Tasmota->Configuration->MQTT->Topic)tasmota_XXXXX
Device ID0xFFFF

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.

Șablon · portalul TapHome Moes Smart Switch 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. Packet Parser → MQTT Vezi în portalul TapHome