--- title: "DATABOOM: Registrieren und Senden eines Werts - icom Data Suite" slug: "databoom-registering-and-sending-a-value-de" updated: 2024-09-12T07:40:59Z published: 2024-09-12T07:40:59Z canonical: "docs.insys-icom.com/databoom-registering-and-sending-a-value-de" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.insys-icom.com/llms.txt > Use this file to discover all available pages before exploring further. # DATABOOM: Registrieren und Senden eines Werts - icom Data Suite Die icom Data Suite ermöglicht das Senden von Daten von einem INSYS-Router an den DATABOOM Cloud-Dienst. ## Situation Ein Datenpunkt eines INSYS-Router soll von der icom Data Suite überwacht und der Wert an den DATABOOM Cloud-Dienst gesendet werden. ## Lösung Folgende einfache Beispielanwendung überträgt den Zählerstand eines Timers eines INSYS-Router in regelmäßigen Abständen an DATABOOM. ### Konfiguration von DATABOOM Es wird vorausgesetzt, dass Sie über einen DATABOOM Account verfügen. 1. Rufen sie die DATABOOM-Webseite auf: - [https://app.databoom.com](https://app.databoom.com) 2. Melden Sie sich an Ihrem DATABOOM Account an. 3. Klicken Sie auf das Weltkugel-Symbol oben und wählen Sie Ihre Sprache aus. 4. Klicken Sie auf *DEVICES* im Menü links und dann auf *Add device*: - *Device type*: *MQTT* - *Beschreibung*: **INSYS router** - Füllen Sie die Definition des Geräts entsprechend aus. 5. Gehen Sie zum jetzt erschienen Abschnitt *MQTT*, gaben Sie **databoom** in das Feld *Projects* ein und spezifizieren Sie den Topic: - *Topic where publish data*: **data** - *Topic where it’s possible to receive information from Databoom*: **info** 6. Klicken Sie auf *Save*. 7. Klicken Sie auf *SIGNALS* im Menü links und dann auf *Add signal*: - *Device*: wählen Sie oben hinzugefügtes Gerät aus - *Typ*: wählen Sie einen passenden Typ aus, z.B. *Other* - *Beschreibung*: **signal** 8. Klicken Sie auf *Save*. 9. Klicken Sie auf *SETTINGS* im Menü links und dann auf *Credentials*. 10. Geben sie im Abschnitt *OAuth keys* **INSYS router** als *Description* ein und klicken Sie auf *Add OAuth*, um ein OAuth-Token zu erzeugen, das später für den Zugriff auf den MQTT-Broker verwendet wird. 11. Klicken Sie auf das Kopieren-Symbol () klicken, um den OAuth-Token in die Zwischenablage zu kopieren. 12. Klicken Sie auf *DEVICES* im Menü links und dann auf das oben hinzugefügte Gerät. 13. Klicken Sie im Abschnitt *INFO* auf das Kopieren-Symbol () hinter *Token*, um den Device-Token in die Zwischenablage zu kopieren, um ihn später zum Erzeugen der MQTT-Nachricht zu verwenden. 14. Klicken Sie im Abschnitt *MQTT* auf das Kopieren-Symbol () hinter *Client-ID*, um die Client-ID in die Zwischenablage zu kopieren, um sie später für den Zugriff auf den MQTT-Broker zu verwenden. 15. Klicken Sie im Abschnitt *MQTT* auf das Kopieren-Symbol () hinter *Topic where publish data* klicken, um den Topic in die Zwischenablage zu kopieren, um ihn später zum Erzeugen der MQTT-Nachricht zu verwenden. 16. Auf *SIGNALS* im Menü links klicken und auf das oben hinzugefügte Signal klicken. 17. Klicken Sie im Abschnitt *Signal info* auf das Kopieren-Symbol () hinter *Token to copy*, um den Signal-Token in die Zwischenablage zu kopieren, um ihn später zum Erzeugen der MQTT-Nachricht zu verwenden. ### Konfiguration der icom Data Suite Es wird vorausgesetzt, dass Sie Zugriff auf das Web-Interface der icom Data Suite haben. Der Router muss über eine Internet-Verbindung verfügen. 1. Öffnen Sie ein neues Browser-Tab oder -Fenster und rufen Sie das Web-Interface der icom Data Suite auf. - [https://192.168.1.10](https://192.168.1.10) oder [https://ids.local](https://ids.local) (Voreinstellung) - *Benutzername*: insys (Voreinstellung) - *Kennwort*: icom (Voreinstellung) 2. Fügen Sie im Menü *Datenpunkt* → *Timer* einen neuen Timer hinzu () und bearbeiten Sie diesen (): - *Beschreibung*: **Message timer** - Typ: *Intervall*, jede Minute ausgelöst > [!NOTE] > Bitte beachten Sie! > > Ein Übertragungsintervall unter einer Minute ist sinnlos, da DATABOOM derzeit nur eine Nachricht pro Minute akzeptiert. 3. Klicken Sie auf *Einstellungen speichern*. 4. Fügen sie im Menü *Datenpunkt* → *Timer* einen neuen Timer hinzu () und bearbeiten Sie diesen (): - *Beschreibung*: **Count sample timer** - Typ: *Intervall*, alle 13 Sekunden ausgelöst 5. Klicken Sie auf *Einstellungen speichern*. 6. Fügen Sie im Menü *Nachrichten* → *MQTT* einen neuen Broker hinzu () und bearbeiten Sie diesen (): - *Beschreibung*: **DATABOOM** - *Server*: [**mqtt.databoom.com**](http://mqtt.databoom.com) - *Port*: **1883** - *Version*: *v3.1* - *Benutzername*: geben Sie Ihren DATABOOM-Benutzernamen ein (in Ihrem DATABOOM-Profil angezeigt ) - *Passwort*: fügen Sie Ihren OAuth Token aus der Zwischenablage hier ein (wie oben beschrieben kopieren) - *Client-ID* : fügen Sie Ihre Client-ID aus der Zwischenablage hier ein (wie oben beschrieben kopieren) 7. Klicken Sie auf *Einstellungen speichern*. 8. Fügen Sie im Menü *Nachrichten* → *MQTT* einen neue Nachricht hinzu () und bearbeiten Sie diese (): - *Beschreibung*: **Signalnachricht** - *Topic*: - *Nachricht*: fügen Sie die Nachricht im folgenden JSON-Format ein: ```json { "type": "data", "message": {    "device": "",    "date": "$TIMESTAMP ",    "signals" : [      {        "name": "",        "value": "$timer2 "      }    ]  } } ``` - *Retain*: - *QoS*: 0 . Auf *Einstellungen speichern* klicken. > [!NOTE] > Bitte beachten Sie! > > Kopieren sie den device und signal token wie oben beschrieben. > > Das Leerzeichen hinter den Variablen `"$TIMESTAMP "` und `"$timer2 "` ist notwendig. 9. Klicken Sie auf *Einstellungen speichern*. 10. Fügen sie im Menü *Ereignisse* ein neues Ereignis hinzu () und bearbeiten Sie dieses (): - *Beschreibung*: **Signalnachricht an DATABOOM senden** - *Ereignis*: *Timer ist abgelaufen* - *Timer*: wählen Sie den oben hinzugefügten *timer1 - Message timer* aus - *Aktion*: *Nachricht versenden* - *Nachricht …​ versenden*: wählen Sie den oben hinzugefügte Signalnachricht aus 11. Klicken Sie auf *Einstellungen speichern*. 12. Aktivieren Sie das Profil (). 13. Wechseln Sie zurück zum Browser-Tab oder -Fenster von DATABOOM. 14. Klicken Sie auf *SIGNALS* im Menü links und wählen Sie das zuvor hinzugefügte Signal aus. 15. Klicken Sie auf *Edit*. 16. Klicken Sie auf *Validate* in der jetzt erscheinenden Validier-Meldung und bestätigen Sie die Validierung. > [!NOTE] > Bitte beachten Sie! > > Die Validierung eines Werts stellt sicher, dass der Benutzer den Wert nicht unbedacht verwendet, obwohl er eine Korrektur erfordern würde. 17. Klicken Sie auf *Save*. ## Fehlersuche - Wenn sich die icom Data Suite nicht mit dem DATABOOM MQTT-Broker verbinden kann, überprüfen Sie die Konfiguration des MQTT-Brokers. - Wenn sich die icom Data Suite mit dem DATABOOM MQTT-Broker verbinden kann, aber DATABOOM keine Signaldaten empfängt, prüfen Sie Folgendes: - Der Topic der Nachricht muss die Form **databoom//data** wie oben beschrieben haben. Ersetzen Sie **** durch den Token-String ohne eckige Klammern. - Die Leerstelle hinter den Variablen (wie hinter `$TIMESTAMP`) und vor dem Komma ist wichtig. Ein fehlendes Leerzeichen lässt die Nachricht ungültig werden.