Hermetry accepte les données de plusieurs façons. Chacune aboutit au même endroit : un appareil dans votre liste Devices, avec sa télémétrie, ses attributs, ses alarmes et ses tableaux de bord. Le bon choix dépend de ce que l’appareil sait faire : s’il peut garder une connexion ouverte, s’il parle LoRaWAN, s’il se trouve derrière un autre boîtier, ou s’il peut seulement être interrogé. Cette page vous aide à choisir.
Décision rapide
| Votre appareil… | Utiliser | Commencer ici |
|---|---|---|
| peut garder une connexion TCP ouverte et dispose de TLS (un contrôleur, un PC industriel, une carte microcontrôleur avec Wi-Fi ou cellulaire) | MQTT sur TLS | MQTT |
| se réveille, envoie puis se met en veille, ou se trouve sur un réseau qui bloque MQTT | API HTTPS des appareils | API HTTP des appareils |
| est un capteur LoRaWAN à batterie (EU868) | LoRaWAN, via une passerelle LoRaWAN | Connecter votre premier capteur LoRaWAN |
| parle Modbus, RS485 ou un autre bus de terrain, ou BLE, derrière un routeur ou une passerelle qui remonte ses données | Derrière une passerelle | Appareils derrière une passerelle |
| ne peut pas initier de connexion sortante mais répond à SNMP (un onduleur, un commutateur, une imprimante, un serveur) | Interrogé par la plateforme (appareil réseau) | Interrogation d’appareils via SNMP |
| est une caméra IP ou un enregistreur | Caméra ou enregistreur (interrogé, vue en direct) | Ajouter une caméra ou un enregistreur |
| est un routeur, une passerelle ou un contrôleur sous licence conçu pour Hermetry | Revendiquer-le avec le code de sa page Cloud | Ajouter et revendiquer des appareils |
Toutes ces voies partent de Devices > New device. Le panneau propose un choix par voie disponible dans votre organisation, et Other device pour les appareils MQTT et HTTP.
Comparer les voies
| MQTT | HTTPS | LoRaWAN | Derrière une passerelle | Interrogé | Appareil sous licence | |
|---|---|---|---|---|---|---|
| L’appareil ouvre la connexion | Oui | Oui, par message | Via sa passerelle LoRaWAN | La passerelle s’en charge | Non : la plateforme interroge | Oui (MQTT) |
| Connexion | Jeton, MQTT basic ou X.509 | Jeton (en-tête bearer) | Clés (OTAA ou ABP) sur la radio ; pas de connexion à la plateforme | La connexion propre de la passerelle | Identifiants du boîtier, stockés en écriture seule | Certificat X.509 |
| Statut en ligne | Connexion active, message récent ou dernière activité | Message récent ou dernière activité | Message récent (profil intégré) | D’après les messages de connexion et de déconnexion de la passerelle | Dernière activité uniquement | Connexion active |
| Commandes vers l’appareil | Oui | Oui (long poll) | Downlinks bruts | En développement | Non | Oui, ainsi que les réglages et l’accès à distance |
| Mise à jour du micrologiciel à distance (OTA) | Oui, si le micrologiciel le prend en charge | Non | Non | Non | Non | Oui |
| Compte dans la limite d’appareils | Chaque appareil | Chaque appareil | Chaque passerelle et chaque capteur | La passerelle et chaque enfant | Chaque appareil interrogé | Chaque appareil |
MQTT
La voie par défaut et la plus complète. L’appareil garde une connexion ouverte, publie la télémétrie et les attributs, et reçoit les commandes et les changements d’attributs partagés immédiatement. Utilisez TLS sur le port 8883. Le MQTT non chiffré sur le port 1883 est refusé, sauf si un profil l’autorise pour les appareils incapables de faire du TLS.
Le micrologiciel existant qui utilise des topics v1/devices/me/telemetry peut les conserver avec le schéma de topics Legacy compatible, et un micrologiciel avec ses propres noms de topics peut utiliser Custom topics. Voir Profils d’appareils.
HTTPS
Chaque message est un POST unique avec le jeton de l’appareil dans l’en-tête Authorization: Bearer. Adapté aux appareils sur batterie et aux réseaux restrictifs. Un appareil peut aussi attendre les commandes par long poll. Les appareils qui ne peuvent pas envoyer d’en-têtes peuvent placer le jeton dans l’URL, au prix de la perte de MQTT et des commandes pour leur profil.
LoRaWAN
Hermetry dispose de son propre serveur de réseau LoRaWAN pour EU868, avec activation OTAA et ABP, classes A et C. Vous enregistrez les passerelles (passerelles Basics Station ou routeurs sous licence) et les capteurs ; un codec transforme chaque trame en mesures. Voir LoRaWAN.
Derrière une passerelle
Une passerelle se connecte en son nom propre et remonte les données de ses appareils enfants avec les topics v1/gw/*. Hermetry crée chaque enfant la première fois que la passerelle le signale. Jusqu’à 500 enfants par passerelle par défaut.
En développement : l’envoi de commandes et de changements d’attributs partagés aux appareils derrière une passerelle est en développement. Aujourd’hui, la passerelle remonte les données de ses enfants ; prévoyez les commandes pour la passerelle elle-même. Voir Commandes vers les appareils derrière une passerelle.
Interrogé par la plateforme
Certains boîtiers ne peuvent pas se connecter à la plateforme. Hermetry les atteint alors via un endpoint : l’adresse publique du boîtier, ses réglages et ses secrets en écriture seule. Deux types sont disponibles :
- Appareil réseau : un agent SNMP (v3, ou v2c si activé) que la plateforme interroge à intervalles réguliers avec un modèle (par exemple onduleur, interfaces réseau, ressources de l’hôte, imprimantes).
- Caméra ou enregistreur : une caméra IP ou un enregistreur, pour la vue en direct.
Le boîtier doit avoir une adresse publique, et votre pare-feu doit laisser passer les adresses de l’interrogateur de la plateforme. Chaque résultat d’interrogation compte comme un message. Voir Endpoints de protocole.
Appareils sous licence
Les routeurs, passerelles et contrôleurs sous licence conçus pour Hermetry sont livrés avec une identité et un certificat d’usine. Vous les revendiquez avec le code de leur page Cloud locale ; ils se connectent ensuite avec leur certificat et proposent les réglages à distance, les mises à jour du micrologiciel et, pour les routeurs, l’accès à distance à leur interface web. Un routeur sous licence peut aussi être une passerelle LoRaWAN et une passerelle pour les appareils de terrain. Voir Appareils sous licence.
Questions qui tranchent
- L’appareil dispose-t-il d’une vraie horloge ? Sinon, laissez Hermetry horodater (envoyez sans
ts). N’inventez jamais d’horodatages. - Devez-vous lui envoyer des commandes ? Alors utilisez MQTT (ou le long poll HTTPS), pas un appareil interrogé ou un enfant de passerelle.
- Est-il sur une liaison mobile ? MQTT avec des messages groupés coûte le moins cher. Les mises à jour du micrologiciel sur des liaisons facturées attendent par défaut.
- Peut-il faire du TLS ? Sinon, donnez-lui un profil distinct qui autorise le MQTT non chiffré et verrouillez ses réseaux. Voir Sécurité du transport des appareils.
- Combien d’appareils du même type ? Placez-les sur un même profil, et ajoutez-les par import en masse, par auto-provisionnement, ou pour LoRaWAN par mode d’appairage.
Étape suivante
Connecter votre premier appareil, ou votre premier capteur LoRaWAN.