TapHome

Shelly Plus 1

Packet Parser → HTTP
Přidal
Poslední aktualizace: 03. 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