IoT Platform:Konfigurasi jarak jauh

Fitur

Fitur konfigurasi jarak jauh IoT Platform memungkinkan Anda untuk:

• Mengaktifkan atau menonaktifkan konfigurasi jarak jauh untuk suatu produk.

• Mengedit file konfigurasi dan mengelola versinya secara online.

• Mendorong (push) file konfigurasi dari IoT Platform untuk memperbarui konfigurasi perangkat secara batch.

• Memungkinkan perangkat meminta pembaruan konfigurasi secara proaktif.

Kasus Penggunaan

Konfigurasi jarak jauh dapat digunakan dalam dua skenario berikut:

• Dari Konsol IoT Platform, Anda dapat mendorong informasi konfigurasi ke perangkat secara batch. Setelah menerima informasi tersebut, perangkat memperbarui file konfigurasi lokalnya.

• Perangkat secara proaktif meminta file konfigurasi baru dari IoT Platform untuk melakukan pembaruan.

Bagian berikut menjelaskan prosedur untuk kasus-kasus penggunaan tersebut.

Kasus Penggunaan 1: IoT Platform mendorong konfigurasi

Di Konsol IoT Platform, Anda dapat mendorong file konfigurasi ke semua perangkat suatu produk secara batch.

1. Hubungkan perangkat ke IoT Platform.

   Untuk informasi lebih lanjut mengenai proses pengembangan perangkat dan contoh kode, lihat dokumentasi Link SDK.

   Penting

   Saat mengembangkan perangkat, Anda harus mengonfigurasi perangkat untuk berlangganan (subscribe) ke topik dorongan informasi konfigurasi: /sys/${productKey}/${deviceName}/thing/config/push.

2. Di Konsol IoT Platform, edit file konfigurasi.

   1. Masuk ke Konsol IoT Platform.

   2. Di halaman Overview, klik All environment. Di tab All environment, temukan instans yang ingin Anda kelola lalu klik ID instans atau nama instans tersebut.

   3. Di panel navigasi sebelah kiri, pilih Maintenance > Remote Configuration.

   4. Pilih produk, aktifkan sakelar konfigurasi jarak jauh, lalu klik Edit.

   5. Di editor di bawah Configuration Template, tulis atau tempel informasi konfigurasi dalam format JSON.

      Catatan

      Templat konfigurasi produk berlaku untuk semua perangkat di bawah produk tersebut. Anda tidak dapat mendorong file konfigurasi ke satu perangkat saja dari Konsol IoT Platform.

   6. Setelah mengedit informasi konfigurasi, klik Save, lalu klik Confirm.

      Setelah disimpan, Anda dapat secara manual mendorong informasi konfigurasi ke semua perangkat di bawah produk tersebut secara batch, atau perangkat dapat meminta konfigurasi ini secara proaktif.

3. Klik Batch Update, lalu klik Confirm Update.

   Setelah Anda mengonfirmasi, IoT Platform akan mendorong file konfigurasi ke semua perangkat di bawah produk tersebut secara batch.

   Jika IoT Platform mendeteksi bahwa operasi dilakukan di lingkungan yang tidak tepercaya setelah Anda mengklik Batch Update, sistem akan memicu verifikasi SMS. IoT Platform hanya akan mengirim file konfigurasi ke perangkat setelah Anda menyelesaikan verifikasi tersebut.

   Penting

   • Setelah dorongan berhasil, Anda tidak dapat mendorong file konfigurasi baru ke produk yang sama dalam waktu satu jam.

   • Anda hanya dapat mendorong file konfigurasi yang sama ke suatu produk satu kali dari IoT Platform.

   • Untuk menghentikan pembaruan batch konfigurasi perangkat, nonaktifkan sakelar konfigurasi jarak jauh untuk produk tersebut. Setelah Anda menonaktifkan konfigurasi jarak jauh, IoT Platform akan menghentikan semua dorongan pembaruan dan menolak permintaan pembaruan proaktif dari perangkat.

4. Perangkat menerima URL unduhan file konfigurasi dari IoT Platform dan memperbarui konfigurasinya.

   Catatan

   URL unduhan file konfigurasi berlaku selama 30 menit. Perangkat harus mengunduh file tersebut dalam periode ini.

5. (Opsional) Tampilkan dan kelola versi file konfigurasi.

   Fitur konfigurasi jarak jauh menyimpan lima catatan modifikasi terakhir secara default. Jika Anda berhasil mengedit dan mengirimkan file konfigurasi baru, versi sebelumnya akan muncul dalam daftar riwayat versi di bawah ini.

   Anda dapat melihat waktu dan isi pembaruan setiap versi untuk keperluan jejak (traceability). Klik View pada versi tertentu untuk melihat isinya dalam kotak dialog. Di kotak dialog tersebut, Anda dapat mengklik Restore to This Version untuk memuat isinya ke editor. Anda kemudian dapat memodifikasi isinya dan melakukan pembaruan batch.

Kasus Penggunaan 2: Perangkat meminta konfigurasi

Bagan alir berikut menunjukkan cara perangkat secara proaktif melakukan kueri dan memperbarui informasi konfigurasinya.

1. Hubungkan perangkat ke IoT Platform.

   Untuk informasi lebih lanjut mengenai proses pengembangan perangkat dan contoh kode, lihat dokumentasi Link SDK.

   Catatan

   Saat mengembangkan perangkat, Anda harus mengonfigurasinya untuk berlangganan ke topik yang digunakan IoT Platform dalam merespons permintaan informasi konfigurasi dari perangkat: /sys/${productKey}/${deviceName}/thing/config/get_reply.

2. Di Konsol IoT Platform, aktifkan konfigurasi jarak jauh dan edit informasi konfigurasi. Untuk informasi lebih lanjut, lihat Langkah 2 di Kasus Penggunaan 1.

3. Perangkat memanggil antarmuka linkkit_invoke_cota_get_config untuk memicu permintaan konfigurasi jarak jauh.

4. Perangkat mengirim permintaan ke topik /sys/${productKey}/${deviceName}/thing/config/get untuk melakukan kueri informasi konfigurasi terbaru.

5. Setelah menerima permintaan, IoT Platform mengembalikan informasi konfigurasi terbaru ke topik: /sys/${productKey}/${deviceName}/thing/config/get_reply.

6. Perangkat menggunakan URL yang diberikan untuk mengunduh file konfigurasi.

   Sebagai contoh, C SDK v3.x menyediakan fungsi callback cota_callback untuk mengunduh file konfigurasi dan menyelesaikan pembaruan.

   Catatan

   URL unduhan file konfigurasi berlaku selama 30 menit. Perangkat harus mengunduh file tersebut dalam periode ini.