--- title: "Moes Smart Switch" description: "Moes Zigbee przełącznik ścienny (seria ZTS-EU) zintegrowany z TapHome przez MQTT za pośrednictwem bramki Zigbee2Tasmota. Panel dotykowy z on/off." url: "https://taphome.com/pl/compatibility/zigbee2tasmota-moes-smart-switch/" language: pl lastmod: 2026-03-29 generator: hugo ai: topics: ["mqtt","zigbee","smart-plug","tasmota","switch","wall-switch"] questions: ["Jak zintegrować przełącznik Zigbee Moes z TapHome?","Jak sterować przełącznikiem ściennym Moes z TapHome?","Jak sparować Moes smart switch z Zigbee2Tasmota?","Czy TapHome może sterować przełącznikami ściennymi Tuya Zigbee?","Jaka jest różnica między przełącznikami Zigbee Moes a Aqara?","Jak skonfigurować szklany przełącznik dotykowy Moes w TapHome?"] --- # Moes Smart Switch Komunikacja: Packet Parser → MQTT - [Moes ZTS-EU — Zigbee2MQTT](https://www.zigbee2mqtt.io/devices/ZTS-EU_1gang.html) - [Moes ZTS-EU1-W — Baza Zigbee Blakadder](https://zigbee.blakadder.com/Moes_ZTS-EU1-W.html) > Adres w sieci > > Przy brokerze MQTT wbudowanym w TapHome wpisz w TapHome jako adres brokera `127.0.0.1`. W urządzeniu wpisz adres IP TapHome Core i nadaj jednostce Core rezerwację IP w routerze. > > [Przygotowanie sieci](https://taphome.com/pl/docs/setup/network-preparation/) ## Poradnik integracji > [!IMPORTANT] > To urządzenie komunikuje się przez **Zigbee** za pośrednictwem bramki Tasmota. Upewnij się, że masz zaimportowany szablon [Zigbee2Tasmota Gateway](https://taphome.com/pl/compatibility/zigbee2tasmota-gateway/) i Twoje urządzenie jest sparowane. Moes Smart Switch (seria ZTS-EU) to przełącznik ścienny Zigbee z panelem dotykowym ze szkła, zaprojektowany do instalacji w stylu EU. TapHome steruje nim przez MQTT za pośrednictwem bramki Zigbee2Tasmota, zapewniając włączanie/wyłączanie podłączonych obciążeń. Moes jest częścią ekosystemu Tuya — przełącznik wykorzystuje chipset Tuya TS0601 i jest dostępny na moeshouse.com oraz Aliexpress. Seria ZTS-EU jest dostępna w wariantach 1, 2 i 3-klawiszowych; ten szablon obsługuje model 1-klawiszowy. Jako urządzenie zasilane z sieci, przełącznik działa jako **router Zigbee** — wzmacnia sieć mesh Zigbee i rozszerza zasięg dla pobliskich urządzeń bateryjnych. ## Konfiguracja ### Parowanie przełącznika 1. Upewnij się, że [Zigbee2Tasmota Gateway](https://taphome.com/pl/compatibility/zigbee2tasmota-gateway/) jest skonfigurowany, a przełącznik **Permit Join** jest włączony w TapHome 2. **Przytrzymaj przycisk dotykowy przez 10+ sekund** (lub szybko przełącz fizyczny przełącznik 5 razy), aż dioda LED zacznie szybko migać 3. Przełącznik wchodzi w tryb parowania — dioda LED miga na potwierdzenie 4. Zanotuj **Device ID** (np. `0x1234`) z atrybutów serwisowych bramki ### Parametry importu szablonu Szablon urządzenia wymaga 4 parametrów: | Parametr | Opis | Przykład | |----------|------|---------| | **MQTT Broker IP Address** | Adres IP brokera MQTT | `192.168.1.10` | | **MQTT Broker Port** | Port brokera (domyślnie 1883) | `1883` | | **Gateway name** | Temat MQTT Tasmota (taki sam jak w szablonie bramki) | `tasmota_XXXXX` | | **Device ID** | Krótki adres Zigbee z parowania | `0x1234` | Po imporcie w TapHome pojawi się jedno urządzenie Przełącznik do sterowania włączaniem/wyłączaniem. ## Możliwości urządzenia ### Sterowanie przełącznikiem Szablon tworzy jedno urządzenie Przełącznik, które odczytuje i zapisuje pole `Power`: - **Odczyt:** Moduł nasłuchuje na temacie `tele/{GWname}/SENSOR` wiadomości `ZbReceived.{ID}.Power`. Gdy naciśniesz fizyczny przycisk dotykowy, przełącznik publikuje swój nowy stan. - **Zapis:** TapHome wysyła polecenie `ZbSend` z `Power: true` (WŁ) lub `Power: false` (WYŁ), aby zdalnie sterować przekaźnikiem. Przełącznik reaguje zarówno na fizyczne dotknięcia, jak i na polecenia TapHome, a TapHome zawsze odzwierciedla aktualny stan — niezależnie od tego, jak przełącznik został przełączony. ### Atrybuty serwisowe Moduł udostępnia informacje diagnostyczne poprzez atrybuty serwisowe: - **IEEE Address** — Adres IEEE Zigbee (64-bitowy unikalny identyfikator) - **Model ID** — Identyfikator modelu Zigbee (zwykle `TS0601`) - **Manufacturer** — Ciąg znaków producenta Zigbee - **Endpoints** — Aktywne punkty końcowe Zigbee - **Config** — Ciąg konfiguracji urządzenia ### Dodatkowe możliwości Moes ZTS-EU obsługuje również sterowanie trybem diody LED wskaźnika (wyłączona, podąża za stanem przełącznika, pokazuje pozycję, zamrożona) oraz konfigurację zachowania po włączeniu zasilania (wyłączony, włączony, poprzedni stan). Te funkcje są dostępne w Zigbee2MQTT, ale nie są obecnie zmapowane w szablonie TapHome. ## Rozwiązywanie problemów ### Przełącznik nie reaguje na polecenia TapHome 1. Sprawdź, czy Device ID w szablonie odpowiada krótkiemu adresowi Zigbee przydzielonemu podczas parowania 2. Upewnij się, że nazwa bramki jest spójna między szablonem bramki a szablonem tego urządzenia 3. Przetestuj fizyczny przycisk dotykowy — jeśli przełącza przekaźnik, ale TapHome się nie aktualizuje, problem może być w ścieżce odczytu (temat SENSOR) 4. Sprawdź konsolę Tasmota, czy pojawiają się wiadomości `ZbReceived` podczas przełączania ### Stan przełącznika nie jest zsynchronizowany 1. Jeśli przełącznik wyświetla w TapHome inny stan niż rzeczywista pozycja przekaźnika, naciśnij fizyczny przycisk, aby wywołać raport stanu 2. Szablon nie odpytuje aktywnie stanu przełącznika — polega na raportach zmian z urządzenia. Jeśli przełącznik krótko straci połączenie, stan może być nieaktualny do następnego fizycznego przełączenia ### Zachowanie diody LED wskaźnika Dioda LED wskaźnika na panelu przełącznika jest sterowana przez firmware Tuya. Domyślnie może podążać za stanem przełącznika lub pozostawać wyłączona. Szablon TapHome nie steruje wskaźnikiem — użyj Zigbee2MQTT lub aplikacji Tuya, aby zmienić tryb wskaźnika. ## Jak zainstalować w TapHome ### Wymagania wstępne - Bramka Zigbee z oprogramowaniem Tasmota (np. Sonoff ZBBridge, eWeLink ZB-GW03) - Broker MQTT działający w sieci lokalnej (wbudowany broker TapHome lub zewnętrzny) - TapHome CCU w tej samej sieci > [!TIP] > TapHome ma wbudowany broker MQTT — aktywuj go w **Ustawienia** → **Hardware** → **MQTT Broker**. Nie jest potrzebne żadne dodatkowe oprogramowanie. ### Krok 1 — Skonfiguruj bramkę Tasmota Zigbee 1. Wgraj [oprogramowanie Tasmota](https://tasmota.github.io/docs/Getting-Started/) na obsługiwany koordynator Zigbee (np. Sonoff ZBBridge, eWeLink ZB-GW03) 2. Połącz bramkę z siecią Wi-Fi przez interfejs webowy Tasmota 3. Przejdź do **Configuration** → **Configure MQTT** i ustaw: - **Host:** dla wbudowanego brokera adres IP TapHome Core (z rezerwacją IP w routerze → [Przygotowanie sieci](https://taphome.com/pl/docs/setup/network-preparation/)), w przeciwnym razie adres IP Twojego brokera (np. `192.168.1.10`) - **Port:** `1883` - **Topic:** zanotuj nazwę topicu (np. `tasmota_XXXXX`) — będzie potrzebna przy imporcie szablonu Szczegółowe instrukcje znajdziesz w [dokumentacji Tasmota Zigbee](https://tasmota.github.io/docs/Zigbee/). ### Krok 2 — Importuj szablon bramki w TapHome 1. Pobierz szablon bramki ze strony kompatybilności [Zigbee2Tasmota Gateway](https://taphome.com/pl/compatibility/zigbee2tasmota-gateway/) 2. W TapHome przejdź do **Ustawienia** → **Hardware** → **Packet Parser** → **Import** 3. Zaimportuj szablon z tymi parametrami: - **MQTT Broker IP Address:** dla wbudowanego brokera TapHome `127.0.0.1`, w przeciwnym razie adres IP Twojego brokera (np. `192.168.1.10`) - **MQTT Broker Port:** `1883` - **Gateway name:** topic MQTT Tasmota z kroku 1 (np. `tasmota_XXXXX`) Po imporcie zobaczysz dwa urządzenia: **Permit Join** (przełącznik) i **Devices Found** (licznik). ### Krok 3 — Sparuj urządzenie Zigbee 1. W TapHome włącz przełącznik **Permit Join** — otworzy się 60-sekundowe okno parowania 2. Na urządzeniu Zigbee rozpocznij procedurę parowania (zazwyczaj przytrzymaj przycisk reset przez 5 sekund, aż dioda LED zacznie migać) 3. Obserwuj licznik **Devices Found** — zwiększy się, gdy nowe urządzenie się połączy 4. Sprawdź **Service Attributes** bramki, aby zobaczyć ID nowego urządzenia (np. `0x1234`), producenta i model 5. Tryb parowania dezaktywuje się automatycznie po upływie limitu czasu ### Krok 4 — Importuj szablon urządzenia 1. Pobierz szablon konkretnego urządzenia z odpowiedniej strony kompatybilności 2. Zaimportuj szablon z tymi parametrami: - **MQTT Broker IP Address:** ten sam co dla bramki - **MQTT Broker Port:** `1883` - **Gateway name:** ten sam topic MQTT Tasmota co powyżej - **Device ID:** krótki adres z parowania (np. `0x1234`) ## Dostępne urządzenia 1 Te urządzenia pojawią się w TapHome po imporcie. Moes Smart Switch Moduł Atrybuty serwisowe | | | |--------------|----------------------------------------------------------| | IEEE Address | Adres IEEE Zigbee (64-bitowy unikalny identyfikator) | | Model ID | Identyfikator modelu Zigbee zgłaszany przez urządzenie | | Manufacturer | Ciąg znaków producenta Zigbee zgłaszany przez urządzenie | | Endpoints | Aktywne punkty końcowe Zigbee na urządzeniu | | Config | Ciąg konfiguracji urządzenia Zigbee | Zmienne niestandardowe `GWname` (string) Nazwa topicu MQTT Tasmota bramy Zigbee (w Configuration → MQTT → Topic) `ID` (string) Krótki adres Zigbee Moes Smart Switch (przypisany podczas parowania) 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 Nasłuchiwanie ```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 ``` Atrybuty serwisowe IEEEAddr ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID) ``` ModelId ``` ``` Manufacturer ``` ``` Endpoints ``` ``` Config ``` ``` Przełącznik Przełącznik Odczyt i zapis Przekaźnik on/off sterowany poleceniem ZbSend Power boolean Wartości / Stany: ON · OFF Zapis stanu przełącznika ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbSend", "{\"device\":\" " + ID + "\",\"send\":{\"Power\":" + St + "}}") ``` Nasłuchiwanie ```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 ``` **Połączenie:** Packet Parser → MQTT Możliwe ulepszenia (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 ## Parametry importu Te wartości podajesz podczas importu pliku XML. | Pytanie w aplikacji | Domyślnie | |-------------------------------------------------------------|-----------------| | Mqtt Broker Adres IP | `192.168.0.1` | | Mqtt Broker port | `1883` | | Gateway name (Tasmota->Configuration->MQTT->Topic) | `tasmota_XXXXX` | | Device ID | `0xFFFF` | ## Źródła - 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 ## Powiązana dokumentacja - [MQTT Integration](https://taphome.com/pl/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/pl/docs/integration/packet-parser/) - [Funkcje Packet parser](https://taphome.com/pl/docs/script/packet-parser/) - [Funkcje parsowania](https://taphome.com/pl/docs/script/parsing-functions/) - [Broker MQTT](https://taphome.com/pl/docs/integration/packet-parser/mqtt-broker/) - [Skrypty listener](https://taphome.com/pl/docs/script/listener-scripts/)