TapHome
Čeština
Slovenčina

Čeština

Magyar Italiano Polski Deutsch Română Hrvatski English
Oficiální · TapHome Ověřená Energie a měření

Aqara Single Switch Module T1 (With Neutral)

Kompaktní Zigbee reléový modul Aqara SSM-U01 integrovaný s TapHome přes MQTT prostřednictvím Zigbee2Tasmota gateway. Spínání zapnutí/vypnutí pro světla a spotřebiče do 2500 W.

AqaraPacket Parser → MQTT1 zařízeníRevize 1.0 Poslední aktualizace: 29. března 2026
Aqara Single Switch Module T1 (With Neutral)

Import do aplikace TapHomeHardware › Packet Parser › Přidat ze šablony

Stáhnout šablonu
Na této stránce

Vyžaduje externí bránu

tasmota zigbee2tasmota-gateway — stránka produktu

Adresa v síti

U MQTT brokeru vestavěného v TapHome zadejte v TapHome jako adresu brokeru 127.0.0.1. V zařízení zadejte IP adresu TapHome Core a jednotce Core dejte rezervaci IP v routeru.

Příprava sítě

Návod na integraci

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: pro vestavěný broker IP adresa TapHome Core (s rezervací IP v routeru → Příprava sítě), jinak IP adresa vašeho 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: pro vestavěný broker TapHome 127.0.0.1, jinak 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í 1

Tato zařízení se po importu zobrazí v TapHome.

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č Čtení i zápis

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.

Parametry importu

Tyto hodnoty zadáte při importu XML.

Ptá se v aplikaciVýchozí
Mqtt Broker IP adresa192.168.0.1
Mqtt Broker port1883
Gateway name (Tasmota->Configuration->MQTT->Topic)tasmota_XXXXX
Device ID0xFFFF

Zdroje

Související dokumentace

Našli jste problém s touto šablonou zařízení?

Napište nám, co nefunguje, co chybí, nebo jak by se měla šablona chovat. Vaše zpětná vazba nám pomáhá udržet katalog přesný.

Šablona · portál TapHome Aqara Single Switch Module T1 (With Neutral) Otevřete tuto šablonu v zákaznickém portálu a použijte ji ve svém domově, nebo navrhněte úpravu a odešlete ji zpět do katalogu. Packet Parser → MQTT Zobrazit v portálu TapHome