TapHome

Aqara Single Switch Module T1 (With Neutral)

Packet Parser → MQTT
Přidal
Poslední aktualizace: 03. 2026

Vyžaduje externí bránu

tasmota zigbee2tasmota-gateway — stránka produktu

Aqara Single Switch Module T1 (With Neutral)

Toto zařízení komunikuje přes Zigbee prostřednictvím Tasmota gateway. Ujistěte se, že máte importovanou šablonu Zigbee2Tasmota Gateway a zařízení spárované, než budete pokračovat.

Aqara Single Switch Module T1 (With Neutral) je kompaktní reléový modul Zigbee 3.0 (model SSM-U01) určený k instalaci za vypínač. Přemění tradiční nástěnný vypínač na chytrý spínač při zachování původního krytu vypínače. TapHome ovládá relé přes MQTT prostřednictvím Zigbee2Tasmota gateway pomocí příkazů ZbSend — bez nutnosti cloudového připojení.

Modul vyžaduje nulový vodič a podporuje zátěže od 3 W do 2500 W (10 A odporová zátěž) při 100 – 250 VAC. Kompaktní rozměry (42,9 x 40 x 19,9 mm) umožňují instalaci do většiny instalačních krabic.

Jako zařízení napájené ze sítě modul funguje jako Zigbee router — posiluje Zigbee mesh síť a rozšiřuje dosah pro blízké bateriově napájené senzory.

Konfigurace

Párování modulu
  1. Ujistěte se, že Zigbee2Tasmota Gateway je nastaven a přepínač Permit Join je v TapHome zapnutý
  2. Na modulu dlouze stiskněte tlačítko, dokud modrá LED nezačne rychle blikat, poté uvolněte
  3. Počkejte, až se počítadlo Devices Found zvýší — Device ID modulu (např. 0x1234) se zobrazí v atributech služby gateway
  4. Importujte šablonu tohoto zařízení pomocí Device ID z párování
Parametry importu šablony

Šablona zařízení vyžaduje 4 parametry:

ParametrPopisPříklad
MQTT Broker IP AddressIP adresa MQTT brokeru192.168.1.10
MQTT Broker PortPort brokeru (výchozí 1883)1883
Gateway nameMQTT topic Tasmota (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDKrátká Zigbee adresa z párování0x1234

Po importu se v TapHome objeví jedno zařízení Spínač pro ovládání zapnutí/vypnutí.

Zapojení

Modul vyžaduje připojení nulového vodiče se třemi svorkami:

SvorkaPřipojení
LVstup fázového vodiče (linka)
NNulový vodič
L1Výstup zátěže (světlo nebo spotřebič)

Tento modul vyžaduje nulový vodič. Nelze jej instalovat do krabic, kde jsou pouze fázový a spínaný vodič. Maximální zátěž je 10 A / 2500 W pro odporové zátěže, minimální zátěž je 3 W. Instalaci musí provést kvalifikovaný elektrikář.

Možnosti zařízení

Ovládání spínače

Šablona vytvoří jedno zařízení Spínač, které čte a zapisuje pole Power:

  • Čtení: Modul naslouchá na topicu tele/{GWname}/SENSOR zprávám ZbReceived.{ID}.Power. Při stisknutí fyzického tlačítka nebo změně stavu relé modul publikuje svůj nový stav.
  • Zápis: TapHome odešle příkaz ZbSend na cmnd/{GWname}/ZbSend s Power: true (ZAP) nebo Power: false (VYP) pro vzdálené ovládání relé.

Spínač reaguje na fyzické stisknutí tlačítka i na příkazy z TapHome a TapHome vždy zobrazuje aktuální stav relé — bez ohledu na to, jak bylo přepnuto.

Atributy služby

Modul poskytuje diagnostická Zigbee metadata získaná prostřednictvím pollingu ZbInfo:

AtributPopis
IEEEAddrUnikátní 64bitový hardwarový identifikátor
ModelIdZigbee model ID (lumi.switch.n0agl1)
ManufacturerŘetězec výrobce hlášený zařízením
EndpointsAktivní Zigbee endpointy
ConfigKonfigurace Zigbee zařízení
Další možnosti

Aqara SSM-U01 také podporuje monitorování výkonu v reálném čase (watty), sledování kumulativní spotřeby energie, hlášení interní teploty zařízení, odpojený režim (tlačítko může spouštět scény bez spínání relé) a ochranu proti přetížení/přehřátí. Tyto funkce jsou dostupné v hardwaru, ale momentálně nejsou mapovány v šabloně TapHome — mohou být přidány v budoucí aktualizaci šablony.

Řešení problémů

Spínač nereaguje na příkazy z TapHome
  1. Ověřte, zda Device ID v šabloně odpovídá krátké Zigbee adrese přiřazené během párování (např. 0xC0B4)
  2. Zkontrolujte, zda se Gateway name shoduje mezi šablonou gateway a šablonou tohoto zařízení
  3. Otestujte fyzické tlačítko na modulu — pokud přepíná relé, ale TapHome se neaktualizuje, problém může být v cestě čtení (topic tele/{GWname}/SENSOR)
  4. Pomocí MQTT klienta (např. MQTT Explorer) se přihlaste k topicu tele/{GWname}/SENSOR a ověřte, zda modul publikuje zprávy ZbReceived s polem Power při přepnutí
Stav spínače není synchronizovaný
  1. Pokud TapHome zobrazuje jiný stav než skutečné relé, stiskněte fyzické tlačítko pro vyvolání hlášení stavu
  2. Šablona aktivně nepoluje stav spínače — spoléhá se na hlášení změn zařízením. Pokud modul krátkodobě ztratí Zigbee konektivitu, stav může být neaktuální do dalšího fyzického přepnutí nebo příkazu
Modul se nepáruje
  1. Ujistěte se, že modul je napájen (nulový vodič i fázový vodič musí být připojeny)
  2. Dlouze stiskněte tlačítko, dokud modrá LED nezačne rychle blikat — krátké stisknutí nespustí párovací režim
  3. Během prvního párování přibližte gateway, pokud je modul daleko od koordinátoru
  4. Pokud byl modul dříve spárován s jiným Zigbee koordinátorem, může být nutný reset do továrního nastavení — držte tlačítko 10+ sekund, dokud LED třikrát blikne

Jak nainstalovat v TapHome

Předpoklady

  • Zigbee brána s firmwarem Tasmota (např. Sonoff ZBBridge, eWeLink ZB-GW03)
  • MQTT broker běžící ve vaší lokální síti (vestavěný TapHome broker nebo externí)
  • TapHome CCU ve stejné síti

TapHome má vestavěný MQTT broker — aktivujte ho v Nastavení → Hardware → MQTT Broker. Není potřeba žádný další software.

Krok 1 — Nastavte Tasmota Zigbee bránu

  1. Nahrajte firmware Tasmota na podporovaný Zigbee koordinátor (např. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Připojte bránu k vaší Wi-Fi síti přes webové rozhraní Tasmota
  3. Přejděte na Configuration → Configure MQTT a nastavte:
    • Host: IP adresa vašeho MQTT brokeru (např. 192.168.1.10)
    • Port: 1883
    • Topic: zapište si název topicu (např. tasmota_XXXXX) — budete ho potřebovat při importu šablony

Podrobné pokyny naleznete v dokumentaci Tasmota Zigbee.

Krok 2 — Importujte šablonu brány v TapHome

  1. Stáhněte si šablonu brány ze stránky kompatibility Zigbee2Tasmota Gateway
  2. V TapHome přejděte na Nastavení → Hardware → Packet Parser → Import
  3. Importujte šablonu s těmito parametry:
    • MQTT Broker IP Address: IP adresa vašeho brokeru (např. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: Tasmota MQTT topic z kroku 1 (např. tasmota_XXXXX)

Po importu uvidíte dvě zařízení: Permit Join (přepínač) a Devices Found (počítadlo).

Krok 3 — Spárujte Zigbee zařízení

  1. V TapHome zapněte přepínač Permit Join — otevře se 60sekundové okno pro párování
  2. Na Zigbee zařízení spusťte proces párování (typicky podržte tlačítko reset 5 sekund, dokud LED nezačne blikat)
  3. Sledujte počítadlo Devices Found — zvýší se, když se připojí nové zařízení
  4. Zkontrolujte Service Attributes brány, kde uvidíte ID nového zařízení (např. 0x1234), výrobce a model
  5. Režim párování se automaticky deaktivuje po uplynutí časového limitu

Krok 4 — Importujte šablonu zařízení

  1. Stáhněte si šablonu konkrétního zařízení z příslušné stránky kompatibility
  2. Importujte šablonu s těmito parametry:
    • MQTT Broker IP Address: stejná jako pro bránu
    • MQTT Broker Port: 1883
    • Gateway name: stejný Tasmota MQTT topic jako výše
    • Device ID: krátká adresa z párování (např. 0x1234)

Dostupná zařízení

Aqara Single Switch Module T1 (With Neutral) Modul
Servisní atributy
IEEEAddrZigbee IEEE adresa — unikátní 64bitový hardwarový identifikátor
ModelId
Manufacturer
Endpoints
Config
Vlastní proměnné
GWname (string)Název MQTT topicu Tasmota Zigbee gateway (najdete v Configuration → MQTT → Topic)
ID (string) = 0xC0B4Krátká Zigbee adresa Aqara Single Switch Module T1 (přiřazená během párování)
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)

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
Servisní atributy
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Spínač Přepínač

On/off relé ovládané příkazem ZbSend Power — spíná výstup zátěže L1

boolean
Hodnoty / Stavy: ON · OFF

Spínač

Zápis stavu přepínače
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
Připojení: Packet Parser → MQTT
Možná vylepšení (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.

Zdroje