---
title: "Shelly 1PM Gen3"
description: "Shelly 1PM Gen3 Wi-Fi relé s měřením výkonu. Ovládejte jeden okruh a sledujte spotřebu energie v reálném čase přes HTTP RPC API z TapHome."
url: "https://taphome.com/cs/compatibility/shelly-1pm-gen3/"
language: cs
lastmod: 2026-03-27
generator: hugo
ai:
  topics: ["http","electric-meter","wifi","relay","power-metering","mdns"]
  questions: ["Jak integrovat Shelly 1PM Gen3 s TapHome?","Co měří šablona Shelly 1PM Gen3 v TapHome?","Jak připojit Shelly 1PM Gen3 přes HTTP k TapHome?","Jaký je rozdíl mezi Shelly 1PM Gen1 a Gen3 v TapHome?","Proč Shelly 1PM Gen3 zobrazuje nulové hodnoty výkonu?","Jak použít mDNS hostname místo IP adresy pro Shelly Gen3?"]
---

# Shelly 1PM Gen3

Komunikace: Packet Parser → HTTP

- [Produktová stránka Shelly 1PM Gen3](https://www.shelly.com/en/products/shop/shelly-1-pm-gen3)

> 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 1PM Gen3 je kompaktní Wi-Fi relé s integrovaným měřením výkonu. Vejde se za standardní nástěnný vypínač a dokáže ovládat jeden okruh se zátěží až 16 A (3500 W při 230 V AC) nebo 10 A (při 24–30 V DC). TapHome komunikuje se zařízením přes HTTP pomocí Gen2+/Gen3 JSON-RPC 2.0 API v lokální síti — cloudové připojení není potřeba.

Na rozdíl od původního Shelly 1PM (Gen1), který používá REST API s endpointem `/status`, verze Gen3 využívá RPC API s voláními metod jako `/rpc/Switch.GetStatus`. Hardware Gen3 obsahuje rychlejší ESP procesor s 8 MB flash pamětí, podporuje až 6 souběžných HTTP připojení (oproti 2 u Gen1) a je připraven na Matter.

Šablona poskytuje ovládání relé a elektroměr, který snímá okamžitou spotřebu energie a celkovou spotřebu.

## Konfigurace

Shelly 1PM Gen3 se připojuje přes Wi-Fi. Při importu šablony do TapHome zadejte IP adresu zařízení (výchozí zástupný symbol `192.168.0.1`).

> [!WARNING]
> Na zařízení Shelly musí být **vypnutá autentifikace** pro integraci s TapHome. TapHome nepodporuje HTTP Digest Auth používanou zařízeními Gen2+/Gen3. Otevřete webové rozhraní Shelly (`http://{device-ip}`) → Nastavení → Autentifikace a ujistěte se, že je vypnutá.

> [!NOTE]
> Pokud je na zařízení Shelly povolen ECO režim, může způsobovat výpadky komunikace kvůli rychlým intervalům dotazování šablony (2,5–3 sekundy). Pokud zaznamenáte přerušované problémy s připojením, vypněte ECO režim ve webovém rozhraní Shelly.

## Možnosti zařízení

### Ovládání relé

Šablona zpřístupňuje relé jako spínač. Stav relé se čte z odpovědi `/rpc/Switch.GetStatus?id=0` (pole `output`, boolean) a ovládá se přes `/rpc/Switch.Set?id=0&on=true` nebo `on=false`.

### Měření výkonu

Integrovaný elektroměr čte dvě hodnoty z odpovědi `/rpc/Switch.GetStatus?id=0`:

- **Okamžitý výkon** — `apower` ve wattech, šablona konvertuje na kW
- **Celková spotřeba** — `aenergy.total` ve watthodinách, šablona konvertuje na kWh

Elektroměr také zpřístupňuje tři servisní atributy:

- **Elektrický proud** — proud zátěže v ampérech (pole `current`)
- **Elektrické napětí** — napájecí napětí ve voltech (pole `voltage`)
- **Teplota** — vnitřní teplota zařízení v °C (pole `temperature.tC`)

Elektroměr je pouze ke čtení — aktualizuje se automaticky při každém cyklu dotazování (interval 15 sekund).

### Servisní diagnostika

Šablona zpřístupňuje servisní atributy na úrovni modulu pro monitorování zařízení:

- **WiFi** — název připojené SSID sítě
- **IP adresa** — aktuální IP adresa stanice
- **Síla signálu** — WiFi RSSI v dB
- **MAC** — MAC adresa zařízení

Čtecí skript modulu také kontroluje dostupné aktualizace firmwaru a požadavky na restart, které zobrazuje jako upozornění v rozhraní TapHome.

### Servisní akce

Na úrovni modulu jsou dostupné dvě servisní akce:

- **Aktualizace firmwaru** — spustí aktualizaci firmwaru na nejnovější stabilní verzi přes `/rpc/Shelly.Update`
- **Restart** — spustí restart zařízení přes `/rpc/Shelly.Reboot`

### Další možnosti

Shelly 1PM Gen3 také zpřístupňuje účiník, síťovou frekvenci (Hz), počítadla vrácené/exportované energie, stav fyzického vstupu (`input:0`), dobu provozu, využití RAM a čas zařízení ve svých RPC odpovědích. K dispozici je také automatický časovač vypnutí přes parametr `toggle_after` a ochrana proti přetížení přes `Switch.SetConfig → power_limit`. Počítadla energie lze resetovat přes `/rpc/Switch.ResetCounters`. Tyto možnosti mohou být přidány v budoucí aktualizaci šablony.

## Řešení problémů

### Zařízení neodpovídá

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

### Hodnoty výkonu zobrazují nulu

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

### Upozornění na přehřívání

Shelly 1PM Gen3 má interní tepelnou ochranu. Pokud teplota zařízení překročí bezpečné limity, hodnota `temperature` v servisních atributech elektroměru se zvýší. Zajistěte dostatečné větrání kolem zařízení, zejména při nepřetržitém spínání vysokých zátěží.

> [!WARNING]
> Zařízení Shelly Gen2+/Gen3 podporují až **6 souběžných HTTP připojení**. I když je to výrazné zlepšení oproti Gen1 (2 připojení), vyhněte se současnému dotazování z příliš mnoha systémů (TapHome, Home Assistant, vlastní skripty), abyste předešli vyčerpání 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 1PM Gen3 Modul

Servisní atributy

|              |
|--------------|
| WiFi         |
| IP adresa    |
| Síla signálu |
| MAC          |

Servisní akce

|                      |
|----------------------|
| Aktualizace firmwaru |
| Restart              |

Vlastní proměnné

Čtení (modul)

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Sys.GetStatus");
IF response.IsSuccess
    Sys.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/Sys.GetConfig");
IF response.IsSuccess
    Sys.GetConfig := response.Content;
END

response := SENDHTTPREQUEST("/rpc/WiFi.GetStatus");
IF response.IsSuccess
    WiFi.GetStatus := response.Content;
END

if ! ISNULL(parsejson(Sys.GetStatus, "available_updates.stable", true))
    addwarning("New firmware update is available");
end

if parsejson(Sys.GetStatus, "restart_required", true)
    addwarning("Restart required");
end
```

Servisní atributy

Wifi

```taphome
PARSEJSON(WiFi.GetStatus, "ssid")
```

${ipAddress}

```taphome
PARSEJSON(WiFi.GetStatus, "sta_ip")
```

${xml\_signal\_strength} \[dB]

```taphome
PARSEJSON(WiFi.GetStatus, "rssi")
```

MAC

```taphome
PARSEJSON(Sys.GetStatus, "mac")
```

Servisní akce

${xml\_update\_fw}

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Update?stage=\"stable\"");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END

```

Reboot

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Reboot");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
```

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"));
var 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
```

Elektroměr Elektroměr Pouze ke čtení

Měření spotřeby energie — okamžitý výkon (kW) a celková spotřeba (kWh) s měřením proudu, napětí a teploty

numeric Jednotka: kW / kWh

Servisní atributy

|                   |
|-------------------|
| Elektrický proud  |
| Elektrické napětí |
| Teplota           |

Čtení celkové spotřeby

```taphome
return(parsejson(parsejson(Switch.GetStatus,"aenergy"), "total")/1000);
```

Čtení odběru

```taphome
return(parsejson(Switch.GetStatus,"apower")/1000);
```

Čtení (modul)

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=0");
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
```

Servisní atributy

${electric\_current} \[A]

```taphome
return(parsejson(Switch.GetStatus,"current"));
```

${electric\_voltage} \[V]

```taphome
return(parsejson(Switch.GetStatus,"voltage"));
```

${temperature} \[°C]

```taphome
return(parsejson(parsejson(Switch.GetStatus,"temperature"), "tC"));
```

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

Možná vylepšení (10)

- 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
- 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
- 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-27
- Shelly Gen2+ Switch Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Switch/) 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
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-27
- Shelly 1PM Gen3 Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-1pm-gen3) 2026-03-27

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