Ikhtisar - IoT Platform

IoT Platform menyediakan fitur pembaruan dan manajemen over-the-air (OTA). Sebelum memperbarui perangkat, pastikan perangkat mendukung layanan OTA. Jika didukung, Anda dapat mengunggah paket pembaruan di halaman Pembaruan OTA pada konsol IoT Platform dan menentukan informasi terkait perangkat yang ingin diperbarui. Setelah IoT Platform memberi notifikasi pembaruan OTA ke perangkat, perangkat dapat mengunduh paket pembaruan OTA dan melakukan pembaruan. Topik ini menjelaskan batasan serta proses untuk pembaruan OTA.

Prasyarat

Sebelum menggunakan fitur pembaruan OTA, pastikan perangkat mendukung layanan OTA.

Untuk panduan lebih lanjut tentang cara melakukan pembaruan OTA menggunakan SDK perangkat, lihat Melakukan pembaruan OTA.
Untuk informasi lebih lanjut tentang pembaruan OTA jika chip AliOS Things dipasang pada perangkat Anda, lihat Tutorial OTA untuk AliOS Things.

Catatan penggunaan dan batasan

Tabel 1. Perangkat

Fitur	Batasan
Protokol yang didukung	Hanya perangkat yang terhubung ke IoT Platform melalui Message Queuing Telemetry Transport (MQTT) yang mendukung fitur pembaruan OTA.
Pembaruan OTA untuk perangkat terdistribusi	Setelah perangkat didistribusikan ke instance tujuan, Anda dapat melakukan pembaruan OTA pada perangkat tersebut.

Tabel 2. Paket pembaruan

Fitur	Batasan
Paket pembaruan	Setiap akun Alibaba Cloud dapat memiliki hingga 500 paket pembaruan.
Paket pembaruan	Saat Anda mengunduh paket pembaruan melalui HTTPS, perhatikan batasan berikut: Ukuran maksimum file paket pembaruan adalah 1.000 MB. Format file bisa berupa `.bin`, `.dav`, `.tar`, `.gz`, `.zip`, `.gzip`, `.apk`, `.tar.gz`, `.tar.xz`, atau `.pack`. Saat Anda mengunduh paket pembaruan melalui MQTT, paket pembaruan hanya dapat berisi satu file dan ukuran file tidak boleh melebihi 16 MB.

Tabel 3. Batch pembaruan

Fitur	Catatan penggunaan dan batasan
Pembaruan berbasis versi	Batasan: Pembaruan statis: Anda dapat menggunakan paket pembaruan untuk membuat satu atau beberapa batch pembaruan statis untuk versi berbeda yang akan diperbarui. Pembaruan dinamis: Anda dapat menggunakan paket pembaruan untuk membuat hanya satu batch pembaruan dinamis. Jika Anda mengatur parameter Upgrade range ke All Devices, Anda dapat menentukan beberapa versi untuk parameter Version number to be upgraded. Jika Anda mengatur parameter Upgrade range ke All Devices dan menentukan versi yang akan diperbarui, hingga 10 pembaruan dapat dilakukan pada perangkat dalam batch pembaruan dinamis. Anda dapat menggunakan beberapa paket pembaruan untuk membuat beberapa batch pembaruan dinamis untuk versi yang sama. Dalam hal ini, hanya batch pembaruan dinamis terbaru yang berlaku.
Pembaruan berbasis versi	Catatan penggunaan: Jika Anda mengatur parameter The device supports simultaneous updates of multiple modules ke No saat Anda memulai batch pembaruan untuk perangkat, perangkat hanya dapat memiliki satu tugas pembaruan yang sedang berlangsung untuk satu modul pada saat yang sama. Jika tidak, konflik pembaruan akan terjadi. Dalam hal ini, tugas pembaruan dapat berada dalam status Akan Didorong, Sudah Didorong, atau Sedang Diperbarui. Jika Anda mengatur parameter The device supports simultaneous updates of multiple modules ke Yes dalam batch pembaruan untuk perangkat, perangkat dapat memiliki beberapa tugas pembaruan yang sedang berlangsung untuk modul berbeda pada saat yang sama. Dalam hal ini, tugas pembaruan dapat berada dalam status Akan Didorong, Sudah Didorong, atau Sedang Diperbarui. Penting Dalam hal ini, perangkat harus menggunakan Link SDK V4.x untuk C.
Pembaruan berbasis grup	Catatan penggunaan: Jika Anda menghapus grup perangkat atau menghapus perangkat dari grup perangkat, tugas OTA yang ada dari grup tidak terpengaruh. Untuk informasi lebih lanjut tentang cara membuat dan menggunakan grup perangkat , lihat Grup perangkat.

Tabel 4. Pembaruan bersamaan pada beberapa modul

Fitur	Deskripsi
Wilayah yang didukung	China (Shanghai) dan Jepang (Tokyo).
Instance yang didukung	Instance Enterprise Edition dan instance publik versi baru.
Link SDK yang didukung	Link SDK V4.x untuk C.
Konfigurasi kebijakan pembaruan	Anda dapat mengatur parameter The device supports simultaneous updates of multiple modules atau Override Previous Device Update Tasks ke Yes.
Batasan	Anda dapat menjalankan hingga lima tugas pembaruan pada modul berbeda di perangkat secara bersamaan. Anda dapat melakukan pembaruan bersamaan pada beberapa modul atau menimpa pembaruan sebelumnya di batch pembaruan berbeda pada perangkat yang sama dari suatu produk. Sebagai contoh, Anda tidak dapat menggunakan satu atau lebih paket pembaruan untuk mengatur parameter The device supports simultaneous updates of multiple modules ke Yes dan parameter Override Previous Device Update Tasks ke Yes untuk pembaruan batch berbeda untuk memperbarui produk yang sama. Jika Anda ingin memperbarui perangkat Anda, jangan lakukan operasi tersebut.

Proses

Konfigurasikan fitur pembaruan OTA: Konfigurasikan fitur pembaruan OTA jarak jauh untuk perangkat.
Tambahkan paket pembaruan: Tambahkan modul OTA dan paket pembaruan ke produk.
Verifikasi paket pembaruan (Opsional): Verifikasi paket pembaruan.
Catatan
- Jika Anda mengatur parameter Verify Update Package? ke No saat menambahkan paket pembaruan, lewati langkah ini.
- Setelah perangkat yang diuji diperbarui dan status paket pembaruan berubah menjadi Verified, Anda dapat memulai pembaruan massal.
Mulai pembaruan massal: IoT Platform mengirimkan informasi pembaruan OTA ke perangkat yang ditentukan. Informasi tersebut mencakup URL, versi, dan ukuran paket pembaruan.
Catatan
Saat memulai pembaruan massal, Anda dapat mengatur parameter Whether IoT Platform Actively Pushes Update Task ke salah satu nilai berikut:
- Yes: IoT Platform mendorong informasi pembaruan OTA ke perangkat online.
- No: IoT Platform tidak mendorong informasi pembaruan OTA ke perangkat. Perangkat harus mengirim permintaan ke IoT Platform untuk mendapatkan informasi pembaruan OTA.
  Untuk informasi lebih lanjut, lihat Langkah 4 yang dijelaskan di bagian Format Pesan pada topik Melakukan Pembaruan OTA.
Melakukan Pembaruan OTA: Perangkat mendapatkan informasi pembaruan OTA, menggunakan URL untuk mengunduh paket pembaruan, dan kemudian melakukan pembaruan OTA.
Catatan
URL paket pembaruan tetap valid selama 24 jam. Perangkat dapat mengunduh paket pembaruan dalam periode yang ditentukan. Jika paket pembaruan tidak diunduh dalam waktu 24 jam, perangkat dapat meminta informasi pembaruan dari IoT Platform dan mengunduh paket pembaruan. Untuk informasi lebih lanjut, lihat skenario berikut.
Skenario:
- Perangkat segera mengunduh paket pembaruan dan melakukan pembaruan OTA. Untuk informasi lebih lanjut, lihat Langkah 5 yang dijelaskan di bagian Format Pesan pada topik "Melakukan Pembaruan OTA".
- Perangkat tidak segera mengunduh paket pembaruan. Perangkat meminta informasi pembaruan dari IoT Platform selama jam-jam sepi lalu melakukan pembaruan OTA. Untuk informasi lebih lanjut, lihat Langkah 4 yang dijelaskan di bagian Format Pesan pada topik "Melakukan Pembaruan OTA".
Lihat status pembaruan: Lihat status pembaruan perangkat dan informasi tentang paket pembaruan.
Lihat statistik versi paket pembaruan dan tingkat keberhasilan: Lihat informasi statistik tentang versi dan tingkat keberhasilan tugas pembaruan setelah pembaruan selesai. Anda juga dapat mengidentifikasi penyebab kegagalan pembaruan untuk meningkatkan tingkat keberhasilan.

Referensi

Untuk informasi lebih lanjut tentang contoh pembaruan OTA, lihat Konfigurasikan pembaruan OTA untuk perangkat.
Untuk informasi lebih lanjut tentang cara menyelesaikan masalah dan memperbaiki kesalahan OTA, lihat Bagaimana cara menyelesaikan masalah kesalahan pembaruan OTA?