Comment connecter les appareils Digi International à TagoIO

Digi International fabrique certaines des passerelles industrielles et des routeurs cellulaires les plus fiables du marché. Sa gamme d’appareils, de la passerelle LTE-M IX15 au routeur série IX30, connecte les capteurs de terrain et les machines à internet dans des environnements où la fiabilité n’est pas une option.

TagoIO vous apporte la couche applicative : gestion des appareils, stockage des données, dashboards en temps réel, alertes automatisées et une API REST complète pour bâtir vos applications. Les deux plateformes se complètent bien.

Mais faire remonter les données d’un appareil Digi vers TagoIO n’est pas automatique. Vous devez choisir la bonne voie d’intégration, formater correctement le payload et configurer les deux côtés. Ce guide couvre exactement cela, avec des instructions pas à pas pour chaque approche et des exemples pour quatre domaines d’application : bâtiments intelligents, surveillance industrielle, agriculture et équipements connectés.

Ce dont vous avez besoin avant de commencer

• Un compte TagoIO (forfait gratuit disponible)
• Une passerelle Digi (IX15, IX20, IX30 ou similaire) ou un compte Digi Remote Manager
• Un accès réseau de l’appareil Digi vers internet

Comment fonctionne l’intégration

Il existe deux voies principales pour faire remonter les données des appareils Digi vers TagoIO :

Voie 1 : DataStreams de Digi Remote Manager + webhook HTTPS C’est la voie recommandée lorsque vous utilisez déjà DRM pour gérer votre flotte. DRM collecte les données de vos appareils Digi via les DataStreams et peut les transférer vers n’importe quel point de terminaison HTTPS, y compris l’API TagoIO.

Voie 2 : MQTT direct depuis la passerelle Digi Si votre passerelle Digi exécute un script Python ou dispose d’un client MQTT intégré, vous pouvez la connecter directement au broker MQTT de TagoIO avec TagoTiP. Cela contourne entièrement DRM et réduit la latence.

Les deux voies fonctionnent. Choisissez celle qui correspond à votre installation actuelle.

Voie 1 : des DataStreams Digi Remote Manager vers TagoIO

Étape 1 : créer un appareil dans TagoIO

1. Connectez-vous à admin.tago.io.
2. Cliquez sur Devices dans la barre latérale gauche.
3. Cliquez sur Add Device.
4. Sélectionnez HTTPS comme type de connecteur.
5. Donnez un nom à l’appareil (par exemple, digi-ix15-building-a).
6. Cliquez sur Create Device.

Documentation complète de configuration des appareils : docs.tago.io/docs/tagoio/devices

Étape 2 : copier le token de l’appareil

Après avoir créé l’appareil, allez dans l’onglet General et copiez le Device Token. Vous l’utiliserez pour authentifier les requêtes provenant de DRM.

En savoir plus sur les tokens : docs.tago.io/docs/tagoio/devices/device-token

Étape 3 : configurer un abonnement DataStream dans Digi Remote Manager

Dans DRM, les DataStreams sont des canaux de données nommés dans lesquels votre appareil Digi écrit (par exemple, temperature, humidity, battery_level). Vous pouvez vous abonner à ces flux et envoyer les données vers un point de terminaison HTTPS externe.

1. Connectez-vous à votre compte DRM sur devicecloud.digi.com.

2. Allez dans Data Services > DataStreams.

3. Repérez les flux de données provenant de votre appareil. Ils suivent le format /dia/channel/<device-id>/<stream-name>.

4. Allez dans Monitor et créez un nouvel abonnement Monitor subscription.

5. Définissez le topic sur les flux de données que vous voulez transférer.

6. Définissez la méthode de livraison sur HTTP POST.

7. Définissez l’URL du point de terminaison sur :

   https://api.tago.io/data

8. Ajoutez l’en-tête HTTP suivant :

   Device-Token: YOUR_DEVICE_TOKEN

DRM enverra désormais les données vers TagoIO par POST chaque fois qu’une nouvelle valeur arrive sur les flux auxquels vous êtes abonné.

Étape 4 : mapper le payload DRM vers les variables TagoIO

DRM envoie les données dans son propre format XML ou JSON. TagoIO attend le format de données standard :

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

Si DRM envoie une structure différente, utilisez un Payload Parser dans TagoIO pour transformer le payload entrant avant son stockage.

Pour ajouter un parser :

1. Ouvrez votre appareil dans TagoIO.
2. Allez dans l’onglet Payload Parser.
3. Écrivez une fonction JavaScript qui extrait les variables du payload DRM et les renvoie au format TagoIO.

Étape 5 : vérifier les données dans le Live Inspector

Ouvrez l’onglet Live Inspector sur la page de votre appareil dans TagoIO. Il affiche chaque requête entrante en temps réel. Envoyez une lecture de test depuis DRM et confirmez que les données apparaissent ici avant de construire votre dashboard.

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

Voie 2 : MQTT direct depuis la passerelle Digi

Les passerelles Digi qui exécutent le firmware Digi ou des scripts Python peuvent se connecter directement à TagoIO via MQTT avec le protocole TagoTiP.

Étape 1 : créer un appareil TagoTiP dans TagoIO

1. Dans TagoIO, allez dans Devices > Add Device.
2. Recherchez TagoTiP et sélectionnez-le comme connecteur.
3. Donnez un nom à l’appareil et définissez son Serial Number (il correspond au topic MQTT).
4. Enregistrez l’appareil et notez l’Authorization Hash dans l’onglet General.

Étape 2 : connecter le client MQTT de la passerelle Digi

Configurez le client MQTT de votre appareil Digi avec ces paramètres :

Étape 3 : publier les données des capteurs

Le format de payload TagoTiP est compact et lisible :

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

Pour un Digi IX15 doté d’un capteur de température connecté, un script Python s’exécutant sur la passerelle ressemblerait à ceci :

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()

Documentation complète de TagoTiP : docs.tago.io/docs/tagotip/transports/mqtt

Étape 6 : construire votre dashboard

Une fois que les données circulent dans TagoIO, allez dans Dashboards et cliquez sur + pour en créer un nouveau.

TagoIO propose des modèles de dashboard prêts à l’emploi à partir desquels démarrer. Dans la fenêtre de création de dashboard, cherchez Templates pour trouver des mises en page prêtes pour des applications courantes, dont la surveillance environnementale et le suivi des actifs. Vous pouvez ensuite adapter les widgets à vos variables de données Digi.

Documentation des dashboards : docs.tago.io/docs/tagoio/dashboards

Pour les applications qui gèrent plusieurs appareils Digi répartis sur différents sites, utilisez un Blueprint Dashboard. Les blueprint dashboards utilisent des tags pour associer automatiquement une seule mise en page de dashboard à plusieurs appareils. Vous créez la mise en page une fois ; chaque appareil obtient sa propre vue.

Étape 7 : configurer des alertes et des actions automatisées

Utilisez les Actions de TagoIO pour déclencher des notifications ou une logique lorsque les valeurs des capteurs franchissent des seuils. Par exemple, envoyez un e-mail ou un SMS quand un capteur de température dans une salle serveur dépasse 30 C, ou déclenchez un script quand une machine passe hors ligne.

Documentation des Actions : docs.tago.io/docs/tagoio/actions

Exemples d’applications

Bâtiments intelligents

Les passerelles Digi IX15 ou IX20 se connectent au BACnet/IP, au Modbus RTU ou à des entrées de capteurs directes à l’intérieur d’un bâtiment. Variables courantes à transmettre à TagoIO :

• Température et humidité du CVC par zone
• Consommation d’énergie (kWh) par circuit
• Comptages des capteurs d’occupation
• Détection de fuite d’eau (alerte binaire)

Sur le dashboard, utilisez des graphiques de séries temporelles pour les tendances énergétiques et des widgets de type carte pour les températures actuelles par zone. Configurez des alertes pour prévenir l’équipe technique lorsqu’une zone sort de la plage de confort.

Surveillance industrielle

Les routeurs Digi IX30 et IX40 disposent de ports série RS-232/RS-485 qui se connectent aux automates et aux équipements industriels anciens. Transmettez à TagoIO :

• Comptages de cycles machine et indicateurs de TRS
• Courant absorbé et vibration des moteurs
• Vitesse et débit des convoyeurs
• Codes d’alarme issus des registres des automates

Utilisez des scripts Analysis de TagoIO pour calculer le TRS à partir des données brutes de cycles et réécrire le résultat dans une variable de dashboard. Les alertes peuvent déclencher un système d’ordres de travail via l’API TagoIO lorsqu’une machine passe en état de défaut.

Agriculture

Le Digi IX15 avec connectivité LTE-M fonctionne dans les zones à couverture cellulaire limitée. Déployez-le sur une station de pompage ou une serre et transmettez :

• L’humidité du sol à plusieurs profondeurs
• La température de l’air et l’humidité relative
• Le débit d’irrigation et l’état des vannes
• Le niveau d’eau des réservoirs

Utilisez la fonction Blueprint Dashboard pour créer une seule mise en page et l’appliquer à chaque station de terrain. Chaque station obtient sa propre vue de dashboard sans dupliquer la configuration.

Équipements connectés (flotte et actifs)

Les routeurs Digi de la série WR et les modules cellulaires XBee sont courants dans les équipements mobiles. Transmettez à TagoIO :

• La position GPS
• Les heures moteur et la consommation de carburant
• L’état des capteurs de portes et de compartiments
• La tension de batterie des équipements électriques

TagoIO stocke les données de localisation et peut les afficher sur un widget carte. Combinez-les avec des données de séries temporelles pour corréler la position avec la consommation de carburant ou les événements de maintenance.

Aller plus loin avec l’IA

TagoIO dispose d’un serveur MCP qui connecte les assistants IA comme Claude directement à vos données IoT. Une fois que vos appareils Digi transmettent à TagoIO, vous pouvez interroger ces données en langage naturel : demander des anomalies, générer des scripts d’analyse ou obtenir un résumé de ce qui s’est passé sur le site la semaine dernière. Détails sur docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration.

Récapitulatif

Connecter les appareils Digi International à TagoIO demande trois choses : un appareil dans TagoIO avec un token valide, une voie de données (webhook DataStreams DRM ou MQTT direct) et un payload au bon format. Tout ce qui suit, dashboards, alertes et analyses, se construit dans TagoIO.

L’intégration fonctionne pour tout appareil Digi capable d’atteindre internet. Commencez par un seul appareil, validez les données dans le Live Inspector, puis construisez le dashboard à partir de là.

• Documentation TagoIO Devices : docs.tago.io/docs/tagoio/devices
• Intégrations réseau : docs.tago.io/docs/tagoio/integrations
• Modèles de dashboard : docs.tago.io/docs/tagoio/dashboards
• TagoTiP MQTT : docs.tago.io/docs/tagotip/transports/mqtt
• TagoIO MCP : docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration