00 CloudGate IoT Integration

Pipeline LoRaWAN bidirectionnel CloudGate ↔ IoBase + Asystom Advisor

Vue d'ensemble

Cette documentation décrit l'intégration d'une passerelle CloudGate CG8102 avec deux plateformes cloud :

IoBase (Indaba) — data lake destinataire des trames brutes capteurs et des métriques de santé de la passerelle. Authentification Bearer via le protocole DAP (single-use tokens).
Asystom Advisor — plateforme d'analyse vibratoire/sonore. Reçoit les uplinks et fournit les commandes downlink (reboot, set frequency) à pousser sur les balises. Authentification Basic.

L'ensemble du code applicatif est hébergé dans le canvas LuvitRED embarqué de la CloudGate. Aucun service auxiliaire n'est nécessaire côté passerelle.

📡

Balises Asystom

jusqu'à 30 par CG
Class A · OTAA

LoRa Class A

📦

CloudGate CG8102

LuvitRED canvas · 4 flux
queue offline 15 j · DAP auth

HTTPS · Bearer DAP

☁️

IoBase

data lake
Indaba alerting + dataviz

HTTPS · Basic Auth

☁️

Asystom Advisor

analyse vibratoire
uplinks + downlink polling

Sommaire

CHAPITRE 01

Architecture & 4 flux de données

Vue topologique. Flux 01 IoBase uplink, Flux 02 Asystom uplink, Flux 03 Asystom downlink polling, Flux 04 health. Chaînes du canvas LuvitRED node par node.

CHAPITRE 02

Auth DAP IoBase

Enrôlement register → Token → refresh. Single-use protégé par mutex. Persistance flash. Retry 401 automatique. Refresh préventif au retour de WAN.

CHAPITRE 03

API IoBase v1.0

URL /api/v1/cloudgate/payloads, headers X-CloudGate-Id + X-Device-Id, body 6 champs requis + ISO 8601 timestamp.

CHAPITRE 04

API Asystom Advisor

Uplink Loriot-like, Basic auth + header X-Network. Downlink polling GET /getPendingMsgs?client=<id>.

CHAPITRE 05

Procédure création capteurs

Enrôlement OTAA d'une nouvelle balise Asystom. msg.app.add, séquence magnet, vérif Join, FPort de référence, troubleshooting.

CHAPITRE 06

Déploiement

Golden Sample CloudGate Universe, clonage multi-CG via export/import config.tar.gz, accès distant via Cloudflare Tunnel + Access policy.

CHAPITRE 07

Runbook ops

Procédures d'incident : coupure WAN, token expiré, balise bloquée, rotation audit, recovery DAP.

ANNEXE A

Cockpit mock

Serveur Python local mock_cockpit.py qui simule IoBase + DAP + Asystom. Dashboard live sur localhost:9000/dashboard.

ANNEXE B

Globals reference

Variables global.* du canvas LuvitRED, qui les lit, qui les écrit, valeur par défaut.

Périmètre fonctionnel

Catégorie	Capacités
CloudGate × Asystom	Uplink push, Downlink polling
CloudGate → IoBase	Payload sensors, Health, DAP auth, Historisation 15 j
Configuration & Opérationnel	Workflow LuvitRED, procédure capteurs, runbook
Déploiement & Accès	Multi-CloudGate via Golden Sample, accès distant via Cloudflare Tunnel

Validation interne par Mock Cockpit

L'ensemble des chaînes est validable end-to-end contre un mock local simulant IoBase + DAP + Asystom (voir Annexe A). Au moment du déploiement contre les vrais endpoints, il suffit de modifier global.iobase_host, global.dap_host, global.asystom_url et les credentials Basic associés pour basculer.