---
title: "Shelly Plus i4"
description: "Shelly Plus i4 Wi-Fi 4-kanálový digitálny vstupný modul. Detekcia stlačení tlačidiel a stavov prepínačov cez MQTT z TapHome — bez relé, čistý vstup."
url: "https://taphome.com/sk/compatibility/shelly-plus-i4/"
language: sk
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","i/o-module","wifi","digital-input","push-button","reed-contact","4-channel"]
  questions: ["Ako integrovať Shelly Plus i4 s TapHome?","Ako detekovať stlačenia tlačidiel so Shelly Plus i4 v TapHome?","Ako pripojiť Shelly Plus i4 cez MQTT k TapHome?","Aký je rozdiel medzi režimom tlačidla a prepínača na Shelly Plus i4?","Ako nakonfigurovať vstupy Shelly Plus i4 ako tlačidlá alebo prepínače?","Prečo Shelly Plus i4 zobrazuje chybu \"Device is set as switch\" v TapHome?","Dokáže Shelly Plus i4 priamo ovládať relé?"]
---

# Shelly Plus i4

Komunikácia: Packet Parser → MQTT

- [Shelly Plus i4 produktová stránka](https://www.shelly.com/en/products/shop/shelly-plus-i4)
- [Shelly Gen2+ Input Component API](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Input/)

Shelly Plus i4 je kompaktný Wi-Fi 4-kanálový digitálny vstupný modul. Nemá žiadne relé ani výstupy — funguje čisto ako vstupné zariadenie, ktoré detekuje stlačenia tlačidiel a stavy prepínačov na štyroch nezávislých svorkách (SW1–SW4). Zmestí sa za štandardný nástenný vypínač (37 x 42 x 16 mm) a napája sa 110–240 VAC. TapHome komunikuje so zariadením cez MQTT pomocou Gen2+ JSON-RPC 2.0 notifikácií v lokálnej sieti — cloudové pripojenie nie je potrebné.

Každý zo štyroch vstupov je možné nezávisle nakonfigurovať ako **režim tlačidla** (detekcia jedného stlačenia, dvojitého stlačenia, dlhého stlačenia) alebo **režim prepínača** (detekcia stavu zapnuté/vypnuté). Šablóna TapHome vytvára pre každý vstup zariadenie tlačidla aj jazýčkového kontaktu — používate to, ktoré zodpovedá konfigurácii vstupu vo webovom rozhraní Shelly.

## Konfigurácia

### Nastavenie MQTT brokera

Shelly Plus i4 komunikuje cez MQTT. Potrebujete MQTT broker bežiaci vo vašej sieti (napr. Mosquitto). Vo webovom rozhraní Shelly (`http://{ip-zariadenia}`) prejdite do Nastavenia → MQTT a aktivujte MQTT, zadajte IP adresu a port brokera.

### Parametre importu šablóny

Počas importu šablóny v TapHome zadajte tri parametre:

| Parameter | Popis | Príklad |
|-----------|-------|---------|
| **MQTT Broker IP** | IP adresa MQTT brokera | `192.168.1.10` |
| **MQTT Broker Port** | Port brokera (predvolený 1883) | `1883` |
| **Shelly ID** | MQTT client ID z webového rozhrania Shelly → Nastavenia → MQTT | `shellyplusi4-xxxxxxxxxxxx` |

### Konfigurácia režimu vstupu

Po importovaní šablóny nakonfigurujte každý vstup vo webovom rozhraní Shelly (`http://{ip-zariadenia}`) → Vstupy:

- **Režim tlačidla** — pre impulzné tlačidlá. Použite zodpovedajúce zariadenie Tlačidlo 1–4 v TapHome.
- **Režim prepínača** — pre páčkové prepínače alebo jazýčkové kontakty. Použite zodpovedajúce zariadenie Prepínač 1–4 v TapHome.

Každý fyzický vstup môže byť naraz iba jedného typu. Ak je vstup nastavený v režime prepínača, ale TapHome prijme udalosť tlačidla (alebo naopak), listener skript vyhlási chybu o nesúlade.

## Možnosti zariadenia

### Detekcia stlačenia tlačidiel (Tlačidlo 1–4)

Štyri zariadenia tlačidiel počúvajú MQTT `NotifyEvent` správy na topiku `{device_id}/events/rpc`. Každé tlačidlo detekuje tri typy stlačení a mapuje ich na číselné hodnoty:

| Typ stlačenia | Hodnota |
|----------------|---------|
| Jednoduché stlačenie | 1 |
| Dlhé stlačenie | 2 |
| Dvojité stlačenie | 3 |

Zariadenia tlačidiel sú len na čítanie — hlásenia o poslednej detekovanej udalosti. Každé tlačidlo počúva udalosti zo zodpovedajúceho vstupného komponentu (`input:0` až `input:3`).

### Detekcia prepínača/jazýčkového kontaktu (Prepínač 1–4)

Štyri zariadenia jazýčkových kontaktov počúvajú MQTT `NotifyStatus` správy. Každý prepínač číta binárny stav zodpovedajúceho vstupu:

| Stav | Hodnota |
|------|---------|
| Zatvorený (aktívny) | 1 |
| Otvorený (neaktívny) | 0 |

Zariadenia prepínačov sú len na čítanie s intervalom dotazovania 2,5 sekundy. Sú vhodné pre páčkové prepínače, magnetické jazýčkové kontakty alebo akýkoľvek binárny on/off senzor pripojený na vstupné svorky.

### Ďalšie možnosti

Shelly Plus i4 API taktiež podporuje detekciu trojitého stlačenia, surové udalosti button-down/button-up a programatickú metódu `Input.Trigger` (unikátnu pre zariadenia i4), ktorá dokáže emitovať udalosti bez fyzického vstupu. Systémová diagnostika (uptime, MAC, WiFi RSSI) je dostupná cez HTTP RPC, ale nie je sprístupnená v tejto šablóne určenej len pre MQTT. Tieto možnosti môžu byť doplnené v budúcej aktualizácii šablóny.

## Riešenie problémov

### Stlačenia tlačidiel nie sú detekované

1. Overte, že vstup je nakonfigurovaný v režime **tlačidla** vo webovom rozhraní Shelly → Vstupy
2. Skontrolujte, že TapHome je pripojený k MQTT brokeru a Shelly ID zodpovedá MQTT client ID zariadenia
3. Ak TapHome zobrazuje chybu "Device is set as switch", vstup je v režime prepínača — zmeňte ho na režim tlačidla vo webovom rozhraní Shelly alebo namiesto toho použite zariadenie Prepínač 1–4

### Stav prepínača sa neaktualizuje

1. Overte, že vstup je nakonfigurovaný v režime **prepínača** vo webovom rozhraní Shelly → Vstupy
2. Ak TapHome zobrazuje chybu "Device is set as button", vstup je v režime tlačidla — zmeňte ho na režim prepínača alebo namiesto toho použite zariadenie Tlačidlo 1–4
3. Prepnite fyzický prepínač a skontrolujte MQTT broker, či prichádzajú `NotifyStatus` správy na topiku `shellyplusi4-{id}/events/rpc`

### Zariadenie nie je dostupné

1. Overte, že Shelly je pripojený k Wi-Fi — modrá LED dióda by mala svietiť neprerušovane
2. Potvrďte, že MQTT je aktivované vo webovom rozhraní Shelly → Nastavenia → MQTT a adresa brokera je správna
3. Skúste použiť mDNS hostname (`shellyplusi4-AABBCCDDEE.local`) na prístup k webovému rozhraniu Shelly
4. Skontrolujte, že MQTT broker beží a je prístupný z TapHome Core aj zo zariadenia Shelly

> [!NOTE]
> Shelly Plus i4 má MQTT limit **80 notifikácií za 60-sekundové okno**. Rýchle opakované stláčanie tlačidiel môže tento limit prekročiť a spôsobiť stratu niektorých udalostí. Toto je obmedzenie na úrovni firmvéru.

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

> [!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:** zadajte IP adresu MQTT brokera (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

Shelly Plus i4 Modul

Vlastné premenné

|               |
|---------------|
| `ID` (string) |

Tlačidlo 1 Tlačidlo Len na čítanie

Tlačidlo na vstupe input:0 — detekuje jedno stlačenie (1), dlhé stlačenie (2), dvojité stlačenie (3)

numeric JSON-RPC event

Premenná: `Button`

Tlačidlo 2 Tlačidlo Len na čítanie

Tlačidlo na vstupe input:1 — detekuje jedno stlačenie (1), dlhé stlačenie (2), dvojité stlačenie (3)

numeric JSON-RPC event

Tlačidlo 3 Tlačidlo Len na čítanie

Tlačidlo na vstupe input:2 — detekuje jedno stlačenie (1), dlhé stlačenie (2), dvojité stlačenie (3)

numeric JSON-RPC event

Tlačidlo 4 Tlačidlo Len na čítanie

Tlačidlo na vstupe input:3 — detekuje jedno stlačenie (1), dlhé stlačenie (2), dvojité stlačenie (3)

numeric JSON-RPC event

Spínač 1 Jazýčkový kontakt Len na čítanie

Jazýčkový kontakt na vstupe input:0 — zatvorený (1), otvorený (0)

boolean JSON-RPC status

Spínač 2 Jazýčkový kontakt Len na čítanie

Jazýčkový kontakt na vstupe input:1 — zatvorený (1), otvorený (0)

boolean JSON-RPC status

Spínač 3 Jazýčkový kontakt Len na čítanie

Jazýčkový kontakt na vstupe input:2 — zatvorený (1), otvorený (0)

boolean JSON-RPC status

Spínač 4 Jazýčkový kontakt Len na čítanie

Jazýčkový kontakt na vstupe input:3 — zatvorený (1), otvorený (0)

boolean JSON-RPC status

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

Možné vylepšenia (7)

- Triple Push Detection — Input component supports triple\_push events but template only maps single\_push, double\_push, long\_push
- Button Press/Release Events — Raw button-down and button-up events available via MQTT but not captured by template
- Programmatic Input Trigger — Input.Trigger method allows emitting events without physical input — unique to i4/i4 Gen3 devices
- System Status (uptime, RAM, MAC, time) — Available via HTTP /rpc/Sys.GetStatus but template uses MQTT only — no HTTP polling configured
- WiFi Status (SSID, IP, RSSI) — Available via HTTP /rpc/WiFi.GetStatus but template uses MQTT only
- Analog Input Mode — Input component supports analog mode (0-100%) but template does not implement it — Plus i4 hardware supports digital inputs only
- Counter/Pulse Input Mode — Input component supports pulse counting mode but template does not implement it

## Zdroje

- Shelly Gen2+ RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-29
- Shelly Gen2+ System Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Shelly/) 2026-03-29
- Shelly Gen2+ WiFi Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Wifi/) 2026-03-29
- Shelly Gen2+ MQTT Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Mqtt/) 2026-03-29
- Shelly Gen2+ Input Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Input/) 2026-03-29
- Shelly Plus i4 Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-i4) 2026-03-29