TapHome

Moes Smart Switch

Packet Parser → MQTT
Inviato da
Ultimo aggiornamento: 03. 2026

Richiede gateway esterno

tasmota zigbee2tasmota-gateway — pagina prodotto

Moes Smart Switch

Questo dispositivo comunica tramite Zigbee attraverso un gateway Tasmota. Assicurati di aver importato il template Zigbee2Tasmota Gateway e che il dispositivo sia accoppiato.

Il Moes Smart Switch (serie ZTS-EU) è un interruttore a parete Zigbee con pannello touch in vetro, progettato per l’installazione in stile EU. TapHome lo controlla tramite MQTT attraverso il gateway Zigbee2Tasmota, fornendo la commutazione on/off dei carichi collegati.

Moes fa parte dell’ecosistema Tuya — l’interruttore utilizza un chipset Tuya TS0601 ed è disponibile su moeshouse.com e Aliexpress. La serie ZTS-EU è disponibile nelle varianti a 1, 2 e 3 tasti; questo template supporta il modello a 1 tasto.

Come dispositivo alimentato dalla rete, l’interruttore funziona come router Zigbee — rafforza la rete mesh Zigbee e amplia la copertura per i dispositivi a batteria nelle vicinanze.

Configurazione

Accoppiamento dell’interruttore
  1. Assicurati che il Zigbee2Tasmota Gateway sia configurato e l’interruttore Permit Join sia attivato in TapHome
  2. Tieni premuto il pulsante touch per 10+ secondi (o commuta rapidamente l’interruttore fisico 5 volte) finché il LED indicatore non lampeggia rapidamente
  3. L’interruttore entra in modalità accoppiamento — il LED lampeggia per conferma
  4. Annota il Device ID (es. 0x1234) dagli attributi di servizio del gateway
Parametri di importazione del template

Il template del dispositivo richiede 4 parametri:

ParametroDescrizioneEsempio
MQTT Broker IP AddressIndirizzo IP del broker MQTT192.168.1.10
MQTT Broker PortPorta del broker (predefinita 1883)1883
Gateway nameTopic MQTT Tasmota (uguale al template gateway)tasmota_XXXXX
Device IDIndirizzo breve Zigbee dall’accoppiamento0x1234

Dopo l’importazione, in TapHome appare un dispositivo Interruttore per il controllo on/off.

Funzionalità del dispositivo

Controllo interruttore

Il template crea un dispositivo Interruttore che legge e scrive il campo Power:

  • Lettura: Il modulo ascolta sul topic tele/{GWname}/SENSOR i messaggi ZbReceived.{ID}.Power. Quando premi il pulsante touch fisico, l’interruttore pubblica il suo nuovo stato.
  • Scrittura: TapHome invia un comando ZbSend con Power: true (ON) o Power: false (OFF) per controllare il relè da remoto.

L’interruttore risponde sia ai tocchi fisici che ai comandi TapHome, e TapHome riflette sempre lo stato corrente — indipendentemente da come è stato commutato l’interruttore.

Attributi di servizio

Il modulo espone informazioni diagnostiche tramite attributi di servizio:

  • IEEE Address — Indirizzo IEEE Zigbee (identificatore univoco a 64 bit)
  • Model ID — Identificatore modello Zigbee (tipicamente TS0601)
  • Manufacturer — Stringa del produttore Zigbee
  • Endpoints — Endpoint Zigbee attivi
  • Config — Stringa di configurazione del dispositivo
Funzionalità aggiuntive

Il Moes ZTS-EU supporta anche il controllo della modalità del LED indicatore (spento, segue lo stato dell’interruttore, mostra posizione, congelato) e la configurazione del comportamento all’accensione (spento, acceso, stato precedente). Queste funzionalità sono disponibili in Zigbee2MQTT ma non sono attualmente mappate nel template TapHome.

Risoluzione dei problemi

L’interruttore non risponde ai comandi TapHome
  1. Verifica che il Device ID nel template corrisponda all’indirizzo breve Zigbee assegnato durante l’accoppiamento
  2. Controlla che il nome del gateway corrisponda tra il template gateway e il template di questo dispositivo
  3. Testa il pulsante touch fisico — se commuta il relè ma TapHome non si aggiorna, potrebbe esserci un problema nel percorso di lettura (topic SENSOR)
  4. Controlla nella console Tasmota che appaiano messaggi ZbReceived quando commuti l’interruttore
Stato dell’interruttore non sincronizzato
  1. Se l’interruttore mostra in TapHome uno stato diverso dalla posizione effettiva del relè, premi il pulsante fisico per attivare un rapporto di stato
  2. Il template non interroga attivamente lo stato dell’interruttore — si basa sulle segnalazioni di cambio dal dispositivo. Se l’interruttore perde brevemente la connessione, lo stato potrebbe non essere aggiornato fino alla prossima commutazione fisica
Comportamento del LED indicatore

Il LED indicatore sul pannello dell’interruttore è controllato dal firmware Tuya. Per impostazione predefinita, può seguire lo stato dell’interruttore o rimanere spento. Il template TapHome non controlla l’indicatore — usa Zigbee2MQTT o l’app Tuya per modificare la modalità dell’indicatore.

Come installare in TapHome

Prerequisiti

  • Gateway Zigbee con firmware Tasmota (es. Sonoff ZBBridge, eWeLink ZB-GW03)
  • Broker MQTT in esecuzione nella rete locale (broker integrato TapHome o esterno)
  • TapHome CCU sulla stessa rete

TapHome ha un broker MQTT integrato — attivalo in Impostazioni → Hardware → MQTT Broker. Non è necessario alcun software aggiuntivo.

Passaggio 1 — Configurare il gateway Tasmota Zigbee

  1. Installa il firmware Tasmota su un coordinatore Zigbee supportato (es. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Connetti il gateway alla tua rete Wi-Fi tramite l’interfaccia web Tasmota
  3. Vai su Configuration → Configure MQTT e imposta:
    • Host: indirizzo IP del tuo broker MQTT (es. 192.168.1.10)
    • Port: 1883
    • Topic: annota il nome del topic (es. tasmota_XXXXX) — ti servirà durante l’importazione del template

Per istruzioni dettagliate, consulta la documentazione Tasmota Zigbee.

Passaggio 2 — Importare il template del gateway in TapHome

  1. Scarica il template del gateway dalla pagina di compatibilità Zigbee2Tasmota Gateway
  2. In TapHome, vai su Impostazioni → Hardware → Packet Parser → Import
  3. Importa il template con questi parametri:
    • MQTT Broker IP Address: indirizzo IP del tuo broker (es. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: il topic MQTT Tasmota dal passaggio 1 (es. tasmota_XXXXX)

Dopo l’importazione vedrai due dispositivi: Permit Join (interruttore) e Devices Found (contatore).

Passaggio 3 — Associare un dispositivo Zigbee

  1. In TapHome, attiva l’interruttore Permit Join — si apre una finestra di associazione di 60 secondi
  2. Sul dispositivo Zigbee, avvia la procedura di associazione (tipicamente tieni premuto il pulsante reset per 5 secondi finché il LED non lampeggia)
  3. Osserva il contatore Devices Found — aumenta quando un nuovo dispositivo si connette
  4. Controlla i Service Attributes del gateway per vedere l’ID del nuovo dispositivo (es. 0x1234), il produttore e il modello
  5. La modalità di associazione si disattiva automaticamente allo scadere del timeout

Passaggio 4 — Importare il template del dispositivo

  1. Scarica il template specifico del dispositivo dalla pagina di compatibilità corrispondente
  2. Importa il template con questi parametri:
    • MQTT Broker IP Address: lo stesso del gateway
    • MQTT Broker Port: 1883
    • Gateway name: lo stesso topic MQTT Tasmota di cui sopra
    • Device ID: l’indirizzo breve ottenuto dall’associazione (es. 0x1234)

Dispositivi disponibili

Moes Smart Switch Modulo
Attributi di servizio
IEEE AddressIndirizzo IEEE Zigbee (identificatore univoco a 64 bit)
Model IDIdentificatore modello Zigbee riportato dal dispositivo
ManufacturerStringa del produttore Zigbee riportata dal dispositivo
EndpointsEndpoint Zigbee attivi sul dispositivo
ConfigStringa di configurazione del dispositivo Zigbee
Variabili personalizzate
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
Attributi di servizio
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Interruttore Interruttore

Relè on/off controllato tramite comando ZbSend Power

boolean
Valori / Stati: ON · OFF

Interruttore

Scrittura stato interruttore
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
Connessione: Packet Parser → MQTT
Possibili miglioramenti (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

Fonti