How to

Comment connecter les gateways LoRaWAN Kerlink à TagoIO

Guide complet pour connecter les gateways LoRaWAN Kerlink (iStation, iFemtoCell, Wirnet) à TagoIO. Couvre le Wanesy Management Center, le transfert via LNS ChirpStack, l'analyse des payloads et des cas d'usage de déploiement pour villes intelligentes et environnements industriels.

David Hall ·
Comment connecter les gateways LoRaWAN Kerlink à TagoIO

Kerlink est un fournisseur français d’infrastructure LoRaWAN bien implanté dans les déploiements de villes intelligentes, de services publics et industriels. Ses produits Wirnet iStation (industriel, extérieur), Wirnet iFemtoCell (intérieur) et Wirnet Station sont reconnus pour leur qualité de fabrication et leur fiabilité de niveau opérateur. Kerlink exploite aussi le Wanesy Management Center, un serveur de réseau LoRaWAN dans le cloud.

TagoIO se situe au niveau de la couche applicative : il reçoit les données des appareils, les stocke et vous permet de construire des dashboards, des alertes et des automatisations. Connecter Kerlink à TagoIO revient à relier la sortie du serveur de réseau Kerlink au point d’ingestion de données de TagoIO.

Ce guide couvre deux approches : le transfert depuis le Kerlink Wanesy Management Center vers TagoIO, et un LNS ChirpStack privé fonctionnant aux côtés des gateways Kerlink.

Ce dont vous avez besoin avant de commencer

  • Un compte TagoIO (plan gratuit disponible)
  • Un gateway Kerlink (iStation, iFemtoCell, Wirnet Station ou compatible)
  • Un serveur de réseau LoRaWAN : Kerlink Wanesy Management Center ou ChirpStack auto-hébergé
  • Des appareils finaux enregistrés sur votre serveur de réseau

Vue d’ensemble de l’architecture

Les gateways Kerlink agissent comme des relais de paquets radio. Ils n’exécutent pas de logique applicative : celle-ci réside sur le LNS. Le LNS décode les trames LoRaWAN, identifie les appareils et achemine les payloads applicatifs vers le point de terminaison de votre choix.

Votre point d’intégration avec TagoIO est toujours le LNS, jamais le gateway directement.

[capteurs LoRaWAN] → [gateway Kerlink] → [LNS (Wanesy ou ChirpStack)] → [TagoIO via HTTPS]

Approche 1 : Kerlink Wanesy Management Center → TagoIO

Wanesy MC prend en charge les notifications push (aussi appelées “push connectors”) qui envoient en POST les uplinks des appareils vers n’importe quel point de terminaison HTTPS.

Étape 1 : créer un appareil dans TagoIO

  1. Connectez-vous à admin.tago.io.
  2. Allez dans Devices → Add Device.
  3. Sélectionnez HTTPS comme type de connecteur.
  4. Nommez l’appareil (par exemple kerlink-end-device-01).
  5. Cliquez sur Create Device et copiez le Device Token depuis l’onglet General.

Documentation des appareils : docs.tago.io/docs/tagoio/devices

Étape 2 : créer un Push Connector dans Wanesy MC

  1. Connectez-vous à votre compte Wanesy Management Center.

  2. Allez dans Applications et ouvrez ou créez une application.

  3. Allez dans Push connectors et cliquez sur Add.

  4. Choisissez HTTP comme type de connecteur.

  5. Définissez l’URL sur :

    https://api.tago.io/data

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

    Device-Token: YOUR_TAGOIO_DEVICE_TOKEN

  7. Réglez le format de push sur JSON (par défaut).

  8. Enregistrez et activez le connecteur.

Wanesy enverra désormais en POST chaque uplink des appareils de cette application vers TagoIO.

Étape 3 : analyser le payload Wanesy dans TagoIO

Wanesy envoie un objet JSON contenant les informations de l’appareil et le payload encodé en base64. Ajoutez un Payload Parser à votre appareil TagoIO pour extraire les mesures des capteurs.

Ouvrez Devices → [votre appareil] → Payload Parser et écrivez :

// Wanesy payload structure
const decodedBytes = Buffer.from(payload.payloadHex, "hex");

// Example for a temperature/humidity sensor with 2-byte temperature, 1-byte humidity
const temperature = decodedBytes.readInt16BE(0) / 100;
const humidity = decodedBytes.readUInt8(2);

payload = [
  { variable: "temperature", value: temperature, unit: "C" },
  { variable: "humidity", value: humidity, unit: "%" },
  { variable: "rssi", value: payload.gwInfo?.[0]?.rssi || null },
  { variable: "snr", value: payload.gwInfo?.[0]?.snr || null }
];

Adaptez la logique de décodage au format de payload de votre capteur.

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

Approche 2 : gateway Kerlink + ChirpStack → TagoIO

De nombreux opérateurs Kerlink exécutent ChirpStack aux côtés de leurs gateways, que ce soit sur site ou dans le cloud. L’intégration HTTP de ChirpStack peut envoyer les données directement vers TagoIO.

Étape 1 : configurer le gateway Kerlink comme relais de paquets

La plupart des gateways Kerlink utilisent le Semtech UDP Packet Forwarder ou le Kerlink Common Packet Forwarder. Pointez le gateway vers l’adresse et le port de votre serveur de réseau ChirpStack (par défaut : UDP 1700).

Accédez à la CLI du gateway via SSH ou via le Kerlink WMC pour mettre à jour global_conf.json avec l’adresse de votre serveur ChirpStack.

Étape 2 : enregistrer le gateway et l’appareil dans ChirpStack

  1. Dans ChirpStack, allez dans Gateways → Add gateway et enregistrez votre appareil Kerlink.
  2. Créez un Device Profile correspondant à la version LoRaWAN et à la région de votre appareil final.
  3. Enregistrez vos appareils finaux sous une Application.

Étape 3 : ajouter une intégration HTTPS TagoIO dans ChirpStack

  1. Dans votre application ChirpStack, allez dans Integrations → HTTP.

  2. Définissez l’Uplink URL sur :

    https://api.tago.io/data

  3. Ajoutez l’en-tête personnalisé :

    Device-Token: YOUR_TAGOIO_DEVICE_TOKEN

  4. Enregistrez.

Étape 4 : analyser le payload ChirpStack dans TagoIO

ChirpStack envoie les uplinks au format JSON. Si vous configurez un codec dans ChirpStack, l’objet décodé arrive dans payload.object. Sinon, décodez les octets bruts depuis payload.data (base64).

// ChirpStack with codec configured
if (payload.object) {
  payload = Object.entries(payload.object).map(([key, val]) => ({
    variable: key,
    value: val
  }));
} else {
  // raw decode from base64
  const raw = Buffer.from(payload.data, "base64");
  // add your sensor-specific decoding here
  payload = [];
}

Étape 5 : vérifier dans le Live Inspector

Une fois l’une ou l’autre des approches terminée, ouvrez le Live Inspector sur votre appareil TagoIO et vérifiez que les données arrivent au prochain cycle d’uplink.

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

Étape 6 : construire des dashboards et des alertes

Créez un dashboard depuis Dashboards → +. Widgets typiques pour un déploiement de ville intelligente ou industriel basé sur Kerlink :

  • Widget de carte pour la localisation des appareils
  • Graphiques de séries temporelles pour suivre les mesures des capteurs dans le temps
  • Cartes de qualité de signal affichant le RSSI et le SNR par gateway
  • Carte de chaleur si de nombreux nœuds reportent sur une même zone de couverture

Configurez des Actions pour :

  • Des alertes de seuil (température, vibration, détection d’inondation)
  • La détection d’appareils hors ligne (aucune donnée reçue depuis X minutes)
  • Des rapports automatisés par e-mail ou webhook vers un système de tickets

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

Exemples de cas d’usage

Services publics en ville intelligente

Des gateways Kerlink Wirnet iStation montés sur des lampadaires. Des capteurs surveillent la pression de l’eau, le niveau de remplissage des poubelles et la qualité de l’air à l’échelle d’une municipalité. TagoIO agrège toutes les mesures, affiche une carte couvrant toute la ville et déclenche des alertes vers les services municipaux quand les poubelles atteignent 80 % de leur capacité.

Surveillance des vibrations industrielles

Des gateways Kerlink iFemtoCell dans une usine. Des capteurs de vibration LoRaWAN installés sur des machines tournantes reportent à TagoIO. Des scripts d’analyse calculent des scores d’anomalie basés sur la FFT et signalent l’usure précoce des roulements avant la panne.

Documentation de l’Analysis : docs.tago.io/docs/tagoio/analysis

Gestion énergétique des bâtiments

Plusieurs compteurs d’énergie LoRaWAN connectés à TagoIO via des gateways Kerlink. TagoIO stocke les données de comptage, calcule la consommation quotidienne et mensuelle par circuit et génère des rapports de coûts. Les Blueprint Dashboards offrent aux gestionnaires d’étage leur propre vue.

Aller plus loin avec l’IA

Le serveur MCP de TagoIO permet des requêtes en langage naturel sur vos données de capteurs Kerlink. Demandez à Claude : “Quels appareils ont la pire qualité de signal ?” ou “Montre-moi toutes les anomalies dans les données de vibration de la semaine passée.”

Documentation MCP : docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration

Résumé

Les gateways Kerlink transfèrent les paquets LoRaWAN vers un serveur de réseau. Ce serveur, qu’il s’agisse du Wanesy MC de Kerlink ou d’un ChirpStack auto-hébergé, envoie les payloads des appareils vers TagoIO via HTTPS. Un Payload Parser dans TagoIO décode les données binaires en variables propres, prêtes pour le stockage et la visualisation.

Articles connexes

Comment connecter les capteurs LoRaWAN Elsys à TagoIO

Comment connecter les capteurs LoRaWAN Elsys à TagoIO

Jun 3, 2026

Comment connecter les appareils RAK Wireless à TagoIO

Comment connecter les appareils RAK Wireless à TagoIO

Jun 2, 2026

Comment connecter les capteurs LoRaWAN Tektelic à TagoIO

Comment connecter les capteurs LoRaWAN Tektelic à TagoIO

Jun 2, 2026