MQTT

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ý popisJednotky
SubscriptionText




Aktory↑

Krátký popisJednotky
PublishText




Vstupy pro diagnostiku↑

Krátký popisPopisJednotkyRozsah hodnot
OnlinestatusUvádí, zda je zařízení dostupné pro Miniserver.
Diagnostika Air zařízení
Diagnostika Tree zařízení
Diagnostika Extensionu
Digital0/1




Vlastnosti↑

Krátký popisPopisRozsah hodnotStandardní hodnota
Adresa brokeraSieťová adresa MQTT brokera--
Port brokeraSieťový port MQTT brokera (Predvolené: 1883)0...65535-
Verzia protokoluVerzia protokolu MQTT podporovaná MQTT brokerom (predvolené: MQTTv5)--
ID klientaID 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é menoUžívateľské meno pre overovanie na MQTT brokera. Nechajte prázdne pre anonymné prihlásenie (ak to MQTT broker umožňuje).--
HesloHeslo pre overovanie na MQTT brokera. Nechajte prázdne pre anonymné prihlásenie (ak to MQTT broker umožňuje).--
Použiť SSL/TLSPoužiť pripojenie SSL/TLS k MQTT brokerovi.--
Monitorovat službuPokud 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.--