Apparaatconnectiviteit en inkomende telemetriegegevens

  • Artikel

Belangrijk

Er is een nieuwe versie van de Azure Digital Twins-service uitgebracht. In het licht van de uitgebreide mogelijkheden van de nieuwe service is de oorspronkelijke Azure Digital Twins-service (beschreven in deze documentatieset) buiten gebruik gesteld.

Als u de documentatie voor de nieuwe service wilt bekijken, gaat u naar de actieve Documentatie voor Azure Digital Twins.

De telemetriegegevens die worden verzonden door apparaten en sensoren vormen de backbone van elke IoT-oplossing. Het vertegenwoordigen van deze verschillende resources en het beheren ervan binnen de context van een locatie zijn belangrijke zorgen bij het ontwikkelen van IoT-apps. Azure Digital Twins vereenvoudigt het ontwikkelen van IoT-oplossingen door apparaten en sensoren te combineren met een grafiek voor ruimtelijke intelligentie.

Maak een Azure IoT Hub resource in de hoofdmap van de ruimtelijke grafiek om aan de slag te gaan. Met de IoT Hub-resource kunnen alle apparaten onder de hoofdruimte berichten verzenden. Nadat de IoT Hub is gemaakt, registreert u apparaten met sensoren in het Digital Twins-exemplaar. De apparaten kunnen gegevens verzenden naar een Digital Twins-service via de Azure IoT Device SDK.

Lees de zelfstudie voor het implementeren en configureren van Digital Twins voor stapsgewijze instructies voor het onboarden van apparaten. In één oogopslag zijn de stappen:

  • Implementeer een Digital Twins-exemplaar vanuit de Azure Portal.
  • Maak spaties in uw grafiek.
  • Maak een IoT Hub resource en wijs deze toe aan een ruimte in uw grafiek.
  • Maak apparaten en sensoren in uw grafiek en wijs ze toe aan de ruimten die in de vorige stappen zijn gemaakt.
  • Maak een matcher om telemetrieberichten te filteren op basis van voorwaarden.
  • Maak een door de gebruiker gedefinieerde functie en wijs deze toe aan een ruimte in de grafiek voor aangepaste verwerking van uw telemetrieberichten.
  • Wijs een rol toe om de door de gebruiker gedefinieerde functie toegang te geven tot de grafiekgegevens.
  • Haal het IoT Hub apparaat connection string op uit de Digital Twins Management-API's.
  • Configureer het apparaat connection string op het apparaat met de Azure IoT Device SDK.

In de volgende secties leert u hoe u het IoT Hub apparaat kunt ophalen connection string van de Digital Twins Management-API. U leert ook hoe u de IoT Hub telemetrieberichtindeling gebruikt om telemetrie op basis van sensoren te verzenden. Voor Digital Twins is elk stukje telemetrie vereist dat deze wordt gekoppeld aan een sensor in de ruimtelijke grafiek. Deze vereiste zorgt ervoor dat de gegevens worden verwerkt en gerouteerd binnen de juiste ruimtelijke context.

Het IoT Hub apparaat connection string ophalen uit de Management-API

In de onderstaande YOUR_MANAGEMENT_API_URL voorbeelden verwijst u naar de URI van de Digital Twins-API's:

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/api/v1.0
Name Vervangen door
YOUR_INSTANCE_NAME De naam van uw Azure Digital Twins-exemplaar
YOUR_LOCATION De regio waarop uw exemplaar wordt gehost

Voer een GET-aanroep uit op de Apparaat-API met een includes=ConnectionString parameter om het IoT Hub apparaat op te halen connection string. Filter op de apparaat-GUID of de hardware-id om het opgegeven apparaat te vinden.

YOUR_MANAGEMENT_API_URL/devices/YOUR_DEVICE_GUID?includes=ConnectionString
Parameter Vervangen door
YOUR_DEVICE_GUID De apparaat-id 
YOUR_MANAGEMENT_API_URL/devices?HardwareIds=YOUR_DEVICE_HARDWARE_ID&includes=ConnectionString
Parameterwaarde Vervangen door
YOUR_DEVICE_HARDWARE_ID De hardware-id van het apparaat

Kopieer in de nettolading van het antwoord de eigenschap connectionString van het apparaat. U gebruikt deze wanneer u de Azure IoT-apparaat-SDK aanroept om gegevens naar Digital Twins te verzenden.

Apparaat-naar-cloudbericht

U kunt de berichtindeling en nettolading van uw apparaat aanpassen aan de behoeften van uw oplossing. Gebruik elk gegevenscontract dat kan worden geserialiseerd in een bytematrix of stream die wordt ondersteund door de azure IoT Device Client Message-klasse, Message(byte[] byteArray). Het bericht kan een aangepaste binaire indeling van uw keuze zijn, zolang u het gegevenscontract in een bijbehorende door de gebruiker gedefinieerde functie decodert. Er is slechts één vereiste voor een apparaat-naar-cloud-bericht. Onderhoud een set eigenschappen om ervoor te zorgen dat uw bericht op de juiste manier wordt doorgestuurd naar de verwerkingsengine.

Telemetrie-eigenschappen

De inhoud van de nettolading van een bericht kan willekeurige gegevens van maximaal 256 kB groot zijn. Er zijn enkele vereisten verwacht voor eigenschappen van het Message.Properties type. De tabel bevat de vereiste en optionele eigenschappen die door het systeem worden ondersteund.

Naam van eigenschap Waarde Vereist Beschrijving
DigitalTwins-Telemetry 1.0 Yes Een constante waarde die een bericht aan het systeem identificeert.
DigitalTwins-SensorHardwareId string(72) Yes Een unieke id van de sensor die het bericht verzendt. Deze waarde moet overeenkomen met de hardware-id-eigenschap van een object, zodat het systeem deze kan verwerken. Bijvoorbeeld 00FF0643BE88-CO2.
CreationTimeUtc string No Een met ISO 8601 opgemaakte datumtekenreeks die de steekproeftijd van de nettolading identificeert. Bijvoorbeeld 2018-09-20T07:35:00.8587882-07:00.
CorrelationId string No Een UUID die wordt gebruikt om gebeurtenissen in het systeem te traceren. Bijvoorbeeld cec16751-ab27-405d-8fe6-c68e1412ce1f.

Uw bericht verzenden naar Digital Twins

Gebruik de DeviceClient SendEventAsync - of SendEventBatchAsync-aanroep om uw bericht naar Digital Twins te verzenden.

Volgende stappen