How to

Comment connecter les capteurs LoRaWAN Tektelic à TagoIO

Comment connecter les capteurs LoRaWAN Tektelic (TUNDRA, HOME, KONA) à TagoIO. Au programme : le transfert via le Network Server Tektelic, le chemin d'intégration TTN, l'analyse du payload pour chaque famille de capteurs et des cas d'usage dans les bâtiments intelligents et la surveillance industrielle.

David Hall ·
Comment connecter les capteurs LoRaWAN Tektelic à TagoIO

Tektelic Communications fabrique une pile complète de matériel LoRaWAN : gateways, network servers et capteurs. Sa gamme de capteurs couvre le bâtiment intelligent (HOME Sensor, TUNDRA Slim, SPARK), l’industrie (capteurs environnementaux BREEZE et BOREALIS) et les applications agricoles.

Les appareils Tektelic envoient des uplinks LoRaWAN standard. Vous pouvez les router via le propre Network Server de Tektelic (TNS), via The Things Network ou via n’importe quel LNS qui prend en charge les webhooks HTTPS, puis transférer les données vers TagoIO pour le stockage longue durée, les dashboards et les alertes.

Ce guide couvre à la fois le chemin par le Network Server Tektelic et le chemin par TTN.

Ce dont vous avez besoin avant de commencer

  • Un compte TagoIO (plan gratuit disponible)
  • Des capteurs Tektelic (TUNDRA, HOME, BOREALIS ou similaires)
  • Une gateway Tektelic ou une gateway LoRaWAN compatible
  • Un accès au Network Server Tektelic (TNS) ou un compte TTN

Chemin 1 : du Network Server Tektelic vers TagoIO

Étape 1 : créer un appareil dans TagoIO

  1. Connectez-vous à admin.tago.io.
  2. Allez dans Devices → Add Device → HTTPS.
  3. Nommez l’appareil et enregistrez.
  4. Copiez le Device Token depuis l’onglet General.

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

Étape 2 : configurer une intégration push dans le NS Tektelic

  1. Connectez-vous à l’interface web du Network Server Tektelic.
  2. Allez dans votre application et sélectionnez Application Integrations.
  3. Ajoutez une intégration HTTP Push.
  4. Renseignez l’URL https://api.tago.io/data.
  5. Ajoutez l’en-tête : Device-Token: YOUR_TAGOIO_DEVICE_TOKEN.
  6. Enregistrez et activez.

Étape 3 : écrire le Payload Parser

Les capteurs Tektelic encodent les données dans leur propre format binaire. Référez-vous au décodeur de payload de votre capteur dans la documentation produit Tektelic.

Exemple pour le Tektelic TUNDRA Slim (température + humidité) :

const raw = Buffer.from(payload.data || payload.payload_hex, "hex");

// TUNDRA Slim standard payload: 2-byte temp (signed, /10), 2-byte humidity (/10)
const temperature = raw.readInt16BE(0) / 10;
const humidity = raw.readInt16BE(2) / 10;

payload = [
  { variable: "temperature", value: temperature, unit: "C" },
  { variable: "humidity", value: humidity, unit: "%" }
];

Pour les capteurs Tektelic multicanaux, chaque type de canal est identifié par un octet identifiant de données dans le payload. Analysez chaque canal en conséquence et renvoyez toutes les variables au format tableau de TagoIO.

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

Chemin 2 : des capteurs Tektelic vers The Things Network vers TagoIO

Si vous préférez router les capteurs Tektelic via TTN :

  1. Enregistrez le capteur Tektelic dans TTN avec son DevEUI, son AppEUI et son AppKey.
  2. Dans TagoIO, créez un appareil à l’aide du connecteur The Things Network v3.
  3. Copiez l’URL du Webhook et le jeton d’autorisation depuis TagoIO.
  4. Ajoutez un webhook personnalisé dans TTN pointant vers l’URL TagoIO avec l’en-tête Authorization.
  5. Ajoutez un Payload Parser dans TagoIO pour décoder le payload binaire Tektelic depuis payload.uplink_message.frm_payload.

Pour le HOME Sensor (température, humidité, lumière, mouvement) :

const raw = Buffer.from(payload.uplink_message.frm_payload, "base64");
// Adjust offsets per Tektelic HOME Sensor payload spec
const temperature = raw.readInt16BE(1) / 10;
const humidity = raw.readUInt8(3) / 2;
const light = raw.readUInt16BE(4);
const motion = raw.readUInt8(6) & 0x01;

payload = [
  { variable: "temperature", value: temperature, unit: "C" },
  { variable: "humidity", value: humidity, unit: "%" },
  { variable: "light", value: light, unit: "lux" },
  { variable: "motion", value: motion }
];

Étape 4 : vérifier dans le Live Inspector

Ouvrez le Live Inspector sur votre appareil TagoIO et confirmez que les variables arrivent correctement.

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

Étape 5 : construire des dashboards

Les capteurs Tektelic sont souvent déployés par lots dans un bâtiment. Utilisez les Blueprint Dashboards pour gérer plusieurs capteurs avec une seule mise en page.

Pour les déploiements en bureau ou bâtiment intelligent, un dashboard type comprend :

  • La température et l’humidité par pièce dans le temps
  • Une carte de chaleur d’occupation à partir des capteurs de mouvement
  • La concentration de CO2 par zone (si vous utilisez BOREALIS)
  • Un tableau d’historique des alertes

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

Exemples de cas d’usage

Surveillance du confort dans un bureau intelligent

Des capteurs Tektelic HOME dans chaque salle de réunion et chaque espace ouvert. Le Blueprint Dashboard de TagoIO donne à l’équipe des services généraux une vue étage par étage de la température, de l’humidité et de l’occupation. Des actions déclenchent des changements de consigne CVC via l’API du BMS lorsque les plages de confort sont dépassées.

Surveillance du stockage frigorifique

Des capteurs Tektelic TUNDRA dans les chambres froides et les congélateurs. TagoIO stocke les relevés toutes les 5 minutes, génère des rapports de conformité pour les audits de sécurité alimentaire et envoie des alertes SMS immédiates en cas de dérive de la température.

Conformité environnementale industrielle

Des capteurs Tektelic BREEZE suivent les particules fines, le CO2 et les COV dans une zone de production. Les scripts Analysis de TagoIO calculent des moyennes glissantes sur 8 heures pour le reporting réglementaire. Des rapports quotidiens sont générés automatiquement par un script Analysis et envoyés par e-mail à l’équipe sécurité.

Aller plus loin avec l’IA

Le serveur MCP de TagoIO permet aux assistants IA comme Claude d’interroger les données de vos capteurs Tektelic en langage naturel. Demandez : “Quels étages sont restés au-dessus de 25°C pendant plus de 2 heures aujourd’hui ?” ou “Montre-moi les schémas de mouvement dans les salles de conférence sur la semaine écoulée.”

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

Résumé

Les capteurs Tektelic se connectent à TagoIO via le Network Server Tektelic ou via TTN, en utilisant une intégration push HTTPS. La principale tâche d’intégration consiste à écrire un payload parser qui décode le format binaire de Tektelic. Une fois que les données circulent, TagoIO prend en charge le stockage, les dashboards multi-appareils et les alertes en temps réel.