MQTT

Az MQTT plugin elérhetővé teszi a kommunikációt egy a hálózaton lévő MQTT broker-rel (szerver). A Miniserver minden esetben MQTT client-két működik és támogatja az adatküldést ("publishing") adatvételt ("subscribing") a broker-től.

MQTT (Message Queuing Telemetry Transport) egy egyszerű és könnyű protocol, amit eszközök közötti kommunikácóra használhatunk. Széles körben használják az IoT ("Internet of Things) megoldások pl.: érzékelőktől vagy okos eszközöktől való adatgyűjtés.

Egy MQTT broker szükséges, amire a Miniserver fel tud iratkozni (subscribe) és publikálni (publish) tud. A Miniserver 16 feliratkozást (subscription - bemenet) és 16 publikációt (publish - kimenet) tud kezelni.

Kérlek vedd figyelembe, hogy a Miniserver Gen. 1. nem támogatott.

Tartalom


Objektum létrehozása és beállítása↑

Az MQTT plugin a Hálózati perifériákon keresztül van integrálva:

Egy MQTT plugin csak egy broker-hez tud csatlakozni. A beállításokat az alábbiak szerint tudod konfigurálni:


Adat küldése/fogadása↑

Annak érdekében, hogy adatot tudj fogadni (subscribe) vagy küldeni (publish) a broker-nek, hozz létre egy megfelelő objektumot:

Az üzenetek küldése és fogadása minden esetben egy topic-on alapul, ami az adatokat azonosító útvonalként vagy címként szolgál. A feliratkozások (subscriptions) egyszerre több topic-ot is le tudnak kezelni (wildcardok) segítségével. A publikációk (publishes) nem támogatják a wildcardokat.

Példa a Topic-ra:
Ha a nappaliban lévő hőmérséklet mérőnek adatot szeretnénk küldeni, a hozzátartozó topicnak így kell kinéznie:
home/livingroom/temperature

Feliratkozás (Subscription):

Feliratkozás (fogadás):
A meghatározott topicról értékeket fogad a brokertől.
Másik eszköz vagy applikáció is fel tud iratkozni a topicra, hogy adatokat tudjon fogadni. Például, egy termosztát fel tud iratkozni a home/livingroom/temperature topicra, hogy hőmérsékleti adatokat kapjon.

Ha JSON formátumú vagy hasonló adatot fogad, javasolt a Parancsfelimerés blokkot használni, hogy ki tudjad nyerni az analóg értéket az adatból.

A feliratkozás (subscription) értékváltozásait 2 másodpercenként egyszer tudja kiértékelni. Ha az értékváltozás 2 másodpercen belül történik az előzőhöz képest, az adat a gyorsítótárba kerül. A 2 másodperces intervallum letelte után, az legfrissebb értéket kapjuk meg. Ez a megközelítés segít csökkenteni a Miniserver terheltségét, különösen akkor, ha egy topicon rövid idő alatt több változás is történik.

Wildcard-ok a feliratkozásoknál:
Annak érdekében, hogy ne kelljen minden egyes topicra külön-külön feliratkozni, az MQTT támogatja a wildcardokat, amelyek lehetővé teszik, hogy egyszerre több topicra is fel lehessen iratkozni:

Egyszintű Wildcard (+):Egy szintet helyettesít a topic elérési útvonalában.

Példa:
home/+/temperature

Ez a feliratkozás (subscription) üzeneteket fogad az összes helyiségtől, ami hőmérsékleti adatokat fogad. pl.:
home/livingroom/temperature
home/kitchen/temperature

Több szintű Wildcard (#):A topic minden további szintjét lefedi, és az útvonal végén kell használni.

Példa:
home/#

Ez a feliratkozás minden üzenetet megkap, ami a home/-rel kezdődik, függetlenül a következő szintek számától. pl.:
home/livingroom/temperature
home/kitchen/humidity
home/garage/car/battery

Csak a feliratkozások (subscriptions) támogatják a wildcardokat, a publikálások (publishes) nem. Egy eszköz csak egy meghatározott topicba tud üzenetet küldeni, több topicban nem tud.

Publikálás (Publish):

Publikálás (küldés):
Egy eszköz (kliens) üzenetet küld egy meghatározott topicba. A fenti példában a hőmérsékletérzékelő elküldi az aktuális hőmérsékletet a home/livingroom/temperature topicba.


Szenzorok↑

Rövid leírásMértékegység
SubscriptionSzöveg




Aktorok↑

Rövid leírásMértékegység
PublishSzöveg




Diagnosztikai bemenetek↑

Rövid leírásLeírásMértékegységÉrtékhatár
OnlinestatusJelzi, ha egy eszközt elér a Miniserver.
Diagnosztika Air eszközökhoz
Diagnosztika Tree eszközökhoz
Diagnosztika Extension-höz
Digitális0/1




Tulajdonságok↑

Rövid leírásLeírásÉrtékhatárAlapértelmezett érték
Broker címeAz MQTT broker hálózati címe--
Broker portAz MQTT broker hálózati portja (alapértelmezett: 1883)0...65535-
Protokol verzióMQTT protokol verziója, amit az MQTT broker támogat (alapértelmezett: MQTTv5)--
Client IDAz MQTT client ID-ja. Az ID-nak egyedinek kell lennie, amikor az MQTT brokerhez csatlakozol! MQTTv3 protokol használata estén az azonosító 23 karakterre rövidül.--
FelhasználónévAz MQTT broker-en történő hitelesítéshez szükséges felhasználónév. Hagyd üresen ha ismeretlenül akarsz belépni (ha az MQTT broker engedélyezi ezt).--
JelszóAz MQTT broker-en történő hitelesítéshez szükséges jelszó. Hagyd üresen ha ismeretlenül akarsz belépni (ha az MQTT broker engedélyezi ezt).--
SSL/TLS használataSSL/TLS használata az MQTT borkerhez való csatlakozáshoz.--
Szolgáltatás megfigyeléseKijelölés esetén az eseményekről rendszerüzeneteket, vagy Cloud Mailer használatával kapsz értesítést, amennyiben a szolgáltatás nem érhető el.--