TapHome

Shelly Pro 3

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 03. 2026
Shelly Pro 3

Shelly Pro 3 je 3-kanálový reléový modul na DIN lištu s bezpotenciálovými kontaktmi. Každý z troch nezávislých výstupov dokáže spínať až 16 A (celkovo 48 A cez všetky kanály), čo ho robí vhodným na ovládanie svetelných obvodov, vykurovacích prvkov alebo trojfázových záťaží, kde sa každá fáza spína samostatne. TapHome komunikuje so zariadením cez HTTP pomocou Gen2 JSON-RPC 2.0 API v lokálnej sieti — cloudové pripojenie nie je potrebné.

Na rozdiel od Shelly Pro 3EM, ktorý je elektromer (len monitorovanie), Pro 3 je čisto reléové spínacie zariadenie bez schopnosti merania výkonu. Zariadenie sa pripája cez WiFi, Ethernet (RJ45) alebo Bluetooth a je určené pre profesionálnu inštaláciu do elektrických rozvádzačov.

Konfigurácia

Shelly Pro 3 sa pripája cez WiFi alebo Ethernet. Počas importu šablóny do TapHome zadajte IP adresu zariadenia (predvolený placeholder 192.168.0.1).

Autentifikácia musí byť na zariadení Shelly vypnutá pre integráciu s TapHome. TapHome nepodporuje HTTP Digest Auth používanú zariadeniami Gen2. Otvorte webové rozhranie Shelly (http://{device-ip}) → Settings → Authentication a uistite sa, že je vypnutá.

LAN kábel sa smie zapájať alebo odpájať len keď je zariadenie vypnuté. Hot-plugging Ethernet kábla môže spôsobiť problémy.

Ak je na zariadení Shelly zapnutý ECO režim, môže spôsobiť timeouty komunikácie kvôli rýchlym intervalom dotazovania šablóny (2,5–3 sekundy). Vypnite ECO režim vo webovom rozhraní Shelly, ak zaznamenáte prerušovanú konektivitu.

Schopnosti zariadenia

Ovládanie relé

Šablóna exponuje tri nezávislé spínače, jeden pre každý reléový kanál. Stav každého relé sa číta z odpovede /rpc/Switch.GetStatus?id=N (pole output, boolean) a ovláda cez /rpc/Switch.Set?id=N&on=true alebo on=false, kde N je 0, 1, alebo 2.

Všetky tri kanály pracujú nezávisle — môžu byť na rôznych obvodoch, rôznych AC fázach, alebo dokonca na zmiešaných AC/DC záťažiach. Reléové kontakty sú bezpotenciálové (suché kontakty), takže každý výstup môže spínať úplne oddelený obvod od napájania zariadenia samotného.

Servisná diagnostika

Šablóna exponuje servisné atribúty na úrovni modulu pre monitorovanie zariadenia:

  • WiFi — názov pripojenej SSID siete
  • IP adresa — aktuálna IP adresa stanice
  • Sila signálu — WiFi RSSI v dB
  • MAC — MAC adresa zariadenia

Čítací skript modulu tiež kontroluje dostupnosť aktualizácií firmvéru a požiadavky na čakajúci reštart, a tieto zobrazuje ako varovania v rozhraní TapHome.

Servisné akcie

Dve servisné akcie sú k dispozícii na úrovni modulu:

  • Aktualizácia firmvéru — spustí aktualizáciu firmvéru na najnovšiu stabilnú verziu cez /rpc/Shelly.Update
  • Reštart — spustí reštart zariadenia cez /rpc/Shelly.Reboot
Ďalšie schopnosti

Shelly Pro 3 tiež exponuje stavy fyzických prepínačov/tlačidiel (S1, S2, S3) cez komponent Input, vnútornú teplotu zariadenia, dobu prevádzky, využitie RAM, čas zariadenia a stav Ethernetu cez RPC API. Auto-off časovač je dostupný cez parameter toggle_after príkazu Switch.Set. Tieto schopnosti môžu byť pridané v budúcej aktualizácii šablóny.

Riešenie problémov

Zariadenie neodpovedá
  1. Overte, že Shelly je pripojený k WiFi alebo Ethernetu a má platnú IP adresu
  2. Skúste použiť mDNS hostname (ShellyPro3-AABBCCDDEE.local) namiesto IP adresy — IP sa mohla zmeniť po obnovení DHCP
  3. Otvorte http://{device-ip}/rpc/Shelly.GetDeviceInfo v prehliadači — ak odpovie JSON-om, zariadenie je dostupné
  4. Skontrolujte, že TapHome Core a Shelly sú v rovnakej sieti / VLAN
  5. Potvrďte, že autentifikácia je na zariadení Shelly vypnutá
Len niektoré kanály reagujú
  1. Overte, že každý kanál je správne adresovaný (id=0 pre Výstup 1, id=1 pre Výstup 2, id=2 pre Výstup 3)
  2. Skontrolujte LED indikátory relé na prednom paneli zariadenia — červená LED znamená, že príslušné relé je zopnuté (ON)
  3. Otestujte nereagujúci kanál manuálne cez prehliadač: http://{device-ip}/rpc/Switch.Set?id=N&on=true
Problémy s induktívnou záťažou

Pre induktívne záťaže (ventilátory, transformátory, LED drivery) sa odporúča RC člen (0,1 uF / 100 Ohm / 1/2 W / 600 VAC) na výstupe relé na ochranu pred napäťovými špičkami a predĺženie životnosti relé.

Zariadenia Shelly Gen2 podporujú až 6 súbežných HTTP pripojení. Vyhnite sa dotazovaniu z príliš veľa systémov súčasne (TapHome, Home Assistant, vlastné skripty), aby ste predišli vyčerpaniu pripojení.

Ako nainštalovať v TapHome

Predpoklady

  • Zariadenie Shelly nainštalované a zapnuté
  • Lokálna Wi-Fi sieť (2,4 GHz)
  • TapHome CCU v rovnakej sieti

Krok 1 — Pripojte Shelly k Wi-Fi

Možnosť A — Aplikácia Shelly (odporúčané):

  1. Stiahnite si aplikáciu Shelly (iOS / Android)
  2. Klepnite na + → Add Device a postupujte podľa sprievodcu Bluetooth párovaním
  3. Po výzve zadajte svoje Wi-Fi prihlasovacie údaje

Možnosť B — AP režim (bez aplikácie):

  1. Pri prvom zapnutí zariadenie vytvorí hotspot: ShellyXXX-AABBCCDDEE
  2. Pripojte telefón/PC k tomuto hotspotu
  3. Otvorte http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
  4. Zadajte SSID a heslo → Save

Shelly podporuje iba 2,4 GHz siete. 5 GHz siete sa pri skenovaní nezobrazia.

Krok 2 — Zistite IP adresu

Po pripojení k Wi-Fi zistite priradenú IP adresu jedným z nasledujúcich spôsobov:

  • Aplikácia Shelly: Detail zariadenia → Device info → IP adresa
  • Webové rozhranie Shelly: Pripojte sa k AP zariadenia pred nastavením Wi-Fi — IP sa zobrazí po uložení
  • DHCP tabuľka routera: Hľadajte hostname ako shelly1pm-AABBCCDDEE
  • mDNS: Pingnite shelly<model>-<mac>.local (napr. shelly1pm-AABBCCDDEE.local) z rovnakej siete

Priraďte zariadeniu Shelly statickú IP (DHCP rezerváciu) vo vašom routeri, aby sa adresa nezmenila po reštarte routera.

Krok 3 — Konfigurácia v TapHome

  1. V TapHome pridajte nový modul Packet Parser (HTTP)
  2. IP Address: zadajte IP z kroku 2 (napr. 192.168.1.50)
  3. Port: 80 (predvolený, nie je potrebné meniť)
  4. Importujte šablónu — TapHome bude pravidelne čítať /status pre zistenie stavu zariadenia

HTTP autentifikácia je na zariadeniach Shelly štandardne vypnutá. Ak ste povolili ochranu prihlásením, TapHome momentálne nepodporuje HTTP Basic Auth — pre integráciu s TapHome ponechajte autentifikáciu vypnutú.

Dostupné zariadenia

Shelly Pro 3 Modul
Servisné atribúty
WiFi
IP adresa
Sila signálu
MAC
Servisné akcie
Aktualizácia firmvéru
Reštart
Vlastné premenné

Shelly Pro 3

Čítanie (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é atribúty
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é akcie
${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 Prepínač
boolean
Hodnoty / Stavy: ON · OFF

Spínač 1

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

Spínač 2

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

Spínač 3

Čítanie stavu prepínača
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
Zápis stavu prepínača
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
Pripojenie: Packet Parser → HTTP
Možné vylepšenia (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