TapHome

Shelly Pro 3

Packet Parser → HTTP
Přidal
Poslední aktualizace: 03. 2026
Shelly Pro 3

Shelly Pro 3 je 3kanálový reléový modul na DIN lištu s bezpotenciálovými kontakty. Každý ze tří nezávislých výstupů dokáže spínat až 16 A (celkem 48 A přes všechny kanály), což jej činí vhodným pro ovládání světelných obvodů, topných prvků nebo třífázových zátěží, kde se každá fáze spíná samostatně. TapHome komunikuje se zařízením přes HTTP pomocí Gen2 JSON-RPC 2.0 API v lokální síti — cloudové připojení není potřeba.

Na rozdíl od Shelly Pro 3EM, který je elektroměr (pouze monitorování), Pro 3 je čistě reléové spínací zařízení bez schopnosti měření výkonu. Zařízení se připojuje přes WiFi, Ethernet (RJ45) nebo Bluetooth a je určeno pro profesionální instalaci do elektrických rozváděčů.

Konfigurace

Shelly Pro 3 se připojuje přes WiFi nebo Ethernet. Během importu šablony do TapHome zadejte IP adresu zařízení (výchozí placeholder 192.168.0.1).

Autentifikace musí být na zařízení Shelly vypnutá pro integraci s TapHome. TapHome nepodporuje HTTP Digest Auth používanou zařízeními Gen2. Otevřete webové rozhraní Shelly (http://{device-ip}) → Settings → Authentication a ujistěte se, že je vypnutá.

LAN kabel se smí zapojovat nebo odpojovat pouze když je zařízení vypnuté. Hot-plugging Ethernet kabelu může způsobit problémy.

Pokud je na zařízení Shelly zapnutý ECO režim, může způsobit timeouty komunikace kvůli rychlým intervalům dotazování šablony (2,5–3 sekundy). Vypněte ECO režim ve webovém rozhraní Shelly, pokud zaznamenáte přerušovanou konektivitu.

Schopnosti zařízení

Ovládání relé

Šablona exponuje tři nezávislé spínače, jeden pro každý reléový kanál. Stav každého relé se čte z odpovědi /rpc/Switch.GetStatus?id=N (pole output, boolean) a ovládá přes /rpc/Switch.Set?id=N&on=true nebo on=false, kde N je 0, 1, nebo 2.

Všechny tři kanály pracují nezávisle — mohou být na různých obvodech, různých AC fázích, nebo dokonce na smíšených AC/DC zátěžích. Reléové kontakty jsou bezpotenciálové (suché kontakty), takže každý výstup může spínat úplně oddělený obvod od napájení zařízení samotného.

Servisní diagnostika

Šablona exponuje 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 dostupnost aktualizací firmwaru a požadavky na čekající restart, a tyto zobrazuje jako varování v rozhraní TapHome.

Servisní akce

Dvě servisní akce jsou k dispozici na úrovni modulu:

  • 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ší schopnosti

Shelly Pro 3 také exponuje stavy fyzických přepínačů/tlačítek (S1, S2, S3) přes komponentu Input, vnitřní teplotu zařízení, dobu provozu, využití RAM, čas zařízení a stav Ethernetu přes RPC API. Auto-off časovač je dostupný přes parametr toggle_after příkazu Switch.Set. Tyto schopnosti 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 WiFi nebo Ethernetu a má platnou IP adresu
  2. Zkuste použít mDNS hostname (ShellyPro3-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-em, 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á
Jen některé kanály reagují
  1. Ověřte, že každý kanál je správně adresován (id=0 pro Výstup 1, id=1 pro Výstup 2, id=2 pro Výstup 3)
  2. Zkontrolujte LED indikátory relé na předním panelu zařízení — červená LED znamená, že příslušné relé je sepnuto (ON)
  3. Otestujte nereagující kanál manuálně přes prohlížeč: http://{device-ip}/rpc/Switch.Set?id=N&on=true
Problémy s induktivní zátěží

Pro induktivní zátěže (ventilátory, transformátory, LED drivery) se doporučuje RC člen (0,1 uF / 100 Ohm / 1/2 W / 600 VAC) na výstupu relé pro ochranu před napěťovými špičkami a prodloužení životnosti relé.

Zařízení Shelly Gen2 podporují až 6 souběžných HTTP připojení. Vyhněte se dotazování z příliš mnoha systémů současně (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 (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 Pro 3 Modul
Servisní atributy
WiFi
IP adresa
Síla signálu
MAC
Servisní akce
Aktualizace firmwaru
Restart
Vlastní proměnné

Shelly Pro 3

Čtení (modul)
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
PARSEJSON(WiFi.GetStatus, "ssid")
${ipAddress}
PARSEJSON(WiFi.GetStatus, "sta_ip")
${xml_signal_strength} [dB]
PARSEJSON(WiFi.GetStatus, "rssi")
MAC
PARSEJSON(Sys.GetStatus, "mac")
Servisní akce
${xml_update_fw}
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Update?stage=\"stable\"");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
Reboot
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Reboot");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
Spínač 1 Přepínač
boolean
Hodnoty / Stavy: ON · OFF

Spínač 1

Čtení stavu přepínače
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
Zápis stavu přepínače
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
Spínač 2 Přepínač
boolean
Hodnoty / Stavy: ON · OFF

Spínač 2

Čtení stavu přepínače
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
Zápis stavu přepínače
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
Spínač 3 Přepínač
boolean
Hodnoty / Stavy: ON · OFF

Spínač 3

Čtení stavu přepínače
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
Zápis stavu přepínače
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
Připojení: Packet Parser → HTTP
Možná vylepšení (9)
  • Input 1 State — Physical switch/button input S1 state, available via /rpc/Input.GetStatus?id=0
  • Input 2 State — Physical switch/button input S2 state, available via /rpc/Input.GetStatus?id=1
  • Input 3 State — Physical switch/button input S3 state, available via /rpc/Input.GetStatus?id=2
  • Device Temperature — Internal temperature in °C, available in Switch.GetStatus response (non-metered devices may still report temperature)
  • 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 for all 3 channels
  • Ethernet Status — Pro 3 has RJ45 LAN port; Ethernet status (IP, link) available via /rpc/Ethernet.GetStatus

Zdroje