TapHome

Moes Smart Switch

Packet Parser → MQTT
Dodane przez
Ostatnia aktualizacja: 03. 2026

Wymaga zewnętrznej bramki

tasmota zigbee2tasmota-gateway — strona produktu

Moes Smart Switch

To urządzenie komunikuje się przez Zigbee za pośrednictwem bramki Tasmota. Upewnij się, że masz zaimportowany szablon 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 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:

ParametrOpisPrzykład
MQTT Broker IP AddressAdres IP brokera MQTT192.168.1.10
MQTT Broker PortPort brokera (domyślnie 1883)1883
Gateway nameTemat MQTT Tasmota (taki sam jak w szablonie bramki)tasmota_XXXXX
Device IDKrótki adres Zigbee z parowania0x1234

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

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 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: adres IP brokera MQTT (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.

Krok 2 — Importuj szablon bramki w TapHome

  1. Pobierz szablon bramki ze strony kompatybilności Zigbee2Tasmota Gateway
  2. W TapHome przejdź do Ustawienia → Hardware → Packet Parser → Import
  3. Zaimportuj szablon z tymi parametrami:
    • MQTT Broker IP Address: adres IP 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

Moes Smart Switch Moduł
Atrybuty serwisowe
IEEE AddressAdres IEEE Zigbee (64-bitowy unikalny identyfikator)
Model IDIdentyfikator modelu Zigbee zgłaszany przez urządzenie
ManufacturerCiąg znaków producenta Zigbee zgłaszany przez urządzenie
EndpointsAktywne punkty końcowe Zigbee na urządzeniu
ConfigCiąg konfiguracji urządzenia Zigbee
Zmienne niestandardowe
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

Nasłuchiwanie
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
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Przełącznik Przełącznik

Przekaźnik on/off sterowany poleceniem ZbSend Power

boolean
Wartości / Stany: ON · OFF

Przełącznik

Zapis stanu przełącznika
MQTTPUBLISH("cmnd/" + GWname+ "/ZbSend", 
    "{\"device\":\" " + ID + 
    "\",\"send\":{\"Power\":" + St + "}}")
Nasłuchiwanie
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

Źródła