--- title: "Moes Smart Switch" description: "Interruttore a parete Zigbee Moes (serie ZTS-EU) integrato con TapHome tramite MQTT attraverso gateway Zigbee2Tasmota. Pannello touch con controllo on/off." url: "https://taphome.com/it/compatibility/zigbee2tasmota-moes-smart-switch/" language: it lastmod: 2026-03-29 generator: hugo ai: topics: ["mqtt","zigbee","smart-plug","tasmota","switch","wall-switch"] questions: ["Come integrare un interruttore Zigbee Moes con TapHome?","Come controllare un interruttore a parete Moes da TapHome?","Come accoppiare un Moes smart switch con Zigbee2Tasmota?","TapHome può controllare interruttori a parete Tuya Zigbee?","Qual è la differenza tra interruttori Zigbee Moes e Aqara?","Come configurare un interruttore touch in vetro Moes in TapHome?"] --- # Moes Smart Switch Comunicazione: Packet Parser → MQTT - [Moes ZTS-EU — Zigbee2MQTT](https://www.zigbee2mqtt.io/devices/ZTS-EU_1gang.html) - [Moes ZTS-EU1-W — Database Zigbee Blakadder](https://zigbee.blakadder.com/Moes_ZTS-EU1-W.html) > Indirizzo di rete > > Con il broker MQTT integrato in TapHome, inserisci `127.0.0.1` come indirizzo del broker in TapHome. Nel dispositivo inserisci l’indirizzo IP del TapHome Core e assegna al Core una prenotazione IP nel router. > > [Preparazione della rete](https://taphome.com/it/docs/setup/network-preparation/) ## Guida all'integrazione > [!IMPORTANT] > Questo dispositivo comunica tramite **Zigbee** attraverso un gateway Tasmota. Assicurati di aver importato il template [Zigbee2Tasmota Gateway](https://taphome.com/it/compatibility/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](https://taphome.com/it/compatibility/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: | Parametro | Descrizione | Esempio | |-----------|-------------|---------| | **MQTT Broker IP Address** | Indirizzo IP del broker MQTT | `192.168.1.10` | | **MQTT Broker Port** | Porta del broker (predefinita 1883) | `1883` | | **Gateway name** | Topic MQTT Tasmota (uguale al template gateway) | `tasmota_XXXXX` | | **Device ID** | Indirizzo breve Zigbee dall'accoppiamento | `0x1234` | 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 > [!TIP] > 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](https://tasmota.github.io/docs/Getting-Started/) 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:** per il broker integrato, l'indirizzo IP del TapHome Core (con una prenotazione IP nel router → [Preparazione della rete](https://taphome.com/it/docs/setup/network-preparation/)), altrimenti l'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](https://tasmota.github.io/docs/Zigbee/). ### Passaggio 2 — Importare il template del gateway in TapHome 1. Scarica il template del gateway dalla pagina di compatibilità [Zigbee2Tasmota Gateway](https://taphome.com/it/compatibility/zigbee2tasmota-gateway/) 2. In TapHome, vai su **Impostazioni** → **Hardware** → **Packet Parser** → **Import** 3. Importa il template con questi parametri: - **MQTT Broker IP Address:** `127.0.0.1` per il broker integrato di TapHome, altrimenti l'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 1 Questi dispositivi compaiono in TapHome dopo l'importazione. Moes Smart Switch Modulo Attributi di servizio | | | |--------------|---------------------------------------------------------| | IEEE Address | Indirizzo IEEE Zigbee (identificatore univoco a 64 bit) | | Model ID | Identificatore modello Zigbee riportato dal dispositivo | | Manufacturer | Stringa del produttore Zigbee riportata dal dispositivo | | Endpoints | Endpoint Zigbee attivi sul dispositivo | | Config | Stringa di configurazione del dispositivo Zigbee | Variabili personalizzate `GWname` (string) Nome del topic MQTT Tasmota del gateway Zigbee (in Configuration → MQTT → Topic) `ID` (string) Indirizzo breve Zigbee del Moes Smart Switch (assegnato durante il 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 Listener ```taphome 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 ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID) ``` ModelId ``` ``` Manufacturer ``` ``` Endpoints ``` ``` Config ``` ``` Interruttore Interruttore Lettura e scrittura Relè on/off controllato tramite comando ZbSend Power boolean Valori / Stati: ON · OFF Scrittura stato interruttore ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbSend", "{\"device\":\" " + ID + "\",\"send\":{\"Power\":" + St + "}}") ``` Listener ```taphome 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 ## Parametri di importazione Inserisci questi valori quando importi l'XML. | Richiesto nell'app | Predefinito | |-------------------------------------------------------------|-----------------| | Mqtt Broker Indirizzo IP | `192.168.0.1` | | Mqtt Broker port | `1883` | | Gateway name (Tasmota->Configuration->MQTT->Topic) | `tasmota_XXXXX` | | Device ID | `0xFFFF` | ## Fonti - Tasmota Zigbee Documentation [tasmota.github.io](https://tasmota.github.io/docs/Zigbee/) - Zigbee Compatible Devices Database - Moes ZTS-EU1-W — Blakadder Zigbee Database [zigbee.blakadder.com](https://zigbee.blakadder.com/Moes_ZTS-EU1-W.html) 2026-03-29 - Moes ZTS-EU\_1gang — Zigbee2MQTT Device Page [www.zigbee2mqtt.io](https://www.zigbee2mqtt.io/devices/ZTS-EU_1gang.html) 2026-03-29 ## Documentazione correlata - [MQTT Integration](https://taphome.com/it/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/it/docs/integration/packet-parser/) - [Funzioni Packet parser](https://taphome.com/it/docs/script/packet-parser/) - [Funzioni di parsing](https://taphome.com/it/docs/script/parsing-functions/) - [Broker MQTT](https://taphome.com/it/docs/integration/packet-parser/mqtt-broker/) - [Script listener](https://taphome.com/it/docs/script/listener-scripts/)