TapHome

Aqara Single Switch Module T1 (With Neutral)

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

Wymaga zewnętrznej bramki

tasmota zigbee2tasmota-gateway — strona produktu

Aqara Single Switch Module T1 (With Neutral)

To urządzenie komunikuje się przez Zigbee za pośrednictwem bramki Tasmota. Upewnij się, że masz zaimportowany szablon Zigbee2Tasmota Gateway i urządzenie sparowane przed kontynuowaniem.

Aqara Single Switch Module T1 (With Neutral) to kompaktowy moduł przekaźnikowy Zigbee 3.0 (model SSM-U01) przeznaczony do instalacji za przełącznikiem. Zamienia tradycyjny przełącznik ścienny w inteligentny przełącznik, zachowując oryginalną ramkę. TapHome steruje przekaźnikiem przez MQTT za pośrednictwem bramki Zigbee2Tasmota przy użyciu poleceń ZbSend — bez połączenia z chmurą.

Moduł wymaga przewodu neutralnego i obsługuje obciążenia od 3 W do 2500 W (10 A obciążenie rezystancyjne) przy 100 – 250 VAC. Kompaktowe wymiary (42,9 x 40 x 19,9 mm) umożliwiają instalację w większości puszek podtynkowych.

Jako urządzenie zasilane z sieci moduł działa jako router Zigbee — wzmacnia sieć mesh Zigbee i zwiększa zasięg dla pobliskich czujników zasilanych bateryjnie.

Konfiguracja

Parowanie modułu
  1. Upewnij się, że Zigbee2Tasmota Gateway jest skonfigurowany i przełącznik Permit Join jest włączony w TapHome
  2. Na module przytrzymaj przycisk, aż niebieska dioda LED zacznie szybko migać, następnie puść
  3. Poczekaj, aż licznik Devices Found się zwiększy — Device ID modułu (np. 0x1234) pojawi się w atrybutach serwisowych bramki
  4. Zaimportuj szablon tego urządzenia, używając Device ID z parowania
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 (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDKrótki adres Zigbee z parowania0x1234

Po imporcie w TapHome pojawia się jedno urządzenie Przełącznik do sterowania on/off.

Okablowanie

Moduł wymaga podłączenia przewodu neutralnego z trzema zaciskami:

ZaciskPodłączenie
LWejście przewodu fazowego (linia)
NPrzewód neutralny
L1Wyjście obciążenia (oświetlenie lub urządzenie)

Ten moduł wymaga przewodu neutralnego. Nie można go zainstalować w puszkach, w których są tylko przewody fazowy i powrotny. Maksymalne obciążenie to 10 A / 2500 W dla obciążeń rezystancyjnych, minimalne obciążenie to 3 W. Instalacja musi być wykonana przez wykwalifikowanego elektryka.

Funkcje 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. Po naciśnięciu fizycznego przycisku lub zmianie stanu przekaźnika moduł publikuje swój nowy stan.
  • Zapis: TapHome wysyła polecenie ZbSend na cmnd/{GWname}/ZbSend z Power: true (WŁ) lub Power: false (WYŁ) do zdalnego sterowania przekaźnikiem.

Przełącznik reaguje zarówno na naciśnięcie fizycznego przycisku, jak i na polecenia TapHome, a TapHome zawsze odzwierciedla aktualny stan przekaźnika — niezależnie od tego, jak został przełączony.

Atrybuty serwisowe

Moduł udostępnia diagnostyczne metadane Zigbee pobierane przez polling ZbInfo:

AtrybutOpis
IEEEAddrUnikalny 64-bitowy identyfikator sprzętowy
ModelIdZigbee model ID (lumi.switch.n0agl1)
ManufacturerCiąg znaków producenta zgłaszany przez urządzenie
EndpointsAktywne punkty końcowe Zigbee
ConfigKonfiguracja urządzenia Zigbee
Dodatkowe możliwości

Aqara SSM-U01 obsługuje również monitorowanie mocy w czasie rzeczywistym (watty), śledzenie skumulowanego zużycia energii, raportowanie wewnętrznej temperatury urządzenia, tryb odłączony (przycisk może wyzwalać sceny bez przełączania przekaźnika) oraz ochronę przed przeciążeniem/przegrzaniem. Te funkcje są dostępne w sprzęcie, ale obecnie nie są mapowane w szablonie TapHome — mogą zostać dodane w przyszłej aktualizacji szablonu.

Rozwiązywanie problemów

Przełącznik nie reaguje na polecenia TapHome
  1. Sprawdź, czy Device ID w szablonie odpowiada krótkiemu adresowi Zigbee przypisanemu podczas parowania (np. 0xC0B4)
  2. Sprawdź, czy Gateway name jest taki sam w szablonie bramki i szablonie tego urządzenia
  3. Przetestuj fizyczny przycisk na module — jeśli przełącza przekaźnik, ale TapHome się nie aktualizuje, problem może być w ścieżce odczytu (temat tele/{GWname}/SENSOR)
  4. Użyj klienta MQTT (np. MQTT Explorer), zasubskrybuj temat tele/{GWname}/SENSOR i sprawdź, czy moduł publikuje wiadomości ZbReceived z polem Power przy przełączaniu
Stan przełącznika nie jest zsynchronizowany
  1. Jeśli TapHome pokazuje inny stan niż rzeczywisty przekaźnik, naciśnij fizyczny przycisk, aby wywołać raport stanu
  2. Szablon nie odpytuje aktywnie stanu przełącznika — polega na raportach zmian stanu przez urządzenie. Jeśli moduł krótkotrwale straci łączność Zigbee, stan może być nieaktualny do następnego fizycznego przełączenia lub polecenia
Moduł się nie paruje
  1. Upewnij się, że moduł jest zasilany (przewód neutralny i przewód fazowy muszą być podłączone)
  2. Przytrzymaj przycisk, aż niebieska dioda LED zacznie szybko migać — krótkie naciśnięcie nie uruchomi trybu parowania
  3. Podczas pierwszego parowania zbliż bramkę, jeśli moduł jest daleko od koordynatora
  4. Jeśli moduł był wcześniej sparowany z innym koordynatorem Zigbee, może wymagać przywrócenia ustawień fabrycznych — przytrzymaj przycisk przez 10+ sekund, aż dioda LED mignie trzy razy

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

Aqara Single Switch Module T1 (With Neutral) Moduł
Atrybuty serwisowe
IEEEAddrAdres IEEE Zigbee — unikalny 64-bitowy identyfikator sprzętowy
ModelId
Manufacturer
Endpoints
Config
Zmienne niestandardowe
GWname (string)Nazwa tematu MQTT Tasmota bramki Zigbee (w Configuration → MQTT → Topic)
ID (string) = 0xC0B4Krótki adres Zigbee Aqara Single Switch Module T1 (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

Aqara - Single Switch Module T1 (With Neutral)

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 — przełącza wyjście obciążenia L1

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 (5)
  • Power Monitoring — Real-time power measurement in watts — hardware supports it but not mapped in XML template
  • Energy Monitoring — Cumulative energy consumption tracking — available in hardware but not mapped in XML template
  • Device Temperature — Internal temperature sensor — hardware supports it but not mapped in XML template
  • Decoupled Mode — Button can be decoupled from relay for scene triggering — not mapped in XML template
  • Overload / Overheating Protection — Built-in safety features — max 10A / 2500W resistive load. Not exposed in template.

Źródła