Neu: Die KI-Firewall überwacht die gesamte Plattform und erklärt jeden Vorfall in einfachen Worten. So funktioniert es

Befehle, die den Kreislauf schließen: einen Befehl an ein Gerät senden und wissen, dass er angekommen ist

Ein Befehl ist erst abgeschlossen, wenn Sie wissen, was mit ihm passiert ist. Die Status von Queued bis Successful, was Timed out wirklich bedeutet und die geräteseitigen Regeln, die den Kreislauf schließen.

Um einen Befehl an ein IoT-Gerät zu senden und zu wissen, dass er angekommen ist, speichern Sie ihn als Anfrage mit einer ID, lassen das Gerät auf genau diese ID antworten und verfolgen den Status, bis er endet. Der Commands-Tab von Hermetry (2.2.0, 22. Oktober 2026) zeigt, wie jeder Befehl von Queued über Sent und Delivered zu Successful, Failed oder Timed out wechselt.

Fire-and-forget reicht für einen Messwert. Bei einem Befehl, der eine Pumpe startet oder ein Gateway neu startet, braucht der Operator eine klare Antwort: Ist er angekommen, und hat er funktioniert?

Was sagt Ihnen jeder Befehlsstatus?

Jeder Status beantwortet einen Teil dieser Frage. Hermetry speichert jeden Befehl als Anfrage und führt ihn durch diese Status:

StatusBedeutung
QueuedGespeichert, wartet auf das Gerät
SentAn das Gerät gesendet
DeliveredDas Gerät hat ihn empfangen
SuccessfulDas Gerät hat mit Erfolg geantwortet
FailedDas Gerät hat mit einem Fehler geantwortet
Timed outRechtzeitig kam keine Antwort
ExpiredEr ist abgelaufen, bevor er zugestellt werden konnte
CancelledJemand hat ihn abgebrochen

Timed out ist der Status, der oft falsch verstanden wird. Er bedeutet, dass keine Antwort eingetroffen ist, nicht dass der Befehl nicht ausgeführt wurde. Hermetry zeigt ihn als „No answer: the outcome is unknown“ an. Ich würde das Gerät prüfen, bevor Sie denselben Befehl erneut senden.

Wie senden Sie einen Befehl von der Geräteseite aus?

Verwenden Sie den Commands-Tab des Geräts, der die Befehle aus dem Katalog des Geräteprofils anbietet. Der Katalog wird pro Profil eingerichtet, neben den übrigen Einstellungen des Profils.

  1. Öffnen Sie das Gerät und dessen Commands-Tab.
  2. Wählen Sie unter Choose a command einen Befehl aus und füllen Sie seine Parameters aus.
  3. Legen Sie den Answer timeout (Sekunden) fest, 1 bis 600; ohne Angabe gilt der Standardwert des Befehls oder des Profils, sonst 10 Sekunden.
  4. Für ein Gerät, das offline sein kann, aktivieren Sie Deliver when the device comes back (persistent) und setzen Give up after (standardmäßig 24 Stunden, höchstens 7 Tage).
  5. Wählen Sie Send. Ein Befehl mit hoher Auswirkung verlangt vorher eine Bestätigung.

Ohne persistent schlägt ein Befehl an ein offline gesetztes Gerät sofort fehl, und der Tab warnt davor, bevor Sie senden. Die History listet danach jeden Befehl mit seinem Status, seinem Absender und seiner Dauer auf, 90 Tage lang.

Was muss das Gerät tun, damit der Kreislauf geschlossen wird?

Subscribe, auf derselben ID antworten und nie eine ID zweimal ausführen. Über MQTT abonniert das Gerät v1/rpc/req/+ und antwortet bei einem zweiseitigen Befehl auf dem passenden Response-Topic:

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}}

Ein Befehl kann zweimal eintreffen, daher sollte das Gerät mindestens die letzten 32 Request-IDs für 10 Minuten merken. Befehle werden nur nach dem Abonnement in der aktuellen Verbindung zugestellt, das heißt, man muss nach jeder Verbindung erneut abonnieren, und sie werden nur über TLS-Sitzungen übertragen, sofern das Profil keinen Befehl im Klartext erlaubt. Ein lang laufender Auftrag wird sofort mit einer job_id angenommen, und sein Ergebnis wird später im Attribut rpc_result gemeldet. Die Grundlagen zu Topics finden Sie unter MQTT for industrial devices.

Woher wissen Sie, dass der Befehl das getan hat, was Sie verlangt haben?

Successful bedeutet, dass das Gerät mit Erfolg geantwortet hat; es beweist nicht, dass sich das Ventil bewegt hat. Lesen Sie die Wirkung über die eigene Telemetrie des Geräts zurück, und wenn sich physisch nichts geändert hat, prüfen Sie die Geräteseite.

Andere Systeme können dasselbe Ergebnis ohne Polling verfolgen: Das Webhook-Ereignis rpc.completed wird ausgelöst, wenn ein Befehl mit Successful endet, und rpc.failed, wenn er mit Failed, Timed out oder Expired endet. Befehle mit hoher Auswirkung und Raw-Befehle werden beim Anlegen und beim Ende im Audit-Log festgehalten. Die vollständige Referenz der Status finden Sie unter sending commands to devices, hängende Befehle werden unter commands do not reach the device behandelt.

Häufig gestellte Fragen

Kann ich aus meiner eigenen Software einen Befehl an ein Hermetry-Gerät senden?

Ja, mit der Commands-API: POST /api/iot/devices/{deviceId}/rpc mit einer method und Parametern. Ein zweiseitiger, nicht persistenter Befehl mit einem Timeout von höchstens 30 Sekunden wartet auf sein Ende und antwortet mit 200; jeder andere Aufruf antwortet sofort mit 202, und das Ergebnis lesen Sie später anhand der ID des Befehls.

Wie viele Befehle kann ich an ein Gerät senden?

Standardmäßig 10 Befehle pro Gerät und Minute sowie 600 pro Organisation und Minute. Parameter können bis zu 16 KiB JSON umfassen und eine Antwort bis zu 64 KiB. Befehle, die Flows an ein Gerät senden, sind separat begrenzt, standardmäßig auf 30 pro Minute.

Kann ich einen Befehl nach dem Senden abbrechen?

Ja, solange er Queued oder Sent ist. Öffnen Sie den Befehl in der History des Commands-Tabs und wählen Sie Cancel command; über die API senden Sie ein POST an die Cancel-Route des Befehls. Ein abgebrochener Befehl endet im Status Cancelled, und ein Abbruch über die API wird im Audit-Log festgehalten.

Teilen

Sehen Sie diese Woche Ihre Felddaten live

Starten Sie eine Testphase in Ihrer Region mit Ihren ersten Geräten oder buchen Sie eine Demo und bringen Sie Ihren eigenen Anwendungsfall mit.