MQTT menggunakan pengiriman pesan pub/sub asinkron yang tidak mendukung komunikasi sinkron dari server ke perangkat. IoT Platform menyediakan Revert-RPC (RRPC) melalui MQTT sehingga server Anda dapat mengirim permintaan ke perangkat dan menunggu respons secara sinkron.
Glosarium
|
Term |
Description |
|
RRPC |
Revert-RPC. RPC (Remote Procedure Call) menggunakan model client/server untuk meminta layanan secara remote tanpa perlu memahami protokol dasarnya. RRPC memperluas model ini untuk memungkinkan komunikasi request-response secara sinkron antara server dan perangkat. |
|
RRPC subscription topic |
Topik yang di-subscribe oleh perangkat untuk menerima pesan RRPC. Berisi karakter wildcard. |
|
RRPC request message |
Pesan yang dikirim IoT Platform ke perangkat. |
|
RRPC response message |
Pesan yang dikirim perangkat kembali ke IoT Platform. |
|
RRPC message ID |
ID unik yang dihasilkan IoT Platform untuk setiap panggilan RRPC guna membedakan pesan RRPC. |
Cara kerja RRPC
Prosesnya sebagai berikut:
-
(Opsional) Perangkat melakukan subscribe ke topik RRPC terkait.
IoT Platform menyediakan mekanisme request-response RRPC kustom berbasis MQTT. Untuk menerima pesan RRPC, perangkat harus berlangganan ke topik tersebut dan Anda harus mengimplementasikan logika pemrosesan data pada perangkat.
-
Perangkat mengirim instruksi SUB untuk berlangganan ke suatu topik dan menerima pesan dari IoT Platform. Link SDK menyediakan contoh kode berlangganan.
-
Untuk mengimplementasikan pemrosesan pesan RRPC pada perangkat, ikuti contoh pengembangan fitur RRPC.
-
-
Server Anda memanggil API RRpc IoT Platform.
-
IoT Platform menerima permintaan tersebut dan mengirim pesan permintaan RRPC ke perangkat. Isi pesan berisi data permintaan dari server dan dikirim ke topik yang ditentukan oleh IoT Platform, mencakup RRPC message ID.
-
Setelah perangkat menerima pesan terminasi seluler, perangkat tersebut mengirim respons RRPC ke IoT Platform. Respons dikirim ke topik dalam format tertentu yang mencakup RRPC message ID dari permintaan.
-
IoT Platform mengekstraksi RRPC message ID dan mencocokkannya dengan permintaan asli.
-
IoT Platform mengembalikan respons tersebut ke server Anda.
-
(Opsional) Perangkat memproses pesan dari topik yang telah di-subscribe.
Saat Anda memanggil API RRpc:
-
Jika perangkat sedang offline, IoT Platform mengembalikan error device-offline.
-
Jika perangkat tidak memberikan respons dalam waktu 8 detik, IoT Platform mengembalikan error timeout.
Jenis topik
Tersedia dua format topik:
-
Panggil topik kustom (Direkomendasikan): Menggabungkan RRPC dengan topik kustom untuk mendukung berbagai skenario.
-
Panggil topik komunikasi RRPC: Menggunakan topik komunikasi default. Penerapannya terbatas dan tidak direkomendasikan.
Topik Mengontrol server Raspberry Pi dari jarak jauh menunjukkan implementasi RRPC secara praktis.