---
title: "Shelly Plus Smoke"
description: "Dymový alarm Shelly Plus Smoke v TapHome cez MQTT: stav alarmu pri dyme, batéria v percentách a napätie, watchdog spojenia počas spánku."
url: "https://taphome.com/sk/compatibility/shelly-plus-smoke/"
language: sk
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["mqtt","sensor","wifi","battery-powered","smoke-detector","security"]
  questions: ["Ako integrovať Shelly Plus Smoke s TapHome cez MQTT?","Čo hlási šablóna Shelly Plus Smoke v TapHome?","Ako TapHome zistí, že Shelly Plus Smoke je offline?","Prečo Shelly Plus Smoke nehlási udalosti alarmu?","Hlási Shelly Plus Smoke stav batérie v TapHome?","Ako funguje watchdog konektivity pre batériové Shelly zariadenia?"]
---

# Shelly Plus Smoke

Komunikácia: Packet Parser → MQTT

- [Produktová stránka Shelly Plus Smoke](https://www.shelly.com/en/products/shop/shelly-plus-smoke)

> Adresa v sieti
> 
> Pri MQTT brokeri vstavanom v TapHome zadajte v TapHome ako adresu brokera `127.0.0.1`. V zariadení zadajte IP adresu TapHome Core a jednotke Core dajte rezerváciu IP v routeri.
> 
> [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/)

## Návod na integráciu

Shelly Plus Smoke je batériový (CR123A) Wi-Fi fotoelektrický dymový alarm certifikovaný podľa DIN EN 14604. TapHome komunikuje so zariadením cez MQTT pomocou Gen2+ RPC notifikácií na topicu `events/rpc`. Zariadenie väčšinu času strávi v hlbokom spánku pre úsporu batérie a periodicky sa prebúdza podľa nakonfigurovaného `wakeup_period`. Udalosti dymového alarmu vyvolajú okamžité prebudenie a MQTT notifikáciu.

Šablóna vytvorí jedno zariadenie Dymový alarm (mapované na Reed Contact) s dvoma servisnými atribútmi Batéria (percentá a napätie). Watchdog konektivity sleduje odpočet periódyprebúdzania a hlási varovania alebo chyby, keď zariadenie dlhšie neodpovedalo.

## Konfigurácia

### MQTT Client ID

Každý Shelly Plus Smoke má unikátne MQTT Client ID vo formáte `shellyplussmoke-<MAC12>`, kde `<MAC12>` je plná 12-znaková MAC adresa v hexadecimálnom tvare veľkými písmenami (napr. `shellyplussmoke-AABBCCDDEEFF`). Toto ID slúži aj ako predvolený prefix MQTT topicov.

Client ID nájdete:

- Na štítku zariadenia (MAC adresa)
- Vo webovom rozhraní Shelly: **Settings** → **MQTT** → **Client ID**
- Cez API: `GET http://<device-ip>/rpc/Mqtt.GetConfig` → pole `client_id`

### Nastavenie šablóny

Po importe šablóny v TapHome:

1. Otvorte modul **Shelly Plus Smoke**
2. Nastavte **MQTT Broker IP** na adresu MQTT brokera
3. Nastavte **Port** (predvolene `1883`)
4. Nastavte import parameter **MQTT ID** na Client ID zariadenia (napr. `shellyplussmoke-AABBCCDDEEFF`)

Modul sa prihlási na odber `<device-id>/#` a listenerový skript parsuje `NotifyFullStatus` a `NotifyStatus` JSON-RPC udalosti z topicu `events/rpc`.

> [!TIP]
> MQTT je na Shelly Plus Smoke predvolene vypnuté. Povoľte ho v nastaveniach zariadenia: **Settings** → **MQTT** → **Enable**. Uistite sa, že `rpc_ntf` (RPC notifikácie) je nastavené na `true` (predvolené). Šablóna sa spolieha na `events/rpc` notifikácie, nie na individuálne stavové topicy.

### Správanie spánku a hlásení

Shelly Plus Smoke pracuje v režime hlbokého spánku pre maximalizáciu výdrže batérie:

- **Periodické prebudenie** — zariadenie sa prebúdza v intervaloch definovaných `sys.wakeup_period` a publikuje udalosť `NotifyFullStatus` obsahujúcu stav batérie, stav dymového alarmu a aktuálnu periódu prebúdzania
- **Udalosť alarmu** — detekcia dymu vyvolá okamžité prebudenie a `NotifyStatus` notifikáciu so stavom alarmu
- **Medzi cyklami prebúdzania** — zariadenie je nedostupné cez HTTP a MQTT

Zariadenie je napájané jednou batériou CR123A s očakávanou výdržou až 5 rokov. Nepoužívajte nabíjateľné batérie — výrobca pred tým výslovne varuje.

> [!WARNING]
> Zariadenie je napájané z batérie a nie je trvalo pripojené k MQTT brokeru. Medzi cyklami prebúdzania nie je možná žiadna komunikácia. Ak má miesto senzora slabý Wi-Fi signál, časté opätovné pripájanie pri prebudení môže výrazne skrátiť výdrž batérie.

## Schopnosti zariadenia

### Dymový alarm

Šablóna mapuje stav dymového alarmu na zariadenie Reed Contact (DeviceType 1030). Listenerový skript parsuje `NotifyStatus` udalosti na topicu `events/rpc` a číta `params['smoke:0'].alarm`:

- **ON** (alarm aktívny) — detekovaný dym, zabudovaný bzučiak zariadenia znie na >85 dB
- **OFF** (alarm zrušený) — žiadny dym, normálna prevádzka

Stav alarmu je len na čítanie a aktualizuje sa okamžite pri detekcii dymu. Zariadenie spustí okamžitú MQTT notifikáciu pri udalostiach alarmu bez ohľadu na rozvrh spánku.

### Monitorovanie batérie

Modul poskytuje dva servisné atribúty Batéria, ktoré čítajú z udalostí `NotifyFullStatus`:

- **Batéria [%]** — percentuálna úroveň nabitia batérie z `params['devicepower:0'].battery.percent`. Varovanie o nízkej batérii sa spustí, keď úroveň klesne pod 30 %
- **Batéria [V]** — napätie batérie vo Voltoch z `params['devicepower:0'].battery.V`. Nominálne napätie je 3V pre batériu CR123A

Obe hodnoty vracajú NaN pred prijatím prvého merania (t.j. keď je uložená hodnota stále 0). Dáta batérie sa aktualizujú pri každom periodickom prebudení.

### Watchdog konektivity

Šablóna monitoruje konektivitu zariadenia pomocou mechanizmu založeného na odpočte. Pri každej `NotifyFullStatus` udalosti listenerový skript uloží hodnotu `sys.wakeup_period` do custom premennej `wakeup_period`. Čítací skript potom znižuje tento počítadlo o 60 v každom cykle dotazovania (60-sekundový interval):

- **Počítadlo dosiahne 0** — zariadenie sa neprebudilo podľa očakávania. Počítadlo sa nastaví na -1 a vyvolá sa **WARNING**: "Update not received"
- **Počítadlo dosiahne -86400** — zariadenie mlčí 48 hodín. Vyvolá sa **ERROR**: "Update not received in last 48h"

Keď sa zariadenie prebudí a odošle nový `NotifyFullStatus`, počítadlo sa resetuje na čerstvú hodnotu `wakeup_period`, čím sa vymažú všetky varovania.

### Ďalšie schopnosti

Shelly Plus Smoke tiež podporuje funkciu stlmenia (`Smoke.Mute` RPC metóda) na potlačenie zvuku alarmu, testovacie udalosti dymového alarmu spustené fyzickým tlačidlom a diagnostiku sily Wi-Fi signálu (RSSI). Zariadenie publikuje individuálne stavové topicy komponentov keď je povolené `status_ntf`. Tieto schopnosti môžu byť pridané v budúcej aktualizácii šablóny.

## Riešenie problémov

### Dymový alarm nehlási udalosti

1. Overte, že Shelly Plus Smoke je pripojený k Wi-Fi a MQTT je povolené v nastaveniach zariadenia (**Settings** → **MQTT** → **Enable**)
2. Skontrolujte, že `rpc_ntf` je nastavené na `true` (predvolené) — šablóna vyžaduje RPC notifikácie na `events/rpc`
3. Potvrďte, že import parameter **MQTT ID** presne zodpovedá Client ID zariadenia (napr. `shellyplussmoke-AABBCCDDEEFF`)
4. Použite MQTT klienta (napr. MQTT Explorer) na prihlásenie odberu `<device-id>/#` a overte, že zariadenie publikuje `NotifyFullStatus` pri prebudení
5. Skontrolujte batériu zariadenia — vybitá batéria CR123A bráni zariadeniu pripojiť sa k Wi-Fi

### Watchdog konektivity zobrazuje falošné varovania

1. Watchdog porovnáva odpočet s očakávanou periódou prebúdzania. Ak sú hodiny TapHome Core výrazne posunuté, môžu sa objaviť falošné varovania
2. Na batériové napájanie sa zariadenie prebúdza len v nakonfigurovanom `wakeup_period` intervale — medzery medzi hláseniami sú očakávané
3. Ak je senzor na mieste s nestabilným Wi-Fi, môže sa pri niektorých cykloch prebúdzania nepodarí pripojiť. Overte silu Wi-Fi signálu na mieste senzora
4. Po výmene batérie môže zariadeniu trvať jeden kompletný cyklus prebúdzania, kým sa počítadlo watchdogu správne inicializuje

### Zariadenie sa zobrazuje ako Reed Contact namiesto dymového alarmu

TapHome šablóna používa typ zariadenia PacketParserReedContact (DeviceType 1030) na reprezentáciu dymového alarmu. Toto je správne mapovanie — stav ON znamená "Núdzový alarm" (detekovaný dym) a stav OFF znamená "OK" (žiadny dym). Názov zariadenia v TapHome je "Shelly Plus Smoke" pre jasné označenie jeho funkcie.

## Ako nainštalovať v TapHome

### Predpoklady

- Zariadenie Shelly pripojené k Wi-Fi (2,4 GHz), napr. cez aplikáciu Shelly alebo vlastný prístupový bod zariadenia
- MQTT broker bežiaci vo vašej lokálnej sieti (napr. Mosquitto, Home Assistant alebo vstavaný broker TapHome)
- TapHome CCU v rovnakej sieti ako broker

> [!WARNING]
> Na zariadeniach **Gen1** povolenie MQTT **vypne Shelly Cloud**. Oboje nemôže bežať súčasne. Na zariadeniach Gen2/Plus toto obmedzenie neplatí.

### Krok 1 — Povoľte MQTT na zariadení Shelly

#### Zariadenia Gen1 (Shelly 1, 1PM, 2.5, EM, 3EM, Plug S, RGBW2, Dimmer, TRV…)

1. Otvorte webové rozhranie Shelly: `http://<device-ip>/`
2. Prejdite na **Internet & Security** → **Advanced — MQTT**
3. Povoľte **MQTT**
4. Nastavte **MQTT Server**: `<broker-ip>:<port>` (napr. `192.168.1.10:1883`)
5. Voliteľne nastavte **MQTT User** a **MQTT Password**, ak váš broker vyžaduje autentifikáciu
6. Kliknite na **Save** — zariadenie sa reštartuje a pripojí k brokeru

#### Zariadenia Gen2 / Plus (Shelly Plus 1, Plus 1PM, Plus 2PM, Plus Plug S, Plus H&T, Pro 3EM…)

1. Otvorte webové rozhranie Shelly: `http://<device-ip>/`
2. Prejdite na **Settings** → **MQTT**
3. Povoľte **MQTT**
4. Nastavte **Server**: `<broker-ip>:<port>` (napr. `192.168.1.10:1883`)
5. **Client ID** je predvyplnené ID zariadenia (napr. `shellyplus1pm-AABBCCDDEE`) — ponechajte tak, pokiaľ nemáte konkrétny dôvod na zmenu
6. Kliknite na **Save** a reštartujte zariadenie

Pri vstavanom brokeri TapHome je `<broker-ip>` IP adresa TapHome Core. Dajte jednotke Core rezerváciu IP v routeri, inak zariadenie stratí broker, keď router adresu zmení → [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/).

> [!TIP]
> Na overenie funkčnosti MQTT použite MQTT klienta (napr. MQTT Explorer) a prihláste sa na odber `shellies/#` (Gen1) alebo `<device-id>/#` (Gen2). Mali by ste vidieť stavové správy zo zariadenia.

### Krok 2 — Zistite Device ID / MQTT Client ID

Niektoré šablóny vyžadujú parameter **Device ID** alebo **MQTT Client ID**. Ide o jedinečný identifikátor používaný v MQTT topicoch.

- **Gen1:** nachádza sa na štítku ako MAC adresa (napr. `AABBCCDDEE`). Device ID = `shelly<model>-<mac>`, napr. `shelly1pm-AABBCCDDEE`
- **Gen2/Plus:** nachádza sa vo webovom rozhraní Shelly v časti **Settings** → **Device Info** → **Device ID**, alebo na štítku zariadenia

### Krok 3 — Konfigurácia v TapHome

1. V TapHome pridajte nový modul **Packet Parser (MQTT)**
2. **IP Address:** pre vstavaný broker TapHome `127.0.0.1` (jednotka sa pripája sama k sebe, adresa sa nikdy nezmení); pre externý broker jeho IP adresa (napr. `192.168.1.10`)
3. **Port:** `1883` (predvolený; pre TLS použite `8883`)
4. **Device ID / MQTT Client ID:** zadajte hodnotu z kroku 2 (ak to šablóna vyžaduje)
5. Importujte šablónu — TapHome sa automaticky prihlási na odber topicov zariadenia

## Dostupné zariadenia 1

Tieto zariadenia sa po importe zobrazia v TapHome.

Shelly Plus Smoke Modul

Vlastné premenné

|                     |                                                                                                                                                                      |
|---------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `deviceid` (string) | MQTT identifikátor zariadenia používaný ako prefix topicov — formát: shellyplussmoke-{MACADDRESS} (nájdete vo webovom rozhraní Shelly → Settings → MQTT → Client ID) |

Dymový alarm Jazýčkový kontakt Len na čítanie

Stav fotoelektrického dymového alarmu — ON = Núdzový alarm (detekovaný dym), OFF = OK (žiadny dym). Alarm okamžite spustí MQTT notifikáciu s &gt;85 dB bzučiakom.

boolean JSON-RPC (NotifyStatus → params.smoke:0.alarm)

Servisné atribúty

|              |                                                                                                         |
|--------------|---------------------------------------------------------------------------------------------------------|
| Batéria \[%] | Percentuálna úroveň nabitia batérie — varovanie pri poklese pod 30 %. Batéria CR123A, výdrž až 5 rokov. |
| Batéria \[V] | Napätie batérie vo Voltoch — nominálne 3V pre batériu CR123A                                            |

Čítanie (modul)

```taphome
if wakeup_period = 0
	# after init
else
	wakeup_period := wakeup_period - 60;
	if wakeup_period = 0
		wakeup_period := -1;
	end
end

if wakeup_period < 0
	ADDWARNING("Update not received");
end

if wakeup_period < -86400
	ADDERROR("Update not received in last 48h");
end
```

Listener

```taphome
if RECEIVEDMSG.TOPIC = deviceid + "/events/rpc"
	var method := parsejson(RECEIVEDMSG.PAYLOAD, "method", true); 
	var params := parsejson(RECEIVEDMSG.PAYLOAD, "params", true);
	if method = "NotifyFullStatus"
		wakeup_period := parsejson(params, "sys.wakeup_period");
		battery_V := parsejson(params, "devicepower:0.battery.V");
		battery_percent := parsejson(params, "devicepower:0.battery.percent");
	end
	if method = "NotifyStatus" and !ISNULL(parsejson(params, "smoke:0", true))
		var alarm := parsejson(params, "smoke:0.alarm", true);
		if !ISNULL(alarm)
			Rc := alarm;
		end
	end
end

if battery_percent < 30
	ADDWARNING("Low battery");
end
```

Servisné atribúty

Battery \[%]

```taphome
if battery_percent != 0
	return(battery_percent);
else
	return(NaN);
end
```

Battery \[V]

```taphome
if battery_V != 0
	return(battery_V);
else
	return(NaN);
end
```

**Pripojenie:** Packet Parser → MQTT • Hostname: `shellyplussmoke-{MAC}.local`

Možné vylepšenia (4)

- Smoke Mute State — smoke:0.mute — true when alarm sound is suppressed via Smoke.Mute RPC. Could show muted status in TapHome.
- External Power Status — devicepower:0.external.present — always false for Plus Smoke (battery-only device), but available in API.
- WiFi RSSI — sys.wifi.rssi — signal strength in dBm. Could be used for placement diagnostics.
- Smoke Alarm Test Event — smoke.alarm\_test webhook event — triggered when user presses test button. Not captured by current template.

## Parametre importu

Tieto hodnoty zadáte pri importe XML.

| Pýta sa v aplikácii | Predvolené                     |
|---------------------|--------------------------------|
| IP adresa           | `192.168.0.1`                  |
| ID                  | `shellyplussmoke-xxxxxxxxxxxx` |

## Zdroje

- Shelly Gen2+ RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-27
- Shelly Gen2+ System (Sys) Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-03-27
- Shelly Gen2+ WiFi Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Wifi/) 2026-03-27
- Shelly Gen2+ MQTT Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Mqtt/) 2026-03-27
- HA Shelly Integration (Gen2+)
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-27
- Smoke Component API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Smoke/) 2026-03-30
- DevicePower Component API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/DevicePower/) 2026-03-30
- Shelly Plus Smoke Device Profile
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/0.14/Devices/ShellyPlusSmoke/) 2026-03-30
- Shelly Plus Smoke KB — Specifications
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-smoke) 2026-03-30

## Súvisiaca dokumentácia

- [MQTT Integration](https://taphome.com/sk/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/)
- [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/)
- [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)
- [MQTT broker](https://taphome.com/sk/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripty](https://taphome.com/sk/docs/script/listener-scripts/)