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.
Řešení předkonfigurovaného vzdáleného monitorování v sadě Azure IoT Suite demonstruje 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í řešení ukládají.
- Jak řešení spravuje metadata zařízení.
Kontext
Předkonfigurované řešení vzdáleného monitorování využí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é ve službě IoT Hub |
| Digitální dvojče zařízení | Metadata: ohlášené vlastnosti, požadované vlastnosti, značky | Integrované ve službě IoT Hub |
| Cosmos DB | Historie příkazů a metod | Přizpůsobení pro řešení |
IoT Hub zahrnuje registr identit zařízení pro správu přístupu k centru IoT a ke správě metadat zařízení používá dvojčata 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. Obě používají stejné ID zařízení k jedinečné identifikaci každého zařízení připojeného k vašemu 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 spravovaný službou IoT Hub a řešení používá rozhraní API služby 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í pro vzdálené monitorování simulovaná zařízení odesílají ohlášené vlastnosti při spuštění a v reakci na příkazy a metody změny stavu zařízení . Ohlášené vlastnosti můžete zobrazit v seznamu zařízení a podrobnostech o zařízení na portálu řešení. Hlásené vlastnosti jsou pouze pro čtení.
- Požadované vlastnosti se načítají ze služby IoT Hub podle zařízení. Za provedení jakékoli potřebné změny konfigurace v zařízení zodpovídá zařízení. Je také zodpovědností zařízení nahlásit změnu zpět k uzlu jako nahlášenou vlastnost. Požadovanou hodnotu vlastnosti můžete nastavit prostřednictvím portálu řešení.
- Značky existují jenom 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í.
Mezi příklady ohlášených vlastností ze simulovaných zařízení patří výrobce, číslo modelu, zeměpisná šířka a zeměpisná délka. Simulovaná zařízení také vrací seznam podporovaných metod jako ohlášené vlastnosti.
Poznámka:
Kód simulovaného zařízení používá pouze požadované vlastnosti Desired.Config.TemperatureMeanValue a Desired.Config.TelemetryInterval k aktualizaci ohlášených vlastností odesílaných zpět do ioT Hubu. Všechny ostatní žádosti o změnu požadovaných vlastností 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, která popisují telemetrii, která zařízení odesílá do IoT Hubu. Řešení pro vzdálené 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ří záznam pro zařízení v registru identit zařízení, který generuje klíče, které zařízení používá k ověření ve službě 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 s informacemi o zařízení. Hodnoty ohlášených vlastností se automaticky ukládají do dvojčete zařízení. Ohlášené vlastnosti zahrnují výrobce zařízení, číslo modelu, sériové číslo a seznam podporovaných metod. Zpráva s informacemi o zařízení obsahuje seznam příkazů, které zařízení podporuje, včetně informací o libovolných 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í
V seznamu zařízení na portálu řešení se ve výchozím nastavení zobrazují následující vlastnosti zařízení: Stav, DeviceId, Manufacturer, Model Number, Serial Number, Firmware, Platform, Processor a Installed 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ě Bing 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í).
K odebrání zařízení z řešení můžete použít portál ř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 zařízení
Zprávy o informacích o zařízení odesílané zařízením se liší od telemetrických zpráv. Zprávy s informacemi o zařízení zahrnují příkazy, na které může zařízení reagovat, a veškerou historii příkazů. IoT Hub sám nemá žádné znalosti o metadatech obsažených v informační zprávě o zařízení a zpracovává zprávu stejným způsobem, jakým zpracovává všechny zprávy typu zařízení-cloud. V řešení pro vzdálené monitorování úloha Azure Stream Analytics (ASA) čte zprávy ze služby IoT Hub. Úloha Analýza streamu DeviceInfo filtruje zprávy, které obsahují "ObjectType": "DeviceInfo", a přepošle 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 o zařízení je standardní zpráva odeslaná zařízením do cloudu. Řešení rozlišuje mezi informačními zprávami zařízení a telemetrickými zprávami pomocí dotazů ASA.
Další kroky
Teď jste se dozvěděli, jak můžete přizpůsobit předkonfigurovaná řešení, můžete prozkoumat některé další funkce a možnosti předkonfigurovaných řešení sady IoT Suite: