Pour envoyer une commande à un appareil IoT et savoir qu’elle est bien arrivée, enregistrez-la comme une requête avec un identifiant, faites répondre l’appareil sur cet identifiant, et suivez son état jusqu’à sa fin. L’onglet Commands de Hermetry (2.2.0, 22 octobre 2026) montre chaque commande passer de Queued à Sent puis Delivered, puis à Successful, Failed ou Timed out.
L’envoi sans accusé de réception convient pour une mesure. Pour une commande qui démarre une pompe ou redémarre une passerelle, l’opérateur a besoin d’une réponse claire : est-elle arrivée, et a-t-elle fonctionné ?
Que vous indique chaque état de commande ?
Chaque état répond à une partie de cette question. Hermetry enregistre chaque commande comme une requête et la fait passer par ces états :
| État | Signification |
|---|---|
| Queued | Enregistrée, en attente de l’appareil |
| Sent | Envoyée à l’appareil |
| Delivered | L’appareil l’a reçue |
| Successful | L’appareil a répondu par un succès |
| Failed | L’appareil a répondu par une erreur |
| Timed out | Aucune réponse reçue à temps |
| Expired | Elle a expiré avant de pouvoir être livrée |
| Cancelled | Annulée par un utilisateur |
Timed out est l’état que l’on interprète mal. Il signifie qu’aucune réponse n’est arrivée, et non que la commande n’a pas été exécutée. Hermetry l’affiche sous la forme « No answer: the outcome is unknown ». Je vérifierais l’appareil avant de renvoyer la même commande.
Comment envoyer une commande depuis la page de l’appareil ?
Utilisez l’onglet Commands de l’appareil, qui propose les commandes du catalogue du profil d’appareil. Le catalogue se configure par profil, à côté des autres paramètres du profil.
- Ouvrez l’appareil puis son onglet Commands.
- Choisissez une commande sous Choose a command et renseignez ses Parameters.
- Définissez l’Answer timeout (seconds), de 1 à 600 ; sans valeur, la valeur par défaut de la commande ou du profil s’applique, sinon 10 secondes.
- Pour un appareil susceptible d’être hors ligne, activez Deliver when the device comes back (persistent) et définissez Give up after (24 hours par défaut, 7 days au maximum).
- Sélectionnez Send. Une commande à fort impact demande d’abord une confirmation.
Sans persistent, une commande envoyée à un appareil hors ligne échoue immédiatement, et l’onglet vous en avertit avant l’envoi. L’History répertorie ensuite chaque commande avec son statut, son auteur (personne ou système) et sa durée, pendant 90 jours.
Que doit faire l’appareil pour boucler la boucle ?
Il doit s’abonner, répondre sur le même identifiant, et ne jamais exécuter deux fois le même identifiant. Avec MQTT, l’appareil s’abonne à v1/rpc/req/+ et répond à une commande bidirectionnelle sur le topic de réponse correspondant :
PUBLISH v1/rpc/req/42
{"method": "sys.ping", "params": {"host": "192.0.2.10", "count": 3}}
PUBLISH v1/rpc/res/42
{"ok": true, "result": {"sent": 3, "received": 3, "avg_ms": 18.2}}
Une commande peut arriver deux fois, l’appareil doit donc conserver au moins les 32 derniers identifiants de requête pendant 10 minutes. Les commandes ne sont livrées qu’après l’abonnement sur la connexion en cours, ce qui impose de se réabonner après chaque connexion, et elles ne circulent que sur des sessions TLS, sauf si le profil autorise une commande en clair. Une tâche longue est acceptée immédiatement avec un job_id, et son résultat est remonté plus tard dans l’attribut rpc_result. Les bases du topic sont expliquées dans MQTT for industrial devices.
Comment savoir que la commande a fait ce que vous avez demandé ?
Successful signifie que l’appareil a répondu par un succès ; cela ne prouve pas que la vanne a bougé. Relisez l’effet à partir de la télémétrie propre à l’appareil et, si rien n’a changé physiquement, vérifiez côté appareil.
D’autres systèmes peuvent suivre ce résultat sans interroger l’API : l’événement webhook rpc.completed se déclenche lorsqu’une commande se termine en Successful, et rpc.failed lorsqu’elle se termine en Failed, Timed out ou Expired. Les commandes à fort impact et les commandes brutes sont écrites dans le journal d’audit à leur création et à leur fin. La référence complète des états se trouve dans sending commands to devices, et les commandes bloquées sont traitées dans commands do not reach the device.
Questions fréquentes
Puis-je envoyer une commande à un appareil Hermetry depuis mon propre logiciel ?
Oui, avec l’API de commandes : POST /api/iot/devices/{deviceId}/rpc avec une method et des parameters. Une commande bidirectionnelle, non persistante, avec un timeout d’au plus 30 secondes attend sa fin et répond 200 ; tout autre appel répond 202 immédiatement, et vous lisez le résultat plus tard à l’aide de l’identifiant de la commande.
Combien de commandes puis-je envoyer à un même appareil ?
Par défaut, 10 commandes par appareil et par minute, et 600 par organisation et par minute. Les parameters peuvent atteindre 16 KiB de JSON et une réponse 64 KiB. Les commandes que les flux envoient à un même appareil sont limitées séparément, à 30 par minute par défaut.
Puis-je annuler une commande après l’avoir envoyée ?
Oui, tant qu’elle est Queued ou Sent. Ouvrez la commande dans l’History de l’onglet Commands et sélectionnez Cancel command ; via l’API, envoyez un POST vers la route d’annulation de la commande. Une commande annulée se termine dans l’état Cancelled, et une annulation via l’API est journalisée dans l’audit.

