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 | Connessione a hub IoT | Esempi | Riferimento |
| Python | pip | GitHub | Connessione a hub IoT | Esempi | Riferimento |
| Node.JS | npm | GitHub | Connessione a hub IoT | Esempi | Riferimento |
| Java | Maven | GitHub | Connessione a hub IoT | Esempi | Riferimento |
| C | packages | GitHub | Connessione 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.
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.
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.
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 clienti Microsoft: gli utenti che hanno un piano di supporto possono contattare il team del supporto tecnico Microsoft creando un ticket di supporto direttamente 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'SDKC 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.
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.
Passaggi successivi
I passaggi successivi suggeriti includono: