Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Deze handleiding laat zien hoe u apparaateigenschappen gebruikt die zijn gedefinieerd in een apparaatsjabloon in uw Azure IoT Central-toepassing.
Eigenschappen vertegenwoordigen momentopnamewaarden. Een apparaat kan bijvoorbeeld een eigenschap gebruiken om de doeltemperatuur te rapporteren die het probeert te bereiken. In IoT Central zijn apparaateigenschappen standaard als alleen-lezen ingesteld. Met schrijfbare eigenschappen kunt u de status synchroniseren tussen uw apparaat en uw Azure IoT Central-toepassing.
U kunt ook cloudeigenschappen definiëren in een Azure IoT Central-toepassing. Cloudeigenschapswaarden worden nooit uitgewisseld met een apparaat en vallen buiten het bereik van dit artikel.
Zie IoT Plug and Play-conventies voor meer informatie over de conventies voor IoT Plug and Play-eigenschappen.
Voor meer informatie over de eigenschapsgegevens die een apparaat uitwisselt met IoT Central, zie telemetrie, eigenschappen en opdracht-payloads.
Zie De Rest API van IoT Central gebruiken om apparaten te beheren voor meer informatie over het beheren van eigenschappen met behulp van de REST API van IoT Central.
Zie Communiceren met een IoT-hub met behulp van het MQTT-protocol voor meer informatie over het implementeren van eigenschappen in een apparaat zonder de apparaat-SDK's te gebruiken.
Uw eigenschappen definiëren
Eigenschappen zijn gegevensvelden die de status van uw apparaat vertegenwoordigen. Gebruik eigenschappen om de duurzame status van het apparaat weer te geven, zoals de aan-/uit-status van een apparaat. Eigenschappen kunnen ook basiseigenschappen van apparaten vertegenwoordigen, zoals de softwareversie van het apparaat. Je definieert eigenschappen als (alleen lezen) of schrijfbaar.
In de volgende schermopname ziet u een eigenschapsdefinitie in een Azure IoT Central-toepassing.
In de volgende tabel ziet u de configuratie-instellingen voor een eigenschapsmogelijkheid.
| Veld | Description |
|---|---|
| Weergavenaam | De weergavenaam voor de eigenschapswaarde die wordt gebruikt op dashboardtegels en apparaatformulieren. |
| Naam | De naam van de eigenschap. Azure IoT Central genereert een waarde voor dit veld op basis van de weergavenaam, maar u kunt indien nodig uw eigen waarde kiezen. Dit veld moet alfanumeriek zijn. De apparaatcode maakt gebruik van deze naamwaarde . |
| Mogelijkheidstype | Eigenschap. |
| Semantische type | Het semantische type eigenschap, zoals temperatuur, status of gebeurtenis. De keuze van het semantische type bepaalt welke van de volgende velden beschikbaar zijn. |
| Schema | Het gegevenstype van de eigenschap, zoals double, tekenreeks of vector. Het semantische type bepaalt de beschikbare opties. Het schema is niet beschikbaar voor de semantische typen gebeurtenissen en statussen. |
| Beschrijfbaar | Als de eigenschap niet schrijfbaar is, kan het apparaat eigenschapswaarden rapporteren aan Azure IoT Central. Als de eigenschap beschrijfbaar is, kan het apparaat eigenschapswaarden rapporteren aan Azure IoT Central. Vervolgens kan Azure IoT Central eigenschapsupdates naar het apparaat verzenden. |
| Severity | Alleen beschikbaar voor het semantische gebeurtenistype. De ernstniveaus zijn Fout, Informatie of Waarschuwing. |
| Statuswaarden | Alleen beschikbaar voor het semantische statustype. Definieer de mogelijke statuswaarden, die elk weergavenaam, naam, opsommingstype en waarde hebben. |
| Unit | Een eenheid voor de eigenschapswaarde, zoals mph of %°C. |
| Beeldscherm | Een weergave-eenheid voor gebruik op dashboardtegels en apparaatformulieren. |
| Comment | Opmerkingen over de functionaliteit van de eigenschap. |
| Description | Een beschrijving van de eigenschapsmogelijkheid. |
Voor meer informatie over de Digital Twin Definition Language (DTDL) die voor Azure IoT Central wordt gebruikt om eigenschappen in een apparaatsjabloon te definiëren, raadpleegt u de IoT Plug en Play-conventies > Lees de alleen-lezen eigenschappen.
Met optionele velden, zoals weergavenaam en beschrijving, kunt u meer details toevoegen aan de interface en mogelijkheden.
Wanneer u een eigenschap maakt, kunt u complexe schematypen opgeven, zoals Object en Enum.
Wanneer u het complexe schema selecteert, zoals Object, moet u het objectschema definiëren.
Alleen-lezen-eigenschappen implementeren
Eigenschappen zijn standaard read-only. Eigenschappen alleen-lezen maken het mogelijk dat een apparaat eigenschapswaarde-updates rapporteert aan uw Azure IoT Central-toepassing. Uw Azure IoT Central-toepassing kan de waarde van een alleen-lezen eigenschap niet instellen.
Azure IoT Central maakt gebruik van apparaatdubbels om eigenschapswaarden tussen het apparaat en de Azure IoT Central-toepassing te synchroniseren. Apparaat-eigenschapswaarden maken gebruik van gerapporteerde eigenschappen van apparaat-tweelingen. Zie Zelfstudie: Uw apparaten configureren vanuit een back-endservice voor meer informatie.
Een apparaat verzendt eigenschapsupdates als een JSON-nettolading. Voor meer informatie, zie telemetrie-, eigenschaps- en opdrachtladingen.
U kunt de Azure IoT-apparaat-SDK gebruiken om een eigenschapsupdate te verzenden naar uw Azure IoT Central-toepassing.
Zie zelfstudie: Een clienttoepassing maken en verbinden met uw Azure IoT Central-toepassing, bijvoorbeeld implementaties in meerdere talen.
In het volgende overzicht in de Azure IoT Central toepassing worden de alleen-lezen eigenschappen van het apparaat weergegeven.
Schrijfbare eigenschappen implementeren
Een IoT Central-operator stelt schrijfbare eigenschappen in op een formulier. Azure IoT Central verzendt de eigenschap naar het apparaat. Azure IoT Central verwacht een bevestiging van het apparaat.
Zie Bijvoorbeeld implementaties in meerdere talen een clienttoepassing maken en verbinden met uw Azure IoT Central-toepassing.
Het antwoordbericht moet de ac en av velden bevatten. Het ad veld is optioneel. Zie De schrijfbare eigenschappen van IoT Plug en Play >voor meer informatie.
Wanneer de operator een waarneembare eigenschap instelt in de gebruikersinterface van Azure IoT Central, gebruikt de toepassing een gewenste eigenschap van een apparaat-tweeling om de waarde naar het apparaat te verzenden. Het apparaat reageert vervolgens via een gerapporteerde eigenschap van een apparaat-tweeling. Wanneer Azure IoT Central de gerapporteerde eigenschapswaarde ontvangt, wordt de eigenschapsweergave bijgewerkt met de status Geaccepteerd.
Wanneer u de waarde invoert en Opslaan selecteert, is de initiële status In behandeling. Wanneer het apparaat de wijziging accepteert, wordt de status gewijzigd in Geaccepteerd.
Eigenschappen gebruiken op niet-toegewezen apparaten
U kunt schrijfbare eigenschappen weergeven en bijwerken op een apparaat dat niet is toegewezen aan een apparaatsjabloon.
Als u bestaande eigenschappen op een niet-toegewezen apparaat wilt weergeven, gaat u naar het apparaat in de sectie Apparaten , selecteert u Apparaat beheren en vervolgens apparaateigenschappen:
U kunt de beschrijfbare eigenschappen in deze weergave bijwerken:
Volgende stappen
Nu u weet hoe u eigenschappen kunt gebruiken in uw Azure IoT Central-toepassing, raadpleegt u: