IoT Platform：Konfigurasi jarak jauh

Fitur

Berikut adalah operasi yang dapat dilakukan terkait dengan fitur konfigurasi jarak jauh:

• Mengaktifkan atau menonaktifkan fitur konfigurasi jarak jauh.

• Mengedit file konfigurasi dan mengelola versi file di konsol IoT Platform.

• Mendorong file konfigurasi dari IoT Platform ke beberapa perangkat sekaligus untuk memperbarui konfigurasi.

• Mengaktifkan perangkat untuk meminta file konfigurasi.

Skenario

Fitur konfigurasi jarak jauh cocok untuk skenario berikut:

• IoT Platform mendorong informasi konfigurasi ke beberapa perangkat sekaligus. Setiap perangkat menerima informasi tersebut dan memodifikasi file konfigurasi lokal sesuai dengan informasi yang diterima.

• Perangkat meminta file konfigurasi dari IoT Platform dan melakukan pembaruan.

Berikut adalah prosedur untuk skenario di atas.

Skenario 1: IoT Platform mendorong informasi konfigurasi ke perangkat

Di konsol IoT Platform, Anda dapat mendorong file konfigurasi ke semua perangkat dari suatu produk sekaligus.

1. Hubungkan perangkat ke IoT Platform.

   Untuk informasi tentang cara mengonfigurasi Link SDK, lihat Dokumentasi Link SDK.

   Penting

   Saat mengonfigurasi perangkat, berlanggananlah ke topik berikut yang digunakan untuk mendorong informasi konfigurasi: /sys/${productKey}/${deviceName}/thing/config/push.

2. Di konsol IoT Platform, modifikasi file konfigurasi.

   1. Masuk ke konsol IoT Platform.

   2. Di halaman Overview, klik All environment. Pada tab Semua Lingkungan, temukan instance yang ingin Anda kelola dan klik ID instance atau nama instance.

   3. Di panel navigasi sisi kiri, pilih Device Log.

   4. Pilih produk, aktifkan Konfigurasi Jarak Jauh, lalu klik Edit.

      

   5. Di editor kode bagian Konfigurasi Template, tulis atau tempel informasi konfigurasi dalam format JSON.

      Catatan

      Template konfigurasi berlaku untuk semua perangkat dari suatu produk. Anda tidak dapat mendorong file konfigurasi ke satu perangkat di konsol IoT Platform.

   6. Klik Simpan, lalu klik OK.

      Anda dapat mendorong file konfigurasi ke semua perangkat dari suatu produk sekaligus. Anda juga dapat mengaktifkan perangkat untuk meminta file konfigurasi.

3. Klik Pembaruan Massal, lalu klik Confirm Update.

   IoT Platform mendorong file konfigurasi ke semua perangkat dari produk tersebut.

   Jika IoT Platform mendeteksi bahwa operasi tidak dilakukan di lingkungan tepercaya setelah Anda klik Batch Update, IoT Platform akan mengirimkan pesan teks kepada Anda untuk verifikasi. File konfigurasi hanya akan dikirimkan ke perangkat setelah verifikasi selesai.

   Penting

   • Setelah Anda mendorong file konfigurasi ke suatu produk, Anda tidak dapat mendorong file konfigurasi lain ke produk tersebut dalam waktu 1 jam.

   • Anda hanya dapat mendorong file konfigurasi ke suatu produk sekali di konsol IoT Platform. Saat Anda mengulangi langkah-langkah di atas untuk mendorong file konfigurasi yang sama ke produk tersebut, operasi dorongan gagal.

   • Jika Anda ingin menghentikan pembaruan massal, Anda dapat menonaktifkan Konfigurasi Jarak Jauh untuk produk tersebut. Setelah Anda menonaktifkan Konfigurasi Jarak Jauh untuk produk tersebut, IoT Platform berhenti mendorong file konfigurasi dan menolak permintaan pembaruan dari perangkat.

4. Perangkat secara otomatis memperbarui konfigurasi setelah menerima URL unduhan file konfigurasi dari IoT Platform.

   Catatan

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

5. Opsional. Lihat dan kelola versi file konfigurasi.

   Secara default, lima versi terbaru dari file konfigurasi disimpan di konsol IoT Platform. Setelah Anda mengedit dan menyimpan versi baru dari file konfigurasi, versi sebelumnya secara otomatis ditampilkan di bagian Rekaman Versi Konfigurasi.

   Anda dapat melihat waktu pembaruan dan isi file konfigurasi. Temukan file konfigurasi yang ingin Anda lihat waktu pembaruan dan isinya, lalu klik View di kolom Tindakan. Di kotak dialog yang muncul, Anda dapat melihat isi tersebut. Anda juga dapat mengklik Restore to This Version untuk mengembalikan isi versi yang dipilih ke editor kode. Kemudian, Anda dapat memodifikasi isi tersebut dan memperbarui konfigurasi beberapa perangkat sekaligus.

Skenario 2: Aktifkan perangkat untuk meminta file konfigurasi

Gambar berikut menunjukkan prosesnya.

1. Hubungkan perangkat ke IoT Platform.

   Untuk informasi lebih lanjut tentang cara menggunakan Link SDK untuk mengonfigurasi perangkat dan kode contoh, lihat Dokumentasi Link SDK.

   Catatan

   Saat mengonfigurasi perangkat, berlanggananlah ke topik berikut yang digunakan oleh IoT Platform untuk mengirim respons ke permintaan informasi konfigurasi dari perangkat: /sys/${productKey}/${deviceName}/thing/config/get_reply.

2. Di konsol IoT Platform, aktifkan fitur konfigurasi jarak jauh dan modifikasi file konfigurasi. Untuk informasi lebih lanjut, lihat Langkah 2 di .Skenario 1: IoT Platform Mendorong Informasi Konfigurasi ke Perangkat

3. Panggil operasi linkkit_invoke_cota_get_config untuk menghasilkan permintaan konfigurasi jarak jauh.

4. Kirim permintaan ke topik berikut untuk menanyakan informasi konfigurasi terbaru: /sys/${productKey}/${deviceName}/thing/config/get.

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

6. Kemudian, perangkat menggunakan URL yang dikirim dari IoT Platform untuk mengunduh file konfigurasi.

   Sebagai contoh, Anda dapat memanggil fungsi callback cota_callback yang disediakan oleh Link SDK for C V3.x untuk memproses URL unduhan file konfigurasi dan melakukan pembaruan.

   Catatan

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