De MQTT-plugin maakt communicatie met een MQTT-broker (server) op het netwerk mogelijk. De Miniserver fungeert altijd als een MQTT-client en ondersteunt het verzenden ("publiceren") van gegevens naar en het ontvangen ("abonneren") van gegevens van de broker.
MQTT (Message Queuing Telemetry Transport) is een eenvoudig en lichtgewicht protocol dat gebruikt kan worden voor communicatie tussen apparaten. Het wordt veel gebruikt voor "Internet of Things (IoT)" toepassingen, bijvoorbeeld voor het verzamelen van gegevens van sensoren of het aansturen van slimme apparaten.
Een MQTT-broker is vereist, waarop de Miniserver zich kan abonneren en publiceren. De Miniserver kan 16 abonnementen (ingangen) beheren en ook 16 publicaties (uitgangen).
|
Houd er rekening mee dat de Miniserver Gen. 1 niet wordt ondersteund. |
Inhoudsopgave
Een object maken en configureren↑
De MQTT-plugin is geïntegreerd via Netwerk apparatuur:
Eén MQTT-plugin kan slechts met één broker tegelijk verbinden. Configureer de instellingen als volgt:
Gegevens verzenden/ontvangen↑
Om gegevens van de broker te ontvangen (abonneren) of gegevens naar de broker te sturen (publiceren), maak het geschikte object aan:
Het verzenden en ontvangen van berichten is altijd gebaseerd op onderwerpen, die dienen als het pad of adres dat de gegevens identificeert. Abonnementen kunnen naar meerdere onderwerpen tegelijk luisteren met behulp van (wildcards). Publicaties ondersteunen geen wildcards.
Voorbeeld van een onderwerp:
Als er gegevens naar een temperatuursensor in de woonkamer gestuurd moeten worden, kan het bijbehorende onderwerp er zo uitzien:
thuis/woonkamer/temperatuur
Abonnement:
Abonneren (ontvangen):
Ontvangt waarden over het opgegeven onderwerp van de broker.
Een ander apparaat of toepassing kan zich abonneren op dit onderwerp om de verzonden berichten te ontvangen. Bijvoorbeeld, een thermostaat kan zich abonneren op het onderwerp home/livingroom/temperature om de temperatuurgegevens te verkrijgen.
Als JSON-geformatteerde gegevens of iets dergelijks worden ontvangen, wordt aanbevolen om het "Bevelsherkenning" bouwsteen te gebruiken om de analoge waarde uit de gegevens te extraheren.
|
|
Abonnementswaardeveranderingen worden hoogstens eenmaal elke 2 seconden geëvalueerd. Als er binnen 2 seconden na de vorige een waardeverandering optreedt, wordt de nieuwe verandering in de cache opgeslagen. Na het 2-secondeninterval wordt de meest recente verandering verwerkt. Deze aanpak helpt om de belasting op de Miniserver te verminderen, vooral wanneer meerdere veranderingen binnen een korte periode naar een onderwerp worden gestuurd. |
Wildcards in Abonnementen:
Om te vermijden dat je je op elk onderwerp afzonderlijk moet abonneren, ondersteunt MQTT wildcards, die een abonnement op meerdere onderwerpen tegelijk mogelijk maken:
Enkelvoudig jokerteken (+): Vervangt precies één onderwerpniveau in het onderwerppad.
Voorbeeld:
thuis/+/temperatuur
Dit abonnement ontvangt berichten van alle ruimtes in het huis die temperatuurgegevens versturen, zoals:
home/woonkamer/temperatuur
home/keuken/temperatuur
Meervoudig niveau wildcard (#): Dek alle volgende onderwerpniveaus in het onderwerppad en moet aan het einde van het pad worden gebruikt.
Voorbeeld:
thuis/#
Dit abonnement ontvangt alle berichten die beginnen met home/, ongeacht het aantal volgende niveaus, zoals:
home/woonkamer/temperatuur
home/keuken/luchtvochtigheid
home/garage/auto/accu
|
|
Alleen abonnementen ondersteunen jokertekens, publicaties niet. Een apparaat kan alleen berichten sturen naar een specifiek onderwerp, niet naar meerdere onderwerpen tegelijkertijd. |
Publiceren:
Publiceren (verzenden):
Een apparaat (client) stuurt een bericht naar een specifiek onderwerp. In het bovenstaande voorbeeld zou de temperatuursensor de huidige temperatuur naar home/livingroom/temperature sturen.
Sensoren↑
| Korte beschrijving | Eenheid |
|---|---|
| Subscription | Tekst |
Actoren↑
| Korte beschrijving | Eenheid |
|---|---|
| Publish | Tekst |
Diagnose ingangen↑
| Korte beschrijving | Beschrijving | Eenheid | Waardebereik |
|---|---|---|---|
| Onlinestatus | Geeft aan of het apparaat door de Miniserver kan worden bereikt. Diagnose voor Air-apparaten Diagnose voor Tree-apparaten Diagnose voor Extensions |
Digitaal | 0/1 |
Eigenschappen↑
| Korte beschrijving | Beschrijving | Waardebereik | Standaardwaarde |
|---|---|---|---|
| Broker address | Netwerkadres van de MQTT-broker | - | - |
| Broker poort | Netwerkpoort van de MQTT-broker (Standaard: 1883) | 0...65535 | - |
| Protocolversie | Ondersteunde MQTT-protocolversie door de MQTT-broker (standaard: MQTTv5) | - | - |
| Client ID | De ID van deze MQTT-client. De ID moet uniek zijn bij het verbinden met de MQTT-broker! Bij gebruik van het MQTTv3-protocol wordt de ID ingekort tot 23 tekens. | - | - |
| Gebruikersnaam | Gebruikersnaam voor authenticatie op de MQTT-broker. Laat leeg voor anonieme aanmelding (indien toegestaan door de MQTT-broker). | - | - |
| Wachtwoord | Wachtwoord voor authenticatie op de MQTT-broker. Laat leeg voor anonieme aanmelding (indien toegestaan door de MQTT-broker). | - | - |
| Gebruik SSL/TLS | Gebruik een SSL/TLS-verbinding voor de MQTT-broker. | - | - |
| Dienst bewaken | Indien aangevinkt, wordt u via de systeemstatus of via de cloud mailer verwittigd indien deze dienst niet langer beschikbaar of offline is. | - | - |