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

![Digi-International-Geräte mit TagoIO verbinden](https://tago.io/og/de/blog/how-to-connect-digi-international-devices-to-tagoio.png)

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](https://tago.io/pricing))
- 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](https://docs.tago.io/docs/tagotip/transports/mqtt) 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](https://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](https://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](https://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](https://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](https://docs.tago.io/docs/tagoio/devices/sending-data):

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

Wenn DRM eine andere Struktur sendet, verwende einen [Payload Parser](https://docs.tago.io/docs/tagoio/devices/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](https://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](https://docs.tago.io/docs/tagotip/transports/mqtt) 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:

| Einstellung | Wert |
|---|---|
| Host | `mqtt.tip.us-e1.tago.io` (US) oder `mqtt.tip.eu-w1.tago.io` (EU) |
| Port | `1883` (dev) oder `8883` mit TLS (Produktion) |
| Username | Erste 8 Hex-Zeichen deines Authorization Hash |
| Password | Letzte 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:

```python
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](https://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](https://docs.tago.io/docs/tagoio/dashboards/)

Für Anwendungen, die mehrere Digi-Geräte über verschiedene Standorte hinweg verwalten, nutze ein [Blueprint Dashboard](https://docs.tago.io/docs/tagoio/dashboards/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](https://docs.tago.io/docs/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](https://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](https://docs.tago.io/docs/tagoio/dashboards/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/tago-ai/tagoio-mcp-ai-powered-iot-data-integration](https://docs.tago.io/docs/tagoio/tago-ai/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.

- TagoIO-Devices-Doku: [docs.tago.io/docs/tagoio/devices](https://docs.tago.io/docs/tagoio/devices/)
- Network Integrations: [docs.tago.io/docs/tagoio/integrations](https://docs.tago.io/docs/tagoio/integrations/)
- Dashboard Templates: [docs.tago.io/docs/tagoio/dashboards](https://docs.tago.io/docs/tagoio/dashboards/)
- TagoTiP MQTT: [docs.tago.io/docs/tagotip/transports/mqtt](https://docs.tago.io/docs/tagotip/transports/mqtt)
- TagoIO MCP: [docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration](https://docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration)

[llms.txt](https://tago.io/llms.txt)