Beispiel: Smarte Steckdose

Erstellen Sie End-to-End-Befehle zum Ein- und Ausschalten einer smarten Steckdose — Payload, Encoder, Verifizierung und Ausführung über den Reiter „States“.

Diese Schritt-für-Schritt-Anleitung baut zwei Befehle auf einem Gerät auf und überprüft, dass sie funktioniert haben. Sie verwendet eine netzbetriebene smarte Steckdose, die meldet, ob ihr Relais ein- oder ausgeschaltet ist, aber dieselbe Abfolge gilt für jeden Aktor: ein Ventil, eine Leuchte, eine Heizung.

Folgen Sie ihr in der angegebenen Reihenfolge — jeder Abschnitt erzeugt etwas, das der nächste benötigt.

Vor dem Start

• Die Steckdose ist registriert und sendet. Klasse C für LoRaWAN oder ein MQTT-Gerät.

• Sie können ihre Messwerte auf der Metriken Registerkarte (Zuordnung für MQTT).

1. Finden Sie heraus, wie das Gerät seinen Status meldet

Öffnen Sie das Gerät und gehen Sie zur Metriken Registerkarte. Sehen Sie in der Tabelle der Connector-Schlüssel nach dem Feld, das den Relaisstatus enthält, und notieren Sie sich zwei Dinge: den Feldnamen und den Wert, der gerade angezeigt wird.

Für diese Steckdose:

Connector-Schlüssel	Aktueller Wert
socket_status	aus

Dieser Wert ist es, mit dem eine spätere Verifizierungsprüfung verglichen wird, also notieren Sie ihn genau so, wie er erscheint — aus, nicht AUS oder falsch.

Wenn das Feld noch nicht einem Messwert zugeordnet ist, ordnen Sie es jetzt zu: Im Befehlseditor werden Sensoren nach ihrem Messwertnamen ausgewählt, daher kann ein nicht zugeordnetes Feld nicht verwendet werden, um irgendetwas zu verifizieren. Siehe Payload-Dekodierung und Connector-Schlüssel.

In diesem Beispiel socket_status ist einem Messwert namens Steckdosenstatus.

2. Erstellen Sie den Befehl Einschalten

Öffnen Sie Befehle & Zustände → Befehle und klicken Sie auf Neuen Befehl hinzufügen.

1. Identität

• Befehlsname — Einschalten

2. Weiterleitung

• Für LoRaWAN: Setzen Sie den fPort den das Gerät erwartet, und schalten Sie Bestätigter Downlink ein.

• Für MQTT: Geben Sie das Topic ein, auf das die Steckdose für Befehle abonniert ist.

3. Payload

Dieser Befehl nimmt keine Parameter entgegen — er sendet immer dasselbe — also fügen Sie keine hinzu und definieren Sie die Nutzlast, die der Encoder erzeugen soll. Die Steckdose erwartet drei Bytes: Kanal 0x08, Typ 0x70, und den Zustand, 0x01 für EIN.

Verwenden Sie Encoder testen prüfen Sie das Ergebnis vor dem Speichern. Es zeigt die kodierte Ausgabe in Hex und Base64 samt ihrer Größe in Bytes an, sodass Sie bestätigen können, dass die Nutzlast 08 70 01 bevor der Befehl das Gerät überhaupt erreicht.

4. Verifizierung

Wählen Sie Auf das nächste Uplink warten — die Steckdose meldet ihren Status in jeder Routine-Nachricht, daher muss sie nicht abgefragt werden.

Unter Erwartete Sensorzustände, klicken Sie auf Zustand hinzufügen:

• Messwert — Steckdosenstatus

• Erwarteter Wert — ein

Geben Sie den Wert so ein, wie das Gerät ihn meldet. Groß- und Kleinschreibung spielen hier keine Rolle, also ein passt auch zu einem Gerät, das EIN meldet — Text und Zahlen sind jedoch nicht austauschbar, also 1 würde nicht passen. Siehe Befehle bestätigen.

Klicken Sie auf Speichern.

3. Erstellen Sie den Befehl Ausschalten

Wiederholen Sie die obigen Schritte mit drei Änderungen:

• Befehlsname — Ausschalten

• Nutzlast — dieselben drei Bytes, wobei das Zustandsbyte auf 0x00

• Erwarteter Wert — aus

Alles andere bleibt gleich.

4. Führen Sie sie aus und prüfen Sie das Ergebnis

Gehen Sie zur Status Registerkarte, suchen Sie Einschalten in der Liste der verfügbaren Befehle und klicken Sie auf Ausführen.

Beobachten Sie, wie der Eintrag in Letzte Ausführungen:

1. Er beginnt als Ausstehend während der Downlink unterwegs ist.

2. Wenn die nächste Nachricht der Steckdose eintrifft und socket_status: ein, wechselt die Ausführung zu Bestätigt — die Plattform hat das Gerät im von Ihnen angeforderten Zustand gesehen.

Ausführen Ausschalten und dasselbe passiert umgekehrt.

Wenn die Ausführung nie bestätigt wird

Eine Ausführung, die bis zum Ende ihres Zeitfensters unbestätigt bleibt, wird markiert als Leichte Warnung — zugestellt, aber nicht bestätigt. Arbeiten Sie diese in dieser Reihenfolge durch:

1. Überprüfen Sie den Wert. Öffnen Sie die Registerkarte Metriken und lesen Sie, was socket_status jetzt meldet. Wenn die Steckdose umgeschaltet hat, aber 1 statt einmeldet, muss der erwartete Wert dieser Form entsprechen — und ein eingegebener Literalwert ist immer Text, verwenden Sie stattdessen eine {{ parameterName }} Referenz auf einen Booleschen- oder Integer-Parameter.

2. Überprüfen Sie den Messwert. Stellen Sie sicher, dass der von Ihnen ausgewählte Messwert derjenige ist, der von socket_statusgespeist wird, und dass er zugeordnet ist und Messwerte empfängt.

3. Überprüfen Sie das Zeitfenster. Das Standardzeitfenster beträgt das 1,5-Fache des Datenübertragungsintervalls des Geräts. Wenn dieses Intervall auf dem Gerät nicht eingestellt ist, setzen Sie es — siehe Konvergenz-Timeout.

4. Überprüfen Sie die Nutzlast. Ausführen Encoder testen erneut und vergleichen Sie die Bytes mit der Dokumentation des Herstellers.

Weiter

• Platzieren Sie die beiden Befehle auf einem Dashboard mit einem Steuerungs-Widget damit das Team die Steckdose umschalten kann, ohne das Gerät zu öffnen.

• Lassen Sie eine Regel die Steckdose selbstständig steuern — siehe Gerätebefehle ausführen.