---
title: "Shelly Plus 1PM"
description: "Shelly Plus 1PM v TapHome přes HTTP nebo MQTT: spínání jednoho okruhu do 16 A a měření výkonu, energie, napětí a proudu. Lokálně, bez cloudu."
url: "https://taphome.com/cs/compatibility/shelly-plus-1pm/"
language: cs
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","mqtt","electric-meter","wifi","relay","power-metering","gen2plus"]
  questions: ["Jak integrovat Shelly Plus 1PM s TapHome?","Co měří šablona Shelly Plus 1PM v TapHome?","Jak připojit Shelly Plus 1PM přes HTTP k TapHome?","Jak připojit Shelly Plus 1PM přes MQTT k TapHome?","Jaký je rozdíl mezi Shelly Plus 1PM a Shelly 1PM v TapHome?","Proč Shelly Plus 1PM ukazuje nulové hodnoty výkonu?","Jaké diagnostiky jsou dostupné pro Shelly Plus 1PM v TapHome?","Mohu použít MQTT místo HTTP pro Shelly Plus 1PM?"]
---

# Shelly Plus 1PM

Komunikace: Packet Parser → HTTP

- [Shelly Plus 1PM produktová stránka](https://www.shelly.com/en/products/shop/shelly-plus-1pm)
- [Shelly Plus 1PM API dokumentace](https://shelly-api-docs.shelly.cloud/gen2/)

> Adresa v síti
> 
> TapHome komunikuje se zařízením na adrese zadané při importu. Dejte zařízení stálou adresu — rezervaci IP v routeru, nebo jeho mDNS jméno, pokud ho podporuje —, jinak integrace přestane fungovat, když router adresu změní.
> 
> [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)

## Návod na integraci

Shelly Plus 1PM je kompaktní Gen2+ Wi-Fi reléový spínač s vestavěným měřením výkonu. Vejde se za standardní nástěnný vypínač a dokáže ovládat jeden okruh do 16 A (3500 W při 230 V AC) nebo 10 A (30 V DC). Zařízení podporuje napájení 110-240 VAC nebo 24-30 VDC, díky čemuž je vhodné pro síťové i nízkonapěťové instalace. TapHome komunikuje se zařízením lokálně přes Wi-Fi — cloudové připojení není potřeba.

K dispozici jsou dvě šablony TapHome: **HTTP šablona**, která dotazuje Gen2+ RPC API zařízení, a **MQTT šablona**, která přijímá data přes MQTT broker. Obě zpřístupňují stejná dvě zařízení — měřič energie a reléový spínač.

## Konfigurace

### HTTP šablona

HTTP šablona vyžaduje pouze IP adresu zařízení (výchozí hodnota `192.168.0.1`). TapHome dotazuje koncový bod `/rpc/Switch.GetStatus?id=0` pro stav relé i data měření výkonu. Modul ukládá JSON odpověď do proměnné `status`, aby jednotlivé skripty zařízení mohly parsovat data bez redundantních HTTP volání.

### MQTT šablona

MQTT šablona vyžaduje při importu tři parametry:

- **IP adresa MQTT brokera** — IP adresa MQTT brokera (ne samotného zařízení Shelly)
- **Port MQTT brokera** — výchozí `1883`
- **MQTT Client ID zařízení Shelly** — formát `shellyplus1pm-{deviceid}`, najdete ve webovém rozhraní Shelly v části **Settings** > **MQTT Settings** > **Client ID**

Po aktivaci MQTT na Shelly Plus 1PM (Settings > MQTT) se TapHome přihlásí k odběru `shellyplus1pm-{deviceid}/status/switch:0` a ovládací příkazy posílá na `shellyplus1pm-{deviceid}/command/switch:0`.

## Možnosti zařízení

### Ovládání relé

Šablona zpřístupňuje relé jako spínací zařízení. Stav relé se čte z pole `output` (boolean) a ovládá se přes `/rpc/Switch.Set?id=0` s parametrem `on=true` nebo `on=false` (HTTP) nebo publikováním `on`/`off` na příkazový topic (MQTT).

HTTP šablona dotazuje relé v 2,5sekundovém intervalu, což poskytuje téměř okamžitou zpětnou vazbu o stavu. MQTT šablona přijímá aktualizace průběžně přes listener skript.

### Měření výkonu

Vestavěný měřič energie čte dvě hodnoty z odpovědi Switch.GetStatus:

- **Okamžitý výkon** — `apower` ve wattech, šablona konvertuje na kW (dělení 1000)
- **Celková spotřeba energie** — `aenergy.total` ve watthodinách, šablona konvertuje na kWh (dělení 1000)

Měřič je pouze ke čtení — aktualizuje se automaticky s každým cyklem dotazování (HTTP) nebo s každou MQTT stavovou zprávou.

HTTP šablona zpřístupňuje na měřiči energie také tři servisní atributy:

| Atribut | Jednotka | Popis |
|---------|----------|-------|
| Proud | A | Okamžitý odebíraný proud |
| Napětí | V | Efektivní síťové napětí |
| Teplota | °C | Vnitřní teplota zařízení |

MQTT šablona zpřístupňuje vnitřní teplotu, napětí a proud jako servisní atributy na úrovni modulu se stejnými daty, parsovanými z MQTT stavové zprávy.

### Další možnosti

Shelly Plus 1PM přes RPC API zpřístupňuje také účiník, síťovou frekvenci, vrácenou energii (pro obousměrné měření), stav fyzického vstupu, sílu Wi-Fi signálu, MAC adresu, dobu provozu, využití RAM a čas zařízení. K dispozici jsou také akce aktualizace firmwaru, restart zařízení, časovač automatického vypnutí, reset počítadla energie a konfigurace ochrany před přetížením. Tyto možnosti mohou být doplněny v budoucí aktualizaci šablony.

## Řešení problémů

### Zařízení neodpovídá (HTTP)

1. Ověřte, že Shelly je připojen k Wi-Fi a má platnou IP adresu
2. Zkuste použít mDNS hostname (`shellyplus1pm-AABBCCDDEE.local`) místo IP adresy — IP se mohla změnit po obnovení DHCP
3. Otevřete `http://{ip-zarizeni}/rpc/Shelly.GetDeviceInfo` v prohlížeči — pokud odpoví JSON, zařízení je dostupné
4. Zkontrolujte, že TapHome CCU a Shelly jsou ve stejné síti / VLAN
5. Ujistěte se, že HTTP Digest autentifikace je vypnutá ve webovém rozhraní Shelly — TapHome nepodporuje autentifikované požadavky

### MQTT zprávy nepřicházejí

1. Ověřte, že MQTT je aktivováno ve webovém rozhraní Shelly (Settings > MQTT)
2. Potvrďte, že adresa a port brokera jsou správné v zařízení Shelly i v nastavení modulu TapHome
3. Zkontrolujte, že vlastní proměnná `plug1topic` přesně odpovídá MQTT Client ID zařízení Shelly (např. `shellyplus1pm-AABBCCDDEE`)
4. Použijte MQTT klienta (např. MQTT Explorer) k odběru `shellyplus1pm-#` a ověřte, zda zařízení publikuje zprávy

### Hodnoty výkonu ukazují nulu

1. Potvrďte, že zátěž je připojena přes relé Shelly (ne obejitá)
2. Zkontrolujte, že relé je zapnuté — měřič měří pouze když přes relé protéká proud
3. Manuálně zavolejte `/rpc/Switch.GetStatus?id=0` a ověřte, že `apower` vrací nenulovou hodnotu

### Pomalá odezva nebo výpadky

1. Gen2+ zařízení podporují až 6 současných HTTP připojení (oproti 2 na Gen1) — vyhněte se však nadměrnému dotazování z více systémů
2. Vypněte režim ECO ve webovém rozhraní Shelly, pokud je zapnutý — přepíná zařízení do režimu spánku mezi dotazy a může způsobovat výpadky při krátkých intervalech dotazování
3. Použijte statickou IP nebo DHCP rezervaci, aby nedocházelo ke změnám adresy
4. Zvažte přechod na MQTT šablonu v prostředích s více systémy — MQTT zcela obchází problém limitu připojení

## Jak nainstalovat v TapHome

### Předpoklady

- Zařízení Shelly nainstalované a zapnuté
- Lokální Wi-Fi síť (2,4 GHz)
- TapHome CCU ve stejné síti

### Krok 1 — Připojte Shelly k Wi-Fi

**Možnost A — Aplikace Shelly (doporučeno):**

1. Stáhněte si [aplikaci Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Klepněte na **+** → **Add Device** a postupujte podle průvodce Bluetooth párováním
3. Po výzvě zadejte své Wi-Fi přihlašovací údaje

**Možnost B — AP režim (bez aplikace):**

1. Při prvním zapnutí zařízení vytvoří hotspot: `ShellyXXX-AABBCCDDEE`
2. Připojte telefon/PC k tomuto hotspotu
3. Otevřete `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Zadejte SSID a heslo → **Save**

> [!NOTE]
> Shelly podporuje pouze **2,4 GHz** sítě. 5 GHz sítě se při skenování nezobrazí.

### Krok 2 — Zjistěte IP adresu

Po připojení k Wi-Fi zjistěte přiřazenou IP adresu jedním z následujících způsobů:

- **Aplikace Shelly:** Detail zařízení → **Device info** → IP adresa
- **Webové rozhraní Shelly:** Připojte se k AP zařízení před nastavením Wi-Fi — IP se zobrazí po uložení
- **DHCP tabulka routeru:** Hledejte hostname jako `shelly1pm-AABBCCDDEE`
- **mDNS:** Pingněte `shelly<model>-<mac>.local` (např. `shelly1pm-AABBCCDDEE.local`) ze stejné sítě

> [!TIP]
> Přiřaďte zařízení Shelly **statickou IP** (DHCP rezervaci) ve vašem routeru, aby se adresa nezměnila po restartu routeru.

### Krok 3 — Konfigurace v TapHome

1. V TapHome přidejte nový modul **Packet Parser (HTTP)**
2. **IP Address:** zadejte IP z kroku 2 (např. `192.168.1.50`)
3. **Port:** `80` (výchozí, není potřeba měnit)
4. Importujte šablonu — TapHome bude pravidelně číst `/status` pro zjištění stavu zařízení

> [!NOTE]
> HTTP autentifikace je na zařízeních Shelly standardně vypnutá. Pokud jste povolili ochranu přihlášením, TapHome momentálně nepodporuje HTTP Basic Auth — pro integraci s TapHome ponechte autentifikaci vypnutou.

## Dostupná zařízení 2

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

Shelly Plus 1PM Modul

Vlastní proměnné

Elektroměr Elektroměr Pouze ke čtení

Okamžitý výkon (kW) a celková spotřeba (kWh) s diagnostikou proudu, napětí a teploty

numeric Jednotka: kW / kWh

Servisní atributy

|         |
|---------|
| Proud   |
| Napětí  |
| Teplota |

Čtení celkové spotřeby

```taphome
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
```

Čtení odběru

```taphome
return(parsejson(status,"apower")/1000);
```

Čtení (modul)

```taphome
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
```

Servisní atributy

${current} \[a]

```taphome
return(parsejson(status,"current"));
```

${electric\_voltage} \[v]

```taphome
return(parsejson(status,"voltage"));
```

${temp} \[C]

```taphome
return(parsejson(parsejson(status,"temperature"), "tC"));
```

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

boolean

Hodnoty / Stavy: ON · OFF

Čtení stavu přepínače

```taphome
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
```

Zápis stavu přepínače

```taphome
VAR response := SENDHTTPREQUEST("rpc/Switch.Set?id=0&on=" + if(St,"true","false"));
IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
END
```

**Připojení:** Packet Parser → HTTP • Hostname: `shellyplus1pm-{MAC}.local`

Možná vylepšení (16)

- Power Factor — Power factor value, available in Switch.GetStatus response for metered devices
- Network Frequency — AC network frequency in Hz, available in Switch.GetStatus response
- Returned Energy — Returned/exported energy in Wh, for bi-directional metering scenarios
- Input State — Physical switch/button input state, available via /rpc/Input.GetStatus?id=0
- WiFi SSID — Connected WiFi network name, available via /rpc/WiFi.GetStatus
- WiFi Signal Strength — WiFi RSSI in dBm, available via /rpc/WiFi.GetStatus
- IP Address — Device IP address, available via /rpc/WiFi.GetStatus
- MAC Address — Device MAC address, available via /rpc/Sys.GetStatus
- Uptime — Seconds since last reboot, available in Sys.GetStatus response
- RAM Usage — Total and free RAM in bytes, available in Sys.GetStatus response
- Device Time — Current device time in HH:MM format, available in Sys.GetStatus response
- Firmware Update — Trigger firmware update to stable channel, available via Shelly.Update RPC method
- Reboot — Reboot the device, available via Shelly.Reboot RPC method
- Auto-off Timer — Auto-reset timer in seconds via toggle\_after parameter, could be added as switch parameter
- Reset Energy Counters — Resets energy measurement counters (aenergy, ret\_aenergy)
- Overpower Protection — Configurable power limit threshold in Watts, relay turns off when exceeded

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci | Výchozí       |
|-------------------|---------------|
| IP adresa         | `192.168.0.1` |

## Zdroje

- Shelly Gen2+/Gen3 RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-29
- Shelly Gen2+ Switch Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Switch/) 2026-03-29
- Shelly Gen2+ System (Sys) Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 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
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-29
- Shelly Plus 1PM Knowledge Base — specs & wiring
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-1pm) 2026-03-29

## Související dokumentace

- [Integrace Packet Parser](https://taphome.com/cs/compatibility/packet-parser-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/)