Sdílet prostřednictvím

Možnosti připojení zařízení a příchozí přenos telemetrických dat

  • Článek

Důležité

Byla vydána nová verze služby Azure Digital Twins. Vzhledem k rozšířeným možnostem nové služby se původní služba Azure Digital Twins (popsaná v této sadě dokumentace) vyřadila z provozu.

Pokud chcete zobrazit dokumentaci k nové službě, navštivte aktivní dokumentaci ke službě Azure Digital Twins.

Telemetrická data odesílaná zařízeními a senzory tvoří páteř jakéhokoli řešení IoT. Jak tyto různé prostředky reprezentovat a spravovat je v kontextu umístění, jsou hlavními obavami při vývoji aplikací IoT. Azure Digital Twins zjednodušuje proces vývoje řešení IoT díky sjednocení zařízení a senzorů s grafem prostorové inteligence.

Začněte vytvořením Azure IoT Hub prostředku v kořenovém adresáři prostorového grafu. Prostředek IoT Hub umožňuje posílat zprávy všem zařízením pod kořenovým prostorem. Po vytvoření IoT Hub zaregistrujte zařízení pomocí senzorů v instanci Služby Digital Twins. Zařízení můžou odesílat data do služby Digital Twins prostřednictvím sady SDK zařízení Azure IoT.

Podrobné pokyny k nasazení a konfiguraci služby Digital Twins najdete v kurzu nasazení a konfiguraci služby Digital Twins. Na první pohled jsou následující kroky:

  • Nasaďte instanci služby Digital Twins z Azure Portal.
  • Vytvořte v grafu mezery.
  • Vytvořte IoT Hub prostředek a přiřaďte ho k prostoru v grafu.
  • Vytvořte zařízení a senzory v grafu a přiřaďte je k prostorům vytvořeným v předchozích krocích.
  • Vytvořte shodovač pro filtrování zpráv telemetrie na základě podmínek.
  • Vytvořte uživatelem definovanou funkci a přiřaďte ji k prostoru v grafu pro vlastní zpracování zpráv telemetrie.
  • Přiřaďte roli, která uživateli definované funkci umožní přístup k datům grafu.
  • Získejte připojovací řetězec IoT Hub zařízení z rozhraní API pro správu služby Digital Twins.
  • Nakonfigurujte připojovací řetězec zařízení v zařízení pomocí sady SDK zařízení Azure IoT.

V následujících částech se dozvíte, jak získat připojovací řetězec IoT Hub zařízení z rozhraní API služby Digital Twins Management. Dozvíte se také, jak používat formát IoT Hub telemetrických zpráv k odesílání telemetrických dat založených na senzorech. Služba Digital Twins vyžaduje každou telemetrii, kterou přijímá, aby byla přidružena k senzoru v rámci prostorového grafu. Tento požadavek zajišťuje zpracování a směrování dat v příslušném prostorovém kontextu.

Získání připojovacího řetězce IoT Hub zařízení z rozhraní API pro správu

V následujících YOUR_MANAGEMENT_API_URL příkladech se odkazuje na identifikátor URI rozhraní API služby Digital Twins:

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/api/v1.0
Název Nahradit hodnotou
YOUR_INSTANCE_NAME Název vaší instance Azure Digital Twins
YOUR_LOCATION Oblast, ve které je vaše instance hostovaná

Volání GET v rozhraní API pro zařízení s parametrem includes=ConnectionString získejte připojovací řetězec IoT Hub zařízení. Vyfiltrujte podle identifikátoru GUID zařízení nebo ID hardwaru a vyhledejte dané zařízení.

YOUR_MANAGEMENT_API_URL/devices/YOUR_DEVICE_GUID?includes=ConnectionString
Parametr Nahradit hodnotou
YOUR_DEVICE_GUID ID zařízení 
YOUR_MANAGEMENT_API_URL/devices?HardwareIds=YOUR_DEVICE_HARDWARE_ID&includes=ConnectionString
Hodnota parametru Nahradit hodnotou
YOUR_DEVICE_HARDWARE_ID ID hardwaru zařízení

V datové části odpovědi zkopírujte vlastnost connectionString zařízení. Použijete ji při volání sady SDK zařízení Azure IoT k odesílání dat do služby Digital Twins.

Zpráva zařízení-cloud

Formát zpráv a datovou část zařízení můžete přizpůsobit tak, aby vyhovovala potřebám vašeho řešení. Použijte libovolný kontrakt dat, který lze serializovat do pole bajtů nebo datového proudu podporovaného třídou zpráv klienta zařízení Azure IoT, Message(byte[] byteArray). Zpráva může být vlastní binární formát podle vašeho výběru, pokud dekódujete datový kontrakt v odpovídající uživatelem definované funkci. Zpráva typu zařízení-cloud má jenom jeden požadavek. Udržujte sadu vlastností, abyste měli jistotu, že je zpráva správně směrována do stroje pro zpracování.

Vlastnosti telemetrie

Obsah datové části zprávy může mít libovolná data o velikosti až 256 kB. U vlastností Message.Properties typu se očekává několik požadavků. V tabulce jsou uvedeny požadované a volitelné vlastnosti podporované systémem.

Název vlastnosti Hodnota Povinné Popis
DigitalTwins-Telemetry 1.0 Yes Konstantní hodnota, která identifikuje zprávu systému.
DigitalTwins-SensorHardwareId string(72) Yes Jedinečný identifikátor senzoru, který odešle zprávu. Tato hodnota musí odpovídat vlastnosti HardwareId objektu, aby ji systém zpracovával. Například, 00FF0643BE88-CO2.
Creationtimeutc string No Formátovaný řetězec data ISO 8601 , který identifikuje čas vzorkování datové části. Například, 2018-09-20T07:35:00.8587882-07:00.
CorrelationId string No Identifikátor UUID, který se používá ke sledování událostí v celém systému. Například, cec16751-ab27-405d-8fe6-c68e1412ce1f.

Odeslání zprávy do služby Digital Twins

K odeslání zprávy do služby Digital Twins použijte volání DeviceClient SendEventAsync nebo SendEventBatchAsync .

Další kroky