Använda egenskaper i en Azure IoT Central-lösning
Den här instruktionsguiden visar hur du använder enhetsegenskaper som definieras i en enhetsmall i ditt Azure IoT Central-program.
Egenskaper representerar punkt-i-tid-värden. En enhet kan till exempel använda en egenskap för att rapportera den måltemperatur som den försöker nå. Som standard är enhetsegenskaper skrivskyddade i IoT Central. Med skrivbara egenskaper kan du synkronisera tillstånd mellan din enhet och ditt Azure IoT Central-program.
Du kan också definiera molnegenskaper i ett Azure IoT Central-program. Molnegenskapsvärden utbyts aldrig med en enhet och ligger utanför omfånget för den här artikeln.
Information om IoT Pug and Play-egendomskonventionerna finns i IoT Plug and Play-konventioner.
Mer information om de egenskapsdata som en enhet utbyter med IoT Central finns i Nyttolaster för telemetri, egenskap och kommando.
Information om hur du hanterar egenskaper med hjälp av REST-API :et för IoT Central finns i Så här använder du REST-API:et för IoT Central för att styra enheter..
Information om hur du implementerar egenskaper på en enhet utan att använda enhetens SDK:er finns i Kommunicera med en IoT-hubb med MQTT-protokollet.
Definiera dina egenskaper
Egenskaper är datafält som representerar enhetens tillstånd. Använd egenskaper för att representera enhetens varaktiga tillstånd, till exempel på/av-tillståndet för en enhet. Egenskaper kan också representera grundläggande enhetsegenskaper, till exempel enhetens programvaruversion. Du deklarerar egenskaper som skrivskyddade eller skrivbara.
Följande skärmbild visar en egenskapsdefinition i ett Azure IoT Central-program.
I följande tabell visas konfigurationsinställningarna för en egenskapsfunktion.
| Fält | Description |
|---|---|
| Display name | Visningsnamnet för egenskapsvärdet som används på instrumentpaneler och enhetsformulär. |
| Name | Namnet på egenskapen. Azure IoT Central genererar ett värde för det här fältet från visningsnamnet, men du kan välja ditt eget värde om det behövs. Det här fältet måste vara alfanumeriskt. Enhetskoden använder det här namnvärdet . |
| Typ av kapacitet | Egenskapen. |
| Semantiktyp | Egenskapens semantiska typ, till exempel temperatur, tillstånd eller händelse. Valet av semantisk typ avgör vilka av följande fält som är tillgängliga. |
| Schema | Egenskapsdatatypen, till exempel dubbel, sträng eller vektor. Den semantiska typen avgör vilka alternativ som är tillgängliga. Schemat är inte tillgängligt för händelse- och tillståndssemantiktyperna. |
| Skrivbar | Om egenskapen inte kan skrivas kan enheten rapportera egenskapsvärden till Azure IoT Central. Om egenskapen är skrivbar kan enheten rapportera egenskapsvärden till Azure IoT Central. Sedan kan Azure IoT Central skicka egenskapsuppdateringar till enheten. |
| Allvarlighet | Endast tillgängligt för händelsesemantisk typ. Allvarlighetsgraden är Fel, Information eller Varning. |
| Statusvärden | Endast tillgängligt för tillståndssemantisk typ. Definiera möjliga tillståndsvärden, som var och en har visningsnamn, namn, uppräkningstyp och värde. |
| Enhet | En enhet för egenskapsvärdet, till exempel mph, %, eller °C. |
| Visningsenhet | En visningsenhet för användning på instrumentpaneler och enhetsformulär. |
| Kommentar | Eventuella kommentarer om egenskapsfunktionen. |
| beskrivning | En beskrivning av egenskapsfunktionen. |
Mer information om DTDL (Digital Twin Definition Language) som Azure IoT Central använder för att definiera egenskaper i en enhetsmall finns i Skrivskyddade > egenskaper för IoT Plug and Play-konventioner.
Med valfria fält, till exempel visningsnamn och beskrivning, kan du lägga till mer information i gränssnittet och funktionerna.
När du skapar en egenskap kan du ange komplexa schematyper som Objekt och Uppräkning.
När du väljer det komplexa schemat, till exempel Objekt, måste du definiera objektschemat.
Implementera skrivskyddade egenskaper
Som standard är egenskaperna skrivskyddade. Med skrivskyddade egenskaper kan en enhetsrapports egenskapsvärde uppdateras till ditt Azure IoT Central-program. Ditt Azure IoT Central-program kan inte ange värdet för en skrivskyddad egenskap.
Azure IoT Central använder enhetstvillingar för att synkronisera egenskapsvärden mellan enheten och Azure IoT Central-programmet. Enhetsegenskapsvärden använder rapporterade egenskaper för enhetstvillingar. Mer information finns i Enhetstvillingar.
En enhet skickar egenskapsuppdateringar som en JSON-nyttolast. Mer information finns i Telemetri, egenskap och kommandonyttolaster.
Du kan använda Azure IoT-enhets-SDK för att skicka en egenskapsuppdatering till ditt Azure IoT Central-program.
Exempel på implementeringar på flera språk finns i Skapa och ansluta ett klientprogram till ditt Azure IoT Central-program.
Följande vy i Azure IoT Central-programmet visar enhetens skrivskyddade egenskaper:
Implementera skrivbara egenskaper
En IoT Central-operator anger skrivbara egenskaper i ett formulär. Azure IoT Central skickar egenskapen till enheten. Azure IoT Central förväntar sig en bekräftelse från enheten.
Exempel på implementeringar på flera språk finns i Skapa och ansluta ett klientprogram till ditt Azure IoT Central-program.
Svarsmeddelandet ska innehålla fälten ac och av . Fältet ad är valfritt. Mer information finns i IoT Plug and Play-konventioner > Skrivbara egenskaper.
När operatorn anger en skrivbar egenskap i Azure IoT Central-användargränssnittet använder programmet en önskad egenskap för enhetstvillingar för att skicka värdet till enheten. Enheten svarar sedan med hjälp av en rapporterad egenskap för enhetstvillingar. När Azure IoT Central tar emot det rapporterade egenskapsvärdet uppdateras egenskapsvyn med statusen Godkänd.
När du anger värdet och väljer Spara är den inledande statusen Väntande. När enheten godkänner ändringen ändras statusen till Godkänd.
Använda egenskaper på otilldelade enheter
Du kan visa och uppdatera skrivbara egenskaper på en enhet som inte är tilldelad till en enhetsmall.
Om du vill visa befintliga egenskaper på en ej tilldelad enhet går du till enheten i avsnittet Enheter , väljer Hantera enhet och sedan Enhetsegenskaper:
Du kan uppdatera skrivbara egenskaper i den här vyn:
Nästa steg
Nu när du har lärt dig hur du använder egenskaper i ditt Azure IoT Central-program kan du läsa: