So verbinden Sie den NiuBoL-Sensor über das MQTT-Protokoll mit der Thinger-IoT-Plattform

Auf dieser Seite (https://docs.thinger.io/mqtt)) wird erläutert, wie Sie Niubol-Geräte über das Protokoll mit MQTT.

In diesem Artikel wird detailliert beschrieben, wie der NiuBoL-Sensor über einen Datenlogger (Gateway/Datenrekorder) das MQTT-Protokoll verwendet, um eine Verbindung zur Thinger.io-Plattform herzustellen. Thinger.io unterstützt das MQTT-Protokoll und ermöglicht es Geräten, mit der Plattform zu kommunizieren, indem sie Nachrichten veröffentlichen (Publish) und abonnieren (Subscribe). Geräte müssen bestimmte MQTT-Themenformate verwenden und sich über ein Geräte-Token authentifizieren. In diesem Artikel wird außerdem erläutert, wie Sie den MQTT-Client konfigurieren, eine Verbindung zum MQTT-Server von Thinger.io herstellen, Daten veröffentlichen und abonnieren sowie Geräteeigenschaften, Ressourcen und Rückrufe verwa lte n.

*Voraussetzungen:

- Sie haben bereits ein Thinger.io-Konto. Wenn nicht, registrieren Sie sich bitte.

- Ihr Gerät unterstützt das MQTT-Protokoll.

Schritt-für-Schritt-Anleitung

Schritt 1: Erstellen Sie ein Gerät auf Thinger.io

1. Melden Sie sich bei Thinger.io an

- Öffnen Sie Ihren Browser, besuchen Sie Thinger.io und melden Sie sich mit Ihrem Benutzernamen und Passwort an.

2.Gehen Sie zur Seite „Geräteverwaltung“.

- Klicken Sie im linken Menü auf „Geräte“.

3. Fügen Sie ein neues Gerät hinzu

- Klicken Sie auf die Schaltfläche „Gerät hinzufügen“.

4. Wählen Sie Gerätetyp

- Gerätetyp: Wählen Sie „MQTT-Gerät“.

- Geräte-ID: Geben Sie einen eindeutigen Gerätenamen ein, z. B. „NiuBoL“.

- Geräteanmeldeinformationen: Dies ist das Gerätesicherheitskennwort, das über die Schaltfläche unten zufällig generiert werden kann. Kopieren Sie dieses Token und speichern Sie es zur späteren Verwendung.

– Beschreibung: Optional, geben Sie eine Beschreibung ein, z. B. „Mein MQTT-Gerät“, ich habe „BodensensorNBL-S-TMC“ verwendet.

- Klicken Sie zum Speichern auf „Gerät hinzufügen“.

Nachdem Sie das Gerät erstellt haben, können Sie auf das Gerät klicken, um es einzurichten oder sein Passwort zu ändern.

Hinweise:

- Gerätetyp: „MQTT-Gerät“ sol lte ausgewählt werden.

- Gerätekennung: Muss unter Ihren Geräten eindeutig sein.

- Gerätebeschreibung: Zusätzliche Informationen zur Identifizierung jedes Geräts.

- Geräteanmeldeinformationen: Dies ist das Gerätesicherheitskennwort, das über die Schaltfläche unten zufällig erstellt werden kann.

Wenn alle Informationen eingegeben sind, wird durch Klicken auf die Schaltfläche „Gerät hinzufügen“ ein neues Geräteprofil in der Geräteliste erstellt. Wenn alles korrekt ist, bedeutet dies, dass die Thinger.io-Plattform bereit ist, Daten von Ihren MQTT-Geräten zu empfangen.

Schritt 2: Erstellen Sie ein Dashboard

- Erstellen Sie ein neues Dashboard und richten Sie die erforderlichen Informationen ein.

Hinzufügen eines Dashboards und Einrichten zugehöriger Informationen

- Sobald das Dashboard erstellt ist, können Sie mit der Anzeige der Daten fortfahren.

Schritt 3: Daten-Buckets erstellen

1. Daten speichern

- Erstellen Sie im Thinger.io-Geräte-Dashboard einen Daten-Bucket, z. B. „Soildata“ oder „Weatherdata“, oder passen Sie ihn nach Ihren Wünschen an.

- Konfigurieren Sie es in den Geräteeinstellungen so, dass die eingehenden MQTT-Daten im Bucket gespeichert werden.

Folgende Parameter müssen konfiguriert werden:

- Bucket-ID: Eine eindeutige Kennung für den Bucket, z. B. „Soildata“ oder „Weatherdata“.

- Bucket-Name: Verwenden Sie einen repräsentativen Namen wie „Wetterdaten“ oder „Bodendaten“ oder den Projektnamen.

- Bucket-Beschreibung: Geben Sie zusätzliche Details an, z. B. „Bodensensordaten“.

- Aktiviert:Scha lte n Sie die Daten-Bucket-Aufzeichnung ein oder aus. Scha lte n Sie es ein, um es zu aktivieren.

- Datenquelle: Definiert normalerweise das vom Server abonnierte Thinger.io-Gerät oder die Ressource. In diesem Fall sol lte n Sie „Von MQTT Thema“ auswählen.

-MQTT-Thema: Geben Sie das MQTT-Thema ein, das vom Server abonniert wird.

Zum Beispiel:

-MQTT Thema: IhrBenutzername/Geräte/NiuBoL/Soildata

Auf diese Weise konfiguriert Thinger.io die Plattform als MQTT-Broker, aber auch als Themenkonsument, was zusätzliche Funktionen ermöglicht. Der Client muss Daten im JSON-Format senden.

Schritt 4: Konfigurieren Sie die Modbus-Erfassungsregeln und -Parameter auf dem Datenlogger (Gateway).

Grundeinstellungen: Legen Sie den Erfassungszeitraum und den Berichtszeitraum entsprechend Ihren Anforderungen fest.

Schnittstelleneinstellungen:

Modbus Regeleinstellungen:Weitere Informationen finden Sie in der spezifischen Sensordatentabelle.

Stellen Sie die Sensorausgabeeinheiten und die Präzision ein.

Schritt 5: Servereinstellungen – Festlegen der MQTT-Verbindungsparameter auf dem Datenlogger (Datenrekorder/Gateway)

Zum Beispiel:

- Kommunikationsprotokoll:MQTT

- Kapselungstyp: JSON

- Serveradresse: backend.thinger.io

- Hafen: 1883

-MQTT Öffentliches Thema: yourusername/devices/NiuBoL/Soildata

-MQTT Abonnieren Thema: Kann leer sein

-MQTT Benutzername: yourusername (Ihr Thinger.io-Benutzername)

-MQTT Passwort: Dies ist das Passwort für die Geräteanmeldeinformationen.

- Client-ID: Die Gerätekennung, die im Geräteformular konfiguriert wurde, z. B. „NiuBoL“

Hinweise:

- Broker-Adresse: backend.thinger.io (ohne den Teilhttp://)

- Broker-Port: 1883 für nicht sichere Verbindungen oder 8883 für SSL/TLS

- Benutzername: Ihr Benutzername (nicht Ihre E-Mail-Adresse).

- MQTT Öffentliches Thema: /Geräte//

- MQTT Thema abonnieren: Kann leer sein

-MQTT Passwort: Muss mit dem Passwort übereinstimmen, das Sie im Feld „Geräteanmeldeinformationen“ auf Thinger.io eingegeben haben.

- Client-ID: Die Gerätekennung, die Sie im Geräteformular eingerichtet haben.

2. Testen Sie die Verbindung

- Starten Sie den Client und prüfen Sie, ob die Verbindung erfolgreich ist.

- Wenn die Verbindung fehlschlägt, überprüfen Sie:

- Ob Benutzername und Passwort korrekt sind.

- Ob das Netzwerk funktioniert (überprüfen Sie, ob Port 1883 von der Firewall blockiert wird).

Schritt 6: Überprüfung und Debugging

1. Überprüfen Sie das Thinger.io-Dashboard

- Gehen Sie zurück zu Thinger.io und rufen Sie das Dashboard „Soildata“ auf.

- Überprüfen Sie, ob Daten in „Geräteeigenschaften“ oder „Daten-Buckets“ empfangen wurden.

Sobald das Gerät online ist, zeigt es eine erfolgreiche Verbindung an.

Sie können die Daten-Buckets überprüfen, um zu sehen, ob Daten empfangen werden.

Wenn Sie das Passwort ändern müssen, können Sie es in den Daten-Bucket-Einstellungen festlegen. Es ist keine Aktion erforderlich, wenn Siedokeine Änderungen vornehmen müssen.

Schritt 7:Konfigurieren Sie die Datenspeicherung und -anzeige

- Erstellen Sie ein Dashboard (Dashboard), fügen Sie Diagramme hinzu und binden Sie diese an die Daten-Buckets, um die Daten in Echtzeit anzuzeigen.

- Fügen Sie eine Registerkarte oder ein Widget hinzu.

- Wählen Sie den Widget-Typ.

- Wählen Sie die Datenquelle für das Widget aus.

- Legen Sie die Maßeinheit sowie die Maximal- und Minimalwerte fest.

Datenanzeige: Nach der Einrichtung werden die Daten auf dem Dashboard angezeigt.

Abschließendes Debuggen:

- Wenn keine Daten angezeigt werden, überprüfen Sie:

- Ob das Themenformat korrekt ist.

– Ob das Geräte-Token gültig ist.

- Ob das Nachrichtenformat korrekt ist (z. B. JSON).

So verbinden Sie den NiuBoL-Sensor über das MQTT-Protokoll mit der Thinger-IoT-Plattform.pdf