---
title: "Aqara Single Switch Module T1 (With Neutral)"
description: "Relej Zigbee modula Aqara SSM-U01 preko pristupnika Tasmota, naredba ZbSend Power. Mrežno napajanje, potreban neutralni vodič, do 10 A/2500 W."
url: "https://taphome.com/hr/compatibility/zigbee2tasmota-aqara-single-switch-module-t1-with-neutral/"
language: hr
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","smart-plug","zigbee","zigbee2tasmota","switch","relay","mains-powered"]
  questions: ["Kako integrirati Aqara Single Switch Module T1 sa sustavom TapHome?","Kako upravljati relejem Aqara SSM-U01 iz sustava TapHome?","Kako upariti Aqara modul sklopke s pristupnikom Zigbee2Tasmota?","Zašto moj Aqara modul sklopke ne reagira na naredbe iz sustava TapHome?","Treba li Aqara SSM-U01 neutralni vodič?","Koje je najveće opterećenje za Aqara modul sklopke SSM-U01?"]
---

# Aqara Single Switch Module T1 (With Neutral)

Komunikacija: Packet Parser → MQTT

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

> Adresa u mreži
> 
> Kod MQTT brokera ugrađenog u TapHome radi se o jednom brokeru kojem se pristupa s dva mjesta. Predložak radi izravno u jedinici TapHome Core, zato je u TapHomeu adresa brokera `127.0.0.1` (ovo računalo). Uređaj radi drugdje u mreži, zato u uređaju unesite IP adresu jedinice TapHome Core i za Core postavite rezervaciju IP adrese u usmjerivaču — ako se adresa jedinice Core promijeni, uređaj više ne dolazi do brokera.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

> [!IMPORTANT]
> Ovaj uređaj komunicira preko protokola **Zigbee** putem pristupnika Tasmota. Prije nastavka provjerite jeste li
> uvezli predložak [Zigbee2Tasmota Gateway](https://taphome.com/hr/compatibility/zigbee2tasmota-gateway/)
> i uparili uređaj.

Aqara Single Switch Module T1 (With Neutral) je kompaktan Zigbee 3.0 relejni modul (model SSM-U01) za ugradnju iza prekidača. Pretvara klasični zidni prekidač u pametni prekidač, uz zadržavanje postojeće maske prekidača. TapHome upravlja relejem preko protokola MQTT putem pristupnika Zigbee2Tasmota pomoću naredbi `ZbSend`, bez potrebe za vezom s oblakom.

Modul zahtijeva neutralni vodič i podržava opterećenja od 3 W do 2500 W (10 A, omsko opterećenje) pri 100–250 VAC. Zahvaljujući malim dimenzijama (42,9 × 40 × 19,9 mm) može se ugraditi u većinu podžbuknih kutija za prekidače.

Budući da se napaja iz mreže, modul radi kao **Zigbee usmjerivač (router)**. Jača Zigbee mesh mrežu i povećava domet za obližnje senzore na baterije.

## Konfiguracija

### Uparivanje modula

1. Provjerite je li [Zigbee2Tasmota Gateway](https://taphome.com/hr/compatibility/zigbee2tasmota-gateway/) postavljen i je li sklopka **Permit Join** u sustavu TapHome uključena
2. Na modulu **dugo pritisnite tipku dok plava LED dioda ne počne brzo treptati**, a zatim je otpustite
3. Pričekajte da se brojač **Devices Found** poveća. Device ID modula (npr. `0x1234`) prikazuje se u servisnim atributima pristupnika
4. Uvezite ovaj predložak uređaja s Device ID-jem dobivenim pri uparivanju

### Parametri uvoza predloška

Predložak uređaja traži 4 parametra:

| Parametar | Opis | Primjer |
|-----------|-------------|---------|
| **MQTT Broker IP Address** | IP adresa vašeg MQTT brokera | `192.168.1.10` |
| **MQTT Broker Port** | Port brokera (zadano 1883) | `1883` |
| **Gateway name** | MQTT tema uređaja Tasmota (Configuration → MQTT → Topic) | `tasmota_XXXXX` |
| **Device ID** | Kratka Zigbee adresa dobivena pri uparivanju | `0x1234` |

Nakon uvoza u sustavu TapHome pojavljuje se jedan uređaj Sklopka za uključivanje i isključivanje.

### Spajanje

Modul zahtijeva priključak neutralnog vodiča i ima tri stezaljke:

| Stezaljka | Spoj |
|----------|------------|
| **L** | Ulaz faznog vodiča (faza) |
| **N** | Neutralni vodič |
| **L1** | Izlaz prema trošilu (svjetlo ili uređaj) |

> [!WARNING]
> Ovaj modul **zahtijeva neutralni vodič**. Ne može se ugraditi u kutije prekidača u kojima su samo fazni i povratni vodič. Najveće opterećenje je 10 A / 2500 W za omska opterećenja, najmanje opterećenje je 3 W. Ugradnju mora obaviti kvalificirani električar.

## Mogućnosti uređaja

### Upravljanje sklopkom

Predložak stvara jedan uređaj Sklopka koji čita i upisuje polje `Power`:

- **Čitanje:** Modul prati temu `tele/{GWname}/SENSOR` i poruke `ZbReceived.{ID}.Power`. Kad se pritisne fizička tipka ili se promijeni stanje releja, modul objavljuje novo stanje.
- **Upisivanje:** TapHome šalje naredbu `ZbSend` na `cmnd/{GWname}/ZbSend` s `Power: true` (uključeno) ili `Power: false` (isključeno) i tako daljinski upravlja relejem.

Sklopka reagira i na pritisak fizičke tipke i na naredbe iz sustava TapHome, a TapHome uvijek prikazuje trenutačno stanje releja, bez obzira na to kako je promijenjeno.

### Servisni atributi

Modul prikazuje dijagnostičke Zigbee metapodatke dobivene periodičnim upitom `ZbInfo`:

| Atribut | Opis |
|-----------|-------------|
| **IEEEAddr** | Jedinstveni 64-bitni hardverski identifikator |
| **ModelId** | Zigbee ID modela (`lumi.switch.n0agl1`) |
| **Proizvođač** | Naziv proizvođača koji javlja uređaj |
| **Endpoints** | Aktivne Zigbee krajnje točke (endpoints) |
| **Config** | Zigbee konfiguracija uređaja |

### Dodatne mogućnosti

Aqara SSM-U01 podržava i mjerenje snage u stvarnom vremenu (W), praćenje ukupne potrošnje energije, javljanje unutarnje temperature uređaja, odvojeni način rada (decoupled mode, tipka može pokrenuti scenu bez prebacivanja releja) i zaštitu od preopterećenja i pregrijavanja. Hardver te mogućnosti ima, ali zasad nisu mapirane u predlošku TapHome. Mogu se dodati u nekom od budućih ažuriranja predloška.

## Rješavanje problema

### Sklopka ne reagira na naredbe iz sustava TapHome

1. Provjerite odgovara li Device ID u predlošku kratkoj Zigbee adresi dodijeljenoj pri uparivanju (npr. `0xC0B4`)
2. Provjerite je li **Gateway name** isti u predlošku pristupnika i u ovom predlošku uređaja
3. Isprobajte fizičku tipku na modulu. Ako prebacuje relej, a TapHome se ne ažurira, problem je možda u primanju stanja (tema `tele/{GWname}/SENSOR`)
4. Pomoću MQTT klijenta (npr. MQTT Explorer) pretplatite se na `tele/{GWname}/SENSOR` i provjerite objavljuje li modul pri prebacivanju poruke `ZbReceived` s poljem `Power`

### Stanje sklopke nije usklađeno

1. Ako TapHome prikazuje drugačije stanje od stvarnog stanja releja, pritisnite fizičku tipku kako bi modul javio stanje
2. Predložak ne ispituje stanje sklopke aktivno, nego se oslanja na to da uređaj javi promjene. Ako modul nakratko izgubi Zigbee vezu, prikazano stanje može biti zastarjelo do sljedećeg fizičkog prebacivanja ili naredbe

### Modul se ne uparuje

1. Provjerite ima li modul napajanje (spojeni moraju biti i neutralni i fazni vodič)
2. Dugo pritisnite tipku dok plava LED dioda ne počne brzo treptati. Kratki pritisak ne pokreće način uparivanja
3. Ako je modul daleko od koordinatora, pri prvom uparivanju približite pristupnik
4. Ako je modul prije bio uparen s drugim Zigbee koordinatorom, prije spajanja na novu mrežu možda ga treba vratiti na tvorničke postavke. Držite tipku dulje od 10 sekundi dok LED dioda ne trepne tri puta

## Kako ga instalirati u TapHome

### Preduvjeti

- Zigbee pristupnik s firmverom Tasmota (npr. Sonoff ZBBridge, eWeLink ZB-GW03)
- MQTT broker koji radi u vašoj lokalnoj mreži (ugrađeni broker TapHome ili vanjski)
- TapHome CCU u istoj mreži

> [!TIP]
> TapHome ima ugrađeni MQTT broker — uključite ga u **Postavke** → **Hardver** → **MQTT Broker**. Nije potreban nikakav dodatni softver.

### Korak 1 — Postavite Tasmota Zigbee pristupnik

1. Na podržani Zigbee koordinator (npr. Sonoff ZBBridge, eWeLink ZB-GW03) učitajte [firmver Tasmota](https://tasmota.github.io/docs/Getting-Started/)
2. Preko web-sučelja Tasmota spojite pristupnik na svoju Wi-Fi mrežu
3. Idite na **Configuration** → **Configure MQTT** i postavite:
   - **Host:** za ugrađeni broker IP adresu centralne jedinice TapHome Core (s rezervacijom IP adrese u usmjerivaču → [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)), inače IP adresu vašeg brokera (npr. `192.168.1.10`)
   - **Port:** `1883`
   - **Topic:** zapišite naziv teme (npr. `tasmota_XXXXX`) — trebat će vam pri uvozu predloška

Detaljne upute potražite u [dokumentaciji Tasmota Zigbee](https://tasmota.github.io/docs/Zigbee/).

### Korak 2 — Uvezite predložak pristupnika u sustav TapHome

1. Preuzmite predložak pristupnika sa stranice kompatibilnosti [Zigbee2Tasmota Gateway](https://taphome.com/hr/compatibility/zigbee2tasmota-gateway/)
2. U sustavu TapHome idite na **Postavke** → **Hardver** → **Packet Parser** → **Uvoz**
3. Uvezite predložak s ovim parametrima:
   - **MQTT Broker IP Address:** za ugrađeni broker TapHome `127.0.0.1`, inače IP adresa vašeg brokera (npr. `192.168.1.10`)
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** Tasmota MQTT tema iz koraka 1 (npr. `tasmota_XXXXX`)

Nakon uvoza vidjet ćete dva uređaja: **Permit Join** (sklopka) i **Pronađeni uređaji** (brojač).

### Korak 3 — Uparite Zigbee uređaj

1. U sustavu TapHome uključite sklopku **Permit Join** — otvara se razdoblje od 60 sekundi za uparivanje
2. Na Zigbee uređaju pokrenite postupak uparivanja (obično držite tipku za resetiranje 5 sekundi, dok LED ne počne treptati)
3. Pratite brojač **Pronađeni uređaji** — povećava se kada se pridruži novi uređaj
4. U **Servisnim atributima** pristupnika pogledajte ID novog uređaja (npr. `0x1234`), proizvođača i model
5. Način uparivanja automatski se isključuje nakon isteka vremena

### Korak 4 — Uvezite predložak uređaja

1. Preuzmite predložak za konkretni uređaj s odgovarajuće stranice kompatibilnosti
2. Uvezite predložak s ovim parametrima:
   - **MQTT Broker IP Address:** ista kao za pristupnik
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** ista Tasmota MQTT tema kao gore
   - **Device ID:** kratka adresa iz uparivanja (npr. `0x1234`)

## Dostupni uređaji 1

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Aqara Single Switch Module T1 (With Neutral) Modul

Servisni atributi

|            |                                                                    |
|------------|--------------------------------------------------------------------|
| IEEEAddr   | Zigbee IEEE adresa — jedinstveni 64-bitni hardverski identifikator |
| ModelId    |                                                                    |
| Proizvođač |                                                                    |
| Endpoints  |                                                                    |
| Config     |                                                                    |

Prilagođene varijable

`GWname` (string) Naziv MQTT teme Zigbee pristupnika u sustavu Tasmota (nalazi se u Configuration → MQTT → Topic) 

`ID` (string) = 0xC0B4 Kratka Zigbee adresa modula Aqara Single Switch Module T1 (dodjeljuje se pri uparivanju)

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

Listener

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

Servisni atributi

IEEEAddr

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

ModelId

```

```

Manufacturer

```

```

Endpoints

```

```

Config

```

```

Sklopka Sklopka Čitanje i pisanje

Relej za uključivanje i isključivanje kojim se upravlja naredbom ZbSend Power — uključuje i isključuje izlaz prema trošilu L1

boolean

Vrijednosti / stanja: ON · OFF

Zapis stanja sklopke

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

Listener

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

**Povezivanje:** Packet Parser → MQTT

Moguća poboljšanja (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 uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji                                        | Zadano          |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker IP adresa                                       | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota-&gt;Configuration-&gt;MQTT-&gt;Topic) | `tasmota_XXXXX` |
| Device ID                                                   | `0xFFFF`        |

## Izvori

- 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

## Povezana dokumentacija

- [MQTT Integration](https://taphome.com/hr/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/hr/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripte](https://taphome.com/hr/docs/script/listener-scripts/)

