---
title: "Shelly Plug S"
description: "Praćenje potrošnje energije, upravljanje relejem i očitavanje temperature uređaja preko MQTT-a. Predložak TapHome za pametnu utičnicu Shelly Plug S."
url: "https://taphome.com/hr/compatibility/shelly-plug-s-mqtt/"
language: hr
lastmod: 2026-03-31
generator: hugo
ai:
  topics: ["mqtt","smart-plug","wifi","energy-monitoring","relay-control"]
  questions: ["Kako integrirati Shelly Plug S sa sustavom TapHome preko MQTT-a?","Što mjeri predložak TapHome za Shelly Plug S?","Kako pronaći MQTT Device ID utičnice Shelly Plug S?","Zašto moj Shelly Plug S ne javlja podatke o snazi?","Kako iz sustava TapHome upravljati relejem utičnice Shelly Plug S?","Javlja li predložak za Shelly Plug S potrošnju energije u kWh?"]
---

# Shelly Plug S

Komunikacija: Packet Parser → MQTT

- [Stranica proizvoda Shelly Plug S](https://www.shelly.com/en/products/shop/shelly-plug-s)

> Adresa u mreži
> 
> Kod MQTT brokera ugrađenog u TapHome radi se o jednom brokeru kojem se pristupa s dva mjesta. Predložak radi izravno u jedinici TapHome Core, zato je u TapHomeu adresa brokera `127.0.0.1` (ovo računalo). Uređaj radi drugdje u mreži, zato u uređaju unesite IP adresu jedinice TapHome Core i za Core postavite rezervaciju IP adrese u usmjerivaču — ako se adresa jedinice Core promijeni, uređaj više ne dolazi do brokera.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

Shelly Plug S je kompaktna pametna Wi-Fi utičnica s ugrađenim praćenjem energije, nazivnih vrijednosti 12 A / 2500 W. TapHome s uređajem komunicira preko MQTT-a: utičnica se spaja na broker i objavljuje stanje releja, potrošnju snage, brojač energije i unutarnju temperaturu.

Predložak daje dva uređaja: brojilo energije za praćenje energije i sklopku za upravljanje relejem. Servisni atribut na razini modula prikazuje unutarnju temperaturu uređaja.

## Konfiguracija

### Device ID

Svaki Shelly Plug S ima jedinstveni MQTT Device ID u obliku `shellyplug-s-<MAC6>`, gdje je `<MAC6>` zadnjih 6 znakova MAC adrese malim slovima u heksadecimalnom zapisu (npr. `shellyplug-s-112233`).

Device ID možete pronaći:

- U web-sučelju Shelly: **Settings** → **Device Info** → **Device ID** (koristite prvi niz znakova, ne onaj u zagradama)
- Preko API-ja: `GET http://<device-ip>/settings` → polje `mqtt.id`

### Omogućivanje MQTT-a

Da biste na utičnici Shelly Plug S omogućili MQTT:

1. U pregledniku otvorite web-sučelje uređaja (idite na IP adresu uređaja)
2. Idite na **Internet and Security** → **Advanced - Developer Settings**
3. Označite **„Enable action execution via MQTT”**
4. U polje **„Server”** upišite `{MQTT broker IP}:{port}` (zadani port `1883`)
5. Pritisnite **SAVE**

### Postavljanje predloška

Nakon uvoza predloška u TapHome:

1. Otvorite modul **Shelly Plug S MQTT**
2. Postavite **MQTT Broker IP** i **Port** (zadano `1883`)
3. Korisničku varijablu **deviceID** postavite na Device ID utičnice Shelly Plug S (npr. `112233`, samo zadnjih 6 heksadecimalnih znakova MAC adrese)

Modul se pretplaćuje na `shellies/#`, a skripte za primanje poruka filtriraju poruke prema postavljenom prefiksu Device ID-a `shellyplug-s-{deviceID}`.

## Mogućnosti uređaja

### Praćenje energije

Uređaj brojila energije čita dvije vrijednosti iz utičnice:

- **Ukupna potrošnja** — ukupna energija iz teme `relay/0/energy`. Uređaj javlja energiju u vat-minutama, a predložak je pretvara u kWh dijeljenjem sa 60000.
- **Trenutačna snaga** — trenutačna potrošnja snage iz teme `relay/0/power`. Uređaj javlja snagu u vatima, a predložak je pretvara u kW dijeljenjem s 1000.

Obje se vrijednosti ažuriraju prema intervalu slanja MQTT poruka (zadano 30 sekundi, može se podesiti u web-sučelju Shelly preko `mqtt_update_period`).

> [!TIP]
> Brojač energije poništava se pri ponovnom pokretanju uređaja. Za trajno praćenje energije koristite ugrađeno bilježenje energije u sustavu TapHome, koje ukupne vrijednosti sprema neovisno o brojaču uređaja.

### Upravljanje relejem

Uređaj vrste „Sklopka” upravlja relejem utičnice:

- **Čitanje stanja** — prima poruke iz `shellies/shellyplug-s-{deviceID}/relay/0` i pretvara `on` → 1, `off` → 0
- **Upis stanja** — objavljuje `on` ili `off` na `shellies/shellyplug-s-{deviceID}/relay/0/command`

Relej podržava trošila do 2500 W / 12 A.

### Praćenje temperature

Servisni atribut na razini modula prikazuje unutarnju temperaturu uređaja u °C, koja se čita iz teme `shellies/shellyplug-s-{deviceID}/temperature`. To je temperatura elektronike utičnice, a ne temperatura zraka u prostoriji.

### Dodatne mogućnosti

Shelly Plug S objavljuje i stanje online/offline preko MQTT teme LWT, upozorenja o pregrijavanju (kada uređaj prijeđe sigurnu radnu temperaturu), opisnu oznaku stanja temperature (Normal/High/Very High) i događaje tipke (kratki i dugi pritisak te dvostruki klik). Te se mogućnosti mogu dodati u budućem ažuriranju predloška.

## Rješavanje problema

### Utičnica ne šalje podatke

1. Provjerite je li Shelly Plug S spojen na Wi-Fi i je li MQTT omogućen u postavkama uređaja (**Internet and Security** → **Advanced - Developer Settings**)
2. Provjerite odgovara li korisnička varijabla **deviceID** točno Device ID-ju (npr. `112233`)
3. MQTT klijentom (npr. MQTT Explorer) pretplatite se na `shellies/#` i provjerite objavljuje li utičnica poruke

### Očitanje snage je nula

1. Provjerite je li spojeno trošilo i je li relej uključen
2. MQTT klijentom provjerite temu `relay/0/power`: vrijednost treba biti različita od nule kada trošilo troši snagu
3. Provjerite prikazuje li uređaj brojila energije vrijednosti u sustavu TapHome: ukupnu potrošnju u kWh i trenutačnu snagu u kW

### Relej ne reagira na naredbe

1. Provjerite je li MQTT omogućen i je li adresa brokera ispravna u web-sučelju Shelly
2. Provjerite može li se TapHome povezati s MQTT brokerom (ispravni IP i port u postavkama modula)
3. Testirajte tako da MQTT klijentom objavite `on` ili `off` na `shellies/shellyplug-s-{deviceID}/relay/0/command`

> [!WARNING]
> Uređaji Shelly Gen1 **ne** podržavaju MQTT preko TLS-a. Komunikacija između utičnice i MQTT brokera nije šifrirana (običan MQTT, port 1883). Provjerite je li MQTT broker u pouzdanoj lokalnoj mreži.

## Kako ga instalirati u TapHome

### Preduvjeti

- Uređaj Shelly spojen na Wi-Fi (2,4 GHz), npr. putem aplikacije Shelly ili vlastite pristupne točke uređaja
- MQTT broker koji radi u vašoj lokalnoj mreži (npr. Mosquitto, Home Assistant ili ugrađeni broker TapHome)
- TapHome CCU u istoj mreži kao broker

> [!WARNING]
> Na uređajima **Gen1** uključivanje MQTT-a **isključuje Shelly Cloud**. MQTT i Shelly Cloud ne mogu raditi istodobno. Na uređajima Gen2/Plus to ograničenje ne vrijedi.

### Korak 1 — Uključite MQTT na uređaju Shelly

#### Uređaji Gen1 (Shelly 1, 1PM, 2.5, EM, 3EM, Plug S, RGBW2, Dimmer, TRV…)

1. Otvorite web-sučelje Shelly: `http://<device-ip>/`
2. Idite na **Internet & Security** → **Advanced — MQTT**
3. Uključite **MQTT**
4. Postavite **MQTT Server**: `<broker-ip>:<port>` (npr. `192.168.1.10:1883`)
5. Ako vaš broker zahtijeva autentifikaciju, postavite **MQTT User** i **MQTT Password**
6. Kliknite **Save** — uređaj će se ponovno pokrenuti i spojiti na broker

#### Uređaji Gen2 / Plus (Shelly Plus 1, Plus 1PM, Plus 2PM, Plus Plug S, Plus H&T, Pro 3EM…)

1. Otvorite web-sučelje Shelly: `http://<device-ip>/`
2. Idite na **Settings** → **MQTT**
3. Uključite **MQTT**
4. Postavite **Server**: `<broker-ip>:<port>` (npr. `192.168.1.10:1883`)
5. **Client ID** je unaprijed popunjen ID-jem uređaja (npr. `shellyplus1pm-AABBCCDDEE`) — ostavite ga takvim, osim ako ga iz određenog razloga trebate promijeniti
6. Kliknite **Save** i ponovno pokrenite uređaj

Kod ugrađenog brokera TapHome `<broker-ip>` je IP adresa centralne jedinice TapHome Core. Centralnoj jedinici Core dodijelite rezervaciju IP adrese u usmjerivaču, inače uređaj gubi broker kada usmjerivač promijeni adresu → [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/).

> [!TIP]
> Za provjeru rada MQTT-a koristite MQTT klijent (npr. MQTT Explorer) i pretplatite se na `shellies/#` (Gen1) ili `<device-id>/#` (Gen2). Trebali biste vidjeti statusne poruke uređaja.

### Korak 2 — Pronađite Device ID / MQTT Client ID

Neki predlošci zahtijevaju parametar **Device ID** ili **MQTT Client ID**. To je jedinstveni identifikator koji se koristi u MQTT temama (topics).

- **Gen1:** nalazi se na naljepnici kao MAC adresa (npr. `AABBCCDDEE`). Device ID = `shelly<model>-<mac>`, npr. `shelly1pm-AABBCCDDEE`
- **Gen2/Plus:** nalazi se u web-sučelju Shelly pod **Settings** → **Device Info** → **Device ID** ili na naljepnici uređaja

### Korak 3 — Konfiguracija u sustavu TapHome

1. U sustavu TapHome dodajte novi modul **Packet Parser (MQTT)**
2. **IP adresa:** za ugrađeni broker TapHome `127.0.0.1` (centralna jedinica spaja se sama na sebe, adresa se nikada ne mijenja); za vanjski broker njegova IP adresa (npr. `192.168.1.10`)
3. **Port:** `1883` (zadano; za TLS koristite `8883`)
4. **Device ID / MQTT Client ID:** unesite vrijednost iz koraka 2 (ako je predložak zahtijeva)
5. Uvezite predložak — TapHome će se automatski pretplatiti na teme uređaja

## Dostupni uređaji 2

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Shelly Plug S MQTT Modul

Servisni atributi

|             |                                                                   |
|-------------|-------------------------------------------------------------------|
| Temperatura | Unutarnja temperatura uređaja — ne temperatura zraka u prostoriji |

Prilagođene varijable

|                     |                                                                                                                                                                          |
|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `deviceID` (string) | MQTT Device ID utičnice Shelly Plug S — zadnjih 6 znakova MAC adrese malim slovima u heksadecimalnom zapisu (pronađite ga u web-sučelju Shelly → Settings → Device Info) |

Listener

```taphome
VAR whatT := "shellies/shellyplug-s-"+deviceID+"/temperature";
IF (whatT = RECEIVEDMSG.TOPIC)
 temperatureC := TOSTRING(RECEIVEDMSG.PAYLOAD);
END
```

Servisni atributi

Temperature \[°C ]

```taphome
temperatureC
```

Brojilo energije Brojilo električne energije Samo za čitanje

Mjerenje potrošnje snage i energije — trenutačna snaga (kW) i ukupna energija (kWh)

numeric Jedinica: kWh (total), kW (demand) energy: Watt-minutes /60000 = kWh; demand: Watts /1000 = kW

Čitanje ukupne potrošnje

```taphome
# Simple HTTP Request:
# VAR response := SENDHTTPREQUEST("/example/getValue");
# IF response.IsSuccess
#  VAR content := response.Content;
#  VAR responseHeaders := response.Headers;
#  RETURN(PARSEXML(content, "//element1/value1"));
# ELSE
#  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
#  RETURN(NaN);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/getValue", "GET", "some data", "header1:value1", "header2:value2", ...);
# OR
# VAR request := HTTPREQUEST("/example/getValue", "POST", "some data");
# request.headers := { "header1:value1", "header2:value2", ...};
# request.method := "GET";
# request.data := null;
# VAR response := SENDHTTPREQUEST(request);
#
#
# Send TCP, UDP data:
# VAR data1 := BYTECOLLECTION("0a bb ea df 01");
# SENDDATA(data1);
# VAR data2 := "{\"name\":\"John\", \"age\":32}";
# SENDDATA(data2);
# VAR data3 := TOBYTES("{\"name\":\"John\", \"age\":32}", "iso-8859-1");
# SENDDATA(data3);
# Process received TCP or UDP data and set device values in the Listener script
#
#
# Download data from FTP:
# FTPDOWNLOAD("filePath");
```

Čitanje zahtjeva

```taphome
# Simple HTTP Request:
# VAR response := SENDHTTPREQUEST("/example/getValue");
# IF response.IsSuccess
#  VAR content := response.Content;
#  VAR responseHeaders := response.Headers;
#  RETURN(PARSEXML(content, "//element1/value1"));
# ELSE
#  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
#  RETURN(NaN);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/getValue", "GET", "some data", "header1:value1", "header2:value2", ...);
# OR
# VAR request := HTTPREQUEST("/example/getValue", "POST", "some data");
# request.headers := { "header1:value1", "header2:value2", ...};
# request.method := "GET";
# request.data := null;
# VAR response := SENDHTTPREQUEST(request);
#
#
# Send TCP, UDP data:
# VAR data1 := BYTECOLLECTION("0a bb ea df 01");
# SENDDATA(data1);
# VAR data2 := "{\"name\":\"John\", \"age\":32}";
# SENDDATA(data2);
# VAR data3 := TOBYTES("{\"name\":\"John\", \"age\":32}", "iso-8859-1");
# SENDDATA(data3);
# Process received TCP or UDP data and set device values in the Listener script
#
#
# Download data from FTP:
# FTPDOWNLOAD("filePath");
```

Listener

```taphome
VAR whatTo := "shellies/shellyplug-s-"+deviceID+"/relay/0/energy";
IF (whatTo = RECEIVEDMSG.TOPIC)
 To := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD))/60000;
END
VAR whatEd := "shellies/shellyplug-s-"+deviceID+"/relay/0/power";
IF (whatEd = RECEIVEDMSG.TOPIC)
 Ed := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD))/1000;
END
```

Sklopka Sklopka Čitanje i pisanje

string on→1, off→0 (read); 1→on, 0→off (write)

Vrijednosti / stanja: ON · OFF

Čitanje stanja sklopke

```taphome
# Simple HTTP Request:
#VAR response := SENDHTTPREQUEST("/example/getValue");
#IF response.IsSuccess
# VAR content := response.Content;
# VAR responseHeaders := response.Headers;
# RETURN(PARSEXML(content, "//element1/value1"));
#ELSE
# ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
# RETURN(NaN);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/getValue", "GET", "some data", "header1:value1", "header2:value2", ...);
# OR
# VAR request := HTTPREQUEST("/example/getValue", "POST", "some data");
# request.headers := { "header1:value1", "header2:value2", ...};
# request.method := "GET";
# request.data := null;
# VAR response := SENDHTTPREQUEST(request);
#
#
# Send TCP, UDP data:
# VAR data1 := BYTECOLLECTION("0a bb ea df 01");
# SENDDATA(data1);
# VAR data2 := "{\"name\":\"John\", \"age\":32}";
# SENDDATA(data2);
# VAR data3 := TOBYTES("{\"name\":\"John\", \"age\":32}", "iso-8859-1");
# SENDDATA(data3);
# Process received TCP or UDP data and set device values in the Listener script
#
#
# Download data from FTP:
# FTPDOWNLOAD("filePath");
```

Zapis stanja sklopke

```taphome
# Simple HTTP Request:
MQTTPUBLISH("shellies/shellyplug-s-"+deviceID+ "/relay/0/command",if(St = 1, "on","off"));
# IF response.IsSuccess = false
#  ADDERROR(response.StatusCode);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/setValue", "GET", "value=" + St, "header1:value1", "header2:value2", ...);\r
# Or VAR request := HTTPREQUEST("/example/setValue");
# request.Method := "PUT";
# VAR response := SENDHTTPREQUEST(request);
#r
#
# Send TCP, UDP data:
# VAR data1 := "{\"name\":\"John\", \"age\":" + St + "}";
# SENDDATA(data1);
# VAR data2 := TOBYTES("{\"name\":\"John\", \"age\":" + St + "}", "iso-8859-1");
# SENDDATA(data2);
# You can process received TCP or UDP data in the Listener script
#
#
# Upload data to FTP:
# FTPUPLOAD("filePath", "somedata=" + St, "write"); # use "append" mode to append data to existing file






#MQTTPUBLISH(topic + "/relay/0/command",if());
```

Listener

```taphome
VAR whatSt := "shellies/shellyplug-s-"+deviceID+"/relay/0";
IF (whatSt = RECEIVEDMSG.TOPIC)
 IF (TOSTRING(RECEIVEDMSG.PAYLOAD) = "on")
  St := 1;
 ELSE
  St := 0;
 END
END
```

**Povezivanje:** Packet Parser → MQTT

Moguća poboljšanja (6)

- Connection Status — LWT topic — true on connect, false on disconnect. Could detect offline device.
- Overtemperature Alert — 1 = overheated, 0 = normal. Could trigger safety alarm when device exceeds safe operating temperature.
- Temperature Status — String: Normal, High, or Very High. Human-readable temperature classification.
- Button Input State — 0 or 1 — physical button state on the device.
- Button Input Event — JSON payload with event type (S=short, L=long, SS=double, SSS=triple) and event counter.
- Overpower State — Relay topic can report 'overpower' payload when load exceeds rating. Not parsed in listener script.

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji  | Zadano             |
|-----------------------|--------------------|
| Mqtt Broker IP adresa | `192.168.0.1`      |
| Mqtt Broker port      | `1883`             |
| Device ID             | Unosi se pri uvozu |

## Izvori

- Shelly Gen1 API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-12
- Shelly Plug S — Device-Specific MQTT API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-plug-plugs-mqtt) 2026-03-31

## Povezana dokumentacija

- [MQTT Integration](https://taphome.com/hr/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/hr/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripte](https://taphome.com/hr/docs/script/listener-scripts/)

