Metadata informací o zařízení v předkonfigurovaném řešení vzdáleného monitorování
Předkonfigurované řešení vzdáleného monitorování Azure IoT Suite ukazuje přístup ke správě metadat zařízení. Tento článek popisuje přístup, který toto řešení vyžaduje, abyste porozuměli:
- Jaká metadata zařízení se ukládají v řešení.
- Jak řešení spravuje metadata zařízení.
Kontext
Předkonfigurované řešení vzdáleného monitorování používá Azure IoT Hub k tomu, aby vaše zařízení mohla odesílat data do cloudu. Řešení ukládá informace o zařízeních na třech různých místech:
| Umístění | Uložené informace | Implementace |
|---|---|---|
| Registr identit | ID zařízení, ověřovací klíče, povolený stav | Integrované do IoT Hub |
| Dvojčata zařízení | Metadata: ohlášené vlastnosti, požadované vlastnosti, značky | Integrované do IoT Hub |
| Cosmos DB | Historie příkazů a metod | Vlastní pro řešení |
IoT Hub zahrnuje registr identit zařízení pro správu přístupu ke službě IoT Hub a používá dvojčata zařízení ke správě metadat zařízení. Existuje také registr zařízení specifický pro vzdálené monitorování, který ukládá historii příkazů a metod. Řešení pro vzdálené monitorování používá databázi Cosmos DB k implementaci vlastního úložiště pro historii příkazů a metod.
Poznámka
Předkonfigurované řešení vzdáleného monitorování udržuje registr identit zařízení synchronizovaný s informacemi v databázi Cosmos DB. Oba používají stejné ID zařízení k jedinečné identifikaci každého zařízení připojeného k centru IoT.
Metadata zařízení
IoT Hub udržuje dvojče zařízení pro každé simulované a fyzické zařízení připojené k řešení pro vzdálené monitorování. Řešení používá dvojčata zařízení ke správě metadat přidružených k zařízením. Dvojče zařízení je dokument JSON udržovaný IoT Hub a řešení používá rozhraní API IoT Hub k interakci s dvojčaty zařízení.
Dvojče zařízení ukládá tři typy metadat:
- Ohlášené vlastnosti se odesílají do centra IoT zařízením. V řešení vzdáleného monitorování simulovaná zařízení odesílají hlášené vlastnosti při spuštění a v reakci na změnu příkazů a metod stavu zařízení . Ohlášené vlastnosti můžete zobrazit v seznamu zařízení a podrobnosti o zařízení na portálu řešení. Ohlášené vlastnosti jsou jen pro čtení.
- Požadované vlastnosti se načítají ze služby IoT Hub zařízeními. Za provedení jakékoli potřebné změny konfigurace v zařízení je zodpovědná zařízení. Je také zodpovědností zařízení nahlásit změnu zpět do centra jako ohlášenou vlastnost. Požadovanou hodnotu vlastnosti můžete nastavit prostřednictvím portálu řešení.
- Značky existují pouze ve dvojčeti zařízení a nikdy se nesynchronují se zařízením. Hodnoty značek můžete nastavit na portálu řešení a použít je při filtrování seznamu zařízení. Řešení také používá značku k identifikaci ikony, která se má zobrazit pro zařízení na portálu řešení.
Příkladem hlášených vlastností ze simulovaných zařízení je výrobce, číslo modelu, zeměpisná šířka a zeměpisná délka. Simulovaná zařízení také vracejí seznam podporovaných metod jako ohlášené vlastnosti.
Poznámka
Kód simulovaného zařízení k aktualizaci ohlášených vlastností odeslaných zpět do služby IoT Hub využívá pouze požadované vlastnosti Desired.Config.TemperatureMeanValue a Desired.Config.TelemetryInterval. Všechny ostatní žádosti o změnu požadované vlastnosti se ignorují.
Dokument JSON s metadaty informací o zařízení uložený v databázi Cosmos DB registru zařízení má následující strukturu:
{
"DeviceProperties": {
"DeviceID": "deviceid1",
"HubEnabledState": null,
"CreatedTime": "2016-04-25T23:54:01.313802Z",
"DeviceState": "normal",
"UpdatedTime": null
},
"SystemProperties": {
"ICCID": null
},
"Commands": [],
"CommandHistory": [],
"IsSimulatedDevice": false,
"id": "fe81a81c-bcbc-4970-81f4-7f12f2d8bda8"
}
Poznámka
Informace o zařízení můžou obsahovat také metadata popisovat telemetrii, která zařízení odesílá do IoT Hub. Řešení vzdáleného monitorování používá tato telemetrická metadata k přizpůsobení způsobu zobrazení dynamické telemetrie řídicího panelu.
Životní cyklus
Při prvním vytvoření zařízení na portálu řešení vytvoří řešení položku v databázi Cosmos DB pro ukládání historie příkazů a metod. V tomto okamžiku řešení také vytvoří položku pro zařízení v registru identit zařízení, který vygeneruje klíče, které zařízení používá k ověření pomocí IoT Hub. Vytvoří také dvojče zařízení.
Když se zařízení poprvé připojí k řešení, odešle ohlášené vlastnosti a zprávu o informacích o zařízení. Hodnoty ohlášených vlastností se automaticky ukládají do dvojčete zařízení. Hlášené vlastnosti zahrnují výrobce zařízení, číslo modelu, sériové číslo a seznam podporovaných metod. Zpráva o informacích o zařízení obsahuje seznam příkazů, které zařízení podporuje, včetně informací o všech parametrech příkazu. Když řešení obdrží tuto zprávu, aktualizuje informace o zařízení v databázi Cosmos DB.
Zobrazení a úprava informací o zařízení na portálu řešení
Seznam zařízení na portálu řešení zobrazuje ve výchozím nastavení následující vlastnosti zařízení jako sloupce: Stav, Id zařízení, Výrobce, Číslo modelu, Sériové číslo, Firmware, Platforma, Procesor a nainstalovaná paměť RAM. Sloupce můžete přizpůsobit kliknutím na editor sloupců. Vlastnosti zařízení Zeměpisná šířka a Zeměpisná délka řídí umístění v mapě Bingu na řídicím panelu.
V podokně Podrobnosti o zařízení na portálu řešení můžete upravit požadované vlastnosti a značky (ohlášené vlastnosti jsou jen pro čtení).
Pomocí portálu řešení můžete odebrat zařízení z vašeho řešení. Když zařízení odeberete, řešení odebere položku zařízení z registru identit a pak odstraní dvojče zařízení. Řešení také odebere informace související se zařízením z databáze Cosmos DB. Než budete moct zařízení odebrat, musíte ho zakázat.
Zpracování zpráv o informacích o zařízení
Zprávy informací o zařízení odeslané zařízením se liší od telemetrických zpráv. Zprávy informací o zařízení zahrnují příkazy, na které může zařízení reagovat, a všechny historie příkazů. IoT Hub sám o sobě nemá žádné znalosti o metadatech obsažených v informační zprávě zařízení a zpracovává zprávu stejným způsobem, jakým zpracovává zprávu typu zařízení-cloud. V řešení pro vzdálené monitorování úloha Azure Stream Analytics (ASA) přečte zprávy z IoT Hub. Filtry úlohy Analýzy datových proudů DeviceInfo pro zprávy, které obsahují ObjectType: DeviceInfo , a přeposílají je do instance hostitele EventProcessorHost , která běží ve webové úloze. Logika v instanci EventProcessorHost používá ID zařízení k vyhledání záznamu Cosmos DB pro konkrétní zařízení a aktualizaci záznamu.
Poznámka
Informační zpráva zařízení je standardní zpráva typu device-to-cloud. Řešení rozlišuje mezi zprávami informací o zařízení a telemetrickými zprávami pomocí dotazů ASA.
Další kroky
Teď jste se naučili, jak přizpůsobit předkonfigurovaná řešení, můžete prozkoumat některé z dalších funkcí a možností předkonfigurovaných řešení sady IoT Suite: