TapHome

Aqara Single Switch Module T1 (With Neutral)

Packet Parser → MQTT
Pridal
Posledná aktualizácia: 03. 2026

Vyžaduje externú bránu

tasmota zigbee2tasmota-gateway — stránka produktu

Aqara Single Switch Module T1 (With Neutral)

Toto zariadenie komunikuje cez Zigbee prostredníctvom Tasmota gateway. Uistite sa, že máte importovanú šablónu Zigbee2Tasmota Gateway a zariadenie spárované skôr, než budete pokračovať.

Aqara Single Switch Module T1 (With Neutral) je kompaktný reléový modul Zigbee 3.0 (model SSM-U01) určený na inštaláciu za vypínač. Premení tradičný nástenný vypínač na inteligentný spínač pri zachovaní pôvodného krytu vypínača. TapHome ovláda relé cez MQTT prostredníctvom Zigbee2Tasmota gateway pomocou príkazov ZbSend — bez potreby cloudového pripojenia.

Modul vyžaduje nulový vodič a podporuje záťaže od 3 W do 2500 W (10 A odporová záťaž) pri 100 – 250 VAC. Kompaktné rozmery (42,9 x 40 x 19,9 mm) umožňujú inštaláciu do väčšiny inštalačných krabíc.

Ako zariadenie napájané zo siete modul funguje ako Zigbee router — posilňuje Zigbee mesh sieť a rozširuje dosah pre blízke batériovo napájané senzory.

Konfigurácia

Párovanie modulu
  1. Uistite sa, že Zigbee2Tasmota Gateway je nastavený a prepínač Permit Join je v TapHome zapnutý
  2. Na module dlho stlačte tlačidlo, kým modrá LED nezačne rýchlo blikať, potom uvoľnite
  3. Počkajte, kým sa počítadlo Devices Found nezvýši — Device ID modulu (napr. 0x1234) sa zobrazí v atribútoch služby gateway
  4. Importujte šablónu tohto zariadenia pomocou Device ID z párovania
Parametre importu šablóny

Šablóna zariadenia vyžaduje 4 parametre:

ParameterPopisPríklad
MQTT Broker IP AddressIP adresa MQTT brokera192.168.1.10
MQTT Broker PortPort brokera (predvolene 1883)1883
Gateway nameMQTT topic Tasmota (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDKrátka Zigbee adresa z párovania0x1234

Po importe sa v TapHome objaví jedno zariadenie Spínač na ovládanie zapnutia/vypnutia.

Zapojenie

Modul vyžaduje pripojenie nulového vodiča s troma svorkami:

SvorkaPripojenie
LVstup fázového vodiča (linka)
NNulový vodič
L1Výstup záťaže (svetlo alebo spotrebič)

Tento modul vyžaduje nulový vodič. Nemožno ho inštalovať do krabíc, kde sú iba fázový a spínaný vodič. Maximálna záťaž je 10 A / 2500 W pre odporové záťaže, minimálna záťaž je 3 W. Inštaláciu musí vykonať kvalifikovaný elektrikár.

Možnosti zariadenia

Ovládanie spínača

Šablóna vytvorí jedno zariadenie Spínač, ktoré číta a zapisuje pole Power:

  • Čítanie: Modul počúva na topicu tele/{GWname}/SENSOR správy ZbReceived.{ID}.Power. Pri stlačení fyzického tlačidla alebo zmene stavu relé modul publikuje svoj nový stav.
  • Zápis: TapHome odošle príkaz ZbSend na cmnd/{GWname}/ZbSend s Power: true (ZAP) alebo Power: false (VYP) na diaľkové ovládanie relé.

Spínač reaguje na fyzické stlačenie tlačidla aj na príkazy z TapHome a TapHome vždy zobrazuje aktuálny stav relé — bez ohľadu na to, ako bolo prepnuté.

Atribúty služby

Modul poskytuje diagnostické Zigbee metadáta získané prostredníctvom pollingu ZbInfo:

AtribútPopis
IEEEAddrUnikátny 64-bitový hardvérový identifikátor
ModelIdZigbee model ID (lumi.switch.n0agl1)
ManufacturerReťazec výrobcu hlásený zariadením
EndpointsAktívne Zigbee endpointy
ConfigKonfigurácia Zigbee zariadenia
Ďalšie možnosti

Aqara SSM-U01 tiež podporuje monitorovanie výkonu v reálnom čase (watty), sledovanie kumulatívnej spotreby energie, hlásenie internej teploty zariadenia, odpojený režim (tlačidlo môže spúšťať scény bez spínania relé) a ochranu proti preťaženiu/prehriatiu. Tieto funkcie sú dostupné v hardvéri, ale momentálne nie sú mapované v šablóne TapHome — môžu byť pridané v budúcej aktualizácii šablóny.

Riešenie problémov

Spínač nereaguje na príkazy z TapHome
  1. Overte, či Device ID v šablóne zodpovedá krátkej Zigbee adrese priradenej počas párovania (napr. 0xC0B4)
  2. Skontrolujte, či sa Gateway name zhoduje medzi šablónou gateway a šablónou tohto zariadenia
  3. Otestujte fyzické tlačidlo na module — ak prepína relé, ale TapHome sa neaktualizuje, problém môže byť v ceste čítania (topic tele/{GWname}/SENSOR)
  4. Pomocou MQTT klienta (napr. MQTT Explorer) sa prihláste na topic tele/{GWname}/SENSOR a overte, či modul publikuje správy ZbReceived s poľom Power pri prepnutí
Stav spínača nie je synchronizovaný
  1. Ak TapHome zobrazuje iný stav ako skutočné relé, stlačte fyzické tlačidlo na vyvolanie hlásenia stavu
  2. Šablóna aktívne nepoluje stav spínača — spolieha sa na hlásenie zmien zariadením. Ak modul krátkodobo stratí Zigbee konektivitu, stav môže byť neaktuálny do ďalšieho fyzického prepnutia alebo príkazu
Modul sa nepáruje
  1. Uistite sa, že modul je napájaný (nulový vodič aj fázový vodič musia byť pripojené)
  2. Dlho stlačte tlačidlo, kým modrá LED nezačne rýchlo blikať — krátke stlačenie nespustí párovací režim
  3. Počas prvého párovania priblížte gateway, ak je modul ďaleko od koordinátora
  4. Ak bol modul predtým spárovaný s iným Zigbee koordinátorom, môže byť potrebný reset na výrobné nastavenia — držte tlačidlo 10+ sekúnd, kým LED trikrát blikne

Ako nainštalovať v TapHome

Predpoklady

  • Zigbee brána s firmvérom Tasmota (napr. Sonoff ZBBridge, eWeLink ZB-GW03)
  • MQTT broker bežiaci vo vašej lokálnej sieti (vstavaný TapHome broker alebo externý)
  • TapHome CCU v rovnakej sieti

TapHome má vstavaný MQTT broker — aktivujte ho v Nastavenia → Hardware → MQTT Broker. Nie je potrebný žiadny ďalší softvér.

Krok 1 — Nastavte Tasmota Zigbee bránu

  1. Nahrajte firmvér Tasmota na podporovaný Zigbee koordinátor (napr. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Pripojte bránu k vašej Wi-Fi sieti cez webové rozhranie Tasmota
  3. Prejdite na Configuration → Configure MQTT a nastavte:
    • Host: IP adresa vášho MQTT brokera (napr. 192.168.1.10)
    • Port: 1883
    • Topic: zapíšte si názov topicu (napr. tasmota_XXXXX) — budete ho potrebovať pri importe šablóny

Podrobné pokyny nájdete v dokumentácii Tasmota Zigbee.

Krok 2 — Importujte šablónu brány v TapHome

  1. Stiahnite si šablónu brány zo stránky kompatibility Zigbee2Tasmota Gateway
  2. V TapHome prejdite na Nastavenia → Hardware → Packet Parser → Import
  3. Importujte šablónu s týmito parametrami:
    • MQTT Broker IP Address: IP adresa vášho brokera (napr. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: Tasmota MQTT topic z kroku 1 (napr. tasmota_XXXXX)

Po importe uvidíte dve zariadenia: Permit Join (prepínač) a Devices Found (počítadlo).

Krok 3 — Spárujte Zigbee zariadenie

  1. V TapHome zapnite prepínač Permit Join — otvorí sa 60-sekundové okno pre párovanie
  2. Na Zigbee zariadení spustite proces párovania (zvyčajne podržte tlačidlo reset 5 sekúnd, kým LED nezačne blikať)
  3. Sledujte počítadlo Devices Found — zvýši sa, keď sa pripojí nové zariadenie
  4. Skontrolujte Service Attributes brány, kde uvidíte ID nového zariadenia (napr. 0x1234), výrobcu a model
  5. Režim párovania sa automaticky deaktivuje po uplynutí časového limitu

Krok 4 — Importujte šablónu zariadenia

  1. Stiahnite si šablónu konkrétneho zariadenia z príslušnej stránky kompatibility
  2. Importujte šablónu s týmito parametrami:
    • MQTT Broker IP Address: rovnaká ako pre bránu
    • MQTT Broker Port: 1883
    • Gateway name: rovnaký Tasmota MQTT topic ako vyššie
    • Device ID: krátka adresa z párovania (napr. 0x1234)

Dostupné zariadenia

Aqara Single Switch Module T1 (With Neutral) Modul
Servisné atribúty
IEEEAddrZigbee IEEE adresa — unikátny 64-bitový hardvérový identifikátor
ModelId
Manufacturer
Endpoints
Config
Vlastné premenné
GWname (string)Názov MQTT topicu Tasmota Zigbee gateway (nájdete v Configuration → MQTT → Topic)
ID (string) = 0xC0B4Krátka Zigbee adresa Aqara Single Switch Module T1 (priradená počas párovania)
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é atribúty
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Spínač Prepínač

On/off relé ovládané príkazom ZbSend Power — spína výstup záťaže L1

boolean
Hodnoty / Stavy: ON · OFF

Spínač

Zápis stavu prepínača
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
Pripojenie: Packet Parser → MQTT
Možné vylepšenia (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