TapHome

Shelly UNI

Packet Parser → MQTT
Autor
Posljednje ažuriranje: 10. 2026

Ovaj uređaj podržava mDNS

Umjesto IP adrese uređaju možete pristupiti na adresi:

shellyuni-{shelly-id}.local

Zamijenite {MAC} MAC adresom svog uređaja (velika slova, bez dvotočaka).

TapHome podržava mDNS. Naziv računala (hostname) pouzdaniji je od statične IP adrese.

Shelly UNI

Shelly UNI kompaktan je univerzalni Wi-Fi I/O modul (20 × 33 × 13 mm) s platforme Shelly Gen1. Ima jedan ADC naponski ulaz, dva beznaponska izlaza s otvorenim kolektorom i dva digitalna ulaza, a namijenjen je naknadnoj nadogradnji starijih uređaja bez središnjeg čvorišta (huba).

TapHome s uređajem komunicira preko MQTT-a. Predložak se pretplaćuje na stablo tema shellies/<prefix>/... i objavljuje naredbe na .../relay/{0,1}/command. Modul prikazuje 5 uređaja: 1 analogni ulaz, 2 sklopke i 2 magnetska kontakta.

Spajanje uređaja

Napajanje

Shelly UNI je niskonaponski modul i ne može se napajati izravno iz mreže 230 V. Napajanje je moguće:

  • 12–36 V DC preko crvenog (+) i crnog (GND) vodiča ili
  • 12–24 V AC preko crvenog i crnog vodiča (bez polariteta)

Potreban je vanjski niskonaponski adapter za napajanje. Potrošnja uređaja manja je od 1 W.

Crveni i crni vodič ne spajajte na mrežni napon. Ovisno o vanjskom strujnom krugu, na stezaljkama IN_1 / IN_2 / OUT1 / OUT2 i dalje može biti opasan napon, pa ugradnju mora obaviti kvalificirani električar.

Oznake vodiča priključnog kabela

Uređaj se isporučuje s priključnim kabelom s vodičima označenima bojama:

VodičStezaljkaFunkcija
CrveniVCC12–36 V DC (ili 12–24 V AC zajedno s crnim)
CrniGNDZajednička masa (ili AC faza s crvenim)
BijeliADC_INAnalogni ulaz (raspon 0–12 V ili 0–30 V)
ŽutiVCC_SENSORIzlaz 3,3 V DC za senzore na sabirnici 1-Wire
PlaviDATA_SENSORPodaci sabirnice 1-Wire (DS18B20 / DHT22)
ZeleniGND_SENSORZajednička masa senzora
SvijetlosmeđiIN_1Digitalni ulaz 1
TamnosmeđiIN_2Digitalni ulaz 2

Dva beznaponska izlaza na kućištu modula označena su s OUT1 i OUT2.

Digitalni ulazi (IN_1, IN_2)

Svaki digitalni ulaz je beznaponski i može se pobuđivati istosmjernim ili izmjeničnim izvorom:

  • DC: HIGH pri ≥ 2,2 V, LOW ispod 2,2 V, najviše 36 V DC
  • AC: HIGH pri ≥ 12 V, LOW ispod 12 V, najviše 24 V AC

Tipična primjena su magnetski kontakti (reed kontakti) (senzori prozora i vrata, sklopke s plovkom) i tipkala koja preko vanjskog izvora kratko spajaju ulaz na GND.

Spajanje reed kontakta na Shelly UNI s istosmjernim napajanjem
Spajanje reed kontakta na Shelly UNI s izmjeničnim napajanjem
Spajanje tipkala ili prekidača na Shelly UNI s istosmjernim napajanjem
Spajanje tipkala ili prekidača na Shelly UNI s izmjeničnim napajanjem
Beznaponski izlazi (OUT1, OUT2)

Svaki izlaz je beznaponski kontakt s otvorenim kolektorom sa sljedećim apsolutnim granicama:

  • najveća struja 100 mA
  • najveća snaga 300 mW
  • najveći sklopni napon 24 V AC ili 36 V DC

Te su vrijednosti preniske za mrežna trošila. Za uključivanje i isključivanje stvarnih trošila (rasvjeta, pumpe, ventili) spojite izlaze na vanjski relej ili sklopnik, a zavojnicu tog releja napajajte iz odgovarajućeg niskonaponskog izvora.

Shema spajanja beznaponskog izlaza modula Shelly UNI
Analogni ulaz (ADC)

Jedan ADC kanal na bijelom vodiču (ADC_IN) podržava dva naponska raspona koja se odabiru u web-sučelju Shelly:

  • 0–12 V — veća razlučivost za niskonaponske signale
  • 0–30 V — širi raspon za nadzor baterije ili istosmjernog međukruga

Odabrani raspon pohranjen je samo na uređaju. Predložak TapHome čita neobrađenu objavljenu vrijednost i ne može prepoznati koji je raspon aktivan. Provjerite odgovara li ADC raspon na uređaju Shelly signalu koji spajate na bijeli vodič.

Shema spajanja ADC ulaza modula Shelly UNI

Konfiguracija

ID uređaja i MQTT prefiks

Svaki Shelly UNI ima jedinstveni Shelly-ID koji odgovara posljednjih 6 znakova njegove MAC adrese (npr. 35FA58). Iz njega nastaje prefiks MQTT tema shellyuni-<Shelly-ID> (npr. shellyuni-35fa58).

Shelly-ID možete pronaći:

  • na naljepnici uređaja (MAC adresa)
  • u web-sučelju Shelly: Settings → Device Info
  • preko API-ja: GET http://<device-ip>/settings → polje device.hostname

Uređaji Shelly Gen1 oglašavaju se preko mDNS-a kao shellyuni-<Shelly-ID>.local. Za pristup web-sučelju možete umjesto fiksne IP adrese koristiti taj naziv hosta.

Uključivanje MQTT-a

Na novom uređaju MQTT je isključen. Uključite ga prije uvoza predloška TapHome:

  1. Spojite se na pristupnu točku uređaja shellyuni-XXXXXX (lozinka je otisnuta na uređaju) ili mu pristupite u svojoj lokalnoj mreži
  2. Otvorite web-sučelje na http://192.168.33.1/ (način pristupne točke) ili na IP adresi u lokalnoj mreži
  3. Idite na Internet & Security → Advanced — Developer Settings
  4. Označite Enable action execution via MQTT
  5. Postavite IP adresu i port brokera (zadano 1883), a korisničko ime i lozinku ostavite prazne, jer TapHome na uređajima Gen1 ne podržava MQTT autentifikaciju
  6. Spremite postavke i ponovno pokrenite uređaj

Uključivanje MQTT-a na uređajima Gen1 isključuje vezu sa Shelly Cloudom. To je namjerno: uređaj ne može istodobno održavati obje veze. Mobilna aplikacija Shelly više neće upravljati uređajem preko oblaka; umjesto nje koristite MQTT ili lokalno web-sučelje.

Uređaji Shelly Gen1 ne podržavaju MQTT preko TLS-a. Komunikacija između uređaja i brokera nije šifrirana (obični MQTT, port 1883). Broker držite u pouzdanoj lokalnoj mreži.

Postavljanje predloška

Pri uvozu predloška u TapHome unesite:

  • IpAddress — IP adresa MQTT brokera
  • Port — port brokera (zadano 1883)
  • DeviceID — 6-znakovni Shelly-ID konkretnog modula UNI (npr. 35fa58)

Parametar uvoza DeviceID koristi se za sastavljanje prilagođene varijable MQTTprefix (zadano shellyuni-$[DeviceID]). Ako ste na uređaju Shelly postavili vlastiti mqtt_id (umjesto zadanog), nakon uvoza prilagodite varijablu MQTTprefix na modulu.

Na uređaju Shelly isključite HTTP autentifikaciju (Internet & Security → Restrict Login). TapHome u ovom predlošku ne koristi HTTP, ali uključena autentifikacija može otežati rješavanje problema i ažuriranje firmvera.

Mogućnosti uređaja

Mjerenje analognog napona

Uređaj Analogni ulaz čita ADC napon iz shellies/<prefix>/adc/0 i prikazuje ga kao brojčanu vrijednost u voltima. Skripta raščlanjuje primljeni sadržaj poruke s TODOUBLE(TOSTRING(PAYLOAD)), bez ikakvog skaliranja.

Stvarni mjerni raspon (0–12 V ili 0–30 V) postavlja se na samom uređaju Shelly i ne javlja se preko MQTT-a. Predložak TapHome ne može provjeriti koji je raspon aktivan.

Sklopni izlazi

Oba izlaza s otvorenim kolektorom prikazuju se kao standardni uređaji TapHome tipa sklopka:

  • Sklopka 1 — OUT_1, tema shellies/<prefix>/relay/0, tema za naredbe .../relay/0/command
  • Sklopka 2 — OUT_2, tema shellies/<prefix>/relay/1, tema za naredbe .../relay/1/command

Skripta za slušanje pretvara sadržaj on → UKLJUČENO (St=1) i off → ISKLJUČENO (St=0). Naredbe iz sustava TapHome objavljuju se kao on / off na odgovarajućoj temi za naredbe.

Izlazi su beznaponski i ograničeni na 100 mA / 300 mW. Mrežna trošila ne spajajte izravno; za sve snažnije od signalnih uređaja male snage koristite vanjski relej ili sklopnik.

Digitalni ulazi (magnetski kontakti)

Oba digitalna ulaza prikazuju se kao uređaji vrste „Magnetski kontakt” s obrnutom logikom:

  • Magnetski kontakt 1 — IN_1, tema shellies/<prefix>/input/0
  • Magnetski kontakt 2 — IN_2, tema shellies/<prefix>/input/1

Firmver Shelly objavljuje 1 kada je na ulazu napon iznad praga i 0 kada je ulaz povučen na GND. Budući da reed kontakti i tipkala u zatvorenom / aktivnom stanju obično kratko spajaju ulaz na GND, skripta TapHome obrće sadržaj poruke:

1

Rc := IF(payload = "0", 1, 0)

To znači da je Rc=1 u sustavu TapHome = kontakt zatvoren (aktivan, senzor otvorenog prozora aktiviran, tipkalo pritisnuto), a Rc=0 = kontakt otvoren (neaktivan).

Dodatne mogućnosti

Hardver Shelly UNI podržava i do 3 senzora temperature DS18B20 na sabirnici 1-Wire ili, alternativno, 1 senzor vlage i temperature DHT22. Ti senzori objavljuju na shellies/<prefix>/ext_temperature/{0,1,2} i shellies/<prefix>/ext_humidity/0. Trenutačni MQTT predložak te teme ne povezuje s uređajima TapHome; mogu se dodati u budućem ažuriranju predloška.

Uređaj također nudi temu LWT online/offline i događaje ulaza za kratki i dugi pritisak na input_event/{0,1}, koje ovaj predložak ne koristi.

Za pokretanje scena na temelju događaja tipkala (kratki pritisak, dugi pritisak) već se sada možete pretplatiti na temu input_event iz zasebnog MQTT klijenta. Predložak TapHome prati samo neobrađeno stanje ulaza.

Rješavanje problema

Uređaj ne odgovara
  1. Provjerite ima li Shelly UNI napajanje (crveni/crni vodič na 12–36 V DC ili 12–24 V AC) i je li spojen na Wi-Fi
  2. Otvorite web-sučelje Shelly preko mDNS naziva hosta shellyuni-<Shelly-ID>.local ili preko IP adrese dodijeljene DHCP-om
  3. Provjerite je li MQTT uključen (Internet & Security → Advanced — Developer Settings) i odgovaraju li IP adresa i port brokera parametrima uvoza u sustavu TapHome
  4. MQTT klijentom (npr. MQTT Explorer) pretplatite se na shellies/# i provjerite objavljuje li uređaj poruke
Sklopke se ne prebacuju
  1. Provjerite putanju teme za naredbe: mora biti shellies/<prefix>/relay/0/command (ne .../relay/0/set)
  2. Provjerite odgovara li varijabla MQTTprefix modula TapHome prefiksu tema na kojem uređaj stvarno objavljuje
  3. Imajte na umu da su izlazi beznaponski: bez vanjskog strujnog kruga koji daje napon stanje izlaza se mijenja, ali se nijedno trošilo ne uključuje niti isključuje
Stanje magnetskog kontakta je obrnuto

Predložak očekuje da payload=0 znači „kontakt zatvoren”. Ako vaše vanjsko ožičenje pri aktivnom kontaktu povlači ulaz na HIGH (obrnuto ožičenje), stanje će se u sustavu TapHome prikazivati obrnuto. Prespojite tako da kontakt u aktivnom stanju kratko spaja IN_1 / IN_2 na GND ili prilagodite logiku u vlastitoj skripti.

ADC vrijednost izvan očekivanog raspona

ADC raspon (0–12 V ili 0–30 V) postavlja se na uređaju i ne može se očitati preko MQTT-a. Ako brojčana vrijednost u sustavu TapHome izgleda pogrešno (npr. 2× veća ili manja od očekivane), otvorite web-sučelje Shelly i provjerite Settings → ADC range. Predložak pretpostavlja da uređaj objavljuje izravno napon i ne radi nikakvu pretvorbu.

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

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

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: unesite IP adresu MQTT brokera (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

Shelly UNI Modul
Prilagođene varijable
MQTTprefix (string) = shellyuni-$[DeviceID]Prefiks MQTT tema uređaja Shelly UNI — zadano shellyuni-{DeviceID}; osnova je za sve teme na koje se modul pretplaćuje i na koje objavljuje
Pass DeviceID as import parameter; find it in the Shelly web UI → Settings → Device Info (last 6 characters of MAC address). Custom mqtt_id set on the Shelly device overrides this default.
Analogni ulaz Varijabla Samo za čitanje

Mjerenje ADC napona — dva raspona, 0–12 V ili 0–30 V, odabir na uređaju

numeric Jedinica: V

Analogni ulaz

Listener
if RECEIVEDMSG.TOPIC = "shellies/" + MQTTprefix + "/adc/0"
    Va := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD));
end
Sklopka 1 Sklopka

Beznaponski izlaz s otvorenim kolektorom OUT_1 — najviše 100 mA / 300 mW, 24 V AC ili 36 V DC

string
Vrijednosti / stanja: ON · OFF

Sklopka 1

Zapis stanja sklopke
MQTTPUBLISH("shellies/" + MQTTprefix + "/relay/0/command", if(St, "on", "off"))
Listener
if RECEIVEDMSG.TOPIC = "shellies/" + MQTTprefix + "/relay/0"
    VAR payload := TOSTRING(RECEIVEDMSG.PAYLOAD);

    if(payload = "on", St := 1, St := 0);
end
Sklopka 2 Sklopka

Beznaponski izlaz s otvorenim kolektorom OUT_2 — najviše 100 mA / 300 mW, 24 V AC ili 36 V DC

string
Vrijednosti / stanja: ON · OFF

Sklopka 2

Zapis stanja sklopke
MQTTPUBLISH("shellies/" + MQTTprefix + "/relay/1/command", if(St, "on", "off"))
Listener
if RECEIVEDMSG.TOPIC = "shellies/" + MQTTprefix + "/relay/1"
    VAR payload := TOSTRING(RECEIVEDMSG.PAYLOAD);

    if(payload = "on", St := 1, St := 0);
end
Magnetski kontakt 1 Magnetski kontakt Samo za čitanje

Digitalni ulaz IN_1 — obrnuta logika, kontakt kratko spojen na GND = aktivan (1) u sustavu TapHome

string

Magnetski kontakt 1

Listener
if RECEIVEDMSG.TOPIC = "shellies/" + MQTTprefix + "/input/0"
    VAR payload := TOSTRING(RECEIVEDMSG.PAYLOAD);

    Rc := if(payload = "0", 1, 0);
end
Magnetski kontakt 2 Magnetski kontakt Samo za čitanje

Digitalni ulaz IN_2 — obrnuta logika, kontakt kratko spojen na GND = aktivan (1) u sustavu TapHome

string

Magnetski kontakt 2

Listener
if RECEIVEDMSG.TOPIC = "shellies/" + MQTTprefix + "/input/1"
    VAR payload := TOSTRING(RECEIVEDMSG.PAYLOAD);

    Rc := if(payload = "0", 1, 0);
end
Povezivanje: Packet Parser → MQTT • Naziv računala (hostname): shellyuni-{shelly-id}.local
Moguća poboljšanja (8)
  • External Temperature Sensor 1 (DS18B20) — Hardware supports up to 3× DS18B20 on the one-wire bus (Blue DATA + Yellow VCC + Green GND). Not wired in this MQTT template; would need a PacketParserVariable listening on ext_temperature/0 (value 999 = invalid).
  • External Temperature Sensor 2 (DS18B20) — Second DS18B20 on the one-wire bus. Same pattern as sensor 1, different index.
  • External Temperature Sensor 3 (DS18B20) — Third DS18B20 on the one-wire bus. Same pattern as sensor 1, different index.
  • External Humidity Sensor (DHT22) — Hardware supports 1× DHT22 humidity/temperature sensor (mutually exclusive with DS18B20 chain). Not wired in this MQTT template; would need a PacketParserVariable on ext_humidity/0 (value 999 = invalid).
  • Connection Status (LWT) — Last-Will-Testament topic — 'true' on connect, 'false' on disconnect. Could be added to detect offline devices.
  • Input 1 Event — JSON payload {event, event_cnt} — short/long press events on IN_1, useful for scene triggers.
  • Input 2 Event — JSON payload {event, event_cnt} — short/long press events on IN_2.
  • Full Status JSON — Full /status JSON published periodically (firmware ≥ 1.8.0). Could be parsed for wifi_sta.rssi, update status, uptime.

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu