MQTT
Forbind til en MQTT-broker, og læs værdier, der publiceres til topics, med valgfri QoS og kryptering.
MQTT læser værdier, der publiceres til topics på en MQTT-broker. Du forbinder til brokeren én gang og opretter et tag for hvert topic, du vil læse.
Forbind til en broker
| Indstilling | Hvad den gør |
|---|---|
| Navn | Identificerer enheden (med et valgfrit brugerdefineret navn). |
| Aktiveret | Om THMI opretter forbindelse til brokeren. Slå den fra for at stoppe kommunikation og indsamling af værdier uden at slette enheden. |
| Basis-topic | Et præfiks, der sættes foran de enkelte tags’ topics, så hvert tag kun behøver sit undertopic. |
| Protokol | Hvordan THMI forbinder til brokeren: MQTTS (TLS, anbefales), MQTT (ukrypteret), WSS (MQTT over sikker WebSocket) eller WS (ukrypteret WebSocket). |
| Vært | Brokerens værtsnavn eller IP-adresse. |
| Port | Brokerens port, typisk 8883 for MQTTS eller 1883 for MQTT. |
| Brugernavn / adgangskode | Loginoplysninger, hvis brokeren kræver det. |
Servicekvalitet og bevarede meddelelser
- Servicekvalitet (QoS): hvor pålideligt meddelelser leveres: 0 - Højst én gang, 1 - Mindst én gang eller 2 - Præcis én gang. Højere niveauer giver større sikkerhed for modtagelse på bekostning af mere trafik.
- Bevaret: sørger for, at brokeren gemmer den seneste meddelelse på et topic og leverer den til nye abonnenter, så snart de forbinder, så et tag får en værdi med det samme i stedet for at vente på næste publicering.
- Kvittering for modtagelse: sender en kvittering ved vellykket modtagelse. Kræves, for at QoS 1 og QoS 2 fungerer korrekt på målenheden.
Datakryptering
Du kan aktivere datakryptering af payloads ved at vælge en algoritme (AES eller DES) og angive nøglen og initialiseringsvektoren (deres krævede størrelser afhænger af algoritmen).
Sundhedstjek
Du kan aktivere et sundhedstjek, der jævnligt kontrollerer forbindelsen, med et interval (standard 60 sekunder) og en timeout (standard 10 sekunder).
Læs en værdi: topic’et
Hvert MQTT-tag læser ét topic (feltet Emne), der føjes til enhedens basis-topic. THMI behandler en værdis topic som en base og udveksler JSON-meddelelser på to undertopics under det:
| Undertopic | Retning | Payload |
|---|---|---|
{base topic}/{topic}/read | broker → THMI (værdi) | { "v": <value> } |
{base topic}/{topic}/write | THMI → broker (skrivninger) | { "v": <value> } |
Et tag med basis-topic building-a og topic boiler/temp læser altså fra
building-a/boiler/temp/read. Angiv den datatype, der passer til den
publicerede værdi (se Datatyper).
Skrivbar lader brugere med tilladelse publicere en værdi på undertopic’et
…/write (se Værdier).