Perangkat gateway Message Queuing Telemetry Transport (MQTT) dapat berkomunikasi dengan IoT Platform menggunakan topik kustom. IoT Platform mendukung komunikasi hulu dan hilir perangkat, serta menyediakan panduan untuk mengimplementasikan komunikasi tersebut.
Topik
IoT Platform berkomunikasi dengan perangkat gateway melalui topik MQTT. Anda harus mendefinisikan topik kustom sesuai dengan spesifikasi protokol MQTT standar. Untuk detail lebih lanjut tentang topik, lihat Topik.
Topik yang digunakan oleh perangkat untuk mengirim data hulu juga digunakan untuk menerima data hilir.
Tabel berikut menjelaskan perbedaan antara topik yang didukung oleh IoT Platform dan topik dalam protokol MQTT standar.
Item | IoT Platform | Protokol MQTT standar |
Panjang | Topik harus memiliki panjang 1 hingga 128 karakter. | Topik dapat memiliki panjang hingga 65.535 karakter. |
Karakter set | Topik hanya dapat berisi huruf, angka, dan garis bawah (_). | Topik dapat berisi karakter UTF-8. Tidak ada batasan lainnya. |
Batasan
Perangkat gateway MQTT dapat berlangganan hingga 100 topik.
Jika parameter Otorisasi Operasi Perangkat untuk kategori topik diatur ke Subscribe, Anda dapat menggunakan karakter wildcard
tanda plus (+)dantanda pagar (#)untuk memungkinkan langganan ke beberapa topik sekaligus. Untuk informasi lebih lanjut, lihat Topik kustom dengan satu atau lebih karakter wildcard.
Komunikasi Hulu: perangkat ke IoT Platform
Perangkat mempublikasikan pesan ke topik kustom, dan IoT Platform menerima pesan tersebut melalui langganan sisi server Protokol Pengantrean Pesan Lanjutan (AMQP) atau fitur penerusan data.
Saat mengonfigurasi aturan penerusan data, perhatikan hal-hal berikut:
Gunakan versi baru fitur penerusan data untuk mengonfigurasi aturan penerusan data perangkat gateway. Untuk detailnya, lihat Konfigurasikan parser penerusan data.
Pesan dari produk dan perangkat gateway IoT Platform tidak dapat diteruskan ke produk dan perangkat umum IoT Platform, begitu juga sebaliknya.
Saat meneruskan data perangkat gateway ke topik lain, konfigurasikan parameter deviceName. Untuk informasi lebih lanjut, lihat Teruskan data ke tujuan.
Untuk menentukan topik sumber dari mana data diteruskan, masukkan nama topik tersebut. Untuk detailnya, lihat Buat sumber data.
Langganan sisi server hanya mendukung pendorongan data dari tipe Device Upstream Notification, Device Status Change Notification, dan Device Changes Throughout Lifecycle. Untuk informasi lebih lanjut, lihat Konfigurasikan langganan sisi server AMQP.
Komunikasi Hilir: IoT Platform ke perangkat
IoT Platform memanggil operasi API Pub untuk mempublikasikan pesan ke topik kustom tertentu. Perangkat menerima pesan tersebut dengan berlangganan topik yang bersangkutan.