MQTT

Yhdistä MQTT-välittäjään ja lue aiheisiin julkaistuja arvoja valinnaisella QoS:llä ja salauksella.

MQTT lukee MQTT-välittäjän aiheisiin julkaistuja arvoja. Yhdistät välittäjään kerran ja luot tagin jokaiselle aiheelle, jonka haluat lukea.

Välittäjään yhdistäminen

AsetusMitä se tekee
NimiTunnistaa laitteen (valinnaisen mukautetun nimen kanssa).
KäytössäMuodostaako THMI yhteyden välittäjään. Poista se käytöstä lopettaaksesi tiedonsiirron ja arvojen keruun poistamatta laitetta.
PerusaiheYksittäisten tagien aiheisiin lisättävä etuliite, jotta kukin tagi tarvitsee vain oman aliaiheensa.
ProtokollaMiten THMI yhdistää välittäjään: MQTTS (TLS, suositeltu), MQTT (salaamaton), WSS (MQTT suojatun WebSocketin kautta) tai WS (salaamaton WebSocket).
IsäntäVälittäjän isäntänimi tai IP-osoite.
PorttiVälittäjän portti, yleensä 8883 MQTTS:lle tai 1883 MQTT:lle.
Käyttäjätunnus / salasanaTunnistetiedot, jos välittäjä vaatii niitä.

Palvelunlaatu ja säilytetyt viestit

  • Palvelunlaatu (QoS): kuinka luotettavasti viestit toimitetaan: 0 – enintään kerran, 1 – vähintään kerran tai 2 – täsmälleen kerran. Korkeammat tasot takaavat paremmin perillemenon, mutta lisäävät liikennettä.
  • Säilytetty: varmistaa, että välittäjä säilyttää aiheen viimeisimmän viestin ja toimittaa sen uusille tilaajille heti niiden yhdistäessä, joten tagilla on arvo heti eikä sen tarvitse odottaa seuraavaa julkaisua.
  • Vastaanottokuittaus: lähettää kuittauksen onnistuneesta vastaanotosta. Tarvitaan, jotta QoS 1 ja QoS 2 toimivat oikein kohdelaitteessa.

Datan salaus

Voit halutessasi ottaa käyttöön hyötykuormien datan salauksen, valita algoritmin (AES tai DES) ja antaa avaimen ja alustusvektorin (niiden vaaditut koot riippuvat algoritmista).

Kuntotarkistus

Voit halutessasi ottaa käyttöön kuntotarkistuksen, joka tarkistaa yhteyden säännöllisesti. Sille määritetään väli (oletus 60 sekuntia) ja aikakatkaisu (oletus 10 sekuntia).

Arvon lukeminen: aihe

Kukin MQTT-tagi lukee yhden aiheen, joka liitetään laitteen perusaiheen perään. THMI käsittelee arvon aihetta perustana ja välittää JSON-viestejä kahden sen alla olevan aliaiheen kautta:

AliaiheSuuntaHyötykuorma
{base topic}/{topic}/readvälittäjä → THMI (arvo){ "v": <value> }
{base topic}/{topic}/writeTHMI → välittäjä (kirjoitukset){ "v": <value> }

Tagi, jonka perusaihe on building-a ja aihe boiler/temp, lukee siis aiheesta building-a/boiler/temp/read. Aseta tietotyyppi vastaamaan julkaistua arvoa (katso Tietotyypit). Kirjoitettava antaa käyttäjien, joilla on oikeus, julkaista arvon aliaiheeseen …/write (katso Arvot).