Použití vlastností v řešení Azure IoT Central
V tomto průvodci návodem se dozvíte, jak používat vlastnosti zařízení definované v šabloně zařízení v aplikaci Azure IoT Central.
Vlastnosti představují hodnoty k určitému bodu v čase. Zařízení může například pomocí vlastnosti hlásit cílovou teplotu, ke které se pokouší dosáhnout. Ve výchozím nastavení jsou vlastnosti zařízení ve službě IoT Central jen pro čtení. Zapisovatelné vlastnosti umožňují synchronizovat stav mezi zařízením a aplikací Azure IoT Central.
Vlastnosti cloudu můžete definovat také v aplikaci Azure IoT Central. Hodnoty cloudových vlastností se nikdy neměňují se zařízením a nejsou určené pro tento článek.
Informace o konvencích vlastností IoT Pug a Play najdete v tématu Konvence technologie Plug and Play IoT.
Další informace o datech vlastností, která zařízení vyměňuje se službou IoT Central, najdete v tématu Telemetrie, vlastnosti a datové části příkazů.
Pokud chcete zjistit, jak spravovat vlastnosti pomocí rozhraní IoT Central REST API, přečtěte si, jak používat rozhraní IOT Central REST API k řízení zařízení.
Informace o tom, jak implementovat vlastnosti v zařízení bez použití sad SDK zařízení, najdete v tématu Komunikace s centrem IoT pomocí protokolu MQTT.
Definování vlastností
Vlastnosti jsou datová pole, která představují stav vašeho zařízení. Pomocí vlastností můžete znázorňovat trvalý stav zařízení, například stav zapnuto/vypnuto zařízení. Vlastnosti mohou také představovat základní vlastnosti zařízení, například softwarovou verzi zařízení. Vlastnosti deklarujete jako jen pro čtení nebo zapisovatelné.
Následující snímek obrazovky ukazuje definici vlastnosti v aplikaci Azure IoT Central.
Následující tabulka ukazuje nastavení konfigurace pro schopnost vlastnosti.
| Pole | Description |
|---|---|
| Zobrazovaný název | Zobrazovaný název hodnoty vlastnosti použité na dlaždicích řídicích panelů a formulářích zařízení. |
| Název | Název vlastnosti Azure IoT Central vygeneruje hodnotu pro toto pole ze zobrazovaného názvu, ale v případě potřeby můžete zvolit vlastní hodnotu. Toto pole musí být alfanumerické. Kód zařízení používá tuto hodnotu Name . |
| Typ funkce | Vlastnost. |
| Sémantický typ | Sémantický typ vlastnosti, například teplota, stav nebo událost. Volba sémantického typu určuje, která z následujících polí jsou k dispozici. |
| Schéma | Datový typ vlastnosti, například double, string nebo vector. Sémantický typ určuje dostupné volby. Schéma není k dispozici pro sémantické typy událostí a stavů. |
| Pro zápis | Pokud vlastnost není zapisovatelná, může zařízení hlásit hodnoty vlastností do Azure IoT Central. Pokud je vlastnost zapisovatelná, může zařízení hlásit hodnoty vlastností do Azure IoT Central. Azure IoT Central pak může do zařízení odesílat aktualizace vlastností. |
| Závažnost | K dispozici pouze pro sémantický typ události. Závažnosti jsou Chyba, Informace nebo Upozornění. |
| Hodnoty stavů | K dispozici pouze pro sémantický typ stavu. Definujte možné hodnoty stavu, z nichž každý má zobrazovaný název, název, typ výčtu a hodnotu. |
| Unit | Jednotka pro hodnotu vlastnosti, například mph, %nebo °C. |
| Jednotka zobrazení | Jednotka zobrazení pro použití na dlaždicích řídicích panelů a formulářích zařízení. |
| Komentář | Jakékoli komentáře k možnosti vlastnosti. |
| Popis | Popis schopnosti vlastnosti. |
Další informace o jazyce DTDL (Digital Twin Definition Language), který Azure IoT Central používá k definování vlastností v šabloně zařízení, najdete v tématu Technologie Plug and Play konvence > jen pro čtení.
Volitelná pole, jako je zobrazovaný název a popis, umožňují přidat do rozhraní a funkcí další podrobnosti.
Při vytváření vlastnosti můžete zadat složité typy schématu, jako je objekt a výčt.
Při výběru komplexního schématu, například objektu, je nutné definovat schéma objektu.
Implementace vlastností jen pro čtení
Ve výchozím nastavení jsou vlastnosti jen pro čtení. Vlastnosti jen pro čtení umožňují aktualizaci hodnoty vlastností sestavy zařízení v aplikaci Azure IoT Central. Vaše aplikace Azure IoT Central nemůže nastavit hodnotu vlastnosti jen pro čtení.
Azure IoT Central používá dvojčata zařízení k synchronizaci hodnot vlastností mezi zařízením a aplikací Azure IoT Central. Hodnoty vlastností zařízení používají ohlášené vlastnosti dvojčete zařízení. Další informace najdete v tématu Dvojčata zařízení.
Zařízení odesílá aktualizace vlastností jako datovou část JSON. Další informace najdete v tématu Telemetrie, vlastnost a datové části příkazů.
Sadu SDK zařízení Azure IoT můžete použít k odeslání aktualizace vlastnosti do aplikace Azure IoT Central.
Příklady implementace ve více jazycích najdete v tématu Vytvoření a připojení klientské aplikace k aplikaci Azure IoT Central.
Následující zobrazení v aplikaci Azure IoT Central zobrazuje vlastnosti jen pro čtení zařízení:
Implementace zapisovatelných vlastností
Operátor IoT Central nastavuje zapisovatelné vlastnosti ve formuláři. Azure IoT Central odešle vlastnost do zařízení. Azure IoT Central očekává potvrzení ze zařízení.
Příklady implementace ve více jazycích najdete v tématu Vytvoření a připojení klientské aplikace k aplikaci Azure IoT Central.
Zpráva odpovědi by měla obsahovat ac pole a av pole. Pole ad je nepovinné. Další informace najdete v tématu Technologie Plug and Play konvence > zapisovatelné vlastnosti IoT.
Když operátor nastaví zapisovatelnou vlastnost v uživatelském rozhraní Azure IoT Central, aplikace použije požadovanou vlastnost dvojčete zařízení k odeslání hodnoty do zařízení. Zařízení pak odpoví pomocí ohlášené vlastnosti dvojčete zařízení. Když Azure IoT Central obdrží hlášenou hodnotu vlastnosti, aktualizuje zobrazení vlastnosti se stavem Přijato.
Když zadáte hodnotu a vyberete Uložit, počáteční stav čeká na vyřízení. Když zařízení změnu přijme, stav se změní na Přijato.
Použití vlastností na nepřiřazených zařízeních
Zapisovatelné vlastnosti můžete zobrazit a aktualizovat na zařízení, které není přiřazené k šabloně zařízení.
Pokud chcete zobrazit existující vlastnosti na nepřiřazeném zařízení, přejděte na zařízení v části Zařízení , vyberte Spravovat zařízení a potom Vlastnosti zařízení:
Zapisovatelné vlastnosti můžete aktualizovat v tomto zobrazení:
Další kroky
Teď, když jste se naučili používat vlastnosti v aplikaci Azure IoT Central, najdete tady: