TapHome

Shelly Plus 1

Packet Parser → HTTP
Přidal
Poslední aktualizace: 06. 2026
Shelly Plus 1

Shelly Plus 1 je kompaktní Wi-Fi reléový spínač s bezpotenciálovými kontakty. 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 široký rozsah napájení — 110-240 VAC, 24-48 VDC nebo 12 VDC — díky čemuž je vhodné pro síťové i nízkonapěťové instalace. TapHome komunikuje se zařízením přes HTTP pomocí Gen2+ RPC API v lokální síti — cloudové připojení není potřeba.

Šablona poskytuje jeden reléový spínač. Na rozdíl od Plus 1PM toto zařízení nemá vestavěný měřič výkonu.

Konfigurace

Shelly Plus 1 se připojuje přes Wi-Fi. Během importu šablony v TapHome zadejte IP adresu zařízení (výchozí hodnota 192.168.0.1).

Zařízení používá Gen2+ JSON-RPC API. Veškerá komunikace probíhá přes HTTP GET požadavky na /rpc/ koncové body na portu 80.

Možnosti zařízení

Ovládání relé

Šablona zpřístupňuje relé jako spínací zařízení. 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 s parametrem on=true nebo on=false.

Interval dotazování je 2,5 sekundy, což poskytuje téměř okamžitou zpětnou vazbu o stavu v TapHome.

Další možnosti

Shelly Plus 1 přes RPC API zpřístupňuje také vnitřní teplotu relé, stav fyzického vstupu, MAC adresu zařízení, dobu provozu, využití RAM, čas zařízení, IP adresu, název Wi-Fi sítě a sílu Wi-Fi signálu. K dispozici je také časovač automatického vypnutí (parametr toggle_after) a akce restartu zařízení / aktualizace firmwaru. Tyto možnosti mohou být doplněny v budoucí aktualizaci šablony.

Shelly Plus 1 nemá měření výkonu. Pokud potřebujete monitoring spotřeby energie, použijte místo toho Shelly Plus 1PM — má stejný formát a stejné reléové možnosti, ale navíc nabízí měření okamžitého výkonu, napětí, proudu a celkové spotřeby energie.

Ř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 (shellyplus1-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
Relé se nepřepíná
  1. Zkontrolujte režim vstupu ve webovém rozhraní Shelly (nastavení in_mode) — pokud je nastaven na detached, fyzický vypínač neovlivňuje relé, ale HTTP příkazy by měly stále fungovat
  2. Manuálně zavolejte /rpc/Switch.GetStatus?id=0 a ověřte, že pole output se mění při přepínání
  3. Zkontrolujte pole source v odpovědi stavu, abyste zjistili, co naposledy ovládalo relé
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

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

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ě

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í

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í

Shelly Plus 1 Modul
Vlastní proměnné
status (string)
Spínač Přepínač

Jednokanálové ovládání relé — zapnutí/vypnutí přes RPC API

boolean
Hodnoty / Stavy: ON · OFF

Spínač

Čtení stavu přepínače
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
Zápis stavu přepínače
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
Možná vylepšení (12)
  • Switch Temperature — Internal relay temperature in °C, available in Switch.GetStatus response
  • Input State — Physical switch/button input state, available via /rpc/Input.GetStatus?id=0
  • MAC Address — Device MAC address, available in Sys.GetStatus response
  • 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
  • IP Address — Device station IP address, available in WiFi.GetStatus response
  • WiFi SSID — Connected WiFi network name, available in WiFi.GetStatus response
  • WiFi Signal Strength — WiFi RSSI in dBm, available in WiFi.GetStatus response
  • Auto-off Timer — Auto-reset timer in seconds via toggle_after parameter, could be added as switch parameter
  • Reboot — Triggers device reboot, could be added as service action
  • Firmware Update — Initiates OTA firmware update to stable or beta channel

Zdroje

Našli jste problém s touto šablonou zařízení?

Napište nám, co nefunguje, co chybí, nebo jak by se měla šablona chovat. Vaše zpětná vazba nám pomáhá udržet katalog přesný.

Ověřeno TapHome

Chcete to použít ve svém TapHome jádře?

Otevřete tuto šablonu v zákaznickém portálu a použijte ji ve svém domově, nebo navrhněte úpravu a odešlete ji zpět do katalogu.

Otevřít v portálu