Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Appareils derrière une passerelle

Comment une passerelle signale les appareils de terrain comme appareils enfants sur les sujets v1/gw – charges utiles, création des enfants, profils, noms et limites.

Une passerelle collecte les données d’appareils de terrain qui ne peuvent pas joindre Hermetry eux-mêmes (compteurs Modbus, contrôleurs RS485, capteurs BLE et autres) et les envoie via sa propre connexion. Hermetry transforme chaque appareil de terrain en appareil enfant : un appareil à part entière avec ses mesures, attributs, alarmes et tableaux de bord. Cette page est la référence complète côté passerelle. Pour un résumé court, voir Passerelles et appareils derrière une passerelle.

Une passerelle sous licence exécutant Hermetry Edge fait tout cela pour vous ; voir Passerelles sous licence et Hermetry Edge. Poursuivez la lecture si vous écrivez vous-même le logiciel de la passerelle ou si vous voulez savoir ce qu’il advient des données.

Dans le cloud Hermetry, les appareils de terrain sont lus par Hermetry Edge ; un logiciel de passerelle développé par vos soins est réservé aux installations sur site.

Configurer l’appareil passerelle

  1. Créez ou choisissez un profil d’appareil pour la passerelle. Il doit utiliser le schéma de sujets v1/ par défaut. Le schéma Legacy compatible ne transporte aucune API de passerelle.
  2. Sous Devices > New device, ajoutez la passerelle et activez This device is a gateway. Un appareil sans cette option est refusé sur chaque sujet v1/gw/* (forbidden_topic).
  3. Donnez à la passerelle ses identifiants (jeton d’accès, MQTT basic ou certificat X.509), comme pour tout appareil MQTT. Voir Identifiants d’appareil.
  4. Facultatif : dans le profil de la passerelle, définissez Profile of new children et Max children of a gateway (voir ci-dessous).

La passerelle se connecte en son nom propre. Les enfants n’ont jamais d’identifiants propres et ne se connectent jamais.

Sujets et charges utiles

Tous les sujets de passerelle utilisent QoS 1.

Sujet (passerelle vers Hermetry)Charge utileSignification
v1/gw/connect{"device": "Meter A", "type": "lorawan-meter"}L’enfant est présent. type est facultatif et choisit le profil de l’enfant.
v1/gw/disconnect{"device": "Meter A"}L’enfant n’est plus présent.
v1/gw/telemetryVoir ci-dessousMesures d’un ou plusieurs enfants.
v1/gw/attributes{"Meter A": {"lora.rssi": -97}}Attributs client d’un ou plusieurs enfants.

La télémétrie est un objet indexé par nom d’enfant. Chaque enfant contient un enregistrement ou une liste d’enregistrements :

{
  "Meter A": [
    {"ts": 1759572000000, "values": {"kwh": 1203.4, "voltage": 229.8}},
    {"ts": 1759572060000, "values": {"kwh": 1203.6, "voltage": 230.1}}
  ],
  "Meter B": {"values": {"flow_m3h": 12.7}}
}
  • ts est l’heure en millisecondes à laquelle la valeur a été obtenue. Omettez-le lorsque l’horloge de la passerelle n’est pas réglée ; Hermetry utilise alors l’heure d’arrivée. Voir Horodatages, mesures tardives et en double.
  • values suit les mêmes règles de clés et de valeurs que la télémétrie de tout appareil. Voir Clés de télémétrie.
  • Un enregistrement peut comporter un objet meta facultatif contenant des informations sur la mesure, par exemple "meta": {"lora": {"rssi": -97, "snr": 7.5}}. meta fait au plus 256 octets. Il n’est jamais stocké comme mesure. Seuls ses membres lora et snmp (au plus 8 valeurs simples chacun) sont transmis à vos flux comme métadonnées de message ; tout le reste est ignoré.
  • Un enregistrement sans values, ou avec un ts qui n’est pas un nombre positif, est ignoré. Le reste du message est conservé.

Un attribut client facultatif time_quality sur un enfant, {"source": true, "arrival": false, "synced": true}, indique si les horodatages proviennent de l’horloge propre de l’enfant ou de l’heure d’arrivée à la passerelle, et si l’horloge de la passerelle était synchronisée. Il est informatif.

Création des enfants

Hermetry crée un enfant la première fois que la passerelle le signale, par connect, par télémétrie ou par attributs. Un enfant vu en télémétrie sans connect est considéré comme connecté.

  • L’enfant appartient à l’organisation de la passerelle. Il n’est jamais revendiqué séparément.
  • Profil, dans cet ordre : un profil de votre organisation portant exactement le nom du type envoyé dans connect ; sinon le Profile of new children du profil de la passerelle ; sinon le profil intégré Generic child profile, que Hermetry crée la première fois qu’il est nécessaire. Un enfant annoncé sans type ignore la première étape.
  • Nom de l’appareil : le nom réseau de l’enfant. Si un appareil portant ce nom existe déjà dans votre organisation, le nom devient <wire name> · <gateway name>, puis ce nom suivi de 2, 3, etc.
  • Renommer l’enfant dans Hermetry ne modifie pas son nom réseau. La passerelle continue de l’adresser par le nom qu’elle a envoyé.
  • Les premiers enregistrements d’un enfant tout nouveau peuvent être supprimés pendant sa création. Hermetry demande l’enfant une fois, et le message suivant le trouve.

Noms des enfants

RègleValeur
LongueurDe 1 à 128 caractères
Non autoriséCaractères de contrôle, espace en début ou en fin
CasseSensible à la casse : abc et ABC sont deux enfants d’une même passerelle
UnicitéPar passerelle

Un nom qui enfreint une règle est ignoré et compté ; les autres enfants du message sont conservés.

Un appareil qui se connecte directement l’emporte. Si le nom de l’enfant est égal au numéro de série d’un appareil de votre organisation disposant de ses propres identifiants (sans tenir compte de la casse), l’enfant est refusé (child_conflict_direct) et aucun enfant n’est créé. Cela évite qu’un appareil ayant sa propre session cloud n’apparaisse deux fois.

Limites

LimiteValeur
Enfants par passerelleLa valeur Max children of a gateway du profil (par défaut 500), sans jamais dépasser la valeur de votre offre (500 si l’offre n’en précise aucune) ni le plafond de la plateforme de 1 000
Limite d’appareilsChaque enfant compte dans la limite d’appareils de votre offre
Un message de passerelle64 Kio au maximum, ou la valeur Max message payload (bytes) du profil de passerelle si elle est plus basse
Enfants dans un message500 ; au-delà, les éléments sont ignorés
Enregistrements par enfant dans un message1 000 ; au-delà, les éléments sont ignorés
meta par enregistrement256 octets

Un enfant qui dépasserait la limite d’enfants ou la limite d’appareils est refusé (child_limit ou device_limit), et ses enregistrements sont supprimés.

Les Rate limits s’appliquent deux fois. D’abord, les limites de profil propres à la passerelle comptent le message entier, y compris les points de données de chaque enfant. Ensuite, les limites de profil de chaque enfant s’appliquent à sa part : un enfant qui dépasse ses limites perd uniquement ses propres enregistrements (child_rate_limited). Voir Device profiles pour les champs de limite et Message quota and usage.

État de connexion

  • connect et disconnect définissent l’état de connexion de l’enfant.
  • Lorsque la passerelle passe hors ligne, tous ses enfants passent hors ligne avec elle.
  • Un enfant désactivé est retiré dans un délai d’environ une minute : ses enregistrements ne sont plus acceptés.

Dépannage

SymptômeCause et solution
La passerelle est déconnectée après quelques messages v1/gw/*L’appareil n’est pas marqué comme passerelle. Trois sujets rejetés en une minute ferment la session. Activez This device is a gateway.
Aucun enfant n’apparaîtLe nom de l’enfant enfreint une règle, la limite d’enfants ou d’appareils est atteinte, ou un appareil direct utilise ce numéro de série. Vérifiez votre nombre d’appareils dans l’utilisation.
Un enfant a le mauvais profilLe type ne correspond pas exactement à un nom de profil. Renommez le profil ou définissez Profile of new children sur le profil de la passerelle. Le changement de profil d’un enfant existant se fait sur la page de l’appareil enfant.
Un enfant affiche deux nomsUn appareil portant le nom réseau existait déjà ; l’enfant a donc été nommé <wire name> · <gateway name>.

Voir aussi