Definování nového typu zařízení IoT v aplikaci Azure IoT Central
Šablona zařízení je podrobný plán, který definuje vlastnosti a chování typu zařízení, které se připojuje k aplikaci Azure IoT Central.
Tento článek popisuje, jak vytvořit šablonu zařízení v IoT Central. Můžete například vytvořit šablonu zařízení pro senzor, který odesílá telemetrii, například teplotu a vlastnosti, jako je poloha. Z této šablony zařízení může operátor vytvářet a připojovat skutečná zařízení.
Následující snímek obrazovky ukazuje příklad šablony zařízení:
Šablona zařízení obsahuje následující části:
- Model – Pomocí modelu můžete definovat, jak vaše zařízení bude pracovat s aplikací IoT Central. Každý model má jedinečné ID modelu a definuje možnosti zařízení. Funkce jsou seskupené do rozhraní. Rozhraní umožňují opakovaně používat komponenty napříč modely nebo používat dědičnost k rozšíření sady funkcí.
- Nezpracovaná data – zobrazí nezpracovaná data odeslaná vaším určeným zařízením s náhledem. Toto zobrazení je užitečné při ladění šablony zařízení nebo řešení potíží.
- Zobrazení – pomocí zobrazení můžete vizualizovat data ze zařízení a formulářů pro správu a řízení zařízení.
Další informace najdete v tématu Co jsou šablony zařízení?.
Informace o správě šablon zařízení pomocí rozhraní IoT Central REST API najdete v tématu Použití rozhraní IoT Central REST API ke správě šablon zařízení.
Vytvořit šablonu zařízení
Šablony zařízení můžete vytvořit několika způsoby:
- Navrhněte šablonu zařízení v grafickém uživatelském rozhraní IoT Central.
- Importujte šablonu zařízení z katalogu zařízení Azure Certified for IoT. Volitelně můžete šablonu zařízení přizpůsobit vašim požadavkům v IoT Central.
- Když se zařízení připojí ke službě IoT Central, požádejte ho, aby odeslalo ID modelu, který implementuje. IoT Central používá ID modelu k načtení modelu z úložiště modelu a k vytvoření šablony zařízení. Do šablony zařízení přidejte všechny vlastnosti cloudu a zobrazení, která vaše aplikace IoT Central potřebuje.
- Když se zařízení připojí ke službě IoT Central, nechte ioT Central automaticky vygenerovat definici šablony zařízení z dat, která zařízení odesílá.
- Vytvořte model zařízení pomocí jazyka DTDL (Digital Twin Definition Language) verze 2. Ručně naimportujte model zařízení do aplikace IoT Central. Pak přidejte vlastnosti cloudu a zobrazíte potřeby vaší aplikace IoT Central.
- Do aplikace IoT Central můžete také přidat šablony zařízení pomocí rozhraní API IoT Central REST API ke správě šablon zařízení nebo rozhraní příkazového řádku.
Poznámka
V každém případě musí kód zařízení implementovat možnosti definované v modelu. Implementace kódu zařízení není ovlivněna oddíly vlastností cloudu a zobrazení šablony zařízení.
V této části se dozvíte, jak importovat šablonu zařízení z katalogu a jak ji přizpůsobit pomocí grafického uživatelského rozhraní IoT Central. V tomto příkladu se používá šablona zařízení ESP32-Azure IoT Kit z katalogu zařízení:
- Pokud chcete přidat novou šablonu zařízení, na stránce Šablony zařízení vyberte + Nové.
- Na stránce Vybrat typ se posuňte dolů, dokud nenajdete dlaždici ESP32-Azure IoT Kit v části Použití předkonfigurované šablony zařízení .
- Vyberte dlaždici ESP32-Azure IoT Kit a pak vyberte Další: Zkontrolovat.
- Na stránce Revize vyberte Vytvořit. Název šablony, kterou jste vytvořili, je Řadič snímače. Model zahrnuje komponenty, jako je řadič senzoru, SensorTemp a rozhraní Device Information. Komponenty definují možnosti zařízení ESP32. Mezi možnosti patří telemetrie, vlastnosti a příkazy.
Automaticky vygenerovat šablonu zařízení
Můžete také automaticky vytvořit šablonu zařízení z připojeného zařízení, které ještě není přiřazené k šabloně zařízení. IoT Central používá hodnoty telemetrie a vlastností, které zařízení odesílá k odvození modelu zařízení.
Poznámka
V současné době tato funkce preview nemůže používat telemetrii a vlastnosti komponent. Může generovat pouze možnosti z kořenové telemetrie a vlastností.
Následující kroky ukazují, jak tuto funkci používat:
Připojte zařízení k IoT Central a začněte odesílat data. Když se zobrazí data v zobrazení Nezpracovaná data, vyberte v rozevíracím seznamu Spravovat šablonumožnost Automaticky vytvořit šablonu:
Na stránce Náhled dat proveďte požadované změny nezpracovaných dat a vyberte Vytvořit šablonu:
IoT Central vygeneruje šablonu na základě formátu dat zobrazeného na stránce Náhled dat a přiřadí k ní zařízení. Další změny šablony zařízení, například přejmenování nebo přidání funkcí, můžete provést na stránce Šablony zařízení :
Správa šablony zařízení
Šablonu můžete přejmenovat nebo odstranit ze stránky editoru šablony.
Po definování šablony ji můžete publikovat. Dokud se šablona nepublikuje, nemůžete k ní připojit zařízení a nezobrazí se na stránce Zařízení .
Další informace o úpravách a správě verzí šablon zařízení najdete v tématu Úprava existující šablony zařízení.
Modely
Model definuje, jak vaše zařízení interaguje s aplikací IoT Central. Přizpůsobte si model pomocí dalších možností, přidejte rozhraní pro dědění funkcí nebo přidejte nové komponenty, které jsou založené na jiných rozhraních.
Pokud chcete vytvořit model zařízení, můžete:
- K vytvoření vlastního modelu od začátku použijte IoT Central.
- Import modelu DTDL ze souboru JSON Tvůrce zařízení mohl použít Visual Studio Code k vytvoření modelu zařízení pro vaši aplikaci.
- Vyberte jedno ze zařízení z Katalogu zařízení. Tato možnost naimportuje model zařízení, který výrobce publikoval pro toto zařízení. Model zařízení importovaný tímto způsobem se publikuje automaticky.
Pokud chcete zobrazit ID modelu, vyberte kořenové rozhraní v modelu a vyberte Upravit identitu:
Pokud chcete zobrazit ID komponenty, vyberte Upravit identitu na libovolném rozhraní komponenty v modelu.
Další informace najdete v průvodci modelováním IoT Plug and Play.
Rozhraní a komponenty
Zobrazení a správa rozhraní v modelu zařízení:
Přejděte na stránku Šablony zařízení a vyberte šablonu zařízení, kterou jste vytvořili. Rozhraní jsou uvedená v části Modely šablony zařízení. Následující snímek obrazovky ukazuje příklad kořenového rozhraní řadiče senzorů v šabloně zařízení:
Výběrem tří teček přidáte do kořenového rozhraní zděděné rozhraní nebo komponentu. Další informace o rozhraních a komponentách najdete v průvodci modelováním s několika komponentami .
Pokud chcete exportovat model nebo rozhraní, vyberte Exportovat.
Pokud chcete zobrazit nebo upravit DTDL pro rozhraní nebo funkci, vyberte Upravit DTDL.
Možnosti
Vyberte + Přidat schopnost a přidejte funkce do rozhraní nebo komponenty. Můžete například přidat funkci Target Temperature do komponenty SensorTemp .
Telemetrie
Telemetrie je datový proud hodnot odesílaných ze zařízení, obvykle ze senzoru. Senzor může například hlásit okolní teplotu, jak je znázorněno na následujícím snímku obrazovky:
Následující tabulka ukazuje nastavení konfigurace pro funkci telemetrie:
| Pole | Popis |
|---|---|
| Zobrazovaný název | Zobrazovaný název hodnoty telemetrie používané v zobrazeních a formulářích. |
| Name | Název pole ve zprávě telemetrie. IoT Central vygeneruje hodnotu pro toto pole ze zobrazovaných názvů, ale v případě potřeby můžete zvolit vlastní hodnotu. Toto pole musí být alfanumerické. |
| Typ funkce | Telemetrie. |
| Sémantický typ | Sémantický typ telemetrie, jako je 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 telemetrie, například double, string nebo vector. Dostupné volby jsou určeny sémantickým typem. Schéma není k dispozici pro sémantické typy událostí a stavů. |
| 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. |
| Jednotka | Jednotka pro hodnotu telemetrie, například mph, %nebo °C. |
| Zobrazovací jednotka | Jednotka zobrazení pro zobrazení a formuláře. |
| Komentář | Všechny komentáře k možnosti telemetrie |
| Popis | Popis funkce telemetrie. |
Vlastnosti
Vlastnosti představují hodnoty k určitému bodu v čase. Zapisovatelné vlastnosti můžete nastavit z IoT Central. Zařízení může například pomocí zapisovatelné vlastnosti nechat operátora nastavit cílovou teplotu, jak je znázorněno na následujícím snímku obrazovky:
Následující tabulka ukazuje nastavení konfigurace pro funkci vlastnosti:
| Pole | Popis |
|---|---|
| Zobrazovaný název | Zobrazovaný název hodnoty vlastnosti použité v zobrazeních a formulářích. |
| Name | Název vlastnosti IoT Central vygeneruje hodnotu pro toto pole ze zobrazovaných názvů, ale v případě potřeby můžete zvolit vlastní hodnotu. Toto pole musí být alfanumerické. |
| 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, řetězec nebo vektor. Dostupné volby jsou určeny sémantickým typem. Schéma není k dispozici pro sémantické typy událostí a stavů. |
| Pro zápis | Pokud vlastnost nejde zapisovat, může zařízení hlásit hodnoty vlastností do IoT Central. Pokud je vlastnost zapisovatelná, zařízení může hlásit hodnoty vlastností do služby IoT Central a IoT Central může odesílat aktualizace vlastností do zařízení. |
| 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. |
| Jednotka | Jednotku pro hodnotu vlastnosti, například mph, %nebo °C. |
| Zobrazovací jednotka | Jednotka zobrazení pro zobrazení a formuláře. |
| Komentář | Všechny komentáře k vlastnostem. |
| Popis | Popis funkce vlastnosti. |
| Barva | Toto je rozšíření IoT Central pro DTDL. |
| Min. hodnota | Nastavit minimální hodnotu – Toto je rozšíření IoT Central pro DTDL. |
| Max. hodnota | Nastavit maximální hodnotu – Jedná se o rozšíření IoT Central pro DTDL. |
| Desetinná místa | Toto je rozšíření IoT Central pro DTDL. |
Příkazy
Příkazy zařízení můžete volat z IoT Central. Příkazy volitelně předávají do zařízení parametry a přijímají od zařízení odpověď. Můžete například zavolat příkaz k restartování zařízení během 10 sekund, jak je znázorněno na následujícím snímku obrazovky:
Následující tabulka ukazuje nastavení konfigurace pro funkci příkazu:
| Pole | Popis |
|---|---|
| Zobrazovaný název | Zobrazovaný název příkazu použitého v zobrazeních a formulářích. |
| Name | Název příkazu. IoT Central vygeneruje hodnotu pro toto pole ze zobrazovaných názvů, ale v případě potřeby můžete zvolit vlastní hodnotu. Toto pole musí být alfanumerické. |
| Typ funkce | Příkaz. |
| Fronta, pokud je offline | Pokud je povoleno, můžete příkaz volat, i když je zařízení offline. Pokud to není povolené, můžete příkaz volat jenom v případě, že je zařízení online. |
| Komentář | Všechny komentáře k možnosti příkazu. |
| Popis | Popis možnosti příkazu. |
| Žádost | Pokud je povoleno, definice parametru požadavku, včetně názvu, zobrazovaného názvu, schématu, jednotky a zobrazované jednotky. |
| Odpověď | Pokud je povoleno, definice odpovědi na příkaz, včetně názvu, zobrazovaného názvu, schématu, jednotky a zobrazované jednotky. |
| Počáteční hodnota | Výchozí hodnota parametru. Toto je rozšíření IoT Central pro DTDL. |
Další informace o tom, jak zařízení implementují příkazy, najdete v tématu Telemetrie, vlastnosti a datové části příkazů – Příkazy > a dlouhotrvající příkazy.
Offline příkazy
Pokud je zařízení momentálně offline, můžete zvolit příkazy fronty tak, že v šabloně zařízení povolíte možnost Zařadit do fronty, pokud je offline .
Tato možnost používá IoT Hub zpráv cloud-zařízení k odesílání oznámení do zařízení. Další informace najdete v IoT Hub článku Odesílání zpráv z cloudu do zařízení.
Zprávy z cloudu do zařízení:
- Jedná se o jednosměrná oznámení do zařízení z vašeho řešení.
- Zaručte alespoň jedno doručení zprávy. IoT Hub zachovají zprávy z cloudu do zařízení ve frontách jednotlivých zařízení, což zaručuje odolnost proti chybám připojení a zařízení.
- Vyžadovat, aby zařízení implementovaly obslužnou rutinu zprávy ke zpracování zprávy z cloudu na zařízení.
Poznámka
Offline příkazy se označí, jako durable kdybyste model vyexportujte jako DTDL.
Vlastnosti cloudu
Pomocí cloudových vlastností můžete ukládat informace o zařízeních v IoT Central. Vlastnosti cloudu se nikdy neodesílají do zařízení. Vlastnosti cloudu můžete například použít k uložení jména zákazníka, který zařízení nainstaloval, nebo data poslední služby zařízení.
Tip
Vlastnosti cloudu můžete přidat pouze do kořenové komponenty v modelu.
Následující tabulka ukazuje nastavení konfigurace pro vlastnost cloudu:
| Pole | Popis |
|---|---|
| Zobrazovaný název | Zobrazovaný název hodnoty vlastnosti cloudu, která se používá v zobrazeních a formulářích. |
| Name | Název vlastnosti cloudu. IoT Central vygeneruje hodnotu pro toto pole ze zobrazovaných názvů, ale v případě potřeby můžete zvolit vlastní hodnotu. |
| 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 cloudu, například double, řetězec nebo vektor. Dostupné volby jsou určeny sémantickým typem. |
Zobrazení
Zobrazení umožňují definovat zobrazení a formuláře, které umožňují operátorovi monitorovat zařízení a pracovat s ním. Zobrazení používají vizualizace, jako jsou grafy, k zobrazení telemetrie a hodnot vlastností.
Generování výchozích zobrazení představuje rychlý způsob, jak vizualizovat důležité informace o zařízení. Tři výchozí zobrazení jsou:
Výchozí zobrazení
- Příkazy: Zobrazení s příkazy zařízení a umožňuje operátorovi odeslat je do zařízení.
- Přehled: Zobrazení s telemetrií zařízení, které zobrazuje grafy a metriky.
- O produktu: Zobrazení s informacemi o zařízení, zobrazující vlastnosti zařízení.
Když vyberete Generovat výchozí zobrazení, automaticky se přidají do oddílu Zobrazení vaší šablony zařízení.
Vlastní zobrazení
Přidáním zobrazení do šablony zařízení umožníte operátorům vizualizovat zařízení pomocí grafů a metrik. Do šablony zařízení můžete přidat vlastní zobrazení.
Přidání zobrazení do šablony zařízení:
- Přejděte k šabloně zařízení a vyberte Zobrazení.
- Vyberte Vizualizace zařízení.
- Do pole Název zobrazení zadejte název zobrazení.
- V části Přidat dlaždice vyberte Začít vizuálem a zvolte typ vizuálu pro vaši dlaždici. Pak buď vyberte Přidat dlaždici , nebo vizuál přetáhněte na plátno. Pokud chcete nakonfigurovat dlaždici, vyberte ikonu ozubeného kola.
Pokud chcete zobrazení otestovat, vyberte Konfigurovat zařízení s náhledem. Tato funkce umožňuje zobrazit zobrazení tak, jak ho operátor vidí po publikování. Pomocí této funkce můžete ověřit, že zobrazení zobrazují správná data. Vybírat můžete z těchto možností:
- Žádné zařízení s náhledem.
- Skutečné testovací zařízení, které jste nakonfigurovali pro šablonu zařízení.
- Existující zařízení ve vaší aplikaci pomocí ID zařízení.
Formuláře
Přidáním formulářů do šablony zařízení umožníte operátorům spravovat zařízení zobrazením a nastavením vlastností. Operátoři můžou upravovat pouze vlastnosti cloudu a zapisovatelné vlastnosti zařízení. Pro šablonu zařízení můžete mít více formulářů.
Vyberte uzel Zobrazení a pak vyberte dlaždici Úpravy zařízení a cloudových dat a přidejte nové zobrazení.
Změňte název formuláře na Spravovat zařízení.
Vyberte vlastnosti a vlastnosti cloudu, které chcete přidat do formuláře. Pak vyberte Přidat oddíl.
Vyberte Uložit a uložte nový formulář.
Publikování šablony zařízení
Než budete moct připojit zařízení, které implementuje váš model zařízení, musíte publikovat šablonu zařízení.
Pokud chcete publikovat šablonu zařízení, přejděte na svou šablonu zařízení a vyberte Publikovat.
Po publikování šablony zařízení může operátor přejít na stránku Zařízení a přidat skutečná nebo simulovaná zařízení, která používají vaši šablonu zařízení. Při provádění změn můžete pokračovat v úpravách a uložení šablony zařízení. Pokud chcete tyto změny odeslat operátorovi, aby se zobrazily na stránce Zařízení , musíte pokaždé vybrat Publikovat .
Další kroky
Dalším navrhovaným krokem je přečíst si, jak provést změny v existující šabloně zařízení.