Freigeben über


Verwenden von Eigenschaften in einer Azure IoT Central-Lösung

In dieser Schrittanleitung wird gezeigt, wie Sie Geräteeigenschaften verwenden können, die in Ihrer Azure IoT Central-Anwendung in einer Gerätevorlage definiert werden.

Eigenschaften stellen Zeitpunktwerte dar. Ein Gerät kann beispielsweise eine Eigenschaft verwenden, um die Zieltemperatur zu melden, die es zu erreichen versucht. Standardmäßig sind Geräteeigenschaften in IoT Central schreibgeschützt. Mithilfe von schreibbaren Eigenschaften können Sie den Zustand zwischen Ihrem Gerät und der Azure IoT Central-Anwendung synchronisieren.

Außerdem können Sie Cloudeigenschaften in einer Azure IoT Central-Anwendung definieren. Cloudeigenschaftswerte werden niemals mit einem Gerät ausgetauscht und deshalb in diesem Artikel nicht behandelt.

Weitere Informationen zu den Konventionen für IoT Plug & Play-Eigenschaften finden Sie unter IoT Plug & Play-Konventionen.

Weitere Informationen zu den Eigenschaftsdaten, die ein Gerät mit IoT Central austauscht, finden Sie unter Telemetrie-, Eigenschaften- und Befehlsnutzlasten.

Informationen zum Verwalten von Eigenschaften mithilfe der IoT Central-REST-API finden Sie unter Verwenden der IoT Central-REST-API zur Steuerung von Geräten.

Informationen zum Implementieren von Eigenschaften in einem Gerät ohne Verwendung der Geräte-SDKs finden Sie unter Kommunizieren mit einem IoT-Hub mithilfe des MQTT-Protokolls.

Definieren Ihrer Eigenschaften

Eigenschaften sind Datenfelder, die den Zustand des Geräts darstellen. Verwenden Sie Eigenschaften zur Darstellung von dessen dauerhaftem Zustand, z. B. seinem „Ein/Aus“-Status. Eigenschaften können auch grundlegende Geräteeigenschaften darstellen, z. B. die Softwareversion des Geräts. Sie können Eigenschaften als schreibgeschützt oder schreibbar deklarieren.

Der folgende Screenshot zeigt eine Eigenschaftsdefinition in einer Azure IoT Central-Anwendung.

Screenshot that shows a property definition in an Azure IoT Central application.

In der folgenden Tabelle sind die Konfigurationseinstellungen für eine Eigenschaftsfunktion angegeben.

Feld Beschreibung
Anzeigename Der Anzeigename des Eigenschaftswerts, der auf Dashboardkacheln und in Geräteformularen verwendet wird.
Name Der Name der Eigenschaft. Azure IoT Central generiert einen Wert für dieses Feld aus dem Anzeigenamen. Bei Bedarf können Sie aber einen eigenen Wert auswählen. Dieses Feld muss alphanumerisch sein. Der Wert von Name wird im Gerätecode verwendet.
Funktionstyp Eigenschaft.
Semantischer Typ Der semantische Typ der Eigenschaft, z. B. Temperatur, Zustand oder Ereignis. Die Auswahl des semantischen Typs bestimmt, welches der folgenden Felder verfügbar ist.
Schema Der Eigenschaftsdatentyp, z.B. „double“, „string“ oder „vector“. Der semantische Typ bestimmt die verfügbaren Auswahlmöglichkeiten. Schema ist für die semantischen Typen „Ereignis“ und „Zustand“ nicht verfügbar.
Schreibbar Wenn die Eigenschaft nicht schreibbar ist, kann das Gerät Eigenschaftswerte an Azure IoT Central melden. Wenn die Eigenschaft schreibbar ist, kann das Gerät Eigenschaftswerte an Azure IoT Central melden. Anschließend kann Azure IoT Central Eigenschaftsaktualisierungen an das Gerät senden.
severity Nur für den semantischen Typ „Ereignis“ verfügbar. Die Schweregrade lauten Fehler, Information und Warnung.
Zustandswerte Nur für den semantischen Typ „Zustand“ verfügbar. Definieren Sie die möglichen Zustandswerte, die jeweils einen Anzeigenamen, Namen, Enumerationstyp und Wert umfassen.
Einheit Eine Einheit für den Eigenschaftswert, z. B. km/h, % oder °C.
Anzeigeeinheit Eine Anzeigeeinheit zur Verwendung auf Dashboardkacheln und in Geräteformularen.
Comment Beliebige Kommentare zur Eigenschaftsfunktion.
BESCHREIBUNG Eine Beschreibung der Eigenschaftsfunktion.

Informationen zur Digital Twin Definition Language (DTDL), die Azure IoT Central zum Definieren von Eigenschaften in einer Gerätevorlage verwendet, finden Sie unter IoT Plug &Play-Konventionen > Schreibgeschützte Eigenschaften.

Über optionale Felder, z. B. Anzeigename und Beschreibung, können Sie der Schnittstelle und den Funktionen weitere Details hinzufügen.

Beim Erstellen einer Eigenschaft können Sie komplexe Schematypen wie Objekt und Enumeration angeben.

Screenshot that shows how to add a capability.

Wenn Sie das komplexe Schema, z. B. Objekt auswählen, müssen Sie das Objektschema definieren.

Screenshot that shows how to define an object.

Implementieren von schreibgeschützten Eigenschaften

Standardmäßig sind Eigenschaften schreibgeschützt. Mit schreibgeschützten Eigenschaften kann das Gerät Aktualisierungen der Eigenschaftswerte an die Azure IoT Central-Anwendung melden. Ihre Azure IoT Central-Anwendung kann den Wert einer schreibgeschützten Eigenschaft nicht festlegen.

Azure IoT Central verwendet Gerätezwillinge zum Synchronisieren von Eigenschaftswerten zwischen dem Gerät und der Azure IoT Central-Anwendung. Die gemeldeten Eigenschaften von Gerätezwillingen werden für die Eigenschaftswerte eines Geräts verwendet. Weitere Informationen finden Sie unter Gerätezwillinge.

Ein Gerät sendet Eigenschaftsupdates als JSON-Payload. Weitere Informationen finden Sie unter Telemetrie, Eigenschafts- und Befehlsnutzdaten.

Sie können mithilfe des Azure IoT-Geräte-SDKs eine Eigenschaftsaktualisierung an Ihre Azure IoT Central-Anwendung senden.

Beispielimplementierungen in mehreren Sprachen finden Sie unter Erstellen und Verbinden einer Clientanwendung mit Ihrer Azure IoT Central-Anwendung.

Die folgende Ansicht in der Anwendung Azure IoT Central zeigt die schreibgeschützten Eigenschaften des Geräts:

Screenshot that shows the view of a read-only property.

Implementieren von schreibbaren Eigenschaften

Ein IoT Central-Operator legt beschreibbare Eigenschaften für ein Formular fest. Azure IoT Central sendet die-Eigenschaft an das Gerät. Azure IoT Central erwartet eine Bestätigung vom Gerät.

Beispielimplementierungen in mehreren Sprachen finden Sie unter Erstellen und Verbinden einer Clientanwendung mit Ihrer Azure IoT Central-Anwendung.

Die Antwortnachricht sollte die Felder ac und av enthalten. Das Feld ad ist optional. Weitere Informationen finden Sie unter IoT Plug & Play-Konventionen > Schreibbare Eigenschaften.

Wenn der Operator eine schreibbare Eigenschaft in der Azure IoT Central-Anwendung einstellt, verwendet die Anwendung eine gewünschte Eigenschaft eines Gerätezwillings, um den Wert an das Gerät zu senden. Das Gerät antwortet dann mithilfe einer gemeldeten Eigenschaft des Gerätezwillings. Wenn Azure IoT Central den gemeldeten Eigenschaftswert empfängt, wird die Eigenschaftsansicht mit dem Status Akzeptiert aktualisiert.

Wenn Sie den Wert eingeben und Speichern auswählen, lautet der Anfangsstatus Ausstehend. Wenn das Gerät die Änderung akzeptiert, wird der Status in Akzeptiert geändert.

Verwenden von Eigenschaften auf nicht zugewiesenen Geräten

Sie können schreibbare Eigenschaften auf einem Gerät anzeigen und aktualisieren, das keiner Gerätevorlage zugewiesen ist.

Um bestehende Eigenschaften auf einem nicht zugewiesenen Gerät anzuzeugen, navigieren Sie im Abschnitt Geräte zu dem Gerät und wählen Gerät verwalten und dann Geräteeigenschaften aus.

Screenshot that shows properties on an unassigned device.

Sie können die schreibbaren Eigenschaften in dieser Ansicht aktualisieren:

Screenshot that shows how to update properties.

Nächste Schritte

Nachdem Sie erfahren haben, wie Sie Eigenschaften in Ihrer Azure IoT Central-Anwendung verwenden können, lesen Sie jetzt: