---
title: "Aqara Single Switch Module T1 (With Neutral)"
description: "Pornirea/oprirea releului Zigbee Aqara SSM-U01 prin gateway Tasmota. Alimentat de la rețea, necesită nul, max. 10 A/2500 W. Comanda ZbSend Power."
url: "https://taphome.com/ro/compatibility/zigbee2tasmota-aqara-single-switch-module-t1-with-neutral/"
language: ro
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","smart-plug","zigbee","zigbee2tasmota","switch","relay","mains-powered"]
  questions: ["Cum integrez Aqara Single Switch Module T1 cu TapHome?","Cum controlez releul Aqara SSM-U01 din TapHome?","Cum împerechez modulul releu Aqara cu un gateway Zigbee2Tasmota?","De ce modulul releu Aqara nu răspunde la comenzile TapHome?","Aqara SSM-U01 necesită fir de nul?","Care este sarcina maximă pentru modulul releu Aqara SSM-U01?"]
---

# Aqara Single Switch Module T1 (With Neutral)

Comunicație: Packet Parser → MQTT

- [Pagina produsului Aqara — SSM-U01](https://www.aqara.com/en/product/single-switch-module-t1-with-neutral/)

> Adresa în rețea
> 
> Pentru brokerul MQTT integrat în TapHome este vorba de un singur broker, accesat din două locuri. Șablonul rulează direct în TapHome Core, de aceea în TapHome adresa brokerului este `127.0.0.1` (acest calculator). Dispozitivul rulează în altă parte a rețelei, de aceea în dispozitiv introduceți adresa IP a unității TapHome Core și atribuiți unității Core o rezervare IP în router — dacă adresa Core se schimbă, dispozitivul nu mai ajunge la broker.
> 
> [Pregătirea rețelei](https://taphome.com/ro/docs/setup/network-preparation/)

## Ghid de integrare

> [!IMPORTANT]
> Acest dispozitiv comunică prin **Zigbee** printr-un gateway Tasmota. Înainte de a continua,
> asigurați-vă că ați importat șablonul [Zigbee2Tasmota Gateway](https://taphome.com/ro/compatibility/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](https://taphome.com/ro/compatibility/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:

| Parametru | Descriere | Exemplu |
|-----------|-------------|---------|
| **MQTT Broker IP Address** | Adresa IP a brokerului dvs. MQTT | `192.168.1.10` |
| **MQTT Broker Port** | Portul brokerului (implicit 1883) | `1883` |
| **Gateway name** | Topicul MQTT Tasmota (Configuration → MQTT → Topic) | `tasmota_XXXXX` |
| **Device ID** | Adresa scurtă Zigbee de la împerechere | `0x1234` |

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 |
|----------|------------|
| **L** | Intrare fază (L) |
| **N** | Fir de nul |
| **L1** | Ieșire spre sarcină (lumină sau aparat) |

> [!WARNING]
> 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`:

| Atribut | Descriere |
|-----------|-------------|
| **IEEEAddr** | Identificator hardware unic de 64 de biți |
| **ModelId** | ID-ul modelului Zigbee (`lumi.switch.n0agl1`) |
| **Producător** | Șirul cu numele producătorului raportat de dispozitiv |
| **Endpointuri** | Endpointuri Zigbee active |
| **Config** | Configuraț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

> [!TIP]
> 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](https://tasmota.github.io/docs/Getting-Started/) 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:** pentru brokerul integrat, adresa IP a unității TapHome Core (cu rezervare IP în router → [Pregătirea rețelei](https://taphome.com/ro/docs/setup/network-preparation/)), altfel 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](https://tasmota.github.io/docs/Zigbee/).

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

1. Descărcați șablonul gateway-ului de pe pagina de compatibilitate [Zigbee2Tasmota Gateway](https://taphome.com/ro/compatibility/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:** pentru brokerul integrat TapHome `127.0.0.1`, altfel 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 1

Aceste dispozitive apar în TapHome după import.

Aqara Single Switch Module T1 (With Neutral) Modul

Atribute de service

|             |                                                                |
|-------------|----------------------------------------------------------------|
| IEEEAddr    | Adresa 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) = 0xC0B4 Adresa 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

Ascultător

```taphome
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

```taphome
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
```

ModelId

```

```

Manufacturer

```

```

Endpoints

```

```

Config

```

```

Comutator Comutator Citire și scriere

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

boolean

Valori / Stări: ON · OFF

Scrierea stării comutatorului

```taphome
MQTTPUBLISH("cmnd/" + GWname+ "/ZbSend", 
    "{\"device\":\" " + ID + 
    "\",\"send\":{\"Power\":" + St + "}}")
```

Ascultător

```taphome
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.

## Parametri de import

Introduceți aceste valori când importați XML-ul.

| Solicitat în aplicație                                      | Implicit        |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker Adresă IP                                       | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota-&gt;Configuration-&gt;MQTT-&gt;Topic) | `tasmota_XXXXX` |
| Device ID                                                   | `0xFFFF`        |

## Surse

- Tasmota Zigbee Documentation
  
  [tasmota.github.io](https://tasmota.github.io/docs/Zigbee/)
- Zigbee Compatible Devices Database
- Aqara Product Page — SSM-U01
  
  [www.aqara.com](https://www.aqara.com/en/product/single-switch-module-t1-with-neutral/) 2026-03-29
- Blakadder Device Entry — Aqara SSM-U01
  
  [zigbee.blakadder.com](https://zigbee.blakadder.com/Aqara_SSM-U01.html) 2026-03-29

## Documentație asociată

- [MQTT Integration](https://taphome.com/ro/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/ro/docs/integration/packet-parser/mqtt-broker/)
- [Scripturi listener](https://taphome.com/ro/docs/script/listener-scripts/)

