Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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.
Další informace o konvencích vlastností IoT Pug a Play najdete v tématu Konvence IoT Plug and Play.
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ů.
Informace o správě vlastností pomocí rozhraní IoT Central REST API najdete v tématu Použití 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.
| Obor | Description |
|---|---|
| Zobrazované jméno | 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 schopnosti | 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. |
| Schema | 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ů. |
| Zapisovatelný | 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 stavu | 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. |
| Jednotka | 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í. |
| Comment | Jakékoli připomínky k funkci vlastnosti. |
| Description | 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 Konvence IoT Plug and Play > Vlastnosti pouze 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 určené pouze pro čtení umožňují zařízení hlásit aktualizace hodnot vlastností do vaší aplikace 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 Kurz: Konfigurace zařízení z back-endové služby.
Zařízení odesílá aktualizace vlastností jako datovou část JSON. Další informace naleznete v části Telemetrie, vlastnosti 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 Kurz: 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í:
Implementujte zapisovatelné vlastnosti
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 volitelné. Další informace najdete v tématu Konvence IoT Plug and Play > Zapisovatelné vlastnosti.
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í následně odpoví pomocí ohlášené vlastnosti "device twin". 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ž víte, jak používat vlastnosti v aplikaci Azure IoT Central, najdete tady: