TapHome

Shelly 1PM

Packet Parser → HTTP
Submitted by
Last updated: 03. 2026
Shelly 1PM

Shelly 1PM je kompaktné Wi-Fi relé s vstavaným meraním výkonu. Zmestí sa za štandardný nástenný vypínač a ovláda jeden okruh až do 16 A (3500 W pri 230 V). TapHome komunikuje so zariadením cez HTTP na lokálnej sieti — cloudové pripojenie nie je potrebné.

Šablóna poskytuje ovládanie relé a elektromer, ktorý číta spotrebu v reálnom čase aj kumulatívnu spotrebu energie.

Konfigurácia

Shelly 1PM sa pripája cez Wi-Fi. Pri importe šablóny TapHome zadaj IP adresu zariadenia (predvolený placeholder 192.168.0.1).

Toto zariadenie podporuje objavovanie cez mDNS. Namiesto IP adresy môžeš pri konfigurácii TapHome použiť hostname shelly1pm-{MAC}.local. Nahraď {MAC} MAC adresou zariadenia (veľké písmená hex, bez dvojbodiek). Použitie hostname predchádza problémom s konektivitou pri zmene IP adresy zariadenia.

Otvor aplikáciu TapHome a použi IP Scanner (Nastavenia → Sieť → Skenovať). Skener objaví zariadenia v sieti a zobrazí IP adresu aj mDNS hostname (napr. shelly1pm-AABBCCDDEE.local). Pre spoľahlivejšie pripojenie použi hostname namiesto IP adresy.

Možnosti zariadenia

Ovládanie relé

Šablóna sprístupňuje relé ako spínač. Stav relé sa číta z odpovede /status (relays[0].ison) a ovláda sa cez endpoint /relay/0 s parametrom turn=on alebo turn=off.

Meranie výkonu

Vstavaný elektromer číta dve hodnoty z odpovede /status:

  • Výkon v reálnom čase — meters[0].power vo wattoch, šablóna konvertuje na kW
  • Celková spotreba — meters[0].total vo watt-minútach, šablóna konvertuje na kWh

Elektromer je len na čítanie — aktualizuje sa automaticky pri každom cykle pollovania.

Servisné diagnostiky

Šablóna sprístupňuje 13 servisných atribútov na monitorovanie zariadenia:

  • Informácie o zariadení — hostname, MAC adresa, čas zariadenia, uptime, využitie RAM
  • Tepelná ochrana — vnútorná teplota (°C), stav teploty (Normal / High / Very High), príznak prehriatia
  • Konektivita — cloud povolený/pripojený, MQTT pripojený, dostupná aktualizácia firmvéru
  • Ochrana výkonu — aktuálny limit maximálneho výkonu (číta sa z /settings)
Servisné akcie

K dispozícii sú tri servisné akcie:

  • Nastaviť ochranu výkonu — nastaví maximálny limit výkonu (1–3500 W). Relé sa automaticky vypne, ak spotreba prekročí túto hodnotu.
  • Povoliť cloud — zapína alebo vypína pripojenie Shelly Cloud
  • Reštartovať — spustí reštart zariadenia
Ďalšie možnosti

Shelly 1PM sprístupňuje v odpovedi /status aj napätie v sieti, jalový výkon, fyzický stav vstupu a intenzitu Wi-Fi signálu. Na endpointe relé je dostupný časovač automatického vypnutia. Tieto možnosti možno pridať v budúcej aktualizácii šablóny.

Riešenie problémov

Zariadenie neodpovedá
  1. Over, že Shelly je pripojený k Wi-Fi a má platnú IP adresu
  2. Skús použiť mDNS hostname (shelly1pm-AABBCCDDEE.local) namiesto IP adresy — IP sa mohla zmeniť po obnove DHCP prenájmu
  3. Otvor http://{device-ip}/shelly v prehliadači — ak odpovie, zariadenie je dostupné
  4. Skontroluj, že TapHome CCU a Shelly sú v rovnakej sieti / VLAN
Meranie výkonu zobrazuje nulu
  1. Skontroluj, že záťaž je zapojená cez relé Shelly (nie obídená)
  2. Over, že relé je zapnuté — elektromer meria len keď ním preteká prúd
  3. Polluj /status manuálne a over, že meters[0].power vracia nenulovú hodnotu
Varovanie o prehriatí

Shelly 1PM má vnútornú tepelnú ochranu. Ak teplota zariadenia prekročí bezpečné limity, temperature_status sa zmení na „High" alebo „Very High" a overtemperature sa nastaví na true. Zabezpeč dostatočnú ventiláciu okolo zariadenia, najmä pri spínaní veľkých záťaží.

Zariadenia Shelly Gen1 podporujú len 2 súbežné HTTP pripojenia. Ak TapHome a iný systém (napr. Home Assistant) pollujú to isté zariadenie súčasne, komunikácia môže byť nespoľahlivá. Použi interval pollovania 10–30 sekúnd.

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 Modul
Servisné atribúty
Ochrana výkonu
Názov hostiteľa
MAC adresa
Čas zariadenia
Doba prevádzky
RAM
Vnútorná teplota zariadenia
Stav teploty
Aktualizácia FW
Cloud povolený
Cloud pripojený
MQTT pripojený
Prehriatý
Servisné akcie
Nastaviť ochranu výkonu
Povoliť cloud
Reštart

Shelly 1PM Module

Čítanie (modul)
VAR response := SENDHTTPREQUEST("/status", "GET");
StatusJson := response.Content;
Servisné atribúty
Power protection
VAR response := SENDHTTPREQUEST("/settings", "GET");
SettingsJson := response.Content;

response := SENDHTTPREQUEST("/status", "GET");
StatusJson := response.Content;

PARSEJSON(SettingsJson, "max_power") + "W";
Host name
PARSEJSON(SettingsJson, "device.hostname");
Mac address
PARSEJSON(StatusJson, "mac");
Device time
PARSEJSON(StatusJson, "time")
Uptime
VAR upTimeSeconds := PARSEJSON(StatusJson, "uptime");
VAR days := FLOOR(upTimeSeconds/86400, 1);
uptimeSeconds := MOD(upTimeSeconds, 86400);
var hours := FLOOR(upTimeSeconds/3600, 1);
uptimeSeconds := MOD(upTimeSeconds, 3600);
var minutes := FLOOR(upTimeSeconds/60, 1);
days + "day(s) " + hours + "h " + minutes + "m"
RAM
var ramTotal := PARSEJSON(StatusJson, "ram_total");
var ramFree := PARSEJSON(StatusJson, "ram_free");
ramFree + " bytes free of " + ramTotal
Internal device temperature
PARSEJSON(StatusJson, "temperature") + "°C"
Temperature status
PARSEJSON(StatusJson, "temperature_status");
FW update
PARSEJSON(StatusJson, "has_update");
Cloud enabled
PARSEJSON(StatusJson, "cloud.enabled");
Cloud connected
PARSEJSON(StatusJson, "cloud.connected");
MQTT connected
PARSEJSON(StatusJson, "mqtt.connected");
Overheated
PARSEJSON(StatusJson, "overtemperature");
Servisné akcie
Set power protection
Parametre: Maximum power (1–3500 Watts)
VAR response := SENDHTTPREQUEST("settings?max_power=" + Watts);
VAR contentJson := response.Content;
VAR limitSet := PARSEJSON(contentJson, "max_power");

"Power limit set to " + limitSet + "W"
Enable cloud
Parametre: Enable (Enable / Disable)
VAR response := SENDHTTPREQUEST("/settings/cloud?enabled=" + enable);
VAR contentJson := response.Content;
VAR wasEnabled := PARSEJSON(contentJson, "enabled");

IF(wasEnabled, "Cloud enabled", "Cloud disabled");
Reboot
VAR response := SENDHTTPREQUEST("/reboot");
VAR contentJson := response.Content;
VAR wasRebooted := PARSEJSON(contentJson, "ok");

IF(wasRebooted, "Reboot successful", "Error");
Spínač Prepínač
boolean

Spínač

Čítanie stavu prepínača
VAR value := PARSEJSON(StatusJson, "relays[0].ison", 1);
IF(ISNULL(value), NaN, value);
Zápis stavu prepínača
VAR path := "relay/0?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
Elektromer Elektromer Len na čítanie

Meranie spotreby energie — okamžitý výkon (kW) a celková spotreba (kWh)

numeric Jednotka: W / kWh

Elektromer

Čítanie celkovej spotreby
VAR total := PARSEJSON(StatusJson, "meters[0].total", 1);
IF(ISNULL(total), NaN, total / 60000.0);
Čítanie odberu
VAR power := PARSEJSON(StatusJson, "meters[0].power", 1);
IF(ISNULL(power), NaN, power / 1000.0);
Pripojenie: Packet Parser → HTTP
Možné vylepšenia (5)
  • Voltage — Line voltage in V, available in /status response
  • Reactive Power — Reactive power in VAR, available in /status response
  • Input State — Physical input state (0/1), available in /status response
  • WiFi Signal Strength — WiFi RSSI in dBm, available in /status response
  • Auto-off Timer — Auto-off timer in seconds, could be added as service action or switch parameter
Stiahnuť šablónu

Zdroje