Menggunakan properti dalam solusi Azure IoT Central
Panduan ini menunjukkan cara menggunakan properti perangkat yang ditentukan dalam templat perangkat di aplikasi Azure IoT Central Anda.
Properti mewakili nilai titik waktu. Misalnya, perangkat dapat menggunakan properti untuk melaporkan suhu target yang coba dijangkaunya. Secara default, properti perangkat baca-saja di IoT Central. Properti yang bisa-tulis memungkinkan Anda menyinkronkan status antara perangkat Anda dan aplikasi Azure IoT Central Anda.
Anda juga dapat menentukan properti cloud di aplikasi Azure IoT Central. Nilai properti cloud tidak pernah ditukar dengan perangkat dan berada di luar cakupan untuk artikel ini.
Untuk mempelajari tentang konvensi properti IoT Pug dan Play, lihat Konvensi IoT Plug and Play.
Untuk mempelajari selengkapnya tentang data properti yang ditukar perangkat dengan IoT Central, lihat Payload telemetri, properti, dan perintah.
Untuk mempelajari cara mengelola properti dengan menggunakan IoT Central REST API, lihat Cara menggunakan IoT Central REST API untuk mengontrol perangkat..
Untuk mempelajari cara menerapkan properti di perangkat tanpa menggunakan SDK perangkat, lihat Berkomunikasi dengan hub IoT menggunakan protokol MQTT.
Menentukan properti Anda
Properti adalah bidang data yang mewakili status perangkat Anda. Gunakan properti untuk mewakili status perangkat yang tahan lama, seperti status aktif/nonaktif perangkat. Properti juga dapat mewakili properti perangkat dasar, seperti versi perangkat lunak perangkat. Anda mendeklarasikan properti sebagai baca-saja atau bisa-tulis.
Cuplikan layar berikut menunjukkan definisi properti di aplikasi Azure IoT Central.
Tabel berikut ini menunjukkan pengaturan konfigurasi untuk kapabilitas properti.
| Bidang | Deskripsi |
|---|---|
| Nama tampilan | Nama tampilan untuk nilai properti yang digunakan pada petak peta dasbor dan formulir perangkat. |
| Nama | Nama properti. Azure IoT Central membuat nilai untuk bidang ini dari nama tampilan, tetapi Anda dapat memilih nilai Anda sendiri jika perlu. Bidang ini harus berupa alfanumerik. Kode perangkat menggunakan nilai Nama ini. |
| Jenis kapabilitas | Properti. |
| Jenis semantik | Jenis semantik properti, seperti suhu, status, atau peristiwa. Pilihan jenis semantik menentukan bidang mana yang tersedia. |
| Skema | Jenis data properti, seperti ganda, string, atau vektor. Jenis semantik menentukan pilihan yang tersedia. Skema tidak tersedia untuk jenis semantik peristiwa dan status. |
| Bisa-tulis | Jika properti bukan bisa-tulis, perangkat dapat melaporkan nilai properti ke Azure IoT Central. Jika properti adalah bisa-tulis, perangkat dapat melaporkan nilai properti ke Azure IoT Central. Kemudian, Azure IoT Central dapat mengirim pembaruan properti ke perangkat. |
| Tingkat keparahan | Hanya tersedia untuk jenis semantik peristiwa. Tingkat keparahannya adalah Kesalahan, Informasi, atau Peringatan. |
| Nilai status | Hanya tersedia untuk jenis semantik status. Tentukan nilai status yang mungkin, yang masing-masing memiliki nama tampilan, nama, jenis enumerasi, dan nilai. |
| Unit | Unit untuk nilai properti, seperti mph, %, atau °C. |
| Unit tampilan | Unit tampilan untuk digunakan di petak peta dasbor dan formulir perangkat. |
| Komentar | Setiap komentar tentang kemampuan properti. |
| Deskripsi | Deskripsi kemampuan properti. |
Untuk mempelajari tentang Digital Twin Definition Language (DTDL) yang digunakan Azure IoT Central untuk menentukan properti dalam templat perangkat, lihat Properti baca-saja konvensi > IoT Plug and Play.
Bidang opsional, seperti nama tampilan dan deskripsi, memungkinkan Anda menambahkan detail selengkapnya ke antarmuka dan kemampuan.
Saat membuat properti, Anda dapat menentukan jenis skema kompleks seperti Objek dan Enum.
Saat Anda memilih Skema kompleks, seperti Objek, Anda perlu menentukan skema objek.
Menerapkan properti baca-saja
Secara default, properti memiliki fitur baca-saja. Properti baca-saja memungkinkan perangkat melaporkan pembaruan nilai properti ke aplikasi Azure IoT Central Anda. Aplikasi Azure IoT Central Anda tidak dapat menetapkan nilai properti baca-saja.
Azure IoT Central menggunakan kembar perangkat untuk menyinkronkan nilai properti antara perangkat dan aplikasi Azure IoT Central. Nilai properti perangkat menggunakan properti yang dilaporkan kembar perangkat. Untuk mengetahui informasi selengkapnya, lihat kembar perangkat.
Perangkat mengirim pembaruan properti sebagai payload JSON. Untuk informasi selengkapnya, lihat Payload telemetri, properti, dan perintah.
Anda dapat menggunakan SDK perangkat Azure IoT untuk mengirim pembaruan properti ke aplikasi Azure IoT Central Anda.
Misalnya implementasi dalam beberapa bahasa, lihat Membuat dan menyambungkan aplikasi klien ke aplikasi Azure IoT Central Anda.
Tampilan berikut di aplikasi Azure IoT Central memperlihatkan properti baca-saja perangkat:
Menerapkan properti bisa-tulis
Operator IoT Central mengatur properti bisa-tulis pada formulir. Azure IoT Central mengirim properti ke perangkat. Azure IoT Central mengharapkan pengakuan dari perangkat.
Misalnya implementasi dalam beberapa bahasa, lihat Membuat dan menyambungkan aplikasi klien ke aplikasi Azure IoT Central Anda.
Pesan respons harus menyertakan bidang ac dan av. Bidang ad bersifat opsional. Untuk mempelajari lebih lanjut, lihat Properti bisa-tulis konvensi > IoT Plug and Play.
Saat operator mengatur properti bisa-tulis di antarmuka pengguna Azure IoT Central, aplikasi menggunakan properti yang diinginkan kembar perangkat untuk mengirim nilai ke perangkat. Perangkat kemudian merespons dengan menggunakan properti yang dilaporkan kembar perangkat. Saat Azure IoT Central menerima nilai properti yang dilaporkan, Azure IoT Central memperbarui tampilan properti dengan status Diterima.
Saat Anda memasukkan nilai dan memilih Simpan, status awal Tertunda. Saat perangkat menerima perubahan, status berubah menjadi Diterima.
Menggunakan properti pada perangkat yang tidak ditetapkan
Anda dapat melihat dan memperbarui properti bisa-tulis pada perangkat yang tidak ditetapkan ke templat perangkat.
Untuk melihat properti yang sudah ada pada perangkat yang tidak ditetapkan, navigasikan ke perangkat di bagian Perangkat , pilih Kelola perangkat, lalu Properti Perangkat:
Anda dapat memperbarui properti bisa-tulis dalam tampilan ini:
Langkah berikutnya
Sekarang setelah Anda mempelajari cara menggunakan properti di aplikasi Azure IoT Central Anda, lihat: