---
title: "Aqara Single Switch Module T1 (With Neutral)"
description: "On/off ovládanie Zigbee spínacieho modulu Aqara SSM-U01 cez Tasmota gateway. Sieťové napájanie, vyžaduje nulový vodič, max 10A/2500W. Príkaz ZbSend Power."
url: "https://taphome.com/sk/compatibility/zigbee2tasmota-aqara-single-switch-module-t1-with-neutral/"
language: sk
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","smart-plug","zigbee","zigbee2tasmota","switch","relay","mains-powered"]
  questions: ["Ako integrovať Aqara Single Switch Module T1 s TapHome?","Ako ovládať relé Aqara SSM-U01 cez TapHome?","Ako spárovať spínací modul Aqara so Zigbee2Tasmota gateway?","Prečo môj spínací modul Aqara nereaguje na príkazy z TapHome?","Vyžaduje Aqara SSM-U01 nulový vodič?","Aké je maximálne zaťaženie spínacieho modulu Aqara SSM-U01?"]
---

# Aqara Single Switch Module T1 (With Neutral)

Komunikácia: Packet Parser → MQTT

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

> [!IMPORTANT]
> Toto zariadenie komunikuje cez **Zigbee** prostredníctvom Tasmota gateway. Uistite sa, že máte
> importovanú šablónu [Zigbee2Tasmota Gateway](https://taphome.com/sk/compatibility/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](https://taphome.com/sk/compatibility/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:

| Parameter | Popis | Príklad |
|-----------|-------|---------|
| **MQTT Broker IP Address** | IP adresa MQTT brokera | `192.168.1.10` |
| **MQTT Broker Port** | Port brokera (predvolene 1883) | `1883` |
| **Gateway name** | MQTT topic Tasmota (Configuration → MQTT → Topic) | `tasmota_XXXXX` |
| **Device ID** | Krátka Zigbee adresa z párovania | `0x1234` |

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:

| Svorka | Pripojenie |
|--------|------------|
| **L** | Vstup fázového vodiča (linka) |
| **N** | Nulový vodič |
| **L1** | Výstup záťaže (svetlo alebo spotrebič) |

> [!WARNING]
> 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út | Popis |
|---------|-------|
| **IEEEAddr** | Unikátny 64-bitový hardvérový identifikátor |
| **ModelId** | Zigbee model ID (`lumi.switch.n0agl1`) |
| **Manufacturer** | Reťazec výrobcu hlásený zariadením |
| **Endpoints** | Aktívne Zigbee endpointy |
| **Config** | Konfigurá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

> [!TIP]
> 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](https://tasmota.github.io/docs/Getting-Started/) 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](https://tasmota.github.io/docs/Zigbee/).

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

1. Stiahnite si šablónu brány zo stránky kompatibility [Zigbee2Tasmota Gateway](https://taphome.com/sk/compatibility/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

|              |                                                                  |
|--------------|------------------------------------------------------------------|
| IEEEAddr     | Zigbee 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) = 0xC0B4 Krá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

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

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

- 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