Sdílet prostřednictvím

Připojení zařízení a příjem telemetrických dat

Důležité

Byla vydána nová verze služby Azure Digital Twins. Vzhledem k rozšířeným funkcím 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 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 sjednocením zařízení a senzorů s grafem prostorové inteligence.

Začněte vytvořením prostředku Azure IoT Hub v základním uzlu prostorového grafu. Prostředek IoT Hubu umožňuje odesílání zpráv všem zařízením pod kořenovým prostorem. Po vytvoření IoT Hubu zaregistrujte zařízení se senzory v instanci Digital Twins. Zařízení mohou odesílat data do služby Digital Twins prostřednictvím sady SDK pro zařízení Azure IoT.

Krok za krokem průvodce, jak připojit zařízení, najdete v kurzu o nasazení a konfiguraci služby Digital Twins. Na první pohled jsou následující kroky:

  • Nasaďte instanci služby Digital Twins z portálu Azure Portal.
  • Vytvořte v grafu mezery.
  • Vytvořte prostředek IoT Hubu a přiřaďte ho k prostoru v grafu.
  • Vytvořte zařízení a senzory v grafu a přiřaďte je prostorům vytvořeným v předchozích krocích.
  • Vytvořte matcher pro filtrování telemetrických zpráv na základě podmínek.
  • Vytvořte uživatelem definovanou funkcia 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 zařízení IoT Hubu z API pro správu Digital Twins.
  • Nakonfigurujte připojovací řetězec zařízení na zařízení pomocí sady SDK pro zařízení Azure IoT.

V následujících částech se dozvíte, jak získat připojovací řetězec zařízení služby IoT Hub z rozhraní API pro správu služby Digital Twins. Naučíte se také používat formát telemetrických zpráv ioT Hubu 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žená k senzoru v rámci prostorového grafu. Tento požadavek zajistí, že se data zpracovávají a směrují v příslušném prostorovém kontextu.

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

V následujících příkladech YOUR_MANAGEMENT_API_URL 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 za
NÁZEV_VAŠEHO_INSTANCE Název instance služby Azure Digital Twins
VAŠE_MÍSTO Oblast, ve které je vaše instance hostovaná

Proveďte volání GET v rozhraní API pro zařízení s parametrem includes=ConnectionString pro získání připojovacího řetězce zařízení ioT Hubu. 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 za
YOUR_DEVICE_GUID ID zařízení 
YOUR_MANAGEMENT_API_URL/devices?HardwareIds=YOUR_DEVICE_HARDWARE_ID&includes=ConnectionString
Hodnota parametru Nahradit za
HARDWAROVÉ_ID_PŘÍSTROJE ID hardwaru zařízení

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

Zpráva z zařízení do cloudu

Formát zprávy a datovou část zařízení můžete přizpůsobit tak, aby vyhovoval potřebám vašeho řešení. Použijte libovolný kontrakt dat, který lze serializovat do bajtového pole nebo datového proudu podporovaného třídy 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 kontrakt dat v odpovídající uživatelem definované funkci. Pro zprávu typu zařízení-cloud existuje jenom jeden požadavek. Udržujte sadu vlastností, abyste měli jistotu, že je zpráva správně směrována do modulu zpracování.

Vlastnosti telemetrie

Obsah datové části zprávy mohou být libovolná data o velikosti až 256 kB. U vlastností typu Message.Properties 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 Ano Konstantní hodnota, která identifikuje zprávu systému.
DigitalTwins-SensorHardwareId string(72) Ano Jedinečný identifikátor senzoru, který odesílá zprávu . Tato hodnota musí odpovídat vlastnosti HardwareId objektu, aby ji systém zpracovával. Například 00FF0643BE88-CO2.
CreationTimeUtc string Ne ISO 8601 formátovaný řetězec data, který identifikuje čas vzorkování užitečného zatížení. Například 2018-09-20T07:35:00.8587882-07:00.
Id korelace string Ne Identifikátor UUID, který se používá k trasování událostí v systému. Například cec16751-ab27-405d-8fe6-c68e1412ce1f.

Odeslání zprávy službě Digital Twins

Použijte volání SendEventAsync nebo SendEventBatchAsync pro odeslání zprávy do služby Digital Twins.

Další kroky

  • Last updated on