Azure IoT SDK

Le tabelle seguenti elencano i vari SDK che è possibile usare per compilare soluzioni IoT.

SDK del dispositivo

Microsoft Azure IoT SDK per dispositivi contiene codice che facilita la compilazione delle applicazioni che si connettono e sono gestite dai servizi hub IoT di Azure. Questi SDK possono essere eseguiti in un dispositivo di elaborazione generico basato su MPU, ad esempio un PC, un tablet, uno smartphone o Raspberry Pi. Gli SDK supportano lo sviluppo in C e in linguaggi moderni gestiti, inclusi C#, Node.JS, Python e Java.

Gli SDK sono disponibili in più lingue che offrono la flessibilità necessaria per scegliere il team e lo scenario più adatti.

Lingua Pacchetto Origine Avvi rapidi Esempi Riferimento
.NET NuGet GitHub Connettersi a hub IoT Esempi Riferimento
Python pip GitHub Connettersi a hub IoT Esempi Riferimento
Node.js npm  GitHub Connettersi a hub IoT Esempi Riferimento
Java Maven GitHub Connettersi a hub IoT Esempi Riferimento
C packages GitHub Connettersi a hub IoT Esempi Riferimento

Java Device SDK include esempi per Android.

L'SDK per dispositivi C include esempi per iOS che usano CocoaPods.

Avviso

Azure IoT C SDK non è adatto per le applicazioni incorporate a causa della gestione della memoria e del modello di threading. Per le opzioni sdk per dispositivi incorporati, vedere sdk per dispositivi incorporati.

Usare gli SDK per dispositivi per sviluppare codice da eseguire nei dispositivi IoT che si connettono a hub IoT o IoT Central.

Per altre informazioni su come usare gli SDK per dispositivi, vedere Informazioni sullo sviluppo di dispositivi e applicazioni di Azure IoT.

SDK per i dispositivi integrati

Questi SDK sono stati progettati e creati per l'esecuzione su dispositivi con risorse di calcolo e memoria limitate e vengono implementati usando il linguaggio C.

Gli SDK per dispositivi incorporati sono disponibili per più sistemi operativi che offrono la flessibilità necessaria per scegliere il più adatto allo scenario.

RTOS SDK Origine Esempi Riferimento
Eclipse ThreadX Azure RTOS Middleware GitHub Avvio rapido Riferimento
FreeRTOS FreeRTOS Middleware GitHub Esempi Riferimento
Bare Metal Azure SDK per Embedded C GitHub Esempi Riferimento

Usare gli SDK dei dispositivi incorporati per sviluppare codice da eseguire nei dispositivi IoT che si connettono a hub IoT o IoT Central.

Per altre informazioni su quando usare gli SDK per dispositivi incorporati, vedere Gli scenari di utilizzo di C SDK e Embedded C SDK.

Ciclo di vita e supporto di Device SDK

Questa sezione riepiloga il ciclo di vita di Azure IoT Device SDK e i criteri di supporto. Per altre informazioni, vedere Criteri relativi al ciclo di vita e al supporto di Azure SDK.

Ciclo di vita del pacchetto

I pacchetti vengono rilasciati nelle categorie seguenti. Ogni categoria ha una struttura di supporto definita.

  1. Beta : noto anche come Anteprima o Versione candidata. Disponibile per scopi di accesso anticipato e feedback e non è consigliato per l'uso nell'ambiente di produzione. Il supporto della versione di anteprima è limitato ai problemi di GitHub. Le versioni di anteprima sono in genere attive per meno di sei mesi, dopo le quali sono deprecate o rilasciate come attive.

  2. Attivo : disponibile a livello generale e completamente supportato, riceve nuovi aggiornamenti delle funzionalità, nonché correzioni di bug e sicurezza. È consigliabile che i clienti usino la versione più recente perché tale versione riceve correzioni e aggiornamenti.

  3. Deprecato : sostituito da una versione più recente. La deprecazione viene eseguita contemporaneamente alla nuova versione. Le versioni deprecate riguardano le correzioni di bug e le correzioni di sicurezza più critiche per altri 12 mesi.

Ottenere supporto

Se si verificano problemi durante l'uso degli SDK di Azure IoT, esistono diversi modi per cercare supporto:

  • Segnalazione di bug : tutti i clienti possono segnalare bug nella pagina dei problemi per il repository GitHub associato all'SDK pertinente.

  • Team di supporto tecnico Microsoft: gli utenti con un piano di supporto possono rivolgersi al team di supporto tecnico Microsoft creando un ticket di supporto dal portale di Azure.

SDK servizio hub IoT

I componenti Azure Iot SDK per servizi contengono codice che facilita la compilazione di applicazioni che interagiscono direttamente con l'hub IoT per gestire dispositivi e sicurezza.

Piattaforma Pacchetto Repository del codice Esempi Riferimento
.NET NuGet GitHub Esempi Riferimento
Java Maven GitHub Esempi Riferimento
Node npm GitHub Esempi Riferimento
Python pip GitHub Esempi Riferimento

Per altre informazioni sull'uso degli SDK del servizio per interagire con i dispositivi tramite un hub IoT, vedere Plug and Play IoT guida per sviluppatori di servizi.

SDK di gestione hub IoT

Gli SDK di gestione hub IoT consentono di creare applicazioni back-end che gestiscono gli hub IoT nella sottoscrizione di Azure.

Piattaforma Pacchetto Repository di codice Riferimento
.NET NuGet GitHub Riferimento
Java Maven GitHub Riferimento
Node.js npm GitHub Riferimento
Python pip GitHub Riferimento

Le alternative agli SDK di gestione includono l'interfaccia della riga di comando di Azure, PowerShell e l'API REST.

SDK per dispositivi del servizio Device Provisioning

Gli SDK per dispositivi DPS forniscono implementazioni dell'API Register e di altri dispositivi che chiamano per effettuare il provisioning tramite DPS. Gli SDK per i dispositivi possono essere eseguiti su dispositivi di elaborazione basati su MPU generici, ad esempio PC, tablet, smartphone o Raspberry Pi. Gli SDK supportano lo sviluppo in C e in linguaggi moderni gestiti, inclusi C#, Node.JS, Python e Java.

Piattaforma Pacchetto Repository di codice Esempi Guida introduttiva Riferimento
.NET NuGet GitHub Esempi Guida introduttiva Riferimento
A apt-get, MBED, IDE Arduino o iOS GitHub Esempi Guida introduttiva Riferimento
Java Maven GitHub Esempi Guida introduttiva Riferimento
Node.js npm GitHub Esempi Guida introduttiva Riferimento
Python pip GitHub Esempi Guida introduttiva Riferimento

Avviso

L'SDK C elencato in precedenza non è adatto per le applicazioni incorporate a causa della gestione della memoria e del modello di threading. Per i dispositivi incorporati, fare riferimento agli SDK per dispositivi incorporati.

SDK per dispositivi incorporati dps

Questi SDK sono stati progettati e creati per l'esecuzione su dispositivi con risorse di calcolo e memoria limitate e vengono implementati usando il linguaggio C.

RTOS SDK Origine Esempi Riferimento
Eclipse ThreadX Azure RTOS Middleware GitHub Avvio rapido Riferimento
FreeRTOS FreeRTOS Middleware GitHub Esempi Riferimento
Bare Metal Azure SDK per Embedded C GitHub Esempi Riferimento

Altre informazioni sugli SDK per dispositivi e dispositivi incorporati negli SDK IoT.

SDK del servizio Device Provisioning

Gli SDK del servizio Device Provisioning consentono di creare applicazioni back-end per gestire le registrazioni e i record di registrazione nelle istanze del servizio Device Provisioning.

Piattaforma Pacchetto Repository di codice Esempi Guida introduttiva Riferimento
.NET NuGet GitHub Esempi Guida introduttiva Riferimento
Java Maven GitHub Esempi Guida introduttiva Riferimento
Node.js npm GitHub Esempi Guida introduttiva Riferimento

SDK di gestione del servizio Device Provisioning

Gli SDK di gestione dps consentono di creare applicazioni back-end che gestiscono le istanze del servizio Device Provisioning e i relativi metadati nella sottoscrizione di Azure.

Piattaforma Pacchetto Repository di codice Riferimento
.NET NuGet GitHub Riferimento
Java Maven GitHub Riferimento
Node.js npm GitHub Riferimento
Python pip GitHub Riferimento

API del piano di controllo di Gemelli digitali di Azure

Le API del piano di controllo sono API ARM usate per gestire l'istanza di Gemelli digitali di Azure nel suo complesso, in modo da coprire operazioni come la creazione o l'eliminazione dell'intera istanza. Queste API verranno usate anche per creare ed eliminare endpoint.

Per chiamare direttamente le API, fare riferimento alla cartella Swagger più recente nel repository Swagger del piano di controllo. Questa cartella include anche una cartella di esempi che mostrano l'utilizzo.

Ecco gli SDK attualmente disponibili per le API del piano di controllo di Gemelli digitali di Azure.

Linguaggio SDK Collegamento al pacchetto Documentazione di riferimento Codice sorgente
.NET (C#) Azure.ResourceManager.DigitalTwins in NuGet Informazioni di riferimento su Azure DigitalTwins SDK per .NET Libreria client di gestione di Gemelli digitali di Microsoft Azure per .NET in GitHub
Java azure-resourcemanager-digitaltwins in Maven Informazioni di riferimento su Gestione risorse - Gemelli digitali Libreria client di Azure Resource Manager AzureDigitalTwins per Java su GitHub
JavaScript Libreria client AzureDigitalTwinsManagement per JavaScript in npm Libreria client AzureDigitalTwinsManagement per JavaScript in GitHub
Python azure-mgmt-digitaltwins in PyPI Microsoft Azure SDK per Python in GitHub
Go azure-sdk-for-go/services/digitaltwins/mgmt Azure SDK for Go su GitHub

API del piano dati di Gemelli digitali di Azure

Le API del piano dati sono le API di Gemelli digitali di Azure usate per gestire gli elementi all'interno dell'istanza di Gemelli digitali di Azure. Includono operazioni come la creazione di route, il caricamento di modelli, la creazione di relazioni e la gestione dei gemelli e possono essere suddivise in modo ampio nelle categorie seguenti:

  • DigitalTwinModels - La categoria DigitalTwinModels contiene API per gestire i modelli in un'istanza di Gemelli digitali di Azure. Le attività di gestione includono caricamento, convalida, recupero ed eliminazione di modelli creati in DTDL.
  • DigitalTwins - La categoria DigitalTwins contiene le API che consentono agli sviluppatori di creare, modificare ed eliminare gemelli digitali e le relative relazioni in un'istanza di Gemelli digitali di Azure.
  • Query - La categoria Query consente agli sviluppatori di trovare set di gemelli digitali nel grafico dei gemelli tra le relazioni.
  • Event Routes - La categoria Route di eventi contiene API per instradare i dati, attraverso il sistema e verso i servizi downstream.
  • Import Jobs - L'API Importa processi consente di gestire un'azione asincrona a esecuzione prolungata per importare modelli, gemelli e relazioni in blocco.
  • Delete Jobs - L'API Elimina processi consente di gestire un'azione asincrona a esecuzione prolungata per eliminare tutti i modelli, i gemelli e le relazioni in un'istanza di .

Per chiamare direttamente le API, fare riferimento alla cartella Swagger più recente nel repository Swagger del piano dati. Questa cartella include anche una cartella di esempi che mostrano l'utilizzo. È anche possibile visualizzare la documentazione di riferimento dell'API del piano dati.

Ecco gli SDK attualmente disponibili per le API del piano dati di Gemelli digitali di Azure.

Linguaggio SDK Collegamento al pacchetto Documentazione di riferimento Codice sorgente
.NET (C#) Azure.DigitalTwins.Core in NuGet Informazioni di riferimento sulla libreria client di Gemelli digitali IoT di Azure per .NET Libreria client di Gemelli digitali IoT di Azure per .NET in GitHub
Java com.azure:azure-digitaltwins-core in Maven Informazioni di riferimento su Azure Digital Twins SDK per Java Libreria client di Gemelli digitali IoT di Azure per Java in GitHub
JavaScript Libreria client core di Gemelli digitali di Azure per JavaScript in npm Reference for @azure/digital-twins-core Libreria client core di Gemelli digitali di Azure per JavaScript in GitHub
Python Libreria client core di Gemelli digitali di Azure per Python in PyPI Informazioni di riferimento su azure-digitaltwins-core Libreria client core di Gemelli digitali di Azure per Python in GitHub

Passaggi successivi

I passaggi successivi suggeriti includono: