How to

Digi-International-Geräte mit TagoIO verbinden

Schritt-für-Schritt-Anleitung zur Anbindung von Digi-International-Gateways und Digi Remote Manager an TagoIO. Mit Einrichtung über HTTPS, MQTT und DataStreams für Smart Buildings, Industrie, Landwirtschaft und vernetzte Maschinen.

Fabio Rosa ·
Digi-International-Geräte mit TagoIO verbinden

Digi International baut einige der zuverlässigsten industriellen Gateways und Mobilfunk-Router auf dem Markt. Die Gerätereihe, vom IX15-LTE-M-Gateway bis zum seriellen Router IX30, verbindet Feldsensoren und Maschinen mit dem Internet, und das in Umgebungen, in denen Zuverlässigkeit nicht verhandelbar ist.

TagoIO liefert die Anwendungsebene: Geräteverwaltung, Datenspeicherung, Echtzeit-Dashboards, automatisierte Alarme und eine vollständige REST-API als Grundlage für eigene Lösungen. Die beiden Plattformen ergänzen sich gut.

Daten von einem Digi-Gerät nach TagoIO zu bekommen, geschieht allerdings nicht von allein. Du musst den passenden Integrationsweg wählen, das Payload korrekt formatieren und beide Seiten konfigurieren. Genau das deckt diese Anleitung ab, mit Schritt-für-Schritt-Anweisungen für jeden Ansatz und Beispielen aus vier Anwendungsbereichen: Smart Buildings, industrielle Überwachung, Landwirtschaft und vernetzte Maschinen.

Was du vorab brauchst

  • Ein TagoIO-Konto (kostenloser Tarif verfügbar)
  • Ein Digi-Gateway (IX15, IX20, IX30 oder ähnlich) oder ein Konto bei Digi Remote Manager
  • Netzwerkzugang vom Digi-Gerät zum Internet

So funktioniert die Integration

Es gibt zwei wesentliche Wege, um Daten von Digi-Geräten nach TagoIO zu bekommen:

Weg 1: Digi Remote Manager DataStreams + HTTPS-Webhook Das ist der empfohlene Weg, wenn du deine Flotte bereits mit DRM verwaltest. DRM sammelt über DataStreams Daten von deinen Digi-Geräten und kann sie an jeden beliebigen HTTPS-Endpunkt weiterleiten, einschließlich der TagoIO-API.

Weg 2: Direktes MQTT vom Digi-Gateway Wenn dein Digi-Gateway ein Python-Skript ausführt oder einen integrierten MQTT-Client hat, kannst du es über TagoTiP direkt mit dem MQTT-Broker von TagoIO verbinden. Das umgeht DRM komplett und bietet geringere Latenz.

Beide Wege funktionieren. Wähle den, der zu deinem bestehenden Setup passt.

Weg 1: Digi Remote Manager DataStreams zu TagoIO

Schritt 1: Ein Gerät in TagoIO anlegen

  1. Melde dich bei admin.tago.io an.
  2. Klicke in der linken Seitenleiste auf Devices.
  3. Klicke auf Add Device.
  4. Wähle HTTPS als Connector-Typ.
  5. Gib dem Gerät einen Namen (zum Beispiel digi-ix15-building-a).
  6. Klicke auf Create Device.

Vollständige Dokumentation zur Geräteeinrichtung: docs.tago.io/docs/tagoio/devices

Schritt 2: Den Device Token kopieren

Nachdem du das Gerät angelegt hast, gehe zum Tab General und kopiere das Device Token. Damit authentifizierst du die Anfragen von DRM.

Mehr zu Tokens: docs.tago.io/docs/tagoio/devices/device-token

Schritt 3: Ein DataStream-Abonnement in Digi Remote Manager konfigurieren

In DRM sind DataStreams benannte Datenkanäle, in die dein Digi-Gerät schreibt (zum Beispiel temperature, humidity, battery_level). Du kannst diese Streams abonnieren und die Daten an einen externen HTTPS-Endpunkt schicken.

  1. Melde dich bei deinem DRM-Konto unter devicecloud.digi.com an.

  2. Navigiere zu Data Services > DataStreams.

  3. Finde die Datenstreams, die von deinem Gerät kommen. Sie folgen dem Format /dia/channel/<device-id>/<stream-name>.

  4. Gehe zu Monitor und erstelle ein neues Monitor subscription.

  5. Setze das Topic auf die Datenstreams, die du weiterleiten möchtest.

  6. Stelle die Zustellmethode auf HTTP POST.

  7. Setze die Endpunkt-URL auf:

    https://api.tago.io/data

  8. Füge folgenden HTTP-Header hinzu:

    Device-Token: YOUR_DEVICE_TOKEN

DRM schickt nun jedes Mal Daten per POST an TagoIO, wenn ein neuer Wert auf den abonnierten Streams eintrifft.

Schritt 4: Das DRM-Payload auf TagoIO-Variablen abbilden

DRM sendet Daten in seinem eigenen XML- oder JSON-Format. TagoIO erwartet das Standard-Datenformat:

[
  {"variable": "temperature", "value": 23.5, "unit": "C"},
  {"variable": "humidity", "value": 65, "unit": "%"}
]

Wenn DRM eine andere Struktur sendet, verwende einen Payload Parser in TagoIO, um das eingehende Payload zu transformieren, bevor es gespeichert wird.

So fügst du einen Parser hinzu:

  1. Öffne dein Gerät in TagoIO.
  2. Gehe zum Tab Payload Parser.
  3. Schreibe eine JavaScript-Funktion, die die Variablen aus dem DRM-Payload extrahiert und sie im TagoIO-Format zurückgibt.

Schritt 5: Daten im Live Inspector prüfen

Öffne den Tab Live Inspector auf der Geräteseite in TagoIO. Er zeigt jede eingehende Anfrage in Echtzeit. Sende eine Testmessung aus DRM und bestätige, dass die Daten hier erscheinen, bevor du dein Dashboard baust.

Live-Inspector-Doku: docs.tago.io/docs/tagoio/devices/live-inspector

Weg 2: Direktes MQTT vom Digi-Gateway

Digi-Gateways, die Digi-Firmware oder Python-Skripte ausführen, können sich über MQTT mit dem TagoTiP-Protokoll direkt mit TagoIO verbinden.

Schritt 1: Ein TagoTiP-Gerät in TagoIO anlegen

  1. Gehe in TagoIO zu Devices > Add Device.
  2. Suche nach TagoTiP und wähle es als Connector.
  3. Gib dem Gerät einen Namen und lege seine Serial Number fest (sie ist dem MQTT-Topic zugeordnet).
  4. Speichere das Gerät und notiere dir den Authorization Hash aus dem Tab General.

Schritt 2: Den MQTT-Client des Digi-Gateways verbinden

Konfiguriere den MQTT-Client auf deinem Digi-Gerät mit diesen Einstellungen:

EinstellungWert
Hostmqtt.tip.us-e1.tago.io (US) oder mqtt.tip.eu-w1.tago.io (EU)
Port1883 (dev) oder 8883 mit TLS (Produktion)
UsernameErste 8 Hex-Zeichen deines Authorization Hash
PasswordLetzte 8 Hex-Zeichen deines Authorization Hash
Publish-Topic$tip/{serial}/push
Subscribe-Topic$tip/{serial}/ack

Schritt 3: Sensordaten veröffentlichen

Das TagoTiP-Payload-Format ist kompakt und gut lesbar:

[temperature:=23.5#C;humidity:=65#%]

Für einen Digi IX15 mit angeschlossenem Temperatursensor würde ein auf dem Gateway laufendes Python-Skript so aussehen:

import paho.mqtt.client as mqtt

SERIAL = "ix15-building-a"
AUTH_HASH = "4deedd7bab8817ec"  # replace with your hash
HOST = "mqtt.tip.us-e1.tago.io"

client = mqtt.Client()
client.username_pw_set(AUTH_HASH[:8], AUTH_HASH[8:])
client.connect(HOST, 1883)

payload = "[temperature:=23.5#C;humidity:=65#%]"
client.publish(f"$tip/{SERIAL}/push", payload)
client.disconnect()

Vollständige TagoTiP-Dokumentation: docs.tago.io/docs/tagotip/transports/mqtt

Schritt 6: Dein Dashboard bauen

Sobald Daten in TagoIO ankommen, gehe zu Dashboards und klicke auf +, um ein neues anzulegen.

TagoIO bietet vorgefertigte Dashboard-Vorlagen, von denen du ausgehen kannst. Suche im Dialog zur Dashboard-Erstellung nach Templates, um fertige Layouts für gängige Anwendungen zu finden, darunter Umweltüberwachung und Asset-Tracking. Anschließend passt du die Widgets an die Variablen deiner Digi-Daten an.

Dashboard-Dokumentation: docs.tago.io/docs/tagoio/dashboards

Für Anwendungen, die mehrere Digi-Geräte über verschiedene Standorte hinweg verwalten, nutze ein Blueprint Dashboard. Blueprint-Dashboards verknüpfen über Tags automatisch ein einzelnes Dashboard-Layout mit mehreren Geräten. Du erstellst das Layout einmal; jedes Gerät bekommt seine eigene Ansicht.

Schritt 7: Alarme und automatisierte Aktionen einrichten

Nutze TagoIO Actions, um Benachrichtigungen oder Logik auszulösen, wenn Sensorwerte Schwellenwerte überschreiten. Sende zum Beispiel eine E-Mail oder SMS, wenn ein Temperatursensor in einem Serverraum 30 C übersteigt, oder starte ein Skript, wenn eine Maschine offline geht.

Actions-Dokumentation: docs.tago.io/docs/tagoio/actions

Anwendungsbeispiele

Smart Buildings

Digi-IX15- oder IX20-Gateways verbinden sich mit BACnet/IP, Modbus RTU oder direkten Sensoreingängen innerhalb eines Gebäudes. Gängige Variablen, die du nach TagoIO streamen kannst:

  • HVAC-Temperatur und -Feuchtigkeit pro Zone
  • Energieverbrauch (kWh) pro Stromkreis
  • Zählwerte von Belegungssensoren
  • Wasserleckerkennung (binärer Alarm)

Verwende im Dashboard Zeitreihendiagramme für Energietrends und Karten-Widgets für die aktuellen Zonentemperaturen. Richte Alarme ein, die das Facility-Team benachrichtigen, wenn eine Zone aus dem Komfortbereich fällt.

Industrielle Überwachung

Die Router Digi IX30 und IX40 haben serielle RS-232/RS-485-Anschlüsse, die sich mit SPS und älteren Industrieanlagen verbinden. Streame nach TagoIO:

  • Maschinenzykluszahlen und OEE-Kennzahlen
  • Motorstromaufnahme und Vibration
  • Förderbandgeschwindigkeit und Durchsatz
  • Alarmcodes aus SPS-Registern

Nutze TagoIO-Analysis-Skripte, um die OEE aus Roh-Zyklusdaten zu berechnen und das Ergebnis in eine Dashboard-Variable zurückzuschreiben. Alarme können über die TagoIO-API ein Arbeitsauftragssystem auslösen, wenn eine Maschine in einen Fehlerzustand geht.

Landwirtschaft

Der Digi IX15 mit LTE-M-Konnektivität funktioniert in Gebieten mit eingeschränkter Mobilfunkabdeckung. Setze ihn an einer Pumpstation oder im Gewächshaus ein und streame:

  • Bodenfeuchte in mehreren Tiefen
  • Lufttemperatur und relative Luftfeuchtigkeit
  • Durchflussrate der Bewässerung und Ventilstatus
  • Tankfüllstand

Nutze die Blueprint Dashboard-Funktion, um ein einziges Layout zu erstellen und auf jede Feldstation anzuwenden. Jede Station bekommt ihre eigene Dashboard-Ansicht, ohne dass du die Konfiguration duplizieren musst.

Vernetzte Maschinen (Flotte und Asset)

Router der Digi-WR-Serie und XBee-Mobilfunkmodule sind in mobilen Geräten weit verbreitet. Streame nach TagoIO:

  • GPS-Standort
  • Betriebsstunden und Kraftstoffverbrauch
  • Status von Tür- und Fachsensoren
  • Batteriespannung bei Elektrogeräten

TagoIO speichert Standortdaten und kann sie in einem Karten-Widget anzeigen. Kombiniere sie mit Zeitreihendaten, um den Standort mit dem Kraftstoffverbrauch oder Wartungsereignissen in Beziehung zu setzen.

Noch weiter mit KI

TagoIO hat einen MCP-Server, der KI-Assistenten wie Claude direkt mit deinen IoT-Daten verbindet. Sobald deine Digi-Geräte nach TagoIO streamen, kannst du diese Daten in natürlicher Sprache abfragen: nach Anomalien fragen, Analysis-Skripte generieren oder eine Zusammenfassung dessen erhalten, was letzte Woche in der Fertigung passiert ist. Details unter docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration.

Zusammenfassung

Digi-International-Geräte mit TagoIO zu verbinden, braucht drei Dinge: ein Gerät in TagoIO mit gültigem Token, einen Datenweg (DRM-DataStreams-Webhook oder direktes MQTT) und ein Payload im richtigen Format. Alles danach, Dashboards, Alarme und Analysen, wird innerhalb von TagoIO gebaut.

Die Integration funktioniert für jedes Digi-Gerät, das das Internet erreichen kann. Starte mit einem Gerät, validiere die Daten im Live Inspector und baue von dort aus dein Dashboard.

Verwandte Beiträge

Elsys LoRaWAN-Sensoren mit TagoIO verbinden

Elsys LoRaWAN-Sensoren mit TagoIO verbinden

Jun 3, 2026

Kerlink LoRaWAN Gateways mit TagoIO verbinden

Kerlink LoRaWAN Gateways mit TagoIO verbinden

Jun 2, 2026

Milesight-Sensoren mit TagoIO verbinden

Milesight-Sensoren mit TagoIO verbinden

Jun 2, 2026