How to

Comment connecter les appareils RAK Wireless à TagoIO

Guide pas à pas pour connecter les capteurs WisBlock et les gateways RAK Wireless à TagoIO. Couvre la configuration du serveur de réseau LoRaWAN (TTN et ChirpStack), le décodage des payloads et des cas d'usage concrets pour l'agriculture intelligente, la surveillance industrielle et la mesure environnementale.

Thiago Lima ·
Comment connecter les appareils RAK Wireless à TagoIO

RAK Wireless construit l’un des écosystèmes LoRaWAN les plus flexibles du marché aujourd’hui. La plateforme modulaire WisBlock vous permet de combiner cœurs de capteurs, modules de communication et cartes de base pour créer un nœud IoT sur mesure en quelques minutes. Leurs gateways RAK7258, RAK7289 et RAK7268 sont largement déployés dans les bâtiments, les campus et les sites industriels.

TagoIO fournit la couche applicative : gestion des appareils, stockage des données, dashboards, alertes et une API REST complète. Ensemble, le matériel RAK et TagoIO couvrent toute la chaîne, du capteur à la décision, mais leur connexion demande quelques étapes précises de chaque côté.

Ce guide détaille l’intégration de bout en bout, de la configuration du serveur de réseau LoRaWAN à votre premier dashboard en direct.

Ce qu’il vous faut avant de commencer

  • Un compte TagoIO (formule gratuite disponible)
  • Un gateway RAK (RAK7258, RAK7289, RAK7268C ou similaire)
  • Un ou plusieurs nœuds capteurs WisBlock ou appareils LoRaWAN RAK
  • Un serveur de réseau LoRaWAN : The Things Network (TTN) ou une instance ChirpStack auto-hébergée

Comment fonctionne l’intégration

Les gateways RAK transmettent les paquets LoRaWAN à un serveur de réseau (NS). Le NS décode l’adressage de l’appareil et transmet le payload à une couche applicative, ici TagoIO.

Il existe deux chemins principaux :

Chemin 1 : Gateway RAK → The Things Network → TagoIO C’est la configuration la plus courante. TTN gère la couche MAC LoRaWAN, et l’intégration TTN native de TagoIO reçoit les uplinks via webhook.

Chemin 2 : Gateway RAK → ChirpStack → webhook HTTPS TagoIO Pour les déploiements privés ou les installations sur site, les gateways RAK qui exécutent ChirpStack (intégré dans le firmware AEP du RAK7258) peuvent transmettre les payloads décodés à TagoIO via HTTP POST.

Les deux chemins produisent le même résultat dans TagoIO. Choisissez selon votre préférence d’infrastructure réseau.

Chemin 1 : RAK + The Things Network + TagoIO

Étape 1 : enregistrez votre gateway sur TTN

  1. Connectez-vous à console.cloud.thethings.network.
  2. Allez dans Gateways et cliquez sur Register gateway.
  3. Saisissez l’EUI de votre gateway (indiqué sur l’étiquette du gateway RAK ou dans l’interface d’administration).
  4. Sélectionnez le plan de fréquences correspondant à votre région (EU868, US915, AU915, etc.).
  5. Enregistrez et vérifiez que votre gateway affiche l’état Connected.

Étape 2 : enregistrez votre appareil terminal sur TTN

  1. Dans votre application TTN, cliquez sur Register end device.
  2. Choisissez votre module WisBlock dans le répertoire d’appareils (par exemple RAK4631 avec le profil de capteur approprié), ou saisissez les identifiants manuellement.
  3. Copiez les AppEUI, DevEUI et AppKey générés : vous les programmerez dans votre nœud WisBlock via le RAK Serial Port Tool ou des commandes AT.

Étape 3 : créez un appareil dans TagoIO

  1. Connectez-vous à admin.tago.io.
  2. Cliquez sur Devices dans la barre latérale gauche, puis sur Add Device.
  3. Recherchez The Things Network v3 dans la liste des connecteurs et sélectionnez-le.
  4. Donnez à l’appareil un nom qui correspond à votre appareil terminal TTN.
  5. TagoIO génère une URL de webhook et un Authorization Token. Copiez les deux.

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

Étape 4 : ajoutez le webhook TagoIO dans TTN

  1. Dans votre application TTN, allez dans Integrations → Webhooks.
  2. Cliquez sur Add webhook et choisissez Custom webhook.
  3. Renseignez la Base URL avec l’URL de webhook TagoIO de l’étape 3.
  4. Renseignez l’en-tête Authorization avec le token de l’étape 3.
  5. Activez Uplink message dans les types de message.
  6. Enregistrez le webhook.

TTN transmettra désormais en temps réel chaque uplink LoRaWAN de vos appareils enregistrés vers TagoIO.

Étape 5 : écrivez un Payload Parser pour votre capteur WisBlock

Les capteurs WisBlock envoient des payloads binaires. Le format dépend du module de capteur que vous avez raccordé. TagoIO attend des variables décodées dans son format de données standard :

[
  {"variable": "temperature", "value": 22.5, "unit": "C"},
  {"variable": "humidity", "value": 58.0, "unit": "%"}
]

Pour transformer le payload TTN brut dans ce format, ajoutez un Payload Parser à votre appareil TagoIO :

  1. Ouvrez l’appareil dans TagoIO.
  2. Allez dans l’onglet Payload Parser.
  3. Écrivez une fonction JavaScript qui lit payload.uplink_message.decoded_payload (TTN l’envoie si vous configurez un formatter dans TTN) ou décodez les octets bruts depuis payload.uplink_message.frm_payload.

Exemple de parser pour un capteur environnemental WisBlock (RAK1906 / BME680) :

const decoded = payload.uplink_message.decoded_payload;

if (!decoded) {
  payload = [];
  return;
}

payload = [
  { variable: "temperature", value: decoded.temperature, unit: "C" },
  { variable: "humidity", value: decoded.humidity, unit: "%" },
  { variable: "pressure", value: decoded.pressure, unit: "hPa" },
  { variable: "gas_resistance", value: decoded.gas, unit: "Ohm" }
];

Documentation du Payload Parser : docs.tago.io/docs/tagoio/devices/payload-parser

Étape 6 : vérifiez dans le Live Inspector

Ouvrez l’onglet Live Inspector sur la page de votre appareil. Il affiche chaque requête entrante en temps réel. Déclenchez un uplink depuis votre nœud WisBlock et confirmez que les variables décodées apparaissent avant de construire votre dashboard.

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

Chemin 2 : Gateway RAK + ChirpStack + TagoIO

Les RAK7258 et RAK7289 sont livrés avec un LNS ChirpStack intégré dans leur firmware AEP. C’est utile pour les réseaux LoRaWAN privés, sans dépendance à TTN.

Étape 1 : configurez ChirpStack sur le gateway RAK

  1. Connectez-vous à l’interface web du gateway RAK (par défaut 192.168.230.1).
  2. Allez dans LoRa Network et assurez-vous que ChirpStack est sélectionné comme serveur de réseau.
  3. Dans le serveur d’application ChirpStack, créez une Application et enregistrez vos appareils terminaux.

Étape 2 : ajoutez une intégration HTTP dans ChirpStack

  1. Dans ChirpStack, ouvrez votre application et cliquez sur Integrations.

  2. Ajoutez une HTTP Integration.

  3. Renseignez l’Uplink URL avec le point de terminaison HTTPS de TagoIO :

    https://api.tago.io/data

  4. Ajoutez l’en-tête HTTP :

    Device-Token: YOUR_TAGOIO_DEVICE_TOKEN

Récupérez le device token dans l’onglet General de votre appareil TagoIO.

Documentation du token : docs.tago.io/docs/tagoio/devices/device-token

Étape 3 : décodez le payload ChirpStack dans TagoIO

ChirpStack envoie un objet JSON avec un champ object contenant les données décodées (si vous avez configuré un codec) ou data en base64. Écrivez un Payload Parser dans TagoIO en conséquence.

// For ChirpStack with codec configured
const obj = payload.object;
payload = [
  { variable: "temperature", value: obj.temperature, unit: "C" },
  { variable: "humidity", value: obj.humidity, unit: "%" }
];

Étape 7 : construisez votre dashboard

Une fois que les données circulent, créez un dashboard dans TagoIO depuis Dashboards → +.

Pour un déploiement WisBlock multi-capteurs, une disposition de départ utile :

  • Widget carte affichant l’emplacement de tous les appareils (si un module GPS est raccordé)
  • Graphiques de séries temporelles pour la température et l’humidité de chaque appareil
  • Widgets carte (card) affichant la dernière mesure de chaque variable
  • Indicateurs d’état affichant le niveau de batterie et l’heure de dernière connexion

Pour les déploiements qui gèrent de nombreux nœuds RAK sur plusieurs sites, utilisez un Blueprint Dashboard. Une seule disposition s’applique automatiquement à tous les appareils via les tags.

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

Étape 8 : configurez les alertes

Utilisez les Actions pour déclencher des notifications quand les mesures des capteurs sortent de leur plage. Utile pour les déploiements RAK :

  • Température au-dessus du seuil → e-mail/SMS à l’équipe d’astreinte
  • Humidité qui descend sous 20 % dans un environnement contrôlé → déclenchement de la logique de ventilation
  • Aucune donnée reçue en 1 heure → alerte hors ligne

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

Exemples de cas d’usage

Agriculture intelligente

Des nœuds WisBlock avec capteurs d’humidité du sol (RAK12035), de température et d’humidité déployés sur un champ. Le gateway extérieur RAK7289 couvre des zones de plusieurs hectares. TagoIO stocke les mesures et déclenche des signaux de contrôle d’irrigation quand l’humidité du sol descend sous la plage cible.

Utilisez les Blueprint Dashboards pour donner à chaque zone du champ sa propre vue sans dupliquer les configurations.

Surveillance environnementale industrielle

Des nœuds WisBlock avec capteurs de gaz (RAK12004, RAK12009) et de particules installés dans les zones de production. Les mesures sont transmises en continu vers TagoIO. Un script Analysis calcule des moyennes glissantes et réinscrit les valeurs calculées dans le bucket de l’appareil. Des alertes se déclenchent quand les seuils de concentration sont franchis.

Documentation d’Analysis : docs.tago.io/docs/tagoio/analysis

Chaîne du froid et denrées périssables

Des nœuds WisBlock dans des camions réfrigérés ou des chambres froides. Un module GPS (RAK1910) ajouté pour le suivi de localisation. TagoIO reçoit les données de température, d’humidité et de GPS. Un widget carte montre la position des véhicules ; une alerte se déclenche si la température sort de la plage de sécurité pendant le transport.

Aller plus loin avec l’IA

Le serveur MCP de TagoIO connecte des assistants IA comme Claude directement à vos données de capteurs. Une fois vos appareils RAK en train de transmettre vers TagoIO, vous pouvez poser des questions en langage naturel : « Quelle zone a eu l’humidité la plus élevée la semaine dernière ? » ou « Montre-moi tous les appareils passés hors ligne au cours des dernières 24 heures. »

Détails : docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration

Résumé

Connecter les appareils RAK Wireless à TagoIO repose sur trois composants : un serveur de réseau LoRaWAN (TTN ou ChirpStack), un appareil TagoIO avec le bon payload parser et une intégration webhook entre les deux. RAK gère le matériel et la couche radio ; TagoIO gère tout, des données brutes aux dashboards et aux alertes.

Commencez par un gateway et un nœud WisBlock. Validez les données dans le Live Inspector, écrivez le payload parser, puis construisez le dashboard à partir de là.

Articles connexes

Comment connecter les capteurs LoRaWAN Elsys à TagoIO

Comment connecter les capteurs LoRaWAN Elsys à TagoIO

Jun 3, 2026

Comment connecter les gateways LoRaWAN Kerlink à TagoIO

Comment connecter les gateways LoRaWAN Kerlink à TagoIO

Jun 2, 2026

Comment connecter les capteurs LoRaWAN Tektelic à TagoIO

Comment connecter les capteurs LoRaWAN Tektelic à TagoIO

Jun 2, 2026