Paramétrage de l'application

  Comprendre le fonctionnement de IoTRoutes

1. Echange des messages :

         Avant de commencer à utiliser ou paramétrer la plateforme, il est essentiel de comprendre l'architecture et le concept de la solution IoTRoutes. Veuillez lire les sections référencées par les liens précédents avant de procéder au paramétrage.

Comme décrit dans les chapitres précédents dans ce guide, la plateforme reçoit des messages de différents types et formats depuis les appareils. Les flows d'acquisitions sont responsables de la conversion des messages vers une seule structure compréhensible par l'application appelé Platform Message Structure (PMS). 

Aussi pour les commandes sortantes du plateforme vers les appareils, les messages sont émis initialement selon la structure de la plateforme et les flows sortants assurent la conversion des messages vers une structure bien définie, compréhensible par les appareils (ou les gateways).

2.   Attributs :

Les attributs sont des éléments de données utilisés pour décrire, configurer, surveiller et contrôler les dispositifs connectés (capteurs, luminaires, contrôleurs, etc.) au sein du réseau IoT. Exemple  DeviceId, Position,Temperature, Status,... 

les attributs sont classés en différents types ou "scopes" fonctionnels, en fonction de leur rôle dans la gestion des objets connectés. Cela permet d’organiser les données selon leur finalité : configuration, mesure, état opérationnel, événements, etc. 

Dans IoTRoutes on trouve les attributs avec les quatre types ci-dessous:

• Configuration : Attributs qui définissent les paramètres statiques ou semi-statiques du dispositif, Exemple : GatewayAddress.
• Measurement : Valeurs mesurées par des capteurs ou enregistrées périodiquement. Exemple : AirQualityIndex, Temperature
• Operational :  Données sur l’état de fonctionnement courant des dispositifs. Indiquent si les appareils fonctionnent correctement ou signalent un état particulier. Exemple : LampFailure, DeviceStatus 
• Event :  Données générées en réponse à des changements ou anomalies. Exemple : MotionDetected, OverVoltageDetected .

Ci-dessous un message Json avec deux attributs de mesure (température et humidité) . C' est un exemple de structure simple et plate contenant l'ID du dispositif envoyant le message, la date et les mesures sous forme de clé, valeur.

{
  "deviceId": "d15922X",
  "timestamp": "2023-11-23T18:25:43.511Z",
  "temperature": 32.8,
  "humidity": 12.0,
}

 Définition d'attributs 

On dit par Définition d'attribut ( Attribute Definition): l'objet qui décrit les caractéristiques d'un attribut dans l'application tel que le Nom, Identifiant (ID),Scope, Type de valeur, Valeur Max/Min,...

Ainsi les attributs sont prédéfinis dans la plateforme et on peut les consulter ainsi que les valeurs depuis plusieurs écrans de l'application. Environ 500 attributs sont préconfigurés automatiquement dans l'application et qui s'activent selon les classes IoT utilisées et le domaine  à couvrir par le déploiement. 

Ci-dessous un exemple d'attributs définis dans IoTRoutes

Un description complètes des attributs peut être récupérer via l' API des définitions hébergé sur l'AOS.

Cette  API (/api/Definition) sert à récupérer toutes les définitions utilisées par l'application tel que la définition des attributs, des fonctions et des commandes. Pour accéder aux définitions des attributs, depuis l'AOS utiliser le lien  [Aos-URL]/api/Definition/Attributes/List

Suivant :  Paramétrer l'application