Der NiuBoL-Sensor ist über das MQTT-Protokoll mit der akenza.io-Plattform verbunden

Der Prozess der Integration mit der akenza.io-Plattform über das MQTT-Protokoll erfordert die Durchführung von Schritten wie Gerätekonfiguration, Datenflusserstellung, Geräteregistrierung und Codeimplementierung. Nachfolgend finden Sie eine detaillierte Anleitung, die auf der offiziellen Akenza-Dokumentation und den Funktionen des MQTT-Protokolls basiert und Schritt für Schritt erklärt, wie die Integration erreicht wird.

Schritt 1: Erstellen Sie ein akenza.io-Konto

1. Registrieren Sie ein Konto:

- Besuchen Sie die Registrierungsseite unterhttps://akenza.iound erstellen Sie ein Konto. Wenn Sie bereits ein Konto haben, melden Sie sich direkt an.

- Nach der Anmeldung werden Sie zum Dashboard der Akenza-Plattform weitergeleitet.

2. Verstehen Sie die Plattform:

– Die Akenza-Plattform unterstützt das MQTT-Protokoll und verwendet Eclipse Mosquitto als MQTT-Broker.Die Plattform fungiert als Broker und die Geräte fungieren als MQTT-Clients.

Schritt 2: Erstellen Sie den MQTT-Datenfluss

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

1. Navigieren Sie zu Datenfluss:

- Klicken Sie im Akenza-Dashboard im linken Menü auf „Datenfluss“.

- Klicken Sie auf die Schaltfläche „Datenfluss erstellen“.

2. Wählen Sie MQTT-Verbindung:

- Wählen Sie als Verbindungstyp „Gerät über MQTT verbinden“ aus.

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

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

3. Generieren Sie ein Geheimnis (Schlüssel):

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

– Notieren Sie dieses Geheimnis, da es in der Themenstruktur MQTT und der Geräteverbindung verwendet wird.

4. Speichern Sie 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:

- Klicken Sie im linken Menü auf „Arbeitsbereich“.

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

2. Geben Sie die Geräteinformationen ein:

- Gerätename: Benennen Sie Ihr Gerät, z. B. „Wettersensor“ oder „Bodensensor“.

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

- Tags/benutzerdefinierte Felder (optional): Fügen Sie Tags oder benutzerdefinierte Felder zur Kategorisierung hinzu.

- Datenfluss: Wählen Sie den im vorherigen Schritt erstel lte n MQTT-Datenfluss aus.

3. Geräte-ID generieren:

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

4. Vollständige Registrierung:

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

- Suchen Sie nach der Registrierung das Gerät im Menü „Geräte“ und klicken Sie, um die Seite mit den Gerätedetails aufzurufen.

5. API-Konfiguration abrufen:

- Rufen Sie auf der Gerätedetailseite unter der Registerkarte „API-Konfiguration“ die folgenden Informationen ab:

-MQTT Broker-Host:Normalerweise mqtt.akenza.io.

-MQTT Benutzername: Benutzername.

-MQTT Passwort: Passwort.

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

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

Schritt 4: Konfigurieren Sie das Gerät für die Verbindung mit MQTT

Konfigurieren Sie ein Gerät wie den Niubol-Sensor oder ein anderes MQTT-fähiges Gerät für die Verbindung mit dem akenza MQTT-Broker. Bei den folgenden Anweisungen wird davon ausgegangen, dass Sie den Datenkollektor Niubol verwenden.

Schritt 5: Daten überprüfen

1. Nachrichtenprotokolle anzeigen:

- Suchen Sie im Arbeitsbereich der Akenza-Plattform nach Ihrem Gerät und rufen Sie die Seite mit den Gerätedetails auf.

- Sehen Sie sich auf der Registerkarte „Nachrichtenprotokolle“ die vom Gerät gesendeten Uplink-Daten an.

– Die Daten sol lte n im JSON-Format erscheinen, z. B.{"sensor":"temperature","value":25.5}.

2. Datenvisualisierung:

- Sehen Sie sich auf der Registerkarte „Dashboard Builder“ 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 erhöhte Sicherheit wird die Verwendung der TLS-Verschlüsselung empfohlen:

1. Verwenden Sie für die verschlüsse lte Kommunikation Port 8883 statt 1883.

Hinweise:

1. Authentifizierungsmethoden:

- akenza unterstützt zwei Authentifizierungsmethoden:

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

- 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}.

- Stellen Sie sicher, dass die Themen mit der Gerätekonfiguration übereinstimmen.

3. Fehlerbehebung:

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

- Stellen Sie sicher, dass der MQTT-Benutzername, das Passwort und das Thema korrekt sind.

- Stellen Sie sicher, dass die Netzwerkverbindung stabil ist (WLAN oder Mobilfunknetz).

- Stellen Sie sicher, 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 MQTT-Nachrichten. Stellen Sie daher sicher, dass die vom Gerät gesendeten Daten das richtige Format haben.

Referenzressourcen:

- Offizielle Dokumentation von akenza:MQTT Konnektivität:

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

- Tutorial: So integrieren Sie ein Arduino-Gerät über MQTT auf akenza:

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