NiuBoL Sensor verbindet sich über das MQTT-Protokoll mit der akenza.io-Plattform

Der Prozess der Integration mit der akenza.io-Plattform über das MQTT-Protokoll erfordert Schritte wie Gerätekonfiguration, Datenflusserstellung, Geräteregistrierung und Code-Implementierung. Nachfolgend finden Sie einen ausführlichen Leitfaden, basierend auf der offiziellen Akenza-Dokumentation und den Funktionen des MQTT-Protokolls, der erklärt, wie man die Integration Schritt für Schritt erreicht.

Schritt 1: Erstelle ein akenza.io-Konto 

1. Konto registrieren:

   - Besuchen Sie die Registrierungsseite unter https://akenza.io und erstellen Sie ein Konto. Wenn Sie bereits ein Konto haben, melden Sie sich direkt an.

   - Nach dem Einloggen werden Sie zum Dashboard der Akenza-Plattform geleitet. 

2. Die Plattform verstehen:

   - Die Akenza-Plattform unterstützt MQTTProtokoll und nutzt Eclipse Mosquitto als MQTTBroker. Die Plattform fungiert als Broker, und Geräte fungieren als MQTTKunden.  

Schritt 2: Erstellen Sie MQTTDatenfluss 

Ein Datenfluss definiert, wie Geräte über MQTTmit der Akenza-Plattform kommunizieren. 

1. Navigieren Sie zum Datenfluss:

   - Im Akenza-Dashboard klicken Sie im linken Menü auf "Datenfluss".

   - Klicken Sie auf die Schaltfläche "Datenfluss erstellen".

2. Wählen Sie MQTTVerbindung:

   - Im Verbindungstyp wählen Sie "Ein Gerät über MQTTverbinden".

   - Gerätetyp: Wählen Sie "Passthrough" aus, um Rohdatenformate zu empfangen (JSON-Format wird empfohlen).

   - Ausgabe-Connector: Wählen Sie das Speicherziel für die Daten, wie z. B. die Akenza-Datenbank (Standarddatenbank) oder andere unterstützte Connectoren wie InfluxDB oder Webhook.

3. Generiere ein Geheimnis (Schlüssel):

   - Nach der Erstellung des Datenflusses generiert das System automatisch ein Geheimnis (Schlüssel) zur Geräteauthentifizierung.

   - Dieses Geheimnis aufzeichnen, da es in der Themenstruktur und der Geräteverbindung MQTTverwendet wird. 

4. Speichere den Datenfluss:

   - Nachdem Sie Ihre Einstellungen bestätigt haben, klicken Sie auf "Erstellen", um den Datenfluss zu speichern. 

Schritt 3: Registrieren Sie ein Gerät 

1. Navigieren Sie zum Arbeitsbereich:

   - Im linken Menü klicken Sie auf "Arbeitsbereich".

   - Klicken Sie auf die Schaltfläche "Gerät erstellen".

2. Geräteinformationen ausfüllen:

   - Gerätename: Nennen Sie Ihr Gerät z. B. "Wettersensor" oder "Bodensensor".

   - Beschreibung (optional): Fügen Sie eine Beschreibung für das Gerät hinzu.

   - Tags/Custom Fields (optional): Tags oder benutzerdefinierte Felder zur Kategorisierung hinzufügen.

   - Datenfluss: Wählen Sie den MQTTDatenfluss aus, der im vorherigen Schritt erstellt wurde.

3. Geräte-ID generieren:

   - Klicken Sie auf "ID generieren", um eine eindeutige ID für das Gerät zu erstellen.

4. Vollständige Registrierung:

   - Klicken Sie auf "Gerät erstellen", um die Geräteregistrierung abzuschließen.

   - Nach der Registrierung finden Sie das Gerät im Gerätemenü und klicken Sie, um die Seite mit Gerätedetails zu öffnen.

5. API-Konfiguration erhalten:

   - Auf der Seite mit Gerätedetails unter dem Reiter "API-Configuration" erhalten Sie folgende Informationen:

     - MQTTBroker Host: Typischerweise mqtt.akenza.io.

     - MQTTBenutzername: Benutzername.

     - MQTTPasswort: Passwort.

     - Uplink-Thema: /up/{secret}/id/{deviceId}.

     - Downlink-Thema (optional): /down/{secret}/id/{deviceId}. 

Schritt 4: Konfigurieren Sie das Gerät so, dass es sich mit MQTTverbindet

Mit einem Gerät wie dem Niubol-Sensor oder einem anderen MQTT-fähigen Gerät konfigurieren Sie es so, dass es sich mit dem Akenza MQTTBroker verbindet. Die folgenden Anweisungen gehen davon aus, dass Sie den Niubol-Datensammler verwenden.

Schritt 5: Daten überprüfen 

1. Nachrichtenprotokolle ansehen:

   - Im Arbeitsbereich der Akenza-Plattform finden Sie Ihr Gerät und gehen Sie zur Seite mit den Gerätedetails.

   - Im Tab "Nachrichtenprotokolle" sehen Sie sich die vom Gerät gesendeten Uplink-Daten an.

   - Die Daten sollten im JSON-Format erscheinen, z. B. {"sensor":"temperature","value":25.5}.

2. Datenvisualisierung:

   - Im Tab Dashboard Builder sehen Sie sich die KPIs und historischen Datendiagramme des Geräts an.

   - Wenn ein Downlink-Thema konfiguriert ist, können Sie das Senden von Befehlen an das Gerät testen.

Schritt 6: TLS aktivieren (optional) 

Für eine verbesserte Sicherheit wird empfohlen, TLS-Verschlüsselung zu verwenden:

1. Verwenden Sie Port 8883 anstelle von 1883 für die verschlüsselte Kommunikation.

Anmerkungen: 

1. Authentifizierungsmethoden:

- Akenza unterstützt zwei Authentifizierungsmethoden:

- Uplink-Geheimnisse: Verwenden Sie einen gemeinsamen Schlüssel als MQTTPasswort.

- JWT: Verwenden Sie den privaten Schlüssel des Geräts, um ein JWT als Passwort zu generieren (sicherer, erfordert zusätzliche Konfiguration).

- Wählen Sie beim Erstellen des Datenflusses den Authentifizierungstyp. 

2. Themenstruktur:

- Uplink-Themenformat: /up/{secret}/id/{deviceId}.

- Downlink-Themenformat: /down/{secret}/id/{deviceId}.

- Sicherstellen, dass die Themen mit der Gerätekonfiguration übereinstimmen. 

3. Fehlerbehebung:

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

- Stellen Sie sicher, dass MQTTBenutzername, Passwort und Thema korrekt sind.

- Überprüfen Sie die stabile Netzwerkverbindung (Wi-Fioder Mobilfunknetz).

- Sicherstellen, dass die Ports nicht durch eine Firewall blockiert werden (1883 oder 8883).

- Verwenden Sie einen seriellen Monitor oder Protokolle, um Fehlercodes anzuzeigen.

4. Unterstützte Formate:

- Akenza akzeptiert JSON-formatierte MQTTNachrichten, daher sollte sichergestellt werden, dass die vom Gerät gesendeten Daten im korrekten Format sind.

Referenzressourcen:

- akenza Offizielle Dokumentation: MQTTVerbindung:

https://docs.akenza.io/akenza.io/get-started/your-data-flow/device-connector/mqtt

- Tutorial: Wie man ein Arduino-Gerät über MQTTauf Akenza integriert:

https://docs.akenza.io/akenza.io/tutorials/add-devices/how-to-integrate-an-arduino-device-via-mqtt-on-akenza

mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt mqtt niubol niubol

(mqtt, niubol)

(mqtt, niubol)