Azure IoT eszköz- és szolgáltatásoldali SDK-k

Ez a hivatkozás felsorolja az IoT-megoldások készítéséhez használható Azure SDK-k, beleértve a IoT Hub és a Device Provisioning Service (DPS) eszköz-, szolgáltatás- és felügyeleti SDK-jait, a tanúsítványkezeléshez használható előzetes SDK-kat, valamint Azure Digital Twins vezérlősíkra és adatsík API-ra mutató hivatkozásokat.

Eszköz SDK-k

A Microsoft Azure IoT eszköz SDK-jai olyan kódot tartalmaznak, amely megkönnyíti a Azure IoT Hub szolgáltatásokhoz csatlakozó és felügyelt alkalmazások létrehozását. Ezek az SDK-k általános MPU-alapú számítástechnikai eszközökön, például PC-n, táblagépen, okostelefonon vagy Raspberry Pi-n futtathatók. Az SDK-k támogatják a fejlesztést c nyelven és modern felügyelt nyelvekben, beleértve a C#, Node.js, Python és Java.

Az SDK-k több nyelven is elérhetők, így rugalmasan kiválaszthatja, hogy melyik felel meg a legjobban a csapatának és a forgatókönyvének.

Nyelv Szoftvercsomag Forrás Quickstarts Példák Utalás
.NET NuGet GitHub Kapcsolódás a IoT Hub Samples Utalás
Python pip GitHub Kapcsolódás a IoT Hub Samples Utalás
Node.js npm  GitHub Kapcsolódás a IoT Hub Samples Utalás
Java Maven GitHub Kapcsolódás a IoT Hub Samples Utalás
C packages GitHub Kapcsolódás a IoT Hub Samples Utalás

Az Java eszköz SDK-ja samples androidos.

A C eszköz SDK-ja sampleseket tartalmaz a CocoaPods használó iOS-hez.

Figyelmeztetés

A Azure IoT C SDK memóriakezelési és szálkezelési modellje miatt nem alkalmas beágyazott alkalmazásokhoz. A beágyazott eszköz SDK-beállításaiért tekintse meg a beágyazott eszköz SDK-jait.

Az eszköz SDK-jaival kódokat fejleszthet a IoT Hub vagy az IoT Centralhoz csatlakozó IoT-eszközökön való futtatáshoz.

Beágyazott eszköz SDK-k

Ezeket az SDK-kat úgy tervezték és hozták létre, hogy korlátozott számítási és memóriaerőforrásokkal rendelkező eszközökön fussanak, és a C nyelv használatával implementálva legyenek.

A beágyazott eszközoldali SDK-k több operációs rendszerhez is elérhetők, így rugalmasan kiválaszthatja, hogy melyik felel meg a legjobban a forgatókönyvnek.

valós idejű operációs rendszer SDK Forrás Példák Utalás
Eclipse ThreadX köztes szoftver Azure RTOS GitHub Gyors kezdés Utalás
FreeRTOS FreeRTOS Middleware GitHub Samples Utalás
Közvetlen hardver Azure SDK beágyazott C-hez GitHub Samples Utalás

A beágyazott eszköz SDK-kkal kódot fejleszthet a IoT Hub vagy az IoT Centralhoz csatlakozó IoT-eszközökön való futtatáshoz.

A beágyazott eszköz SDK-jaival kapcsolatos további információkért tekintse meg a C SDK és a Embedded C SDK használati forgatókönyveit.

Eszköz SDK életciklusa és támogatása

Ez a szakasz az Azure IoT Eszköz SDK életciklusát és támogatási szabályzatát foglalja össze. További információ: Azure SDK Életciklus és támogatási szabályzat.

Csomag életciklusa

A csomagok a következő kategóriákban jelennek meg. Minden kategória meghatározott támogatási struktúrával rendelkezik.

  1. Bétaverzió – Más néven előzetes verzió vagy kiadási jelölt. Korai hozzáférés és visszajelzés céljára használható, de éles környezetben nem ajánlott. Az előzetes verzió támogatása GitHub problémákra korlátozódik. Az előzetes verziók általában kevesebb mint hat hónapig érhetők el, majd elavulttá válnak, vagy aktívvá válnak.

  2. Aktív – Általánosan elérhető és teljes mértékben támogatott, új funkciófrissítéseket, valamint hiba- és biztonsági javításokat kap. Használja a legújabb verziót , mert ez a verzió javításokat és frissítéseket kap.

  3. Elavult – Egy újabb kiadás felülírja. Az elavulás az új kiadás aktívvá válásával egyidejűleg történik. Az elavult kiadások további 12 hónapig kezelik a legkritikusabb hibajavításokat és biztonsági javításokat.

Támogatás igénybevétele

Ha problémákat tapasztal a Azure IoT SDK-k használata során, kérjen támogatást az alábbi lehetőségek közül:

  • Bejelentő hibák – Minden ügyfél jelentheti a hibákat az adott SDK-hoz társított GitHub tárház problémaoldalán.

  • Microsoft ügyfélszolgálati csapat – Azok a felhasználók, akik támogatási csomaggal rendelkeznek közvetlenül a Azure portálról hozhatnak létre támogatási jegyet a Microsoft ügyfélszolgálati csapatához.

IoT Hub szolgáltatás SDK-k

A Azure IoT szolgáltatás SDK-jai olyan kódot tartalmaznak, amely megkönnyíti a IoT Hub közvetlenül kezelő alkalmazások létrehozását az eszközök és a biztonság kezelése érdekében.

Platform Szoftvercsomag Kódtár Példák Utalás
.NET NuGet GitHub Samples Utalás
Java Maven GitHub Samples Utalás
Node npm GitHub Samples Utalás
Python pip GitHub Samples Utalás

A szolgáltatási SDK-k IoT Hubon keresztüli használatáról további információt IoT Plug and Play szolgáltatásfejlesztői útmutatóban talál.

IoT Hub felügyeleti SDK-k

A IoT Hub felügyeleti SDK-k segítségével olyan háttéralkalmazásokat hozhat létre, amelyek az IoT Hubokat kezelik az Azure-előfizetésben.

Platform Szoftvercsomag Kódtár Utalás
.NET NuGet GitHub Utalás
Java Maven GitHub Utalás
Node.js npm GitHub Utalás
Python pip GitHub Utalás

A felügyeleti SDK-k alternatívái közé tartozik a Azure CLI, PowerShell és REST API.

DPS-eszköz SDK-k

A DPS-eszköz SDK-k biztosítják a Register API implementációit, valamint azokat, amelyeket az eszközök a DPS-ben keresztül történő üzembe helyezésre hívnak. Az eszköz SDK-k általános MPU-alapú számítástechnikai eszközökön, például PC-n, táblagépen, okostelefonon vagy Raspberry Pi-n futtathatók. Az SDK-k támogatják a fejlesztést c nyelven és modern felügyelt nyelvekben, beleértve a C#, Node.js, Python és Java.

Az alábbi táblázat az egyes támogatott nyelvekhez elérhető eszköz SDK-kat sorolja fel.

Platform Szoftvercsomag Kódtár Példák gyorskonfigurálás Utalás
.NET NuGet GitHub Samples Gyors kezdés Utalás
C apt-get, MBED, Arduino IDE vagy iOS GitHub Samples Gyors kezdés Utalás
Java Maven GitHub Samples Gyors kezdés Utalás
Node.js npm GitHub Samples Gyors kezdés Utalás
Python pip GitHub Samples Gyors kezdés Utalás

Figyelmeztetés

A fent felsorolt C SDK memóriakezelési és szálkezelési modellje miatt nem alkalmas beágyazott alkalmazásokhoz. Beágyazott eszközök esetén tekintse meg a Beágyazott eszköz SDK-jait.

DPS-beágyazott eszköz SDK-k

Ezeket az SDK-kat úgy tervezték és hozták létre, hogy korlátozott számítási és memóriaerőforrásokkal rendelkező eszközökön fussanak, és a C nyelv használatával implementálva legyenek.

valós idejű operációs rendszer SDK Forrás Példák Utalás
Eclipse ThreadX köztes szoftver Azure RTOS GitHub Gyors kezdés Utalás
FreeRTOS FreeRTOS Middleware GitHub Samples Utalás
Közvetlen hardver Azure SDK beágyazott C-hez GitHub Samples Utalás

További információ a készülékek és beágyazott eszközök SDK-jairól az IoT SDK-k részben.

DPS szolgáltatás SDK-k

A DPS szolgáltatás SDK-k segítségével háttéralkalmazásokat hozhat létre a DPS-példányok regisztrációs és regisztrációs rekordjainak kezeléséhez.

Platform Szoftvercsomag Kódtár Példák gyorskonfigurálás Utalás
.NET NuGet GitHub Samples Gyors kezdés Utalás
Java Maven GitHub Samples Gyors kezdés Utalás
Node.js npm GitHub Samples Gyors kezdés Utalás

DPS felügyeleti SDK-k

A DPS felügyeleti SDK-k segítségével olyan háttéralkalmazásokat hozhat létre, amelyek a DPS-példányokat és azok metaadatait kezelik az Azure-előfizetésben.

Platform Szoftvercsomag Kódtár Utalás
.NET NuGet GitHub Utalás
Java Maven GitHub Utalás
Node.js npm GitHub Utalás
Python pip GitHub Utalás

Tanúsítványkezelési SDK-k (előzetes verzió)

A Microsoft támogatott X.509-tanúsítványkezelést előzetes verzióban támogató SDK-k esetében kövesse az alábbi utasításokat és mintákat. A tanúsítványkezelési SDK-k előzetes verzióban való használatához Azure IoT Hub kell használnia egy társított DPS-példánnyal, és az eszközöknek a DPS-ben kell kiépíteni.

Tanúsítványkezelési eszköz SDK-k (előzetes verzió)

Az alábbi táblázat azokat a platform SDK-kat sorolja fel, amelyek jelenleg Microsoft-alapú X.509-tanúsítványkezelést támogatnak előzetes verzióban.

Nyelv Szoftvercsomag Forrás/ág Példák
.NET NuGet Azure/azure-iot-sdk-csharp a feature/iot-csr-preview CertificateSigningRequestSample
Python pip Azure/azure-iot-sdk-python a feature/iot-csr-preview cert-mgmt minták
Node.js npm Nem elérhető Nem elérhető
Java Maven Azure/azure-iot-sdk-java a feature/csr certificate-signing-sample
C packages Azure/azure-iot-sdk-c a feature/dps-csr-preview iothub_ll_client_sample_certificate_signing_request

Tanúsítványkezelés beágyazott eszközoldali SDK-k (előzetes verzió)

Az alábbi táblázat azokat a beágyazott SDK-kat sorolja fel, amelyek jelenleg Microsoft-alapú X.509-tanúsítványkezelést támogatnak előzetes verzióban.

valós idejű operációs rendszer SDK Forrás Példák
FreeRTOS FreeRTOS Middleware Azure/azure-iot-middleware-freertos a feature/dps-csr-preview Nem elérhető
Közvetlen hardver Azure SDK beágyazott C-hez Azure/azure-sdk-for-c a feature/dps-csr-preview paho_iot_hub_csr_sample.c

Azure Digital Twins vezérlősík API-k

A vezérlősík API-k ARM API-k, amelyek a Azure Digital Twins-példány egészének kezelésére szolgálnak, így olyan műveleteket fednek le, mint a teljes példány létrehozása vagy törlése. Ezekkel az API-kkal végpontokat is létrehozhat és törölhet.

Az API-k közvetlen meghívásához hivatkozzon a control plane Swagger-adattár legújabb Swagger mappájára. Ez a mappa egy példákat tartalmazó mappát is tartalmaz, amely a használatot mutatja.

A Azure Digital Twins vezérlősík API-khoz jelenleg elérhető SDK-k.

SDK nyelve Csomagkapcsolat Referenciadokumentáció Forráskód
.NET (C#) Azure. ResourceManager.DigitalTwins a NuGeten Referencia a .NET-hez készült Azure DigitalTwins SDK-hoz Microsoft Azure Digital Twins felügyeleti ügyfélkódtár .NET GitHub
Java azure-resourcemanager-digitaltwins elérhető a Mavenen Referencia erőforrás-kezeléshez – Digital Twins Azure Resource Manager AzureDigitalTwins ügyfélkódtár Java GitHub
JavaScript AzureDigitalTwinsManagement ügyfélkódtár JavaScripthez npm-en AzureDigitalTwinsManagement ügyfélkódtár JavaScripthez GitHub
Python azure-mgmt-digitaltwins a PyPI felületén Microsoft Azure SDK Python GitHub
Go azure-sdk-for-go/services/digitaltwins/mgmt Azure SDK a Go on GitHub

Azure Digital Twins adatsík API-k

Az adatsík API-k a Azure Digital Twins API-k, amelyek a Azure Digital Twins-példány elemeinek kezelésére szolgálnak. Ilyen műveletek például az útvonalak létrehozása, a modellek feltöltése, a kapcsolatok létrehozása és az ikerpéldányok kezelése, és széles körben a következő kategóriákba sorolhatók:

  • DigitalTwinModels – A DigitalTwinModels kategória API-kat tartalmaz a modellek kezelésére egy Azure Digital Twins-példányban. A felügyeleti tevékenységek közé tartozik a DTDL-ben létrehozott modellek feltöltése, érvényesítése, lekérése és törlése.
  • DigitalTwins – A DigitalTwins kategória tartalmazza azokat az API-kat, amelyek lehetővé teszik a fejlesztők számára a digital ikerpéldányok és kapcsolataik létrehozását, módosítását és törlését egy Azure Digital Twins-példányban.
  • Query – A Lekérdezés kategória lehetővé teszi a fejlesztők számára , hogy a kapcsolatok között digitális ikerpéldányokat találjanak az ikergráfban .
  • Event Routes - Az Event Routes kategória api-kat tartalmaz az adatok a rendszeren és az alárendelt szolgáltatásokon keresztül történő átirányításához.
  • Import Jobs– Az Import Jobs API lehetővé teszi egy hosszú ideig futó, aszinkron művelet kezelését modellek, ikerpéldányok és kapcsolatok tömeges importálásához.
  • Delete Jobs– A Feladatok törlése API lehetővé teszi egy hosszú ideig futó, aszinkron művelet kezelését az összes modell, ikerpéldány és kapcsolat törlésére egy példányban.

Az API-k közvetlen meghívásához hivatkozzon a legújabb Swagger mappára a data plane Swagger-adattárban. Ez a mappa egy példákat tartalmazó mappát is tartalmaz, amely a használatot mutatja. Megtekintheti az adatsík API referenciadokumentációját is.

Az Azure Digital Twins adatsík API-khoz jelenleg elérhető SDK-k az alábbiak.

SDK nyelve Csomagkapcsolat Referenciadokumentáció Forráskód
.NET (C#) Azure. DigitalTwins.Core a NuGeten Reference Azure IoT Digital Twins ügyfélkódtárhoz .NET Azure IoT Digital Twins ügyfélkódtár GitHub
Java com.azure:azure-digitaltwins-core on Maven Referencia a Java-hoz készült Azure Digital Twins SDK-hoz Azure IoT Digital Twins ügyfélkódtár Java GitHub
JavaScript Azure Azure Digital Twins JavaScript-ügyfélkódtár npm-en Reference for @azure/digital-twins-core Azure Azure Digital Twins JavaScript-ügyfélkódtár GitHub
Python Azure Azure Digital Twins Alapvető ügyfélkódtár a PyPI-n Python Az Azure Digital Twins Core referenciája Azure Azure Digital Twins Alapvető ügyfélkódtár Python GitHub

Következő lépések

A következő javasolt lépések a következők: