MQTT
Anslut till en MQTT-broker och läs värden som publiceras till topics, med valfri QoS och kryptering.
MQTT läser värden som publiceras till topics på en MQTT-broker. Du ansluter till brokern en gång och skapar en tagg för varje topic du vill läsa.
Ansluta till en broker
| Inställning | Vad den gör |
|---|---|
| Namn | Identifierar enheten (med ett valfritt anpassat namn). |
| Aktiverad | Om THMI ansluter till brokern. Stäng av den för att stoppa kommunikation och värdeinsamling utan att radera den. |
| Bas-topic | Ett prefix som läggs till på de enskilda taggarnas topics, så att varje tagg bara behöver sitt sub-topic. |
| Protokoll | Hur THMI ansluter till brokern: MQTTS (TLS, rekommenderas), MQTT (oskyddad), WSS (MQTT över säker WebSocket) eller WS (oskyddad WebSocket). |
| Värd | Värdnamnet eller IP-adressen för brokern. |
| Port | Broker-porten — vanligtvis 8883 för MQTTS eller 1883 för MQTT. |
| Användarnamn / lösenord | Inloggningsuppgifter, om brokern kräver dem. |
Tjänstekvalitet och bevarade meddelanden
- Tjänstekvalitet (QoS) — hur tillförlitligt meddelanden levereras: 0 – Högst en gång, 1 – Minst en gång eller 2 – Exakt en gång. Högre nivåer ger större säkerhet om mottagande till priset av mer trafik.
- Bevarad — säkerställer att det senaste meddelandet på en topic bevaras av brokern och levereras till nya prenumeranter så snart de ansluter, så att en tagg har ett värde direkt i stället för att vänta på nästa publicering.
- Mottagningsbekräftelse — skickar en bekräftelse vid lyckat mottagande; krävs för att QoS 1 och QoS 2 ska fungera korrekt på målenheten.
Datakryptering
Aktivera valfritt datakryptering för payloads, välj en algoritm (AES eller DES) och ange nyckel och initialiseringsvektor (deras erforderliga storlekar beror på algoritmen).
Statuskontroll
Aktivera valfritt en statuskontroll som periodvis verifierar anslutningen, med ett intervall (standard 60 sekunder) och en tidsgräns (standard 10 sekunder).
Läsa ett värde: topic
Varje MQTT-tagg läser en topic, tillagd efter enhetens bas-topic. THMI behandlar ett värdes topic som en bas och utbyter JSON-meddelanden på två sub-topics under det:
| Sub-topic | Riktning | Payload |
|---|---|---|
{base topic}/{topic}/read | broker → THMI (värde) | { "v": <value> } |
{base topic}/{topic}/write | THMI → broker (skriver) | { "v": <value> } |
Så en tagg med base topic building-a och topic boiler/temp läser från
building-a/boiler/temp/read. Ställ in datatypen för att matcha det
publicerade värdet (se Datatyper). Skrivbar
låter användare med behörighet publicera ett värde på …/write-sub-topic:t (se
Värden).