TapHome
Službeni · TapHome Provjereno

Shelly UNI

Univerzalni Wi-Fi I/O modul Shelly UNI povezan sa sustavom TapHome preko MQTT-a. Ima jedan ADC ulaz, dva beznaponska sklopna izlaza i dva digitalna ulaza.

ShellyPacket Parser → MQTT5 uređajaRevizija 1.1 Posljednje ažuriranje: 8. listopada 2026.
Radi na Coreu TapHome Next 2026.1.41766
iOvaj smo predložak u laboratoriju TapHome uvezli u ovaj Core i svi su njegovi uređaji dodani bez pogreške.
Shelly UNI

Uvoz u aplikaciju TapHomeHardver › Packet Parser › Dodaj iz predloška

Preuzmite predložak
Na ovoj stranici

Ovaj uređaj podržava mDNS

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

shellyuni-{shelly-id}.local

Zamijenite {shelly-id} vrijednošću svog uređaja.

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

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

Upute za integraciju

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:

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

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.

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 5

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

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 Čitanje i pisanje

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 Čitanje i pisanje

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.

Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

Pitanje u aplikacijiZadano
Mqtt Broker IP adresa192.168.0.1
Mqtt Broker port1883
Device IDXXXXXXXXX

Izvori

Dokumenti proizvođača zaštićeni su autorskim pravom (©) svojih vlasnika. Dostupni su onako kako ih je proizvođač objavio, samo za informaciju.

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.

Predložak · TapHome portal Shelly UNI 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. Packet Parser → MQTT Pogledaj u TapHome portalu