Tech Insights

Comment connecter les capteurs LoRaWAN Elsys à TagoIO

Comment connecter les capteurs LoRaWAN Elsys (ERS, ELT, EMS, ESENS) à TagoIO. Couvre l'intégration TTN, le décodage du payload Elsys ERS, la gestion des appareils par tags et les cas d'usage de surveillance des bureaux et bâtiments intelligents.

Thiago Lima ·
Comment connecter les capteurs LoRaWAN Elsys à TagoIO

Elsys est une entreprise suédoise qui fabrique des capteurs LoRaWAN compacts et alimentés par batterie, largement utilisés dans les bâtiments intelligents, les bureaux et la surveillance environnementale. Les séries ERS (Environment & Room Sensor), ELT (External Light Sensor), EMS (Environment Monitoring Sensor) et ESENS couvrent la température, l’humidité, le CO2, la lumière, la présence et les entrées de sondes externes.

Les capteurs Elsys sont plug-and-play du point de vue matériel : il suffit de les allumer pour qu’ils commencent à transmettre. Le travail d’intégration consiste à connecter ces données LoRaWAN à une plateforme applicative. Ce guide montre comment acheminer les données des capteurs Elsys via TTN vers TagoIO pour le stockage, les dashboards et les alertes.

Ce qu’il vous faut avant de commencer

Étape 1 : enregistrer les capteurs Elsys sur TTN

Les capteurs Elsys figurent dans le TTN Device Repository, ce qui simplifie l’enregistrement.

  1. Dans votre application TTN, cliquez sur Register end device.
  2. Recherchez Elsys dans le device repository et sélectionnez votre modèle (par exemple ERS CO2).
  3. Sélectionnez la version du firmware et le plan de fréquences.
  4. Saisissez les JoinEUI, DevEUI et AppKey indiqués sur l’étiquette du capteur ou dans l’application Elsys Sensor Settings (configuration Bluetooth).
  5. Enregistrez l’appareil.

Les capteurs Elsys prennent en charge l’OTAA par défaut. Au premier allumage après l’enregistrement, ils rejoignent le réseau et commencent à envoyer des données.

Étape 2 : créer un appareil dans TagoIO

  1. Connectez-vous à admin.tago.io.
  2. Allez dans Devices → Add Device.
  3. Recherchez The Things Network v3 et sélectionnez-le.
  4. Nommez l’appareil pour qu’il corresponde à votre capteur Elsys (par exemple elsys-ers-co2-floor-3).
  5. Copiez la Webhook URL et le Authorization Token.

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

Étape 3 : ajouter le webhook TTN à TagoIO

  1. Dans votre application TTN, allez dans Integrations → Webhooks → + Add webhook → Custom webhook.
  2. Définissez la Base URL sur la Webhook URL de TagoIO.
  3. Ajoutez l’en-tête : Authorization: YOUR_TAGOIO_TOKEN.
  4. Activez Uplink message.
  5. Enregistrez.

Étape 4 : écrire le Payload Parser

Elsys utilise un format de payload binaire bien documenté, appelé Elsys Payload Specification. Chaque point de données se compose d’un identifiant de type sur 1 octet suivi des octets de valeur. Elsys publie un décodeur de référence sur GitHub.

Voici un parser pour l’ERS CO2 (température, humidité, lumière, mouvement, CO2) :

const raw = Buffer.from(payload.uplink_message.frm_payload, "base64");

const result = [];
let i = 0;

while (i < raw.length) {
  const type = raw[i++];
  switch (type) {
    case 0x01: // Temperature (2 bytes, signed, /10)
      result.push({ variable: "temperature", value: raw.readInt16BE(i) / 10, unit: "C" });
      i += 2;
      break;
    case 0x02: // Humidity (1 byte, unsigned, /2)
      result.push({ variable: "humidity", value: raw.readUInt8(i) / 2, unit: "%" });
      i += 1;
      break;
    case 0x05: // Light (2 bytes)
      result.push({ variable: "light", value: raw.readUInt16BE(i), unit: "lux" });
      i += 2;
      break;
    case 0x06: // Motion (1 byte)
      result.push({ variable: "motion", value: raw.readUInt8(i) });
      i += 1;
      break;
    case 0x08: // CO2 (2 bytes)
      result.push({ variable: "co2", value: raw.readUInt16BE(i), unit: "ppm" });
      i += 2;
      break;
    case 0x0B: // Battery voltage (2 bytes, /1000)
      result.push({ variable: "battery_voltage", value: raw.readUInt16BE(i) / 1000, unit: "V" });
      i += 2;
      break;
    default:
      i = raw.length; // Stop on unknown type
  }
}

payload = result;

Ce parser gère les types de capteurs Elsys les plus courants. Ajoutez des cas pour d’autres types (son, pression, GPS) selon vos besoins, en vous appuyant sur l’Elsys payload specification.

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

Étape 5 : vérifier dans le Live Inspector

Ouvrez le Live Inspector dans TagoIO. Déclenchez une lecture depuis votre capteur Elsys (un appui court sur le bouton provoque une transmission immédiate sur la plupart des modèles). Vérifiez que toutes les variables sont décodées correctement.

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

Étape 6 : gérer une flotte de capteurs Elsys

Les capteurs Elsys sont généralement déployés par groupes : un étage, un bâtiment ou un campus. Utilisez les Blueprint Dashboards de TagoIO pour gérer cela à grande échelle.

Comment les Blueprint Dashboards fonctionnent avec Elsys :

  1. Créez un appareil TagoIO par capteur Elsys.
  2. Taguez chaque appareil par emplacement : building:a, floor:3, room:conference-01.
  3. Créez un Blueprint Dashboard qui utilise un sélecteur de tags pour récupérer les données de l’appareil sélectionné.
  4. Chaque capteur obtient sa propre vue de dashboard avec la même mise en page : aucune duplication.

Documentation des Blueprint Dashboards : docs.tago.io/docs/tagoio/dashboards/blueprint-dashboard

Étape 7 : configurer les alertes

Utilisez les Actions pour :

  • CO2 supérieur à 1000 ppm dans une pièce → notifier les services généraux par e-mail
  • Température hors de la plage 19-26°C → alerte HVAC
  • Mouvement détecté en dehors des heures de bureau → notification de sécurité
  • Tension de batterie inférieure à 2,5 V → rappel de maintenance

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

Exemples de cas d’usage

Qualité de l’air dans les bureaux intelligents

Des capteurs ERS CO2 dans chaque salle de réunion et espace ouvert. Le Blueprint Dashboard de TagoIO offre aux services généraux une vue du CO2, de la température et de l’humidité étage par étage. Les Actions déclenchent la ventilation lorsque le CO2 dépasse 1000 ppm. Un rapport hebdomadaire sur la qualité de l’air est généré automatiquement par un script d’Analysis.

Corrélation entre énergie et occupation

Des capteurs ERS avec détection de mouvement. Les scripts d’Analysis de TagoIO croisent les données d’occupation avec les relevés des compteurs d’énergie, générant des rapports de corrélation qui montrent le coût énergétique par heure d’occupation et par zone.

Surveillance de la conformité

Des capteurs EMS dans les zones de stockage alimentaire et pharmaceutique. TagoIO conserve les relevés horodatés pour les pistes d’audit réglementaires. Les rapports sont générés automatiquement pour les déclarations de conformité.

Aller plus loin avec l’IA

Le serveur MCP de TagoIO connecte Claude et d’autres assistants IA à vos données Elsys. Posez des questions en langage naturel : « Quelles pièces ont dépassé 1000 ppm de CO2 cette semaine ? » ou « Quelle est la température moyenne de tous les capteurs de l’étage 2 ? »

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

Récapitulatif

Les capteurs Elsys se connectent à TagoIO via TTN en quatre étapes : enregistrement sur TTN, création d’un appareil TTN dans TagoIO, ajout du webhook et écriture du payload parser Elsys. Le parser suit la spécification de format binaire publiée par Elsys. Une fois les données qui circulent, TagoIO se charge du stockage, des Blueprint Dashboards pour la gestion de la flotte et des alertes en temps réel.