TapHome

Aqara Single Switch Module T1 (With Neutral)

Packet Parser → MQTT
Trimis de
Ultima actualizare: 03. 2026

Necesită gateway extern

tasmota zigbee2tasmota-gateway — pagina produsului

Aqara Single Switch Module T1 (With Neutral)

Acest dispozitiv comunică prin Zigbee printr-un gateway Tasmota. Înainte de a continua, asigurați-vă că ați importat șablonul Zigbee2Tasmota Gateway și ați împerecheat dispozitivul.

Aqara Single Switch Module T1 (With Neutral) este un modul releu Zigbee 3.0 compact (model SSM-U01), conceput pentru montarea în spatele întrerupătorului. Transformă un întrerupător de perete clasic într-un întrerupător inteligent, păstrând întrerupătorul original. TapHome controlează releul prin MQTT, printr-un gateway Zigbee2Tasmota, cu comenzi ZbSend — fără conexiune la cloud.

Modulul necesită fir de nul și acceptă sarcini de la 3 W la 2500 W (10 A pentru sarcini rezistive) la 100-250 V AC. Dimensiunile compacte (42,9 x 40 x 19,9 mm) permit montarea în majoritatea dozelor de aparataj.

Fiind alimentat de la rețea, modulul funcționează ca router Zigbee — întărește rețeaua mesh Zigbee și extinde raza de acoperire pentru senzorii cu baterie din apropiere.

Configurare

Împerecherea modulului
  1. Asigurați-vă că Zigbee2Tasmota Gateway este configurat și comutatorul Permit Join este ON în TapHome
  2. Pe modul, țineți apăsat butonul până când LED-ul albastru începe să clipească rapid, apoi eliberați-l
  3. Așteptați până când contorul Dispozitive găsite crește — Device ID-ul modulului (de ex. 0x1234) apare în atributele de service ale gateway-ului
  4. Importați acest șablon de dispozitiv folosind Device ID-ul de la împerechere
Parametrii de import ai șablonului

Șablonul dispozitivului necesită 4 parametri:

ParametruDescriereExemplu
MQTT Broker IP AddressAdresa IP a brokerului dvs. MQTT192.168.1.10
MQTT Broker PortPortul brokerului (implicit 1883)1883
Gateway nameTopicul MQTT Tasmota (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDAdresa scurtă Zigbee de la împerechere0x1234

După import, în TapHome apare un singur dispozitiv Comutator pentru pornire/oprire.

Cablare

Modulul necesită conectarea firului de nul și are trei borne:

BornăConexiune
LIntrare fază (L)
NFir de nul
L1Ieșire spre sarcină (lumină sau aparat)

Acest modul necesită fir de nul. Nu poate fi montat în doze de aparataj în care există doar faza și faza comutată. Sarcina maximă este de 10 A / 2500 W pentru sarcini rezistive, iar sarcina minimă este de 3 W. Montarea trebuie efectuată de un electrician autorizat.

Funcțiile dispozitivului

Controlul comutatorului

Șablonul creează un dispozitiv Comutator care citește și scrie câmpul Power:

  • Citire: Modulul ascultă pe topicul tele/{GWname}/SENSOR mesajele ZbReceived.{ID}.Power. Când se apasă butonul fizic sau starea releului se schimbă, modulul publică noua stare.
  • Scriere: TapHome trimite o comandă ZbSend la cmnd/{GWname}/ZbSend cu Power: true (ON) sau Power: false (OFF), pentru a controla releul de la distanță.

Comutatorul răspunde atât la apăsările butonului fizic, cât și la comenzile TapHome, iar TapHome afișează întotdeauna starea curentă a releului — indiferent de modul în care a fost comutat.

Atribute de service

Modulul pune la dispoziție metadate Zigbee de diagnosticare, obținute prin interogarea ZbInfo:

AtributDescriere
IEEEAddrIdentificator hardware unic de 64 de biți
ModelIdID-ul modelului Zigbee (lumi.switch.n0agl1)
ProducătorȘirul cu numele producătorului raportat de dispozitiv
EndpointuriEndpointuri Zigbee active
ConfigConfigurația Zigbee a dispozitivului
Funcții suplimentare

Aqara SSM-U01 acceptă și monitorizarea puterii în timp real (wați), urmărirea consumului de energie cumulat, raportarea temperaturii interne a dispozitivului, modul decuplat (butonul poate declanșa scene fără a comuta releul) și protecția la suprasarcină/supraîncălzire. Aceste funcții sunt disponibile în hardware, dar în prezent nu sunt mapate în șablonul TapHome — pot fi adăugate într-o actualizare viitoare a șablonului.

Rezolvarea problemelor

Comutatorul nu răspunde la comenzile TapHome
  1. Verificați dacă Device ID-ul din șablon corespunde adresei scurte Zigbee atribuite la împerechere (de ex. 0xC0B4)
  2. Verificați dacă Gateway name este același în șablonul gateway-ului și în acest șablon de dispozitiv
  3. Testați butonul fizic al modulului — dacă acesta comută releul, dar TapHome nu se actualizează, problema poate fi pe calea de citire (topicul tele/{GWname}/SENSOR)
  4. Folosiți un client MQTT (de ex. MQTT Explorer) pentru a vă abona la tele/{GWname}/SENSOR și verificați dacă modulul publică mesaje ZbReceived cu câmpul Power la comutare
Starea comutatorului nu este sincronizată
  1. Dacă TapHome afișează o altă stare decât cea reală a releului, apăsați butonul fizic pentru a declanșa raportarea stării
  2. Șablonul nu interoghează activ starea comutatorului — se bazează pe raportarea schimbărilor de către dispozitiv. Dacă modulul pierde pentru scurt timp conectivitatea Zigbee, starea poate rămâne neactualizată până la următoarea comutare fizică sau comandă
Modulul nu se împerechează
  1. Asigurați-vă că modulul este alimentat (firul de nul și faza trebuie să fie conectate amândouă)
  2. Țineți apăsat butonul până când LED-ul albastru clipește rapid — o apăsare scurtă nu activează modul de împerechere
  3. La prima împerechere, apropiați gateway-ul dacă modulul este departe de coordonator
  4. Dacă modulul a fost împerecheat anterior cu un alt coordonator Zigbee, poate necesita o resetare la setările din fabrică înainte de a se conecta la o rețea nouă — țineți apăsat butonul 10 secunde sau mai mult, până când LED-ul clipește de trei ori

Cum se instalează în TapHome

Cerințe preliminare

  • Gateway Zigbee cu firmware Tasmota (de ex. Sonoff ZBBridge, eWeLink ZB-GW03)
  • Broker MQTT care rulează în rețeaua dvs. locală (brokerul integrat TapHome sau unul extern)
  • TapHome CCU în aceeași rețea

TapHome are un broker MQTT integrat — activați-l în Setări → Hardware → MQTT Broker. Nu este necesar niciun software suplimentar.

Pasul 1 — Configurați gateway-ul Zigbee Tasmota

  1. Încărcați firmware-ul Tasmota pe un coordonator Zigbee acceptat (de ex. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Conectați gateway-ul la rețeaua dvs. Wi-Fi prin interfața web Tasmota
  3. Accesați Configuration → Configure MQTT și setați:
    • Host: adresa IP a brokerului dvs. MQTT (de ex. 192.168.1.10)
    • Port: 1883
    • Topic: notați numele topicului (de ex. tasmota_XXXXX) — veți avea nevoie de el la importul șablonului

Pentru instrucțiuni detaliate, consultați documentația Tasmota Zigbee.

Pasul 2 — Importați șablonul gateway-ului în TapHome

  1. Descărcați șablonul gateway-ului de pe pagina de compatibilitate Zigbee2Tasmota Gateway
  2. În TapHome, accesați Setări → Hardware → Packet Parser → Import
  3. Importați șablonul cu acești parametri:
    • MQTT Broker IP Address: adresa IP a brokerului dvs. (de ex. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: topicul MQTT Tasmota de la pasul 1 (de ex. tasmota_XXXXX)

După import veți vedea două dispozitive: Permit Join (comutator) și Dispozitive găsite (contor).

Pasul 3 — Împerecheați un dispozitiv Zigbee

  1. În TapHome, porniți comutatorul Permit Join — se deschide o fereastră de împerechere de 60 de secunde
  2. Pe dispozitivul Zigbee, porniți procedura de împerechere (de obicei țineți apăsat butonul de resetare 5 secunde, până când LED-ul clipește)
  3. Urmăriți contorul Dispozitive găsite — crește când se conectează un dispozitiv nou
  4. Verificați atributele de service ale gateway-ului pentru a vedea ID-ul noului dispozitiv (de ex. 0x1234), producătorul și modelul
  5. Modul de împerechere se dezactivează automat după expirarea timpului

Pasul 4 — Importați șablonul dispozitivului

  1. Descărcați șablonul specific dispozitivului de pe pagina de compatibilitate corespunzătoare
  2. Importați șablonul cu acești parametri:
    • MQTT Broker IP Address: aceeași ca la gateway
    • MQTT Broker Port: 1883
    • Gateway name: același topic MQTT Tasmota ca mai sus
    • Device ID: adresa scurtă de la împerechere (de ex. 0x1234)

Dispozitive disponibile

Aqara Single Switch Module T1 (With Neutral) Modul
Atribute de service
IEEEAddrAdresa IEEE Zigbee — identificator hardware unic de 64 de biți
ModelId
Producător
Endpointuri
Config
Variabile personalizate
GWname (string)Numele topicului MQTT Tasmota al gateway-ului Zigbee (se găsește în Configuration → MQTT → Topic)
ID (string) = 0xC0B4Adresa scurtă Zigbee a modulului Aqara Single Switch Module T1 (atribuită la împerechere)
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)

Ascultător
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
Atribute de service
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Comutator Comutator

Releu de pornire/oprire controlat prin comanda ZbSend Power — comută ieșirea L1 spre sarcină

boolean
Valori / Stări: ON · OFF

Comutator

Scrierea stării comutatorului
MQTTPUBLISH("cmnd/" + GWname+ "/ZbSend", 
    "{\"device\":\" " + ID + 
    "\",\"send\":{\"Power\":" + St + "}}")
Ascultător
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
Conexiune: Packet Parser → MQTT
Îmbunătățiri posibile (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.

Surse

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Verificat de TapHome

Doriți să folosiți acest șablon în TapHome Core?

Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog.

Deschideți în portal