TapHome

Shelly 1PM Gen3

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 03. 2026
Shelly 1PM Gen3

Shelly 1PM Gen3 je kompaktné Wi-Fi relé s integrovaným meraním výkonu. Zmestí sa za štandardný nástenný vypínač a dokáže ovládať jeden okruh s maximálnym zaťažením 16 A (3500 W pri 230 V AC) alebo 10 A (pri 24–30 V DC). TapHome komunikuje so zariadením cez HTTP pomocou Gen2+/Gen3 JSON-RPC 2.0 API v lokálnej sieti — cloudové pripojenie nie je potrebné.

Na rozdiel od pôvodného Shelly 1PM (Gen1), ktorý používa REST API s endpointom /status, verzia Gen3 využíva RPC API s volaniami metód ako /rpc/Switch.GetStatus. Hardvér Gen3 obsahuje rýchlejší ESP procesor s 8 MB flash pamäťou, podporuje až 6 súbežných HTTP pripojení (oproti 2 na Gen1) a je pripravený na Matter.

Šablóna poskytuje ovládanie relé a elektromer, ktorý sníma okamžitú spotrebu energie a celkovú spotrebu.

Konfigurácia

Shelly 1PM Gen3 sa pripája cez Wi-Fi. Pri importe šablóny do TapHome zadajte IP adresu zariadenia (predvolený zástupný symbol 192.168.0.1).

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

Ak je na zariadení Shelly povolený ECO režim, môže spôsobiť výpadky komunikácie kvôli rýchlym intervalom dotazovania šablóny (2,5–3 sekundy). Ak zaznamenáte prerušované problémy s pripojením, vypnite ECO režim vo webovom rozhraní Shelly.

Možnosti zariadenia

Ovládanie relé

Šablóna sprístupňuje relé ako spínač. Stav relé sa číta z odpovede /rpc/Switch.GetStatus?id=0 (pole output, boolean) a ovláda sa cez /rpc/Switch.Set?id=0&on=true alebo on=false.

Meranie výkonu

Integrovaný elektromer číta dve hodnoty z odpovede /rpc/Switch.GetStatus?id=0:

  • Okamžitý výkon — apower vo wattoch, šablóna konvertuje na kW
  • Celková spotreba — aenergy.total vo watthodinách, šablóna konvertuje na kWh

Elektromer tiež sprístupňuje tri servisné atribúty:

  • Elektrický prúd — prúd záťaže v ampéroch (pole current)
  • Elektrické napätie — napájacie napätie vo voltoch (pole voltage)
  • Teplota — vnútorná teplota zariadenia v °C (pole temperature.tC)

Elektromer je len na čítanie — aktualizuje sa automaticky pri každom cykle dotazovania (interval 15 sekúnd).

Servisná diagnostika

Šablóna sprístupňuje 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 dostupné aktualizácie firmvéru a požiadavky na reštart, ktoré zobrazuje ako upozornenia v rozhraní TapHome.

Servisné akcie

Na úrovni modulu sú dostupné dve servisné akcie:

  • 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 možnosti

Shelly 1PM Gen3 tiež sprístupňuje účinník, sieťovú frekvenciu (Hz), počítadlá vrátenej/exportovanej energie, stav fyzického vstupu (input:0), dobu prevádzky, využitie RAM a čas zariadenia vo svojich RPC odpovediach. K dispozícii je aj automatický časovač vypnutia cez parameter toggle_after a ochrana proti preťaženiu cez Switch.SetConfig → power_limit. Počítadlá energie je možné resetovať cez /rpc/Switch.ResetCounters. Tieto možnosti môžu byť pridané v budúcej aktualizácii šablóny.

Riešenie problémov

Zariadenie neodpovedá
  1. Overte, že Shelly je pripojený k Wi-Fi a má platnú IP adresu
  2. Skúste použiť mDNS hostname (shelly1pmg3-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, 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á
Hodnoty výkonu zobrazujú nulu
  1. Potvrďte, že záťaž je pripojená cez relé Shelly (nie obídená)
  2. Skontrolujte, že relé je zapnuté — merač sníma len keď cez relé preteká prúd
  3. Manuálne zavolajte /rpc/Switch.GetStatus?id=0 a overte, že apower vracia nenulovú hodnotu
Upozornenie na prehrievanie

Shelly 1PM Gen3 má internú tepelnú ochranu. Ak teplota zariadenia prekročí bezpečné limity, hodnota temperature v servisných atribútoch elektromeru sa zvýši. Zabezpečte dostatočné vetranie okolo zariadenia, najmä pri nepretržitom spínaní vysokých záťaží.

Zariadenia Shelly Gen2+/Gen3 podporujú až 6 súbežných HTTP pripojení. Aj keď je to výrazné zlepšenie oproti Gen1 (2 pripojenia), vyhnite sa súčasnému dotazovaniu z príliš veľa systémov (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 1PM Gen3 Modul
Servisné atribúty
WiFi
IP adresa
Sila signálu
MAC
Servisné akcie
Aktualizácia firmvéru
Reštart
Vlastné premenné

Shelly 1PM Gen3

Čí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č Prepínač
boolean
Hodnoty / Stavy: ON · OFF

Spínač

Čítanie stavu prepínača
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
var status := x.Content;
return(PARSEJSON(status, "$.output", true));
Zápis stavu prepínača
VAR response := SENDHTTPREQUEST("rpc/Switch.Set?id=0&on=" + if(St,"true","false"));
IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
END
Elektromer Elektromer Len na čítanie

Meranie spotreby energie — okamžitý výkon (kW) a celková spotreba (kWh) s meraním prúdu, napätia a teploty

numeric Jednotka: kW / kWh
Servisné atribúty
Elektrický prúd
Elektrické napätie
Teplota

Elektromer

Čítanie celkovej spotreby
return(parsejson(parsejson(Switch.GetStatus,"aenergy"), "total")/1000);
Čítanie odberu
return(parsejson(Switch.GetStatus,"apower")/1000);
Čítanie (modul)
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=0");
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
Servisné atribúty
${electric_current} [A]
return(parsejson(Switch.GetStatus,"current"));
${electric_voltage} [V]
return(parsejson(Switch.GetStatus,"voltage"));
${temperature} [°C]
return(parsejson(parsejson(Switch.GetStatus,"temperature"), "tC"));
Pripojenie: Packet Parser → HTTP
Možné vylepšenia (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

Zdroje