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
- 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. - 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). - Donnez à la passerelle ses identifiants (jeton d’accès, MQTT basic ou certificat X.509), comme pour tout appareil MQTT. Voir Identifiants d’appareil.
- 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 utile | Signification |
|---|---|---|
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/telemetry | Voir ci-dessous | Mesures 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}}
}
tsest 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.valuessuit 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
metafacultatif contenant des informations sur la mesure, par exemple"meta": {"lora": {"rssi": -97, "snr": 7.5}}.metafait au plus 256 octets. Il n’est jamais stocké comme mesure. Seuls ses membresloraetsnmp(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 untsqui 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
typeenvoyé dansconnect; 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é sanstypeignore 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 de2,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ègle | Valeur |
|---|---|
| Longueur | De 1 à 128 caractères |
| Non autorisé | Caractères de contrôle, espace en début ou en fin |
| Casse | Sensible à 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
| Limite | Valeur |
|---|---|
| Enfants par passerelle | La 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’appareils | Chaque enfant compte dans la limite d’appareils de votre offre |
| Un message de passerelle | 64 Kio au maximum, ou la valeur Max message payload (bytes) du profil de passerelle si elle est plus basse |
| Enfants dans un message | 500 ; au-delà, les éléments sont ignorés |
| Enregistrements par enfant dans un message | 1 000 ; au-delà, les éléments sont ignorés |
meta par enregistrement | 256 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
connectetdisconnectdé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ôme | Cause 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ît | Le 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 profil | Le 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 noms | Un appareil portant le nom réseau existait déjà ; l’enfant a donc été nommé <wire name> · <gateway name>. |

