MQTT plugin umožňuje komunikáciu s MQTT brokerom (serverom) v sieti. Miniserver vždy funguje ako klient MQTT a podporuje odosielanie („ publishing“) údajov do brokera a prijímanie („subscribing“) údajov z neho.
MQTT (Message Queuing Telemetry Transport) je jednoduchý a nenáročný protokol, ktorý možno použiť na komunikáciu medzi zariadeniami. Široko sa používa v aplikáciách „internetu vecí“ (IoT), napr. na zber údajov zo snímačov alebo na ovládanie inteligentných zariadení.
Je potrebný MQTT broker, ku ktorému sa môže Miniserver pripojiť. Miniserver môže spravovať 16 odberov (vstupov) a 16 publikácií (výstupov).
![]() | Upozorňujeme, že Miniserver Gen. 1 nie je podporovaný. |
Obsah
Vytvorenie a konfigurácia objektu↑
MQTT plugin je integrovaný cez Sieťové Periférie:

Jeden MQTT plugin sa môže naraz pripojiť len k jednému brokerovi. Nastavenia nakonfigurujte nasledovne:

Odosielanie/prijímanie údajov↑
Ak chcete prijímať údaje od brokera (subscribe) alebo odosielať údaje brokerovi (publish), vytvorte príslušný objekt:

Odosielanie a prijímanie správ je vždy založené na témach, ktoré slúžia ako cesta alebo adresa identifikujúca údaje. Odbery môžu načúvať viacerým témam súčasne pomocou (wildcards). Publikovanie nepodporuje zástupné znaky.
Príklad témy:
Ak je potrebné odoslať údaje do snímača teploty v obývačke, príslušná téma by mohla vyzerať takto:
home/livingroom/temperature

Odber:
Odoberať (prijímať):
Prijíma hodnoty na zadanú tému od brokera.
Túto tému môže odoberať iné zariadenie alebo aplikácia, ktorá bude prijímať prenášané správy. Napríklad termostat môže odoberať tému domov/obývacia izba/teplota, aby získal údaje o teplote.
Ak sa prijímajú údaje vo formáte JSON alebo podobnom, odporúča sa použiť blok „Rozpoznanie príkazu“ na extrakciu analógovej hodnoty z údajov.
![]() | Zmeny hodnôt odberu sa vyhodnocujú najviac raz za 2 sekundy. Ak zmena hodnoty nastane do 2 sekúnd od predchádzajúcej zmeny, nová zmena sa uloží do vyrovnávacej pamäte. Po uplynutí 2-sekundového intervalu sa spracuje najnovšia zmena. Tento prístup pomáha znížiť zaťaženie Miniserveru, najmä keď sa v krátkom čase odošle do témy viacero zmien. |
Wildcards v Odberoch:
Aby ste nemuseli odoberať každú tému osobitne, MQTT podporuje zástupné znaky, ktoré umožňujú odber viacerých tém súčasne:
Single-Level Wildcard (+): Nahradí presne jednu úroveň témy v ceste k téme.
Príklad:
home/+/temperature
Tento odber prijíma správy zo všetkých miestností v domácnosti, ktoré odosielajú údaje o teplote, napríklad:
home/livingroom/temperature
home/kitchen/temperature
Multi-Level Wildcard (#): Pokrýva všetky nasledujúce úrovne témy v ceste k téme a musí sa použiť na konci cesty.
Príklad:
home/#
Tento odber prijíma všetky správy začínajúce na home/ bez ohľadu na počet nasledujúcich úrovní, napríklad:
home/livingroom/temperature
home/kitchen/humidity
home/garage/car/battery
![]() | Zástupné znaky podporujú iba odbery, publikácie nie. Zariadenie môže posielať správy len do konkrétnej témy, nie do viacerých tém súčasne. |
Publikovať:
:Publikovať (odoslať):
Zariadenie (klient) odošle správu na konkrétnu tému. Vo vyššie uvedenom príklade by snímač teploty odoslal aktuálnu teplotu na adresu home/livingroom/temperature.
Senzory↑
| Krátký popis | Jednotky |
|---|---|
| Subscription | Text |
Aktory↑
| Krátký popis | Jednotky |
|---|---|
| Publish | Text |
Vstupy pro diagnostiku↑
| Krátký popis | Popis | Jednotky | Rozsah hodnot |
|---|---|---|---|
| Onlinestatus | Uvádí, zda je zařízení dostupné pro Miniserver. Diagnostika Air zařízení Diagnostika Tree zařízení Diagnostika Extensionu | Digital | 0/1 |
Vlastnosti↑
| Krátký popis | Popis | Rozsah hodnot | Standardní hodnota |
|---|---|---|---|
| Adresa brokera | Sieťová adresa MQTT brokera | - | - |
| Port brokera | Sieťový port MQTT brokera (Predvolené: 1883) | 0...65535 | - |
| Verzia protokolu | Verzia protokolu MQTT podporovaná MQTT brokerom (predvolené: MQTTv5) | - | - |
| ID klienta | ID tohto klienta MQTT. ID musí byť pri pripájaní k MQTT brokerovi jedinečné! Pri použití protokolu MQTTv3 sa ID skráti na 23 znakov. | - | - |
| Užívateľské meno | Užívateľské meno pre overovanie na MQTT brokera. Nechajte prázdne pre anonymné prihlásenie (ak to MQTT broker umožňuje). | - | - |
| Heslo | Heslo pre overovanie na MQTT brokera. Nechajte prázdne pre anonymné prihlásenie (ak to MQTT broker umožňuje). | - | - |
| Použiť SSL/TLS | Použiť pripojenie SSL/TLS k MQTT brokerovi. | - | - |
| Monitorovat službu | Pokud je tato možnost zaškrtnuta, budete o nedostupnosti nebo offline stavu této služby informováni prostřednictvím Stavu Systému nebo Cloud Maileru. | - | - |
