SDK Azure IoT Terpadu (pratinjau) untuk IoT Hub dan Azure Device Registry

Important

Beberapa rilis Azure IoT SDK terpadu dan kemampuan Azure IoT yang dijelaskan dalam artikel ini sedang dalam pratinjau, termasuk .NET SDK versi 2.0.0-preview4, C SDK versi 2.0.0-preview.2, IoT Hub yang mendukung MQTTv5, integrasi Azure Device Registry dengan IoT Hub, manajemen sertifikat, dan pembaruan perangkat lunak. Jangan mengartikan versi SDK tanpa akhiran pratinjau sebagai indikasi bahwa kemampuan Azure IoT yang bekerja dengannya umumnya tersedia.

Fungsi pratinjau disediakan tanpa perjanjian tingkat layanan dan tidak direkomendasikan untuk beban kerja produksi. Lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure untuk mengetahui ketentuan hukum yang berlaku untuk fitur Azure yang dalam tahap beta, pratinjau, atau belum dirilis ke ketersediaan umum.

SDK Azure IoT terpadu menyediakan model pemrograman yang sadar siklus hidup untuk membangun aplikasi perangkat yang bekerja dengan layanan Azure IoT. Mereka membawa penyediaan perangkat, konektivitas, manajemen kredensial, dan operasi perangkat ke dalam pengalaman pengembangan yang lebih konsisten.

Alih-alih mengharuskan aplikasi mengoordinasikan pustaka khusus layanan dan status siklus hidup perangkat secara independen, SDK terpadu memperkenalkan model koneksi bersama dan klien yang berfokus pada kapabilitas. Pendekatan ini menyederhanakan cara aplikasi menyediakan perangkat, membangun koneksi, mengelola kredensial, dan berinteraksi dengan layanan Azure IoT.

SDK terpadu adalah SDK baru, berbeda dari SDK Azure IoT Hub dan Device Provisioning Service (DPS) yang sudah ada. SDK yang sudah ada tetap tersedia untuk aplikasi yang bergantung pada kemampuan yang didukung.

Artikel ini menjelaskan arsitektur SDK terpadu, siklus hidup perangkat end-to-end, dan cara memilih versi SDK yang sesuai sesuai dengan kebutuhan aplikasi Anda.

Note

Artikel ini berlaku untuk perangkat yang menggunakan instance IoT Hub dan Device Provisioning Service (DPS) yang terintegrasi dengan Azure Device Registry. SDK terpadu terpisah dari SDK perangkat Azure IoT Hub dan DPS yang sudah ada yang belum terintegrasi dengan Azure Device Registry, yang tetap tersedia untuk aplikasi yang bergantung pada kemampuan yang didukung. Untuk penerapan IoT Hub dan DPS yang tidak terintegrasi dengan Azure Device Registry, lanjutkan menggunakan SDK perangkat yang tercantum dalam SDK perangkat dan layanan Azure IoT.

Strategi SDK terpadu

SDK Azure IoT terpadu menggunakan satu klien koneksi bersama dan satu set klien fitur yang berfokus pada kapabilitas.

Klien koneksi mengoordinasikan operasi siklus hidup perangkat yang umum, termasuk:

  • Provisioning perangkat melalui Azure IoT Hub Device Provisioning Service (DPS).
  • Membangun koneksi ke Azure IoT Hub yang ditugaskan.
  • Mengelola operasi autentikasi dan siklus hidup kredensial yang didukung.
  • Menangani pemulihan koneksi, percobaan ulang, dan provisioning ulang jika berlaku.

Klien fitur menggunakan koneksi bersama untuk menyediakan kemampuan perangkat seperti:

  • Telemetri perangkat ke cloud.
  • Device twin.
  • Metode langsung.
  • Kemampuan tambahan didukung oleh SDK yang dipilih dan konfigurasi layanan Azure IoT.

Arsitektur ini menyediakan model pemrograman yang konsisten sepanjang siklus hidup perangkat. Aplikasi dapat menggunakan klien koneksi bersama dan menambahkan klien fitur yang diperlukan untuk skenario mereka.

SDK mengoordinasikan perilaku koneksi khusus layanan dan protokol yang didukung, mengurangi jumlah logika manajemen siklus hidup yang perlu diterapkan aplikasi.

Note

Ketersediaan kemampuan dapat bervariasi tergantung bahasa SDK, versi, permukaan API, metode autentikasi, dan profil koneksi IoT Hub. Tinjau dokumentasi dan contoh untuk versi SDK spesifik yang Anda gunakan.

Untuk panduan arsitektur dan penerapan DPS, lihat praktik terbaik penerapan Device Provisioning Service dalam skala besar.

Konektivitas berbasis MQTT

SDK Azure IoT terpadu berfokus pada konektivitas perangkat berbasis MQTT, mendukung MQTT 3.1.1 dan, jika tersedia, MQTT 5.0.

MQTT adalah protokol pesan ringan yang banyak diadopsi dan dirancang untuk perangkat yang terhubung. Dengan fokus pada MQTT, SDK terpadu menyediakan model pemrograman perangkat yang lebih konsisten di seluruh penyediaan, konektivitas, autentikasi, dan operasi perangkat. Pendekatan ini juga menyederhanakan siklus hidup koneksi yang perlu dikelola oleh pengembang.

SDK terpadu mendukung:

  • MQTT 3.1.1: Konektivitas ke Azure IoT Hub yang sudah ada. Keempat versi SDK yang dijelaskan dalam artikel ini mendukung MQTT 3.1.1.
  • MQTT 5.0 (pratinjau): Konektivitas ke Azure IoT Hub yang mendukung MQTTv5 yang berpartisipasi dalam pratinjau, termasuk kemampuan khusus untuk pengalaman MQTTv5 yang baru. Hanya versi preview SDK, .NET 2.0.0-preview4 dan C 2.0.0-preview.2, yang mendukung MQTT 5.0.

SDK terpadu saat ini belum mendukung AMQP atau HTTP sebagai transportasi pesan perangkat-ke-IoT Hub. Aplikasi yang memerlukan protokol ini harus terus menggunakan SDK perangkat Azure IoT Hub yang sudah ada dan mendukungnya.

Note

Kemampuan MQTTv5 memerlukan Azure IoT Hub yang mendukung MQTTv5 dalam preview. Versi SDK saja tidak mengaktifkan fitur MQTTv5 pada MQTT 3.1.1 IoT Hub yang sudah ada.

Untuk protokol, kemampuan, dan permukaan API yang didukung, lihat dokumentasi Azure IoT SDK untuk .NET dan dokumentasi C SDK. Untuk dukungan MQTT 5.0 di C SDK, lihat dokumentasi C SDK 2.0.0-preview.2.

Siklus hidup perangkat Azure IoT end-to-end

SDK terpadu memodelkan siklus hidup perangkat sebagai perjalanan berkelanjutan, bukan serangkaian operasi layanan yang terputus.

Perangkat tipikal bergerak melalui tahap-tahap berikut:

  1. Tetapkan identitas awal perangkat. Perangkat dimulai dengan sertifikat X.509 atau kunci simetris untuk autentikasi tanda tangan akses bersama (SAS), tergantung pada skenario penyediaan yang didukung. SDK mendukung X.509 untuk MQTT 3.1.1 dan MQTT 5.0, sementara mereka hanya mendukung autentikasi SAS untuk MQTT 3.1.1.
    • C SDK juga mendukung attestasi Trusted Platform Module (TPM) dengan DPS untuk perangkat yang terhubung ke MQTT 3.1.1 IoT Hubs.
    • SDK .NET saat ini tidak mendukung autentikasi berbasis TPM.
  2. Provisikan perangkat. Klien koneksi menggunakan DPS untuk mendaftarkan perangkat dan memperoleh endpoint IoT Hub serta informasi koneksi yang ditugaskan.
  3. Hubungkan dan operasikan. Klien koneksi membangun konektivitas dengan IoT Hub yang ditugaskan. Aplikasi ini menggunakan klien fitur untuk bertukar telemetri dan melakukan operasi perangkat yang didukung.
  4. Kelola kredensial perangkat. Jika manajemen sertifikat didukung dan dikonfigurasi, SDK berpartisipasi dalam pendaftaran dan pembaruan sertifikat sebagai bagian dari siklus hidup koneksi perangkat.
  5. Gunakan kapabilitas perangkat tambahan. Aplikasi dapat menggunakan klien fitur lain yang didukung sesuai dengan versi SDK yang dipilih dan kemampuan layanan.
  6. Pulihkan konektivitas. Klien koneksi menyediakan perilaku rekoneksi dan penyediaan ulang yang didukung ketika konektivitas atau penugasan perangkat berubah.

Karena klien koneksi mengoordinasikan tahap-tahap ini, aplikasi dapat mengikuti siklus hidup perangkat yang konsisten tanpa harus mengimplementasikan setiap interaksi layanan secara independen.

SDK menangani perilaku pemulihan koneksi yang didukung, tetapi aplikasi tetap bertanggung jawab atas logika bisnis, status aplikasi yang persisten, dan penanganan operasi yang aman yang mungkin dicoba ulang atau diulang.

Memetakan kemampuan Azure IoT ke klien SDK

Arsitektur SDK terpadu memisahkan perilaku siklus hidup koneksi yang umum dari operasi perangkat yang spesifik untuk tiap kapabilitas.

Area daur hidup kapabilitas Azure Peran SDK
Provisioning Layanan Penyediaan Perangkat (DPS) Klien untuk koneksi
Konektivitas dan pesan perangkat Azure IoT Hub Klien koneksi dan klien fitur
Siklus hidup sertifikat Pendaftaran dan perpanjangan sertifikat Klien koneksi, jika didukung
Operasi perangkat Telemetri, perangkat kembar dan metode langsung Klien untuk fitur
Kemampuan perangkat tambahan Kemampuan Azure IoT lainnya yang didukung Klien khusus fitur, jika tersedia

Bagaimana Azure Device Registry berperan

Azure Device Registry melengkapi SDK sisi perangkat dengan menyediakan bidang manajemen terpadu untuk perangkat IoT di seluruh layanan Azure.

SDK terpadu tidak berkomunikasi langsung dengan Azure Device Registry. Sebaliknya, perangkat berinteraksi dengan DPS dan IoT Hub, sementara Azure Device Registry menyediakan kemampuan representasi, manajemen, dan tata kelola perangkat melalui bidang manajemen Azure.

Pemisahan ini memungkinkan aplikasi perangkat untuk fokus pada penyediaan, konektivitas, dan operasi perangkat, sementara Azure Device Registry mendukung manajemen terpusat atas estate perangkat.

Untuk informasi lebih lanjut, lihat integrasi Azure Device Registry dengan IoT Hub.

Pilih Azure IoT SDK terpadu

SDK Azure IoT terpadu tersedia untuk .NET dan C.

Pilih SDK berdasarkan bahasa aplikasi perangkat Anda, kemampuan yang dibutuhkan, dan layanan Azure IoT yang perlu digunakan aplikasi Anda.

SDK Azure IoT terpadu dirancang untuk aplikasi perangkat menggunakan Azure IoT Hub yang terintegrasi dengan Azure Device Registry (ADR), bersama dengan Device Provisioning Service (DPS).

SDK ini mendukung pengalaman siklus hidup perangkat baru, termasuk provisioning, konektivitas, dan manajemen sertifikat jika tersedia.

Untuk penerapan IoT Hub dan DPS yang belum terintegrasi dengan Azure Device Registry, lanjutkan menggunakan SDK perangkat Azure IoT yang sudah ada untuk bahasa pemrograman pilihan Anda.

SDK yang Tersedia

Bahasa Paket atau sumber Version Penggunaan yang disarankan Documentation
.NET Microsoft.Azure.Iot.Device 1.2.0 Aplikasi perangkat yang menggunakan Hub IoT terintegrasi ADR dengan konektivitas MQTT 3.1.1, penyediaan DPS, dan kemampuan manajemen sertifikat yang didukung. Paket NuGet 1.2.0
.NET Microsoft.Azure.Iot.Device 2.0.0-preview4 Aplikasi perangkat yang mengevaluasi konektivitas dan kemampuan MQTTv5 dengan IoT Hub yang mendukung MQTTv5 dalam pratinjau, bersama dengan model pemrograman terpadu untuk skenario yang didukung. Paket NuGet 2.0.0-preview4
C Sumber GitHub 1.0.0 Rilis yang tersedia secara umum untuk aplikasi C native, termasuk perangkat embedded. Mendukung konektivitas MQTT 3.1.1 IoT Hub, penyediaan DPS, dan manajemen sertifikat untuk skenario IoT Hub yang terintegrasi dengan ADR. Catatan rilis C SDK 1.0.0
C Sumber GitHub 2.0.0-preview.2 Aplikasi C asli yang mengevaluasi konektivitas MQTTv5 dengan IoT Hub yang mendukung MQTTv5 dalam pratinjau dan pembaruan perangkat lunak Azure Device Registry (pratinjau). Mencakup kemampuan versi 1.0.0. Catatan rilis C SDK 2.0.0-preview.2

Untuk versi SDK .NET terbaru yang dipublikasikan, termasuk versi prarilis, lihat Microsoft.Azure. Iot.Device di NuGet.

Untuk perubahan spesifik versi C SDK, tinjau catatan rilis Azure IoT SDK C di daftar rilis GitHub dan sumber rilis terkait.

Note

SDK Azure IoT terpadu mendukung kemampuan yang tersedia secara umum dan pratinjau, tergantung pada versi SDK dan konfigurasi layanan. Perangkat berkomunikasi dengan DPS dan IoT Hub yang ditugaskan, sementara Azure Device Registry menyediakan manajemen perangkat melalui plane manajemen Azure. Kemampuan MQTTv5 memerlukan IoT Hub yang mendukung MQTTv5 dalam pratinjau dan tidak diaktifkan hanya dengan menginstal SDK pratinjau saja.

Kapan menggunakan versi .NET SDK

Gunakan versi 1.2.0 untuk skenario MQTT 3.1.1 IoT Hub yang didukung.

Versi 1.2.0 menyediakan model pemrograman perangkat terpadu untuk aplikasi yang menggunakan penyediaan DPS yang didukung, konektivitas IoT Hub, dan operasi perangkat.

Versi ini sesuai ketika aplikasi Anda tidak memerlukan kemampuan khusus MQTTv5 baru yang saat ini tersedia dalam preview. Versi 1.2.0 tidak mendukung koneksi ke IoT Hub yang mendukung MQTTv5.

Gunakan versi 2.0.0-preview4 untuk mengevaluasi kemampuan MQTTv5.

Versi 2.0.0-preview4 mendukung IoT Hubs yang mendukung MQTTv5 dan menyertakan dua permukaan API dalam paket NuGet yang sama:

  • Permukaan API terpadu: Menyediakan model pemrograman umum di seluruh profil koneksi MQTT 3.1.1 dan MQTT 5.0 IoT Hub yang didukung. SDK menggunakan profil koneksi yang ditetapkan melalui DPS untuk membangun koneksi yang sesuai. Fitur yang hanya didukung oleh Hub IoT yang mendukung MQTTv5, seperti push twin dan penanganan probe metode langsung, tidak termasuk dalam permukaan ini.
  • Permukaan API khusus MQTTv5: Mengekspos kemampuan khusus untuk Hub IoT yang mendukung MQTTv5 yang bukan bagian dari permukaan API terpadu yang umum. Surface ini hanya terhubung ke IoT Hub yang mendukung MQTTv5 dan hanya mendukung autentikasi X.509. Pada versi 2.0.0-preview4, versi ini tidak mendukung manajemen sertifikat.

Anda tidak memerlukan paket NuGet terpisah untuk setiap cakupan API.

Important

Dukungan MQTTv5 saat ini merupakan kemampuan pratinjau. Untuk memanfaatkan konektivitas MQTTv5 dan fitur khusus MQTTv5, perangkat Anda harus disediakan ke Azure IoT Hub yang mendukung MQTTv5 dan berpartisipasi dalam pratinjau.

Menginstal versi 2.0.0-preview4 saja tidak mengaktifkan kemampuan MQTTv5 pada MQTT 3.1.1 IoT Hub yang sudah ada.

Permukaan API terpadu dimaksudkan untuk meminimalkan perbedaan aplikasi di seluruh profil koneksi IoT Hub yang didukung. Namun, kemampuan dan metode autentikasi individual masih dapat bervariasi tergantung pada IoT Hub yang ditugaskan.

Aplikasi yang secara eksplisit memerlukan fitur MQTTv5 saja harus menggunakan permukaan API khusus MQTTv5 dan IoT Hub yang memenuhi syarat dengan MQTTv5.

Untuk detail tentang fitur yang tersedia dan perbedaan antar permukaan API, lihat .NET SDK README. Contoh untuk kedua jenis API ada di cabang pratinjau.

Kapan menggunakan versi C SDK

SDK C terpadu menyediakan siklus hidup koneksi bersama dan model pemrograman berfokus pada kemampuan untuk aplikasi C asli, termasuk lingkungan embedded dan perangkat terbatas.

Gunakan versi 1.0.0 untuk skenario MQTT 3.1.1 IoT Hub.

Versi 1.0.0 adalah rilis yang umum tersedia dari unified C SDK. Mendukung konektivitas MQTT 3.1.1 IoT Hub tetapi tidak mendukung IoT Hub yang mendukung MQTTv5 atau pembaruan perangkat lunak. Jika DPS menetapkan perangkat ke profil koneksi IoT Hub yang tidak didukung versi 1.0.0, koneksi tersebut gagal.

Gunakan versi 2.0.0-preview.2 untuk mengevaluasi MQTTv5 dan pembaruan perangkat lunak.

Versi 2.0.0-preview.2 adalah rilis pratinjau yang mencakup kemampuan versi 1.0.0 dan menambahkan dukungan untuk IoT Hubs yang mendukung MQTTv5 serta pembaruan perangkat lunak Azure Device Registry. DPS mengembalikan profil koneksi IoT Hub yang ditugaskan, dan SDK memilih MQTT 3.1.1 atau MQTT 5.0 sesuai dengan itu. API pratinjau mungkin berubah sebelum rilis stabil.

SDK mendukung skenario terdokumentasi melibatkan:

  • Penyediaan DPS dan konektivitas IoT Hub.
  • Otentikasi X.509 dan SAS, atestasi DPS TPM, serta operasi manajemen sertifikat yang didukung.
  • Telemetri perangkat ke cloud.
  • Operasi device twin dan metode langsung.
  • Pemulihan koneksi dan provisi ulang.
  • Operasi perangkat tambahan yang didukung oleh profil koneksi yang dipilih.
  • Pembaruan perangkat lunak Azure Device Registry (pratinjau) pada versi 2.0.0-preview.2.

Beberapa kemampuan C SDK spesifik untuk MQTT 3.1.1 dan tidak tersedia untuk IoT Hub yang mendukung MQTTv5. Misalnya, pesan cloud-ke-perangkat, unggahan file, dan pembaruan sertifikat melalui IoT Hub memerlukan profil koneksi MQTT 3.1.1.

C SDK memiliki persyaratan platform, ketergantungan, konfigurasi build, dan matriks fitur yang didukung tersendiri. Tinjau dokumentasi dan contoh untuk rilis yang dipilih sebelum mengintegrasikannya ke dalam aplikasi perangkat.

Untuk versi 1.0.0, lihat dokumentasi Unified C SDK dan contoh C SDK. Untuk versi 2.0.0-preview.2, lihat dokumentasi dan contoh C SDK 2.0.0-preview.2. Untuk catatan rilis, lihat rilis GitHub.

Skenario dan pertimbangan yang didukung

SDK terpadu menyediakan arsitektur siklus hidup perangkat yang sama, tetapi tidak selalu memberikan kesetaraan fitur dengan setiap kemampuan Azure IoT Hub dan DPS SDK yang ada.

Tinjau pertimbangan berikut saat memilih SDK.

Penyediaan dan autentikasi

SDK terpadu mengintegrasikan Device Provisioning Service (DPS) ke dalam siklus hidup koneksi perangkat.

Autentikasi perangkat selama penyediaan DPS (kredensial onboarding) terpisah dari autentikasi ke IoT Hub yang ditugaskan (kredensial operasional). Tergantung pada SDK dan konfigurasi yang didukung, perangkat dapat menggunakan sertifikat X.509, kunci simetris (SAS), atau, dengan C SDK, sertifikasi TPM untuk autentikasi dengan DPS.

Untuk .NET SDK:

  • Penyediaan DPS: Mendukung autentikasi X.509 dan kunci simetris (SAS). Skenario SAS hanya didukung dengan MQTT 3.1.1 IoT Hubs.
  • MQTT 3.1.1 IoT Hub: Mendukung autentikasi X.509 dan SAS, tergantung pada skenario yang dikonfigurasi.
  • IoT Hub yang mendukung MQTTv5 (pratinjau): Memerlukan autentikasi X.509. Pada versi 2.0.0-preview4, manajemen sertifikat tidak tersedia untuk IoT Hub yang mendukung MQTTv5, sehingga perangkat harus menggunakan sertifikat X.509 yang sudah didukung.
  • Autentikasi TPM: Saat ini tidak didukung oleh SDK .NET terpadu.

Untuk C SDK:

  • Provisi DPS: Mendukung autentikasi X.509 dan kunci simetris (SAS) melalui klien koneksi, dengan integrasi penyedia sertifikat untuk kredensial X.509. Sertifikasi DPS TPM didukung sebagai langkah registrasi terpisah melalui HTTPS sebelum perangkat terhubung ke IoT Hub yang ditugaskan. Karena pendaftaran TPM terjadi di luar klien koneksi, klien koneksi tidak secara otomatis menyediakan ulang perangkat yang menggunakan sertifikat TPM.
  • MQTT 3.1.1 IoT Hub: Mendukung autentikasi X.509 dan SAS. Perangkat yang menggunakan atestasi TPM diautentikasi dengan token SAS yang ditandatangani oleh TPM.
  • IoT Hub (pratinjau) yang mendukung MQTTv5: Versi 2.0.0-preview.2 memerlukan autentikasi X.509 dan tidak mendukung SAS. Perangkat dapat menggunakan sertifikat X.509 yang sudah didukung atau memperoleh sertifikat operasional melalui manajemen sertifikat selama penyediaan DPS.
  • Kunci yang didukung perangkat keras: Kunci privat X.509 dapat disimpan dalam token PKCS#11 atau TPM 2.0, digunakan melalui PSA Crypto, atau diakses melalui callback penandatanganan yang disediakan aplikasi.

Note

Autentikasi SAS ke DPS tidak berarti autentikasi SAS ke IoT Hub yang ditugaskan. Misalnya, dengan C SDK versi 2.0.0-preview.2, sebuah perangkat dapat menyediakan menggunakan SAS, memperoleh sertifikat X.509 operasional melalui DPS, dan menggunakan sertifikat tersebut untuk autentikasi dengan IoT Hub yang mendukung MQTTv5.

Manajemen sertifikat

Manajemen sertifikat adalah kemampuan opsional yang Anda aktifkan dan konfigurasikan pada tingkat namespace Azure Device Registry (ADR). Perangkat ini menyediakan infrastruktur kunci publik (PKI) yang didukung Microsoft untuk menerbitkan dan mengelola sertifikat X.509 operasional yang digunakan perangkat untuk autentikasi dengan IoT Hub.

Untuk konfigurasi yang didukung, perangkat dapat menggunakan sertifikat X.509 yang sudah ada atau kredensial symmetric-key (SAS) untuk onboarding awal melalui DPS. Saat Anda mengonfigurasi penerbitan sertifikat, perangkat akan mengirimkan permintaan penandatanganan sertifikat (CSR), dan DPS mengembalikan sertifikat operasional yang diterbitkan oleh ADR.

Perangkat kemudian menggunakan sertifikat operasional untuk mengautentikasi dengan IoT Hub yang ditetapkan untuk perangkat tersebut.

Kemampuan perpanjangan sertifikat bergantung pada profil koneksi IoT Hub:

  • MQTT 3.1.1: Mendukung pembaruan sertifikat melalui IoT Hub di mana manajemen sertifikat dikonfigurasi.
  • MQTT 5.0 (pratinjau): Dapatkan sertifikat operasional melalui DPS. Perpanjangan memerlukan penyediaan ulang melalui DPS, bukan perpanjangan sertifikat melalui IoT Hub.

Dukungan manajemen sertifikat juga berbeda menurut versi SDK:

Versi SDK Penerbitan sertifikat melalui DPS Perpanjangan sertifikat melalui IoT Hub Hub IoT yang mendukung MQTTv5
.NET 1.2.0 Dukungan Dukungan Tidak dapat diterapkan. Versi 1.2.0 tidak mendukung MQTT 5.0.
.NET 2.0.0-preview4 Didukung untuk MQTT 3.1.1 IoT Hubs melalui antarmuka API terpadu Didukung untuk MQTT 3.1.1 IoT Hubs melalui API terpadu Tidak didukung
C 1.0.0 Dukungan Dukungan Tidak dapat diterapkan. Versi 1.0.0 tidak mendukung MQTT 5.0.
C 2.0.0-preview.2 Dukungan Didukung untuk MQTT 3.1.1 IoT Hub IoT Hubs Penerbitan kredensial melalui DPS didukung. Perpanjang dengan memprovisi ulang melalui DPS.

C SDK mencakup abstraksi penyedia sertifikat untuk mengintegrasikan penyimpanan sertifikat dan operasi kriptografi dengan platform perangkat. Aplikasi harus mengonfigurasi penyedia yang didukung dan memenuhi persyaratan platform SDK yang dipilih.

Untuk informasi lebih lanjut tentang mengonfigurasi dan mengelola kemampuan ini pada tingkat namespace Azure Device Registry, lihat Manajemen sertifikat di Azure Device Registry.

Konektivitas dan operasi perangkat

SDK terpadu menyediakan konektivitas berbasis MQTT dan kemampuan perangkat yang didukung melalui klien fitur.

Untuk .NET, kemampuan ini meliputi:

  • Telemetri perangkat ke cloud.
  • Operasi device twin.
  • Metode langsung.
  • Percobaan ulang koneksi dan pemulihan.
  • Implementasi klien MQTT yang dapat digantikan.

Untuk C, kemampuan yang terdokumentasi meliputi:

  • Telemetri perangkat ke cloud.
  • Operasi device twin.
  • Metode langsung.
  • Pesan cloud-ke-perangkat untuk skenario MQTT 3.1.1 yang didukung.
  • Unggah file untuk skenario MQTT 3.1.1 yang didukung.
  • Topik khusus untuk IoT Hub yang mendukung MQTTv5, pada versi 2.0.0-preview.2.
  • Percobaan ulang koneksi, pemulihan, dan provisioning ulang.
  • Integrasi khusus platform untuk aplikasi C asli.

Pesan cloud-ke-perangkat dan unggahan file tidak tersedia untuk IoT Hub yang diaktifkan untuk MQTTv5 di C SDK terpadu. Aplikasi harus memperhitungkan keterbatasan spesifik protokol ini saat memilih profil koneksi.

Unggahan file juga memerlukan integrasi aplikasi. C SDK tidak menyertakan klien HTTP, jadi aplikasi Anda menyediakan permintaan HTTPS untuk operasi unggahan file dan mengunggah file tersebut ke Azure Storage. Konektivitas IoT Hub berbasis MQTT tidak berarti setiap operasi tambahan menggunakan MQTT.

Beberapa operasi dan fitur berbeda antara profil koneksi IoT Hub MQTT 3.1.1 dan MQTT 5.0.

SDK terpadu tidak dimaksudkan untuk menyediakan cakupan transportasi dan autentikasi yang identik untuk setiap Azure IoT SDK yang sudah ada. Misalnya, jangan mengasumsikan dukungan untuk AMQP, transport perangkat HTTPS, atau autentikasi TPM kecuali SDK yang dipilih secara eksplisit mendokumentasikan dukungan tersebut.

Pembaruan perangkat lunak (pratinjau)

Azure Device Registry menyediakan pembaruan perangkat lunak sebagai kemampuan opsional yang dikonfigurasi pada tingkat namespace. Ini memungkinkan pembaruan over-the-air dengan menggunakan grup dan pekerjaan Azure Device Registry untuk mengelola penyebaran pembaruan di berbagai perangkat.

Unified C SDK versi 2.0.0-preview.2 mencakup klien pembaruan perangkat lunak yang dapat diintegrasikan oleh aplikasi perangkat untuk memeriksa pembaruan, mengunduh dan menginstal konten pembaruan, serta melaporkan hasil.

Pembaruan perangkat lunak saat ini sedang dalam pratinjau untuk perangkat yang terhubung dengan IoT Hub. Perangkat memeriksa pembaruan dan melaporkan hasil melalui koneksi DPS-nya, bukan melalui IoT Hub, sehingga klien mendukung perangkat yang ditetapkan ke IoT Hub yang mendukung MQTT 3.1.1 atau MQTTv5. Pembaruan perangkat lunak memerlukan autentikasi X.509. C SDK versi 1.0.0 dan .NET SDK terpadu tidak menyertakan klien pembaruan perangkat lunak.

Klien pembaruan perangkat lunak adalah pustaka, bukan agen pembaruan mandiri. Aplikasi perangkat bertanggung jawab untuk mengintegrasikan klien dan mengimplementasikan logika instalasi serta pemulihan khusus perangkat.

Untuk informasi lebih lanjut, lihat ikhtisar konsep pembaruan perangkat lunak dan panduan pembaruan perangkat lunak C SDK.

Kemampuan siklus hidup perangkat tambahan

Anda dapat mengintegrasikan kemampuan Azure IoT tambahan melalui klien khusus fitur jika didukung.

Ketersediaan dapat berbeda tergantung bahasa SDK, versi paket, permukaan API, dan layanan Azure.

Secara khusus, evaluasilah kemampuan pembaruan perangkat lunak terhadap dukungan terdokumentasi dari SDK dan layanan yang dipilih. Dukungan dalam satu bahasa SDK tidak otomatis berarti dukungan yang setara dalam bahasa lain.

Untuk cakupan implementasi saat ini, konsultasikan tabel dan contoh fitur yang didukung di repositori.

Mulai dengan SDK Azure IoT terpadu

SDK Azure IoT terpadu tersedia untuk .NET dan C. Pilih SDK yang sesuai dengan lingkungan perangkat Anda, dan tinjau kemampuan yang didukung, persyaratan layanan, serta contoh sebelum mengintegrasikannya ke dalam aplikasi Anda.

.NET SDK

Microsoft mendistribusikan SDK .NET terpadu melalui Microsoft.Azure.Iot.Device paket NuGet. Versi 1.2.0 dan 2.0.0-preview4 menargetkan .NET 10 (net10.0).

Untuk menginstal versi 1.2.0 untuk skenario MQTT 3.1.1 IoT Hub yang didukung:

dotnet add package Microsoft.Azure.Iot.Device --version 1.2.0

Untuk mengevaluasi versi 2.0.0-preview4, termasuk kemampuan MQTTv5:

dotnet add package Microsoft.Azure.Iot.Device --version 2.0.0-preview4

Untuk detail paket dan contoh implementasi, lihat:

Pilih versi paket tertentu untuk build yang dapat diulang. Versi terbaru yang tersedia tidak selalu menjadi pilihan yang tepat untuk setiap aplikasi karena versi pratinjau dapat menampilkan berbagai permukaan API dan kemampuan layanan.

C SDK

Anda dapat menemukan C SDK terpadu sebagai kode sumber di repositori Azure IoT SDK GitHub. SDK ini dirancang untuk aplikasi perangkat C asli dan menawarkan siklus hidup koneksi bersama serta kemampuan perangkat yang didukung.

Versi 1.0.0 tersedia di cabang repositori main . Versi 2.0.0-preview.2 adalah rilis pratinjau dari unified C SDK, dan pengembangan pratinjau terus berlanjut di cabang releases/public-preview.

Berbeda dengan .NET SDK, Anda mengintegrasikan C SDK ke dalam aplikasi Anda melalui sistem sumber dan build-nya. Kedua versi mendukung Linux, Windows, ESP32 melalui komponen ESP-IDF, dan Yocto. Anda dapat menggunakan SDK dengan CMake dengan menggunakan add_subdirectory(), FetchContent, atau paket yang terpasang. Periksa dokumentasi repositori untuk persyaratan platform, ketergantungan, instruksi build, dan konfigurasi yang didukung.

Untuk memulai, lihat:

C SDK versi 2.0.0-preview.2 juga menyediakan klien software updates untuk pembaruan perangkat lunak Azure Device Registry (preview). Untuk informasi lebih lanjut, lihat Ikhtisar konsep pembaruan perangkat lunak.

Note

Kemampuan SDK bervariasi tergantung bahasa, versi, dan konfigurasi IoT Hub. Kemampuan MQTTv5 mengharuskan IoT Hub berkemampuan MQTTv5 yang memenuhi syarat dan berpartisipasi dalam pratinjau. Pembaruan perangkat lunak Azure Device Registry saat ini hanya tersedia dalam bentuk pratinjau melalui C SDK versi 2.0.0-preview.2.

Informasi rilis dan perubahan SDK

SDK Azure IoT terpadu terus berkembang seiring Microsoft menambah kemampuan.

Gunakan sumber daya berikut untuk meninjau versi yang dipublikasikan, kemampuan yang didukung, contoh implementasi, dan aktivitas pengembangan.

Resource Informasi
Rilis GitHub Tag rilis yang dipublikasikan dan informasi rilis yang tersedia
Paket .NET NuGet Versi paket yang dipublikasikan, dependensi, dan instruksi instalasi
Dokumentasi .NET SDK Kemampuan yang didukung, permukaan API, dan keterbatasan yang diketahui
Contoh .NET SDK Contoh implementasi untuk skenario .NET yang didukung
Riwayat sumber .NET Perubahan digabungkan ke dalam .NET SDK
Dokumentasi C SDK Arsitektur C SDK, kemampuan yang didukung, dan panduan integrasi
Sampel C SDK Contoh implementasi untuk skenario C yang didukung
Changelog SDK C Perubahan pada setiap rilis C SDK
Cabang pratinjau Dokumentasi, sampel, dan pengembangan berkelanjutan untuk versi SDK pratinjau

Pertimbangan rilis saat ini

.NET v1.2.0

  • Mendukung MQTT 3.1.1 IoT Hubs melalui permukaan API Terpadu. Tidak mendukung IoT Hub yang diaktifkan untuk MQTTv5.
  • Menyediakan penyediaan DPS dengan autentikasi X.509 dan SAS yang didukung.
  • Mendukung penerbitan sertifikat melalui DPS dan pembaruan sertifikat operasional melalui IoT Hub ketika manajemen sertifikat diaktifkan.
  • Termasuk telemetri, device twins, metode langsung, serta rekoneksi dan penyediaan ulang otomatis.
  • Tidak mendukung autentikasi TPM atau menyertakan klien pembaruan perangkat lunak Azure Device Registry.

.NET v2.0.0-preview4 (pratinjau)

  • Mencakup permukaan API Unified dan khusus MQTTv5 dalam satu paket.
  • Mendukung siklus hidup penyediaan bersama dan koneksi, dengan kemampuan yang bergantung pada profil koneksi IoT Hub yang ditetapkan.
  • Mengaktifkan kemampuan MQTTv5 dengan IoT Hub berkemampuan MQTTv5 yang memenuhi syarat dan berpartisipasi dalam pratinjau.
  • Memerlukan autentikasi X.509 untuk IoT Hub yang mendukung MQTTv5. Otentikasi SAS dan manajemen sertifikat hanya tersedia dengan MQTT 3.1.1 IoT Hubs melalui antarmuka API terpadu.
  • Saat ini tidak mendukung topik kustom, autentikasi TPM, atau klien pembaruan perangkat lunak Azure Device Registry.
  • API pratinjau dapat berubah sewaktu-waktu.

C v1.0.0

  • Menyediakan siklus hidup penyediaan dan koneksi terpadu untuk aplikasi C asli, termasuk lingkungan embedded.
  • Mendukung konektivitas MQTT 3.1.1 IoT Hub, telemetri, twin perangkat, metode langsung, pesan cloud-ke-perangkat, dan unggahan file. Tidak mendukung IoT Hub dengan MQTTv5 yang diaktifkan.
  • Mendukung autentikasi X.509 dan SAS, atestasi DPS TPM, dan manajemen sertifikat, termasuk penerbitan sertifikat melalui DPS dan pembaruan sertifikat operasional melalui IoT Hub.
  • Mendukung rekoneksi, provisi ulang, dan integrasi khusus untuk platform tertentu.
  • Tidak termasuk klien pembaruan perangkat lunak, yang tersedia dalam versi 2.0.0-preview.2.

C v2.0.0-preview.2 (pratinjau)

  • Mencakup kemampuan versi 1.0.0 dan menambahkan konektivitas ke IoT Hub yang mendukung MQTTv5. DPS mengembalikan profil koneksi IoT Hub yang ditugaskan, dan SDK memilih MQTT 3.1.1 atau MQTT 5.0.
  • Mendukung telemetri, device twins, dan metode langsung dengan kedua profil koneksi, serta topik khusus dengan IoT Hub yang mendukung MQTTv5.
  • Menyediakan integrasi penyedia sertifikat X.509 dan alur manajemen sertifikat yang didukung, termasuk penerbitan sertifikat melalui DPS dan pembaruan sertifikat operasional melalui IoT Hub untuk konfigurasi MQTT 3.1.1. Hub IoT yang mendukung MQTTv5 memerlukan autentikasi X.509 dan tidak mendukung pembaruan sertifikat melalui IoT Hub.
  • Mendukung pemulihan koneksi dan penyediaan ulang untuk skenario yang terdokumentasi.
  • Termasuk pesan cloud-ke-perangkat dan unggahan file untuk skenario MQTT 3.1.1 yang didukung. Operasi ini tidak didukung untuk IoT Hub yang mendukung MQTTv5.
  • Menyediakan klien pembaruan perangkat lunak Azure Device Registry (pratinjau) yang memeriksa pembaruan melalui DPS dan mendukung perangkat yang ditugaskan ke Hub IoT yang mendukung MQTT 3.1.1 atau MQTTv5. Pembaruan perangkat lunak memerlukan autentikasi X.509.
  • Memerlukan integrasi dan konfigurasi spesifik platform sesuai dokumentasi C SDK.
  • API pratinjau mungkin berubah sebelum rilis stabil.

Untuk penambahan, perbaikan, dan batasan yang diketahui berdasarkan versi, lihat informasi rilis Azure IoT SDK dan dokumentasi rilis terkait.

Note

Kemampuan SDK dan persyaratan autentikasi bervariasi menurut bahasa, versi, dan konfigurasi IoT Hub. Manajemen sertifikat harus diaktifkan dan dikonfigurasi pada tingkat namespace Azure Device Registry. Pembaruan perangkat lunak MQTTv5 dan Azure Device Registry memiliki persyaratan pratinjau yang terpisah.

Bagian ini merangkum kemampuan yang terdokumentasi dan pertimbangan pemilihan rilis. Ini bukan log perubahan lengkap. Perubahan yang digabungkan ke cabang repositori main mungkin tidak termasuk dalam rilis SDK yang dipublikasikan, dan pengembangan pratinjau terus berlanjut pada cabang tersebut releases/public-preview . Tinjau tag rilis yang sesuai dan dokumentasi spesifik versi saat memilih SDK.