--- title: "Shelly UNI" description: "Ovládej dva bezpotenciálové výstupy, čti dva digitální vstupy a jedno ADC napětí na Shelly UNI přes MQTT. Šablona pro Shelly UNI Gen1." url: "https://taphome.com/cs/compatibility/shelly-uni-mqtt/" language: cs lastmod: 2026-10-08 generator: hugo ai: topics: ["mqtt","i/o-module","shelly","gen1","wifi","low-voltage"] questions: ["Jak integrovat Shelly UNI s TapHome přes MQTT?","Co šablona Shelly UNI pro TapHome ovládá a měří?","Jak připojit bezpotenciálové výstupy Shelly UNI k reálné zátěži?","Proč se jazýčkový kontakt Shelly UNI zobrazuje v TapHome v invertovaném stavu?","Jaký rozsah napětí mohu měřit na ADC vstupu Shelly UNI?","Dokáže Shelly UNI v TapHome číst teplotní DS18B20 nebo vlhkostní DHT22 senzor?"] --- # Shelly UNI Komunikace: Packet Parser → MQTT - [Shelly UNI — znalostní báze](https://kb.shelly.cloud/knowledge-base/shelly-uni) - [Shelly UNI — dokumentace](https://www.shelly.com/blogs/documentation/shelly-uni) > Adresa v síti > > U MQTT brokeru vestavěného v TapHome zadejte v TapHome jako adresu brokeru `127.0.0.1`. V zařízení zadejte IP adresu TapHome Core a jednotce Core dejte rezervaci IP v routeru. > > [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/) ## Návod na integraci Shelly UNI je kompaktní univerzální Wi-Fi I/O modul (20 × 33 × 13 mm) z platformy Shelly Gen1. Poskytuje jeden ADC napěťový vstup, dva bezpotenciálové výstupy s otevřeným kolektorem a dva digitální vstupy — určený pro dovybavení stávajících spotřebičů bez centrály. TapHome komunikuje se zařízením přes MQTT. Šablona se přihlašuje ke stromu topiců `shellies//...` a publikuje příkazy na `.../relay/{0,1}/command`. Modul poskytuje 5 zařízení: 1 analogový vstup, 2 spínače a 2 jazýčkové kontakty. ## Hardwarové zapojení ### Napájení Shelly UNI je **nízkonapěťový modul** a nelze jej napájet přímo ze sítě 230 V. Napájej buď: - **12–36 V DC** přes červený (+) a černý (GND) vodič, nebo - **12–24 V AC** přes červený a černý vodič (bez polarity) Potřebný je externí nízkonapěťový adaptér. Spotřeba zařízení je pod 1 W. > [!WARNING] > Červený/černý vodič nepřipojuj na síťové napětí. Na svorkách IN_1 / IN_2 / OUT1 / OUT2 může být podle externího zapojení stále nebezpečné napětí — instalaci musí provést kvalifikovaný elektrikář. ### Legenda pigtail kabelu Zařízení se dodává s barevně označeným pigtail kabelem: | Vodič | Svorka | Funkce | |-------|--------|--------| | Červený | VCC | 12–36 V DC (nebo 12–24 V AC společně s černým) | | Černý | GND | Zem (nebo AC fáze s červeným) | | Bílý | ADC_IN | Analogový vstup (rozsah 0–12 V nebo 0–30 V) | | Žlutý | VCC_SENSOR | Výstup 3,3 V DC pro one-wire senzory | | Modrý | DATA_SENSOR | One-wire data (DS18B20 / DHT22) | | Zelený | GND_SENSOR | Zem senzoru | | Světle hnědý | IN_1 | Digitální vstup 1 | | Tmavě hnědý | IN_2 | Digitální vstup 2 | Dva bezpotenciálové výstupy jsou na těle modulu označené `OUT1` a `OUT2`. ### Digitální vstupy (IN_1, IN_2) Každý digitální vstup je bezpotenciálový a lze jej řídit DC nebo AC zdrojem: - **DC:** HIGH při ≥ 2,2 V, LOW pod 2,2 V, max 36 V DC - **AC:** HIGH při ≥ 12 V, LOW pod 12 V, max 24 V AC Typické použití jsou **jazýčkové kontakty** (senzory oken/dveří, plovákové spínače) a **tlačítka** zkratující vstup na GND přes externí napájení. ![Zapojení jazýčkového kontaktu Shelly UNI s DC napájením](https://taphome.com/images/compatibility/shelly-uni-mqtt/wiring-reed-contact-dc_hu_4be040d051e42061.jpg) ![Zapojení jazýčkového kontaktu Shelly UNI s AC napájením](https://taphome.com/images/compatibility/shelly-uni-mqtt/wiring-reed-contact-ac_hu_425daade8b447828.jpg) ![Zapojení tlačítka/spínače Shelly UNI s DC napájením](https://taphome.com/images/compatibility/shelly-uni-mqtt/wiring-button-switch-dc_hu_c95c9802866cc9c7.jpg) ![Zapojení tlačítka/spínače Shelly UNI s AC napájením](https://taphome.com/images/compatibility/shelly-uni-mqtt/wiring-button-switch-ac_hu_f9d3f31ed08b9743.jpg) ### Bezpotenciálové výstupy (OUT1, OUT2) Každý výstup je **bezpotenciálový kontakt s otevřeným kolektorem** s těmito absolutními limity: - maximální proud **100 mA** - maximální výkon **300 mW** - maximální spínané napětí **24 V AC** nebo **36 V DC** Tyto parametry jsou příliš nízké pro síťové zátěže — pro spínání reálných zátěží (světla, čerpadla, ventily) připoj výstupy na **externí relé nebo stykač** a cívku tohoto relé napájej odpovídajícím nízkonapěťovým zdrojem. ![Schéma zapojení bezpotenciálového výstupu Shelly UNI](https://taphome.com/images/compatibility/shelly-uni-mqtt/wiring-load-output_hu_5cd4aa406bacbcc0.jpg) ### Analogový vstup (ADC) Jeden ADC kanál na bílém vodiči (ADC_IN) podporuje dva napěťové rozsahy volitelné ve webovém rozhraní Shelly: - **0–12 V** — vyšší rozlišení pro nízkonapěťové signály - **0–30 V** — širší rozsah pro sledování baterie / DC linky Vybraný rozsah je uložen pouze v zařízení — šablona TapHome čte surovou publikovanou hodnotu a nedokáže zjistit, který rozsah je aktivní. Ujisti se, že ADC rozsah Shelly odpovídá signálu, který připojuješ na bílý vodič. ![Schéma zapojení ADC vstupu Shelly UNI](https://taphome.com/images/compatibility/shelly-uni-mqtt/wiring-adc-input_hu_b1b1677c93ad99cb.jpg) ## Konfigurace ### Shelly-ID a MQTT prefix Každý Shelly UNI má jedinečné **Shelly-ID** rovnající se posledním 6 znakům jeho MAC adresy (např. `35FA58`). Výsledný MQTT topic prefix je `shellyuni-` (např. `shellyuni-35fa58`). Shelly-ID najdeš: - Na štítku zařízení (MAC adresa) - Ve webovém rozhraní Shelly: **Settings** → **Device Info** - Přes API: `GET http:///settings` → pole `device.hostname` > [!TIP] > Shelly Gen1 zařízení se ohlašují přes mDNS jako `shellyuni-.local`. Tento hostname můžeš použít místo pevné IP adresy pro přístup do webového rozhraní. ### Zapnutí MQTT Na novém zařízení je MQTT vypnuté. Zapni ho před importem šablony TapHome: 1. Připoj se na přístupový bod zařízení `shellyuni-XXXXXX` (heslo je vytištěné na zařízení) nebo ho najdi v lokální síti 2. Otevři webové rozhraní na `http://192.168.33.1/` (AP režim) nebo na LAN IP 3. Přejdi na **Internet & Security** → **Advanced — Developer Settings** 4. Zaškrtni **Enable action execution via MQTT** 5. Nastav IP a port brokeru (výchozí `1883`), pole uživatele a hesla nech prázdná — TapHome na Gen1 **nepodporuje** MQTT autentizaci 6. Ulož a restartuj zařízení > [!WARNING] > Zapnutí MQTT **vypne připojení k Shelly Cloud** na Gen1 zařízeních. Je to záměrné — zařízení nedokáže udržet obě spojení současně. Mobilní aplikace Shelly nebude zařízení přes cloud ovládat; použij MQTT nebo lokální webové rozhraní. > [!WARNING] > Shelly Gen1 zařízení **nepodporují** MQTT přes TLS. Komunikace mezi zařízením a brokerem je nešifrovaná (obyčejné MQTT, port 1883). Ponech broker v důvěryhodné lokální síti. ### Nastavení šablony Při importu šablony do TapHome zadej: - **IpAddress** — IP adresa MQTT brokeru - **Port** — port brokeru (výchozí `1883`) - **DeviceID** — 6znakové Shelly-ID konkrétního UNI (např. `35fa58`) Importní parametr `DeviceID` se používá k sestavení custom proměnné `MQTTprefix` (výchozí `shellyuni-$[DeviceID]`). Pokud jsi na zařízení Shelly nastavil vlastní `mqtt_id` (přepisující výchozí), uprav po importu proměnnou `MQTTprefix` na modulu, aby odpovídala. > [!TIP] > Na zařízení Shelly vypni HTTP autentizaci (**Internet & Security** → **Restrict Login**). TapHome v této šabloně HTTP nepoužívá, ale ponechaná autentizace může zkomplikovat diagnostiku a aktualizace firmwaru. ## Možnosti zařízení ### Měření analogového napětí Zařízení **Analog Input** čte ADC napětí z `shellies//adc/0` a vystavuje jej jako číselnou hodnotu ve voltech. Skript parsuje příchozí zprávu přes `TODOUBLE(TOSTRING(PAYLOAD))` — bez jakéhokoli škálování. Skutečný rozsah měření (0–12 V nebo 0–30 V) je nakonfigurován přímo na zařízení Shelly a přes MQTT se neposílá. Šablona TapHome nedokáže ověřit, který rozsah je aktivní. ### Spínací výstupy Oba výstupy s otevřeným kolektorem jsou vystaveny jako standardní TapHome Switch zařízení: - **Switch 1** — OUT_1, topic `shellies//relay/0`, příkazový topic `.../relay/0/command` - **Switch 2** — OUT_2, topic `shellies//relay/1`, příkazový topic `.../relay/1/command` Listener mapuje payload `on` → ON (St=1) a `off` → OFF (St=0). Příkazy z TapHome se publikují jako `on` / `off` na příslušný příkazový topic. > [!WARNING] > Výstupy jsou bezpotenciálové a omezené na 100 mA / 300 mW. Nepřipojuj síťové zátěže přímo — na cokoli vyššího než nízkopříkonová signalizační zařízení použij externí relé nebo stykač. ### Digitální vstupy (jazýčkové kontakty) Oba digitální vstupy jsou vystaveny jako zařízení Reed Contact s **invertovanou logikou**: - **Reed Contact 1** — IN_1, topic `shellies//input/0` - **Reed Contact 2** — IN_2, topic `shellies//input/1` Firmware Shelly publikuje `1` když vstup vidí napětí nad svým prahem a `0` když je vstup stažen na GND. Protože jazýčkové kontakty a tlačítka typicky zkratují vstup na GND v **zavřeném / aktivním** stavu, skript TapHome payload invertuje: ```taphome Rc := IF(payload = "0", 1, 0) ``` To znamená, že `Rc=1` v TapHome = kontakt zavřený (aktivní, senzor otevření okna sepnutý, tlačítko stisknuté), `Rc=0` = kontakt otevřený (neaktivní). ### Další možnosti Hardware Shelly UNI podporuje také až **3 × DS18B20** teplotní senzory na one-wire sběrnici a — jako alternativu — **1 × DHT22** senzor vlhkosti/teploty. Tyto senzory publikují na `shellies//ext_temperature/{0,1,2}` a `shellies//ext_humidity/0`. Současná MQTT šablona tyto topicy nezapojuje do zařízení TapHome; mohou být přidány v budoucí aktualizaci šablony. Podobně zařízení vystavuje topic **online/offline LWT** a **vstupní události** (input events) krátkého/dlouhého stisku na `input_event/{0,1}`, které tato šablona nezpracovává. > [!TIP] > Pro spouštění scén podle událostí tlačítka (krátký stisk, dlouhý stisk) lze topic `input_event` dnes odebírat ze samostatného MQTT klienta — šablona TapHome sleduje pouze surový stav vstupu. ## Řešení problémů ### Zařízení neodpovídá 1. Ověř, že Shelly UNI je napájeno (červený/černý na 12–36 V DC nebo 12–24 V AC) a připojeno k Wi-Fi 2. Otevři webové rozhraní Shelly přes mDNS hostname `shellyuni-.local` nebo jeho DHCP IP 3. Ověř, že MQTT je zapnuté (**Internet & Security** → **Advanced — Developer Settings**) a IP/port brokeru odpovídají parametrům importu TapHome 4. Použij MQTT klienta (např. MQTT Explorer) k odběru `shellies/#` a ověř, že zařízení publikuje zprávy ### Spínače se nepřepínají 1. Zkontroluj cestu příkazového topicu — musí být `shellies//relay/0/command` (ne `.../relay/0/set`) 2. Ověř, že proměnná `MQTTprefix` modulu TapHome odpovídá topic prefixu, na kterém zařízení skutečně publikuje 3. Pamatuj, že výstupy jsou bezpotenciálové — bez externího obvodu dodávajícího napětí se stav výstupu mění, ale žádná zátěž se nespíná ### Stav jazýčkového kontaktu je obrácený Šablona předpokládá, že `payload=0` znamená „kontakt zavřený". Pokud externí zapojení táhne vstup do HIGH když je kontakt aktivní (opačné zapojení), stav se v TapHome jeví obráceně. Přepojuj tak, aby kontakt **zkratoval IN_1 / IN_2 na GND** když je aktivní, nebo uprav logiku ve vlastním skriptu. ### ADC hodnota mimo očekávaný rozsah ADC rozsah (0–12 V nebo 0–30 V) je nastaven na zařízení a nelze jej zpětně načíst přes MQTT. Pokud se číselná hodnota v TapHome zdá nesprávná (např. 2× vyšší nebo nižší než očekáváš), otevři webové rozhraní Shelly a zkontroluj **Settings** → **ADC range**. Šablona předpokládá, že zařízení publikuje napětí přímo a neprovádí žádnou konverzi. ## Jak nainstalovat v TapHome ### Předpoklady - Zařízení Shelly připojené k Wi-Fi (2,4 GHz), např. přes aplikaci Shelly nebo vlastní přístupový bod zařízení - MQTT broker běžící ve vaší lokální síti (např. Mosquitto, Home Assistant nebo vestavěný broker TapHome) - TapHome CCU ve stejné síti jako broker > [!WARNING] > Na zařízeních **Gen1** povolení MQTT **vypne Shelly Cloud**. Obojí nemůže běžet současně. Na zařízeních Gen2/Plus toto omezení neplatí. ### Krok 1 — Povolte MQTT na zařízení Shelly #### Zařízení Gen1 (Shelly 1, 1PM, 2.5, EM, 3EM, Plug S, RGBW2, Dimmer, TRV…) 1. Otevřete webové rozhraní Shelly: `http:///` 2. Přejděte na **Internet & Security** → **Advanced — MQTT** 3. Povolte **MQTT** 4. Nastavte **MQTT Server**: `:` (např. `192.168.1.10:1883`) 5. Volitelně nastavte **MQTT User** a **MQTT Password**, pokud váš broker vyžaduje autentifikaci 6. Klikněte na **Save** — zařízení se restartuje a připojí k brokeru #### Zařízení Gen2 / Plus (Shelly Plus 1, Plus 1PM, Plus 2PM, Plus Plug S, Plus H&T, Pro 3EM…) 1. Otevřete webové rozhraní Shelly: `http:///` 2. Přejděte na **Settings** → **MQTT** 3. Povolte **MQTT** 4. Nastavte **Server**: `:` (např. `192.168.1.10:1883`) 5. **Client ID** je předvyplněné ID zařízení (např. `shellyplus1pm-AABBCCDDEE`) — ponechte tak, pokud nemáte konkrétní důvod ke změně 6. Klikněte na **Save** a restartujte zařízení U vestavěného brokeru TapHome je `` IP adresa TapHome Core. Dejte jednotce Core rezervaci IP v routeru, jinak zařízení ztratí broker, když router adresu změní → [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/). > [!TIP] > Pro ověření funkčnosti MQTT použijte MQTT klienta (např. MQTT Explorer) a přihlaste se k odběru `shellies/#` (Gen1) nebo `/#` (Gen2). Měli byste vidět stavové zprávy ze zařízení. ### Krok 2 — Zjistěte Device ID / MQTT Client ID Některé šablony vyžadují parametr **Device ID** nebo **MQTT Client ID**. Jde o jedinečný identifikátor používaný v MQTT topicích. - **Gen1:** nachází se na štítku jako MAC adresa (např. `AABBCCDDEE`). Device ID = `shelly-`, např. `shelly1pm-AABBCCDDEE` - **Gen2/Plus:** nachází se ve webovém rozhraní Shelly v části **Settings** → **Device Info** → **Device ID**, nebo na štítku zařízení ### Krok 3 — Konfigurace v TapHome 1. V TapHome přidejte nový modul **Packet Parser (MQTT)** 2. **IP Address:** pro vestavěný broker TapHome `127.0.0.1` (jednotka se připojuje sama k sobě, adresa se nikdy nezmění); pro externí broker jeho IP adresa (např. `192.168.1.10`) 3. **Port:** `1883` (výchozí; pro TLS použijte `8883`) 4. **Device ID / MQTT Client ID:** zadejte hodnotu z kroku 2 (pokud to šablona vyžaduje) 5. Importujte šablonu — TapHome se automaticky přihlásí k odběru topiců zařízení ## Dostupná zařízení 5 Tato zařízení se po importu zobrazí v TapHome. Shelly UNI Modul Vlastní proměnné `MQTTprefix` (string) = shellyuni-$\[DeviceID] MQTT topic prefix zařízení Shelly UNI — výchozí shellyuni-{DeviceID} a používá se jako základ pro všechna odebíraná/publikovaná témata 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. Analogový vstup Proměnná Pouze ke čtení Měření napětí ADC — dvojitý rozsah 0–12 V nebo 0–30 V, volený na zařízení numeric Jednotka: V Listener ```taphome if RECEIVEDMSG.TOPIC = "shellies/" + MQTTprefix + "/adc/0" Va := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)); end ``` Spínač 1 Přepínač Čtení i zápis Bezpotenciálový výstup s otevřeným kolektorem OUT\_1 — max 100 mA / 300 mW, 24 V AC nebo 36 V DC string Hodnoty / Stavy: ON · OFF Zápis stavu přepínače ```taphome MQTTPUBLISH("shellies/" + MQTTprefix + "/relay/0/command", if(St, "on", "off")) ``` Listener ```taphome if RECEIVEDMSG.TOPIC = "shellies/" + MQTTprefix + "/relay/0" VAR payload := TOSTRING(RECEIVEDMSG.PAYLOAD); if(payload = "on", St := 1, St := 0); end ``` Spínač 2 Přepínač Čtení i zápis Bezpotenciálový výstup s otevřeným kolektorem OUT\_2 — max 100 mA / 300 mW, 24 V AC nebo 36 V DC string Hodnoty / Stavy: ON · OFF Zápis stavu přepínače ```taphome MQTTPUBLISH("shellies/" + MQTTprefix + "/relay/1/command", if(St, "on", "off")) ``` Listener ```taphome if RECEIVEDMSG.TOPIC = "shellies/" + MQTTprefix + "/relay/1" VAR payload := TOSTRING(RECEIVEDMSG.PAYLOAD); if(payload = "on", St := 1, St := 0); end ``` Jazýčkový kontakt 1 Jazýčkový kontakt Pouze ke čtení Digitální vstup IN\_1 — invertovaná logika, kontakt spojený s GND = aktivní (1) v TapHome string Listener ```taphome if RECEIVEDMSG.TOPIC = "shellies/" + MQTTprefix + "/input/0" VAR payload := TOSTRING(RECEIVEDMSG.PAYLOAD); Rc := if(payload = "0", 1, 0); end ``` Jazýčkový kontakt 2 Jazýčkový kontakt Pouze ke čtení Digitální vstup IN\_2 — invertovaná logika, kontakt spojený s GND = aktivní (1) v TapHome string Listener ```taphome if RECEIVEDMSG.TOPIC = "shellies/" + MQTTprefix + "/input/1" VAR payload := TOSTRING(RECEIVEDMSG.PAYLOAD); Rc := if(payload = "0", 1, 0); end ``` **Připojení:** Packet Parser → MQTT • Hostname: `shellyuni-{shelly-id}.local` Možná vylepšení (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. ## Parametry importu Tyto hodnoty zadáte při importu XML. | Ptá se v aplikaci | Výchozí | |-----------------------|---------------| | Mqtt Broker IP adresa | `192.168.0.1` | | Mqtt Broker port | `1883` | | Device ID | `XXXXXXXXX` | ## Zdroje - 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 UNI Knowledge Base [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-uni) 2026-04-16 - Shelly UNI Documentation (shelly.com) [www.shelly.com](https://www.shelly.com/blogs/documentation/shelly-uni) 2026-04-16 - Shelly UNI User Guide [shellysa.co.za](https://shellysa.co.za/wp-content/uploads/2021/04/Shelly-UNI-User-Guide.pdf) 2026-04-16 [PDF](https://taphome.com/compatibility/devices/shelly-uni-mqtt/manufacturer/shelly-uni-user-guide.pdf) Dokumenty výrobců jsou © jejich příslušných vlastníků. Poskytujeme je tak, jak je výrobce zveřejnil, pouze pro informaci. ## Související dokumentace - [MQTT Integration](https://taphome.com/cs/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/) - [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/) - [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/) - [Broker MQTT](https://taphome.com/cs/docs/integration/packet-parser/mqtt-broker/) - [Listener skripty](https://taphome.com/cs/docs/script/listener-scripts/)