SDK's voor apparaten en services Azure IoT

Deze verwijzing bevat de Azure-SDK's die u kunt gebruiken om IoT-oplossingen te bouwen, waaronder SDK's voor apparaten, services en beheer voor IoT Hub en Device Provisioning Service (DPS), preview-SDK's voor certificaatbeheer en koppelingen naar Azure Digital Twins besturingsvlak- en gegevensvlak-API's.

SDK's voor apparaten

De SDK's voor Microsoft Azure IoT-apparaten bevatten code waarmee u toepassingen kunt bouwen die verbinding maken met en worden beheerd door Azure IoT Hub-services. Deze SDK's kunnen worden uitgevoerd op een algemeen computerapparaat op basis van MPU, zoals een pc, tablet, smartphone of Raspberry Pi. De SDK's ondersteunen ontwikkeling in C en in moderne beheerde talen, waaronder in C#, Node.js, Python en Java.

De SDK's zijn beschikbaar in meerdere talen en bieden de flexibiliteit om te kiezen welke het beste past bij uw team en scenario.

Language Package bron Quickstarts Voorbeelden Referentie
.NET NuGet GitHub Verbinding maken met IoT Hub Samples Referentie
Python pip GitHub Verbinding maken met IoT Hub Samples Referentie
Node.js npm  GitHub Verbinding maken met IoT Hub Samples Referentie
Java Maven GitHub Verbinding maken met IoT Hub Samples Referentie
C packages GitHub Verbinding maken met IoT Hub Samples Referentie

De Java device SDK bevat samples voor Android.

De SDK voor C-apparaten bevat samples voor iOS die CocoaPods gebruiken.

Waarschuwing

De Azure IoT C SDK is niet geschikt voor ingesloten toepassingen vanwege het geheugenbeheer- en threadingmodel. Zie de opties voor SDK's voor ingesloten apparaten.

Gebruik de apparaat-SDK's om code te ontwikkelen die moet worden uitgevoerd op IoT-apparaten die verbinding maken met IoT Hub of IoT Central.

SDK's voor ingesloten apparaten

Deze SDK's zijn ontworpen en gemaakt om te worden uitgevoerd op apparaten met beperkte reken- en geheugenresources en worden geïmplementeerd met behulp van de C-taal.

De SDK's voor ingesloten apparaten zijn beschikbaar voor meerdere besturingssystemen die de flexibiliteit bieden om te kiezen welke het beste bij uw scenario past.

RTOS SDK bron Voorbeelden Referentie
Eclipse ThreadX Azure RTOS Middleware GitHub Snelstartgidsen Referentie
FreeRTOS FreeRTOS Middleware GitHub Samples Referentie
Ruwe Metalen Azure SDK voor Ingesloten C GitHub Samples Referentie

Gebruik de SDK's voor ingesloten apparaten om code te ontwikkelen die moet worden uitgevoerd op IoT-apparaten die verbinding maken met IoT Hub of IoT Central.

Zie C SDK- en Embedded C SDK-gebruiksscenario's voor meer informatie over het gebruik van de SDK's voor ingesloten apparaten.

Levenscyclus en ondersteuning van Device SDK

In deze sectie vindt u een overzicht van de levenscyclus en het ondersteuningsbeleid voor de Azure IoT Device SDK. Zie Azure SDK Levenscyclus en ondersteuningsbeleid voor meer informatie.

Levenscyclus van pakketten

Pakketten worden uitgebracht in de volgende categorieën. Elke categorie heeft een gedefinieerde ondersteuningsstructuur.

  1. Bèta - ook wel preview- of releasekandidaat genoemd. Beschikbaar voor vroege toegang en feedbackdoeleinden en wordt niet aanbevolen voor gebruik in productie. De ondersteuning van de preview-versie is beperkt tot GitHub problemen. Preview-releases zijn doorgaans minder dan zes maanden actief, waarna ze zijn afgeschaft of als actief worden uitgebracht.

  2. Actief : algemeen beschikbaar en volledig ondersteund, ontvangt nieuwe functie-updates, evenals bug- en beveiligingsoplossingen. Gebruik de nieuwste versie omdat die versie fixes en updates ontvangt.

  3. Afgeschaft - Vervangen door een recentere release. De deprecatie vindt plaats op hetzelfde moment dat de nieuwe release actief wordt. Afgeschafte releases hebben betrekking op de meest kritieke bugfixes en beveiligingsoplossingen voor nog eens 12 maanden.

Ondersteuning vinden

Als u problemen ondervindt tijdens het gebruik van de Azure IoT SDK's, zoekt u ondersteuning via de volgende opties:

  • Rapporteringsfouten : alle klanten kunnen bugs melden op de pagina met problemen voor de GitHub opslagplaats die is gekoppeld aan de relevante SDK.

  • Microsoft klantondersteuningsteam - Gebruikers met een ondersteuningsplan kunnen rechtstreeks vanuit de Azure portal contact opnemen met het Microsoft klantenondersteuningsteam.

SERVICE-SDK's voor IoT Hub

De SDK's van de Azure IoT-service bevatten code om toepassingen te bouwen die rechtstreeks met IoT Hub werken om apparaten en beveiliging te beheren.

Platform Package Codeopslagplaats Voorbeelden Referentie
.NET NuGet GitHub Samples Referentie
Java Maven GitHub Samples Referentie
Node npm GitHub Samples Referentie
Python pip GitHub Samples Referentie

Zie IoT Plug and Play serviceontwikkelaarshandleiding voor meer informatie over het gebruik van de service-SDK's voor interactie met apparaten via een IoT-hub.

IOT HUB beheer-SDK's

De IoT Hub beheer-SDK's helpen u bij het bouwen van back-endtoepassingen die de IoT-hubs in uw Azure-abonnement beheren.

Platform Package Codeopslagplaats Referentie
.NET NuGet GitHub Referentie
Java Maven GitHub Referentie
Node.js npm GitHub Referentie
Python pip GitHub Referentie

Alternatieven voor de beheer-SDK's zijn de Azure CLI, PowerShell en REST-API.

DPS-apparaat-SDK's

De SDK's van het DPS-apparaat bieden implementaties van de Register-API en andere API's die door apparaten worden aangeroepen om via DPS voorzieningen te treffen. De APPARAAT-SDK's kunnen worden uitgevoerd op algemene MPU-computingapparaten, zoals een pc, tablet, smartphone of Raspberry Pi. De SDK's ondersteunen ontwikkeling in C en in moderne beheerde talen, waaronder in C#, Node.js, Python en Java.

De volgende tabel bevat de apparaat-SDK's die beschikbaar zijn voor elke ondersteunde taal.

Platform Package Codeopslagplaats Voorbeelden Snelstart Referentie
.NET NuGet GitHub Samples Quickstart Referentie
C apt-get, MBED, Arduino IDE of iOS GitHub Samples Quickstart Referentie
Java Maven GitHub Samples Quickstart Referentie
Node.js npm GitHub Samples Quickstart Referentie
Python pip GitHub Samples Quickstart Referentie

Waarschuwing

De hierboven vermelde C SDK is niet geschikt voor ingesloten toepassingen vanwege het geheugenbeheer- en threadingmodel. Raadpleeg de SDK's voor ingesloten apparaten.

SDK's voor ingesloten DPS-apparaten

Deze SDK's zijn ontworpen en gemaakt om te worden uitgevoerd op apparaten met beperkte reken- en geheugenresources en worden geïmplementeerd met behulp van de C-taal.

RTOS SDK bron Voorbeelden Referentie
Eclipse ThreadX Azure RTOS Middleware GitHub Snelstartgidsen Referentie
FreeRTOS FreeRTOS Middleware GitHub Samples Referentie
Ruwe Metalen Azure SDK voor Ingesloten C GitHub Samples Referentie

Meer informatie over de apparaat- en ingesloten apparaat-SDK's in IoT SDK's.

DPS-service-SDKs

Met de SDK's van de DPS-service kunt u back-end toepassingen bouwen voor het beheren van inschrijvingen en registratiegegevens in DPS-exemplaren.

Platform Package Codeopslagplaats Voorbeelden Snelstart Referentie
.NET NuGet GitHub Samples Quickstart Referentie
Java Maven GitHub Samples Quickstart Referentie
Node.js npm GitHub Samples Quickstart Referentie

DPS-beheer-SDK's

Met de DPS-beheer-SDK's kunt u back-endtoepassingen bouwen die de DPS-exemplaren en de bijbehorende metagegevens in uw Azure-abonnement beheren.

Platform Package Codeopslagplaats Referentie
.NET NuGet GitHub Referentie
Java Maven GitHub Referentie
Node.js npm GitHub Referentie
Python pip GitHub Referentie

SDK's voor certificaatbeheer (preview)

Gebruik de volgende instructies en voorbeelden voor SDK's die ondersteuning bieden voor Microsoft X.509-certificaatbeheer in preview. Als u certificaatbeheer-SDK's in preview wilt gebruiken, moet u Azure IoT Hub gebruiken met een gekoppeld DPS-exemplaar en moeten apparaten worden ingericht via DPS.

APPARAAT-SDK's voor certificaatbeheer (preview)

De volgende tabel bevat de platform-SDK's die momenteel ondersteuning bieden voor Microsoft X.509-certificaatbeheer in preview.

Language Package Bron/vertakking Voorbeelden
.NET NuGet Azure/azure-iot-sdk-csharp op feature/iot-csr-preview CertificateSigningRequestSample
Python pip Azure/azure-iot-sdk-python at feature/iot-csr-preview cert-mgmt samples
Node.js npm Niet beschikbaar Niet beschikbaar
Java Maven Azure/azure-iot-sdk-java at feature/csr certificate-signing-sample
C packages Azure/azure-iot-sdk-c at feature/dps-csr-preview iothub_ll_client_sample_certificate_signing_request

Ingesloten apparaat-SDK's voor certificaatbeheer (preview)

De volgende tabel bevat de ingesloten SDK's die momenteel ondersteuning bieden voor Microsoft X.509-certificaatbeheer in preview.

RTOS SDK bron Voorbeelden
FreeRTOS FreeRTOS Middleware Azure/azure-iot-middleware-freertos op feature/dps-csr-preview Niet beschikbaar
Ruwe Metalen Azure SDK voor Ingesloten C Azure/azure-sdk-for-c at feature/dps-csr-preview paho_iot_hub_csr_sample.c

API's voor Azure Digital Twins besturingsvlak

De API's van het besturingsvlak zijn ARM API's die worden gebruikt om uw Azure Digital Twins exemplaar als geheel te beheren, zodat ze bewerkingen behandelen, zoals het maken of verwijderen van uw hele exemplaar. U gebruikt deze API's ook om eindpunten te maken en te verwijderen.

Als u de API's rechtstreeks wilt aanroepen, verwijst u naar de meest recente Swagger-map in de control plane Swagger-opslagplaats. Deze map bevat ook een map met voorbeelden waarin het gebruik wordt weergegeven.

Dit zijn de SDK's die momenteel beschikbaar zijn voor de Azure Digital Twins besturingsvlak-API's.

SDK-taal Pakketlink Referentiedocumentatie Broncode
.NET (C#) Azure. ResourceManager.DigitalTwins op NuGet Deductie voor Azure DigitalTwins SDK voor .NET Microsoft Azure Digital Twins-beheerclientbibliotheek voor .NET op GitHub
Java azure-resourcemanager-digitaltwins op Maven Naslaginformatie voor Resource Management - Digital Twins Azure Resource Manager AzureDigitalTwins-clientbibliotheek voor Java op GitHub
JavaScript AzureDigitalTwinsManagement-clientbibliotheek voor JavaScript op npm AzureDigitalTwinsManagement-clientbibliotheek voor JavaScript op GitHub
Python azure-mgmt-digitaltwins op PyPI Microsoft-Azure SDK voor Python op GitHub
Go azure-sdk-for-go/services/digitaltwins/mgmt Azure SDK voor Go on GitHub

API's voor Azure Digital Twins gegevensvlak

De API's voor het gegevensvlak zijn de Azure Digital Twins API's die worden gebruikt om de elementen binnen uw Azure Digital Twins exemplaar te beheren. Ze omvatten bewerkingen zoals het maken van routes, het uploaden van modellen, het maken van relaties en het beheren van digitale tweelingen, en kunnen over het algemeen onderverdeeld worden in de volgende categorieën:

  • DigitalTwinModels - De categorie DigitalTwinModels bevat API's voor het beheren van de models in een Azure Digital Twins-exemplaar. Beheeractiviteiten omvatten uploaden, valideren, ophalen en verwijderen van modellen die zijn geschreven in DTDL.
  • DigitalTwins - De categorie DigitalTwins bevat de API's waarmee ontwikkelaars digital twins en hun relaties in een Azure Digital Twins exemplaar kunnen maken, wijzigen en verwijderen.
  • Query - Met de categorie Query kunnen ontwikkelaars sets met digitale tweelingen vinden in de tweelinggrafiek via relaties.
  • Event Routes - De categorie Gebeurtenisroutes bevat API's voor het routeren van gegevens, via het systeem en naar downstreamservices.
  • Import Jobs- Met de API Voor importtaken kunt u een langdurige, asynchrone actie beheren om modellen, tweelingen en relaties bulksgewijs te importeren.
  • - De API voor het verwijderen van taken stelt u in staat om een langlopende, asynchrone actie te beheren om alle modellen, tweelingen en relaties in een exemplaar te verwijderen.

Als u de API's rechtstreeks wilt aanroepen, verwijst u naar de meest recente Swagger-map in de datavlak Swagger-opslagplaats. Deze map bevat ook een map met voorbeelden waarin het gebruik wordt weergegeven. U kunt ook de api-referentiedocumentatie voor het gegevensvlak bekijken.

Dit zijn de SDK's die momenteel beschikbaar zijn voor de Azure Digital Twins gegevensvlak-API's.

SDK-taal Pakketlink Referentiedocumentatie Broncode
.NET (C#) Azure. DigitalTwins.Core op NuGet Deductie voor Azure IoT Digital Twins-clientbibliotheek voor .NET Azure IoT Digital Twins-clientbibliotheek voor .NET op GitHub
Java com.azure:azure-digitaltwins-core op Maven Deductie voor Azure Digital Twins SDK voor Java Azure IoT Digital Twins-clientbibliotheek voor Java op GitHub
JavaScript Azure Azure Digital Twins Core-clientbibliotheek voor JavaScript op npm Reference for @azure/digital-twins-core Azure Azure Digital Twins Core-clientbibliotheek voor JavaScript op GitHub
Python Azure Azure Digital Twins Core-clientbibliotheek voor Python op PyPI Naslaginformatie voor azure-digitaltwins-core Azure Azure Digital Twins Core-clientbibliotheek voor Python op GitHub

Volgende stappen 

Voorgestelde volgende stappen zijn onder andere: