MQTT

Koble til en MQTT-broker og les verdier som publiseres på temaer, med valgfri QoS og kryptering.

MQTT leser verdier som publiseres på temaer hos en MQTT-broker. Du kobler til brokeren én gang og oppretter en tagg for hvert tema du vil lese.

Koble til en broker

InnstillingHva den gjør
NavnIdentifiserer enheten (med et valgfritt egendefinert navn).
AktivertOm THMI kobler til brokeren. Slå den av for å stoppe kommunikasjon og verdiinnsamling uten å slette enheten.
BasistemaEt prefiks som legges til foran temaene til de enkelte taggene, slik at hver tagg bare trenger undertemaet sitt.
ProtokollHvordan THMI kobler til brokeren: MQTTS (TLS, anbefalt), MQTT (ukryptert), WSS (MQTT over sikker WebSocket) eller WS (ukryptert WebSocket).
VertVertsnavnet eller IP-adressen til brokeren.
PortPorten til brokeren, som regel 8883 for MQTTS eller 1883 for MQTT.
Brukernavn / passordPåloggingsinformasjon, hvis brokeren krever det.

Tjenestekvalitet og beholdte meldinger

  • Tjenestekvalitet (QoS): hvor pålitelig meldinger leveres: 0 – høyst én gang, 1 – minst én gang eller 2 – nøyaktig én gang. Høyere nivåer gir større sikkerhet for mottak, men mer trafikk.
  • Beholdt: sørger for at brokeren tar vare på den siste meldingen på et tema og leverer den til nye abonnenter så snart de kobler til, slik at en tagg får en verdi med en gang i stedet for å vente på neste publisering.
  • Mottaksbekreftelse: sender en bekreftelse når en melding er mottatt; kreves for at QoS 1 og QoS 2 skal fungere riktig på målenheten.

Datakryptering

Du kan aktivere datakryptering for payloads, velge en algoritme (AES eller DES) og oppgi nøkkel og initialiseringsvektor (størrelsene som kreves, avhenger av algoritmen).

Tilstandssjekk

Du kan aktivere en tilstandssjekk som jevnlig kontrollerer tilkoblingen, med et intervall (standard 60 sekunder) og et tidsavbrudd (standard 10 sekunder).

Lese en verdi: temaet

Hver MQTT-tagg leser ett tema, som legges til etter basistemaet til enheten. THMI behandler temaet til en verdi som en base og utveksler JSON-meldinger på to undertemaer under det:

UndertemaRetningPayload
{base topic}/{topic}/readbroker → THMI (verdi){ "v": <value> }
{base topic}/{topic}/writeTHMI → broker (skriving){ "v": <value> }

En tagg med basistemaet building-a og temaet boiler/temp leser altså fra building-a/boiler/temp/read. Angi datatypen slik at den passer til den publiserte verdien (se Datatyper). Skrivbar lar brukere med tillatelse publisere en verdi på undertemaet …/write (se Verdier).