---
title: "Aqara Single Switch Module T1 (With Neutral)"
description: "On/off ovládání Zigbee spínacího modulu Aqara SSM-U01 přes Tasmota gateway. Síťové napájení, vyžaduje nulový vodič, max 10A/2500W. Příkaz ZbSend Power."
url: "https://taphome.com/cs/compatibility/zigbee2tasmota-aqara-single-switch-module-t1-with-neutral/"
language: cs
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","smart-plug","zigbee","zigbee2tasmota","switch","relay","mains-powered"]
  questions: ["Jak integrovat Aqara Single Switch Module T1 s TapHome?","Jak ovládat relé Aqara SSM-U01 přes TapHome?","Jak spárovat spínací modul Aqara se Zigbee2Tasmota gateway?","Proč můj spínací modul Aqara nereaguje na příkazy z TapHome?","Vyžaduje Aqara SSM-U01 nulový vodič?","Jaké je maximální zatížení spínacího modulu Aqara SSM-U01?"]
---

# Aqara Single Switch Module T1 (With Neutral)

Komunikace: Packet Parser → MQTT

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

> Adresa v síti
> 
> U MQTT brokeru vestavěného v TapHome zadejte v TapHome jako adresu brokeru `127.0.0.1`. V zařízení zadejte IP adresu TapHome Core a jednotce Core dejte rezervaci IP v routeru.
> 
> [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)

## Návod na integraci

> [!IMPORTANT]
> Toto zařízení komunikuje přes **Zigbee** prostřednictvím Tasmota gateway. Ujistěte se, že máte
> importovanou šablonu [Zigbee2Tasmota Gateway](https://taphome.com/cs/compatibility/zigbee2tasmota-gateway/)
> a zařízení spárované, než budete pokračovat.

Aqara Single Switch Module T1 (With Neutral) je kompaktní reléový modul Zigbee 3.0 (model SSM-U01) určený k instalaci za vypínač. Přemění tradiční nástěnný vypínač na chytrý spínač při zachování původního krytu vypínače. TapHome ovládá relé přes MQTT prostřednictvím Zigbee2Tasmota gateway pomocí příkazů `ZbSend` — bez nutnosti cloudového připojení.

Modul vyžaduje nulový vodič a podporuje zátěže od 3 W do 2500 W (10 A odporová zátěž) při 100 – 250 VAC. Kompaktní rozměry (42,9 x 40 x 19,9 mm) umožňují instalaci do většiny instalačních krabic.

Jako zařízení napájené ze sítě modul funguje jako **Zigbee router** — posiluje Zigbee mesh síť a rozšiřuje dosah pro blízké bateriově napájené senzory.

## Konfigurace

### Párování modulu

1. Ujistěte se, že [Zigbee2Tasmota Gateway](https://taphome.com/cs/compatibility/zigbee2tasmota-gateway/) je nastaven a přepínač **Permit Join** je v TapHome zapnutý
2. Na modulu **dlouze stiskněte tlačítko, dokud modrá LED nezačne rychle blikat**, poté uvolněte
3. Počkejte, až se počítadlo **Devices Found** zvýší — Device ID modulu (např. `0x1234`) se zobrazí v atributech služby gateway
4. Importujte šablonu tohoto zařízení pomocí Device ID z párování

### Parametry importu šablony

Šablona zařízení vyžaduje 4 parametry:

| Parametr | Popis | Příklad |
|----------|-------|---------|
| **MQTT Broker IP Address** | IP adresa MQTT brokeru | `192.168.1.10` |
| **MQTT Broker Port** | Port brokeru (výchozí 1883) | `1883` |
| **Gateway name** | MQTT topic Tasmota (Configuration → MQTT → Topic) | `tasmota_XXXXX` |
| **Device ID** | Krátká Zigbee adresa z párování | `0x1234` |

Po importu se v TapHome objeví jedno zařízení Spínač pro ovládání zapnutí/vypnutí.

### Zapojení

Modul vyžaduje připojení nulového vodiče se třemi svorkami:

| Svorka | Připojení |
|--------|-----------|
| **L** | Vstup fázového vodiče (linka) |
| **N** | Nulový vodič |
| **L1** | Výstup zátěže (světlo nebo spotřebič) |

> [!WARNING]
> Tento modul **vyžaduje nulový vodič**. Nelze jej instalovat do krabic, kde jsou pouze fázový a spínaný vodič. Maximální zátěž je 10 A / 2500 W pro odporové zátěže, minimální zátěž je 3 W. Instalaci musí provést kvalifikovaný elektrikář.

## Možnosti zařízení

### Ovládání spínače

Šablona vytvoří jedno zařízení Spínač, které čte a zapisuje pole `Power`:

- **Čtení:** Modul naslouchá na topicu `tele/{GWname}/SENSOR` zprávám `ZbReceived.{ID}.Power`. Při stisknutí fyzického tlačítka nebo změně stavu relé modul publikuje svůj nový stav.
- **Zápis:** TapHome odešle příkaz `ZbSend` na `cmnd/{GWname}/ZbSend` s `Power: true` (ZAP) nebo `Power: false` (VYP) pro vzdálené ovládání relé.

Spínač reaguje na fyzické stisknutí tlačítka i na příkazy z TapHome a TapHome vždy zobrazuje aktuální stav relé — bez ohledu na to, jak bylo přepnuto.

### Atributy služby

Modul poskytuje diagnostická Zigbee metadata získaná prostřednictvím pollingu `ZbInfo`:

| Atribut | Popis |
|---------|-------|
| **IEEEAddr** | Unikátní 64bitový hardwarový identifikátor |
| **ModelId** | Zigbee model ID (`lumi.switch.n0agl1`) |
| **Manufacturer** | Řetězec výrobce hlášený zařízením |
| **Endpoints** | Aktivní Zigbee endpointy |
| **Config** | Konfigurace Zigbee zařízení |

### Další možnosti

Aqara SSM-U01 také podporuje monitorování výkonu v reálném čase (watty), sledování kumulativní spotřeby energie, hlášení interní teploty zařízení, odpojený režim (tlačítko může spouštět scény bez spínání relé) a ochranu proti přetížení/přehřátí. Tyto funkce jsou dostupné v hardwaru, ale momentálně nejsou mapovány v šabloně TapHome — mohou být přidány v budoucí aktualizaci šablony.

## Řešení problémů

### Spínač nereaguje na příkazy z TapHome

1. Ověřte, zda Device ID v šabloně odpovídá krátké Zigbee adrese přiřazené během párování (např. `0xC0B4`)
2. Zkontrolujte, zda se **Gateway name** shoduje mezi šablonou gateway a šablonou tohoto zařízení
3. Otestujte fyzické tlačítko na modulu — pokud přepíná relé, ale TapHome se neaktualizuje, problém může být v cestě čtení (topic `tele/{GWname}/SENSOR`)
4. Pomocí MQTT klienta (např. MQTT Explorer) se přihlaste k topicu `tele/{GWname}/SENSOR` a ověřte, zda modul publikuje zprávy `ZbReceived` s polem `Power` při přepnutí

### Stav spínače není synchronizovaný

1. Pokud TapHome zobrazuje jiný stav než skutečné relé, stiskněte fyzické tlačítko pro vyvolání hlášení stavu
2. Šablona aktivně nepoluje stav spínače — spoléhá se na hlášení změn zařízením. Pokud modul krátkodobě ztratí Zigbee konektivitu, stav může být neaktuální do dalšího fyzického přepnutí nebo příkazu

### Modul se nepáruje

1. Ujistěte se, že modul je napájen (nulový vodič i fázový vodič musí být připojeny)
2. Dlouze stiskněte tlačítko, dokud modrá LED nezačne rychle blikat — krátké stisknutí nespustí párovací režim
3. Během prvního párování přibližte gateway, pokud je modul daleko od koordinátoru
4. Pokud byl modul dříve spárován s jiným Zigbee koordinátorem, může být nutný reset do továrního nastavení — držte tlačítko 10+ sekund, dokud LED třikrát blikne

## Jak nainstalovat v TapHome

### Předpoklady

- Zigbee brána s firmwarem Tasmota (např. Sonoff ZBBridge, eWeLink ZB-GW03)
- MQTT broker běžící ve vaší lokální síti (vestavěný TapHome broker nebo externí)
- TapHome CCU ve stejné síti

> [!TIP]
> TapHome má vestavěný MQTT broker — aktivujte ho v **Nastavení** → **Hardware** → **MQTT Broker**. Není potřeba žádný další software.

### Krok 1 — Nastavte Tasmota Zigbee bránu

1. Nahrajte [firmware Tasmota](https://tasmota.github.io/docs/Getting-Started/) na podporovaný Zigbee koordinátor (např. Sonoff ZBBridge, eWeLink ZB-GW03)
2. Připojte bránu k vaší Wi-Fi síti přes webové rozhraní Tasmota
3. Přejděte na **Configuration** → **Configure MQTT** a nastavte:
   - **Host:** pro vestavěný broker IP adresa TapHome Core (s rezervací IP v routeru → [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)), jinak IP adresa vašeho brokeru (např. `192.168.1.10`)
   - **Port:** `1883`
   - **Topic:** zapište si název topicu (např. `tasmota_XXXXX`) — budete ho potřebovat při importu šablony

Podrobné pokyny naleznete v [dokumentaci Tasmota Zigbee](https://tasmota.github.io/docs/Zigbee/).

### Krok 2 — Importujte šablonu brány v TapHome

1. Stáhněte si šablonu brány ze stránky kompatibility [Zigbee2Tasmota Gateway](https://taphome.com/cs/compatibility/zigbee2tasmota-gateway/)
2. V TapHome přejděte na **Nastavení** → **Hardware** → **Packet Parser** → **Import**
3. Importujte šablonu s těmito parametry:
   - **MQTT Broker IP Address:** pro vestavěný broker TapHome `127.0.0.1`, jinak IP adresa vašeho brokeru (např. `192.168.1.10`)
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** Tasmota MQTT topic z kroku 1 (např. `tasmota_XXXXX`)

Po importu uvidíte dvě zařízení: **Permit Join** (přepínač) a **Devices Found** (počítadlo).

### Krok 3 — Spárujte Zigbee zařízení

1. V TapHome zapněte přepínač **Permit Join** — otevře se 60sekundové okno pro párování
2. Na Zigbee zařízení spusťte proces párování (typicky podržte tlačítko reset 5 sekund, dokud LED nezačne blikat)
3. Sledujte počítadlo **Devices Found** — zvýší se, když se připojí nové zařízení
4. Zkontrolujte **Service Attributes** brány, kde uvidíte ID nového zařízení (např. `0x1234`), výrobce a model
5. Režim párování se automaticky deaktivuje po uplynutí časového limitu

### Krok 4 — Importujte šablonu zařízení

1. Stáhněte si šablonu konkrétního zařízení z příslušné stránky kompatibility
2. Importujte šablonu s těmito parametry:
   - **MQTT Broker IP Address:** stejná jako pro bránu
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** stejný Tasmota MQTT topic jako výše
   - **Device ID:** krátká adresa z párování (např. `0x1234`)

## Dostupná zařízení 1

Tato zařízení se po importu zobrazí v TapHome.

Aqara Single Switch Module T1 (With Neutral) Modul

Servisní atributy

|              |                                                                 |
|--------------|-----------------------------------------------------------------|
| IEEEAddr     | Zigbee IEEE adresa — unikátní 64bitový hardwarový identifikátor |
| ModelId      |                                                                 |
| Manufacturer |                                                                 |
| Endpoints    |                                                                 |
| Config       |                                                                 |

Vlastní proměnné

`GWname` (string) Název MQTT topicu Tasmota Zigbee gateway (najdete v Configuration → MQTT → Topic) 

`ID` (string) = 0xC0B4 Krátká Zigbee adresa Aqara Single Switch Module T1 (přiřazená během párování)

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

Servisní atributy

IEEEAddr

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

ModelId

```

```

Manufacturer

```

```

Endpoints

```

```

Config

```

```

Spínač Přepínač Čtení i zápis

On/off relé ovládané příkazem ZbSend Power — spíná výstup zátěže L1

boolean

Hodnoty / Stavy: ON · OFF

Zápis stavu přepínače

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

**Připojení:** Packet Parser → MQTT

Možná vylepšení (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.

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci                                           | Výchozí         |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker IP adresa                                       | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota->Configuration->MQTT->Topic) | `tasmota_XXXXX` |
| Device ID                                                   | `0xFFFF`        |

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

## Související dokumentace

- [MQTT Integration](https://taphome.com/cs/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/)
- [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/)
- [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)
- [Broker MQTT](https://taphome.com/cs/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripty](https://taphome.com/cs/docs/script/listener-scripts/)