TapHome
Oficiálna · TapHome Overená

Shelly Plus 1

Shelly Plus 1 Wi-Fi reléový spínač s bezpotenciálovými kontaktmi. Ovládaj jeden okruh cez HTTP z TapHome — bez cloudu.

ShellyPacket Parser → HTTP1 zariadenieRevízia 1.0 Posledná aktualizácia: 29. marca 2026
Shelly Plus 1

Import do aplikácie TapHomeHardvér › Packet Parser › Pridať zo šablóny

Stiahnuť šablónu
Na tejto stránke

Toto zariadenie podporuje mDNS

Namiesto IP adresy môžete zariadenie osloviť na:

shellyplus1-{MAC}.local

Nahraďte {MAC} MAC adresou zariadenia (veľké písmená, bez dvojbodiek).

TapHome podporuje mDNS — použitie hostname je spoľahlivejšie ako statická IP.

Adresa v sieti

TapHome komunikuje so zariadením na adrese zadanej pri importe. Dajte zariadeniu stálu adresu — rezerváciu IP v routeri, alebo jeho mDNS meno, ak ho podporuje —, inak integrácia prestane fungovať, keď router adresu zmení.

Príprava siete

Návod na integráciu

Shelly Plus 1 je kompaktný Wi-Fi reléový spínač s bezpotenciálovými kontaktmi. Zmestí sa za štandardný nástenný vypínač a dokáže ovládať jeden okruh do 16 A (3500 W pri 230 V AC) alebo 10 A (30 V DC). Zariadenie podporuje široký rozsah napájania — 110-240 VAC, 24-48 VDC alebo 12 VDC — vďaka čomu je vhodné pre sieťové aj nízkonapäťové inštalácie. TapHome komunikuje so zariadením cez HTTP pomocou Gen2+ RPC API v lokálnej sieti — cloudové pripojenie nie je potrebné.

Šablóna poskytuje jeden reléový spínač. Na rozdiel od Plus 1PM toto zariadenie nemá vstavaný merač výkonu.

Konfigurácia

Shelly Plus 1 sa pripája cez Wi-Fi. Počas importu šablóny v TapHome zadajte IP adresu zariadenia (predvolená hodnota 192.168.0.1).

Zariadenie používa Gen2+ JSON-RPC API. Celá komunikácia prebieha cez HTTP GET požiadavky na /rpc/ koncové body na porte 80.

Možnosti zariadenia

Ovládanie relé

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

Interval dotazovania je 2,5 sekundy, čo poskytuje takmer okamžitú spätnú väzbu o stave v TapHome.

Ďalšie možnosti

Shelly Plus 1 cez RPC API sprístupňuje aj vnútornú teplotu relé, stav fyzického vstupu, MAC adresu zariadenia, dobu prevádzky, využitie RAM, čas zariadenia, IP adresu, názov Wi-Fi siete a silu Wi-Fi signálu. K dispozícii je aj časovač automatického vypnutia (parameter toggle_after) a akcie reštartu zariadenia / aktualizácie firmvéru. Tieto možnosti môžu byť doplnené v budúcej aktualizácii šablóny.

Shelly Plus 1 nemá meranie výkonu. Ak potrebujete monitoring spotreby energie, použite namiesto toho Shelly Plus 1PM — má rovnaký formát a rovnaké reléové možnosti, ale navyše ponúka meranie okamžitého výkonu, napätia, prúdu a celkovej spotreby energie.

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 (shellyplus1-AABBCCDDEE.local) namiesto IP adresy — IP sa mohla zmeniť po obnovení DHCP
  3. Otvorte http://{ip-zariadenia}/rpc/Shelly.GetDeviceInfo v prehliadači — ak odpovie JSON, zariadenie je dostupné
  4. Skontrolujte, že TapHome CCU a Shelly sú v rovnakej sieti / VLAN
  5. Uistite sa, že HTTP Digest autentifikácia je vypnutá vo webovom rozhraní Shelly — TapHome nepodporuje autentifikované požiadavky

Relé sa neprepína

  1. Skontrolujte režim vstupu vo webovom rozhraní Shelly (nastavenie in_mode) — ak je nastavený na detached, fyzický vypínač neovplyvňuje relé, ale HTTP príkazy by mali stále fungovať
  2. Manuálne zavolajte /rpc/Switch.GetStatus?id=0 a overte, že pole output sa mení pri prepínaní
  3. Skontrolujte pole source v odpovedi stavu, aby ste zistili, čo naposledy ovládalo relé

Pomalá odozva alebo výpadky

  1. Gen2+ zariadenia podporujú až 6 súčasných HTTP pripojení (oproti 2 na Gen1) — vyhnite sa však nadmernému dotazovaniu z viacerých systémov
  2. Vypnite režim ECO vo webovom rozhraní Shelly, ak je zapnutý — prepína zariadenie do režimu spánku medzi dotazmi a môže spôsobovať výpadky pri krátkych intervaloch dotazovania
  3. Použite statickú IP alebo DHCP rezerváciu, aby nedochádzalo k zmenám adresy

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 1

Tieto zariadenia sa po importe zobrazia v TapHome.

Shelly Plus 1 Modul
Vlastné premenné
status (string)
Spínač Prepínač Čítanie aj zápis

Jednokanalové ovládanie relé — zapnutie/vypnutie cez RPC API

boolean
Hodnoty / Stavy: ON · OFF

Spínač

Čítanie stavu prepínača
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
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
Pripojenie: Packet Parser → HTTP • Hostname: shellyplus1-{MAC}.local
Možné vylepšenia (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

Parametre importu

Tieto hodnoty zadáte pri importe XML.

Pýta sa v aplikáciiPredvolené
IP adresa192.168.0.1

Zdroje

Našli ste problém s touto šablónou zariadenia?

Napíšte nám, čo nefunguje, čo chýba, alebo ako by sa mala šablóna správať. Vaša spätná väzba nám pomáha udržiavať katalóg presný.

Šablóna · portál TapHome Shelly Plus 1 Otvorte túto šablónu v Customer Portali a aplikujte ju na svoj domov, alebo navrhnite zmenu a odošlite ju späť do katalógu. Packet Parser → HTTP Zobraziť v portáli TapHome