cihaz ve hizmet SDK'larını Azure IoT

Bu başvuruda, IoT Hub ve Cihaz Sağlama Hizmeti (DPS) için cihaz, hizmet ve yönetim SDK'ları, sertifika yönetimi için önizleme SDK'ları ve Azure Digital Twins denetim düzlemi ve veri düzlemi API'lerine bağlantılar gibi IoT çözümleri oluşturmak için kullanabileceğiniz Azure SDK’ları listelenir.

Cihaz SDK'ları

Microsoft Azure IoT cihaz SDK'ları, Azure IoT Hub hizmetlerine bağlanan ve Azure IoT Hub hizmetler tarafından yönetilen uygulamalar derlemeyi kolaylaştıran kod içerir. Bu SDK'lar BILGISAYAR, tablet, akıllı telefon veya Raspberry Pi gibi genel bir MPU tabanlı bilgi işlem cihazında çalıştırılabilir. SDK'lar C'de ve C#, Node.js, Python ve Java gibi modern yönetilen dillerde geliştirmeyi destekler.

SDK'lar, ekibinize ve senaryonuza en uygun olanı seçme esnekliği sağlayan birden çok dilde kullanılabilir.

Language Package Kaynak Quickstarts Örnekleri Referans
.NET NuGet GitHub IoT Hub Örnekler Referans
Python pip GitHub IoT Hub Örnekler Referans
Node.js npm  GitHub IoT Hub Örnekler Referans
Java Maven GitHub IoT Hub Örnekler Referans
C packages GitHub IoT Hub Örnekler Referans

Java cihaz SDK'sı, Android için samples içerir.

C cihaz SDK'sı, CocoaPods kullanan iOS için samples içerir.

Uyarı

Azure IoT C SDK bellek yönetimi ve iş parçacığı modeli nedeniyle katıştırılmış uygulamalar için uygun değildir. Ekli cihaz SDK'sı seçenekleri için bkz. katıştırılmış cihaz SDK'ları.

IoT Hub veya IoT Central'a bağlanan IoT cihazlarında çalıştırılacak kod geliştirmek için cihaz SDK'larını kullanın.

Katıştırılmış cihaz SDK'ları

Bu SDK'lar sınırlı işlem ve bellek kaynaklarına sahip cihazlarda çalıştırılacak şekilde tasarlanmış ve oluşturulmuştur ve C dili kullanılarak uygulanır.

Katıştırılmış cihaz SDK'ları, senaryonuza en uygun olanı seçme esnekliği sağlayan birden çok işletim sistemi için kullanılabilir.

RTOS SDK Kaynak Örnekleri Referans
Eclipse ThreadX Azure RTOS Ara Yazılımı GitHub Hızlı başlangıçlar Referans
FreeRTOS FreeRTOS Ara Yazılımı GitHub Örnekler Referans
Çıplak Metal Embedded C için Azure SDK GitHub Örnekler Referans

IoT Hub veya IoT Central'a bağlanan IoT cihazlarında çalıştırılacak kod geliştirmek için ekli cihaz SDK'larını kullanın.

Katıştırılmış cihaz SDK'larının ne zaman kullanılacağı hakkında daha fazla bilgi edinmek için bkz . C SDK ve Embedded C SDK kullanım senaryoları.

Cihaz SDK'sı yaşam döngüsü ve desteği

Bu bölümde Azure IoT Cihaz SDK'sı yaşam döngüsü ve destek ilkesi özetlemektedir. Daha fazla bilgi için bkz. Azure SDK Yaşam Döngüsü ve destek ilkesi.

Paket yaşam döngüsü

Paketler aşağıdaki kategorilerde yayımlanıyor. Her kategorinin tanımlı bir destek yapısı vardır.

  1. Beta - Önizleme veya Sürüm Adayı olarak da bilinir. Erken erişim ve geri bildirim amacıyla kullanılabilir ve üretimde kullanılması önerilmez . Önizleme sürümü desteği GitHub sorunlarla sınırlıdır. Önizleme sürümleri genellikle altı aydan kısa bir süre boyunca yayınlanır ve bu süre sonunda kullanım dışı bırakılır veya etkin olarak yayınlanır.

  2. Etkin - Genel olarak kullanılabilir ve tam olarak desteklenir, yeni özellik güncelleştirmelerinin yanı sıra hata ve güvenlik düzeltmeleri alır. Bu sürüm düzeltmeleri ve güncelleştirmeleri aldığından en son sürümü kullanın.

  3. Kullanım dışı - Daha yeni bir sürümle değiştirilir. Kullanımdan kaldırma, yeni sürümün etkin hale gelmesiyle aynı zamanda gerçekleşir. Kullanım dışı bırakılan sürümler, 12 ay daha en kritik hata düzeltmelerini ve güvenlik düzeltmelerini ele alır.

Destek alın

Azure IoT SDK'larını kullanırken sorunlarla karşılaşıyorsanız aşağıdaki seçeneklerle destek isteyin:

  • Reporting bugs - Tüm müşteriler ilgili SDK ile ilişkili GitHub deposunun sorunlar sayfasında hataları bildirebilir.

  • Microsoft Müşteri Desteği ekibi - support planı olan kullanıcılar, doğrudan Azure portalından bir destek bileti oluşturarak Microsoft Müşteri Desteği ekibiyle etkileşime geçebilir.

hizmet SDK'larını IoT Hub

Azure IoT hizmeti SDK'ları, cihazları ve güvenliği yönetmek için doğrudan IoT Hub etkileşim kuran uygulamalar derlemeyi kolaylaştıran kod içerir.

Platform Package Kod Deposu Örnekleri Referans
.NET NuGet GitHub Örnekler Referans
Java Maven GitHub Örnekler Referans
Düğüm npm GitHub Örnekler Referans
Python pip GitHub Örnekler Referans

IoT hub'ı aracılığıyla cihazlarla etkileşimde bulunurken hizmet SDK'larını kullanma hakkında daha fazla bilgi edinmek için bkz. IoT Tak Çalıştır hizmet geliştirici kılavuzu.

IoT Hub yönetim SDK'ları

IoT Hub yönetim SDK'ları, Azure aboneliğinizdeki IoT hub'larını yöneten arka uç uygulamaları oluşturmanıza yardımcı olur.

Platform Package Kaynak kod deposu Referans
.NET NuGet GitHub Referans
Java Maven GitHub Referans
Node.js npm GitHub Referans
Python pip GitHub Referans

Yönetim SDK'larına alternatif olarak Azure CLI, PowerShell ve REST API bulunur.

DPS cihaz SDK'ları

DPS cihaz SDK'ları, Kayıt API'si ve cihazların DPS aracılığıyla sağlanması için çağrıldığı diğer API'lerin implementasyonlarını sağlar. Cihaz SDK'ları bilgisayar, tablet, akıllı telefon veya Raspberry Pi gibi genel MPU tabanlı bilgi işlem cihazlarında çalıştırılabilir. SDK'lar C'de ve C#, Node.js, Python ve Java gibi modern yönetilen dillerde geliştirmeyi destekler.

Aşağıdaki tabloda desteklenen her dil için kullanılabilen cihaz SDK'ları listelenmektedir.

Platform Package Kaynak kod deposu Örnekleri Hızlı Başlangıç Referans
.NET NuGet GitHub Örnekler Hızlı Başlangıç Referans
C apt-get, MBED, Arduino IDE veya iOS GitHub Örnekler Hızlı Başlangıç Referans
Java Maven GitHub Örnekler Hızlı Başlangıç Referans
Node.js npm GitHub Örnekler Hızlı Başlangıç Referans
Python pip GitHub Örnekler Hızlı Başlangıç Referans

Uyarı

Yukarıda listelenen C SDK'sı, bellek yönetimi ve iş parçacığı modeli nedeniyle katıştırılmış uygulamalar için uygun değildir. Katıştırılmış cihazlar için Katıştırılmış cihaz SDK'larına bakın.

DPS gömülü cihaz SDK'ları

Bu SDK'lar sınırlı işlem ve bellek kaynaklarına sahip cihazlarda çalıştırılacak şekilde tasarlanmış ve oluşturulmuştur ve C dili kullanılarak uygulanır.

RTOS SDK Kaynak Örnekleri Referans
Eclipse ThreadX Azure RTOS Ara Yazılımı GitHub Hızlı başlangıçlar Referans
FreeRTOS FreeRTOS Ara Yazılımı GitHub Örnekler Referans
Çıplak Metal Embedded C için Azure SDK GitHub Örnekler Referans

IoT SDK'larındaki cihaz ve gömülü cihaz SDK'ları hakkında daha fazla bilgi edinin.

DPS hizmet SDK'ları

DPS hizmeti SDK'ları, DPS örneklerindeki kayıtları ve kayıt kayıtlarını yönetmek için arka uç uygulamaları oluşturmanıza yardımcı olur.

Platform Package Kaynak kod deposu Örnekleri Hızlı Başlangıç Referans
.NET NuGet GitHub Örnekler Hızlı Başlangıç Referans
Java Maven GitHub Örnekler Hızlı Başlangıç Referans
Node.js npm GitHub Örnekler Hızlı Başlangıç Referans

DPS yönetim SDK'ları

DPS yönetim SDK'ları, Azure aboneliğinizde DPS örneklerini ve bunların meta verilerini yöneten arka uç uygulamaları oluşturmanıza yardımcı olur.

Platform Package Kaynak kod deposu Referans
.NET NuGet GitHub Referans
Java Maven GitHub Referans
Node.js npm GitHub Referans
Python pip GitHub Referans

Sertifika yönetimi SDK'ları (önizleme)

Önizlemede Microsoft destekli X.509 sertifika yönetimini destekleyen SDK'lar için aşağıdaki yönergeleri ve örnekleri kullanın. Sertifika yönetimi SDK'larını önizlemede kullanmak için bağlı bir DPS örneğiyle Azure IoT Hub kullanmanız ve cihazların DPS aracılığıyla sağlanması gerekir.

Sertifika yönetimi cihaz SDK'ları (önizleme)

Aşağıdaki tabloda, şu anda Microsoft destekli X.509 sertifika yönetimini önizlemede destekleyen platform SDK'ları listelenmektedir.

Language Package Kaynak/Dal Örnekleri
.NET NuGet feature/iot-csr-previewAzure/azure-iot-sdk-csharp> CertificateSigningRequestSample
Python pip feature/iot-csr-previewAzure/azure-iot-sdk-python> cert-mgmt örnekleri
Node.js npm Mevcut değil Mevcut değil
Java Maven feature/csrAzure/azure-iot-sdk-java> certificate-signing-sample
C packages feature/dps-csr-previewAzure/azure-iot-sdk-c> iothub_ll_client_sample_certificate_signing_request

Sertifika yönetimi eklenmiş cihaz SDK'ları (önizleme)

Aşağıdaki tabloda şu anda Microsoft destekli X.509 sertifika yönetimini önizlemede destekleyen ekli SDK'lar listelenmektedir.

RTOS SDK Kaynak Örnekleri
FreeRTOS FreeRTOS Ara Yazılımı feature/dps-csr-previewAzure/azure-iot-middleware-freertos> Mevcut değil
Çıplak Metal Embedded C için Azure SDK feature/dps-csr-previewAzure/azure-sdk-for-c> paho_iot_hub_csr_sample.c

Azure Digital Twins kontrol düzlemi API'leri

Denetim düzlemi API'leri, Azure Digital Twins örneğinizi bir bütün olarak yönetmek için kullanılan ARM API'leridir; bu nedenle örneğinizin tamamını oluşturma veya silme gibi işlemleri kapsar. Uç noktaları oluşturmak ve silmek için de bu API'leri kullanacaksınız.

API'leri doğrudan çağırmak için control düzlemi Swagger deposundaki en son Swagger klasörüne başvurun. Bu klasör, kullanımı gösteren örneklerden oluşan bir klasör de içerir.

Azure Digital Twins kontrol düzlemi API'leri için şu anda kullanılabilen SDK'lar aşağıdadır.

SDK dili Paket bağlantısı Başvuru belgeleri Kaynak kodu
.NET (C#) Azure. NuGet .NETReference> GitHubMicrosoft Azure Digital Twins yönetimi istemci kitaplığı>
Java azure-resourcemanager-digitaltwins Maven'de Kaynak Yönetimi için Referans - Digital Twins GitHubAzure Resource Manager AzureDigitalTwins istemci kitaplığı>
JavaScript npm üzerinde JavaScript için AzureDigitalTwinsManagement istemci kitaplığı GitHubAzureDigitalTwinsManagement istemci kitaplığı>
Python PyPI üzerinde azure-mgmt-digitaltwins GitHubMicrosoft Azure SDK>
Başla azure-sdk-for-go/services/digitaltwins/mgmt GitHubAzure SDK>

veri düzlemi API'lerini Azure Digital Twins

Veri düzlemi API'leri, Azure Digital Twins örneğinizdeki öğeleri yönetmek için kullanılan Azure Digital Twins API'lerdir. Bunlar yol oluşturma, modelleri karşıya yükleme, ilişki oluşturma ve ikizleri yönetme gibi işlemleri içerir ve geniş bir şekilde aşağıdaki kategorilere ayrılabilir:

  • DigitalTwinModels - DigitalTwinModels kategorisi, Azure Digital Twins bir örnekte modeller yönetmek için API'ler içerir. Yönetim etkinlikleri DTDL'de yazılan modelleri yükleme, doğrulama, geri alma ve silmeyi içerir.
  • DigitalTwins - DigitalTwins kategorisi, geliştiricilerin Azure Digital Twins örneğindeki digital twins ve ilişkilerini oluşturmasına, değiştirmesine ve silmesine olanak sağlayan API'leri içerir.
  • Query- Sorgu kategorisi, geliştiricilerin ilişkiler arasında ikiz grafında dijital ikiz kümelerini bulmasını sağlar.
  • Event Routes- Event Routes kategorisi, verileri sistem üzerinden ve aşağı akış hizmetlerine yönlendirmek için API'leri içerir.
  • Import Jobs- İşleri İçeri Aktar API'si modelleri, ikizleri ve ilişkileri toplu olarak içeri aktarmak için uzun süre çalışan, zaman uyumsuz bir eylemi yönetmenize olanak tanır.
  • Delete Jobs- İşleri Sil API'si, bir örnekteki tüm modelleri, ikizleri ve ilişkileri silmek için uzun süre çalışan, zaman uyumsuz bir eylemi yönetmenize olanak tanır.

API'leri doğrudan çağırmak için veri düzlemi Swagger deposundaki en son Swagger klasörüne başvurun. Bu klasör, kullanımı gösteren örneklerden oluşan bir klasör de içerir. Veri düzlemi API başvuru belgelerini de görüntüleyebilirsiniz.

Azure Digital Twins veri düzlemi API'leri için şu anda kullanılabilen SDK'lar aşağıdadır.

SDK dili Paket bağlantısı Başvuru belgeleri Kaynak kodu
.NET (C#) Azure. NuGet .NETReference> GitHubAzure IoT Digital Twins istemci kitaplığı>
Java Maven'da com.azure:azure-digitaltwins-core JavaReference> GitHubAzure IoT Digital Twins istemci kitaplığı>
JavaScript npmAzure Azure Digital Twins Core istemci kitaplığı> Reference for @azure/digital-twins-core GitHubAzure Azure Digital Twins Core istemci kitaplığı>
Python PyPIAzure Azure Digital Twins Core istemci kitaplığı> azure-digitaltwins-core için referans GitHubAzure Azure Digital Twins Core istemci kitaplığı>

Sonraki Adımlar

Önerilen sonraki adımlar şunlardır: