全部产品
Search
文档中心

IoT Platform:Lihat status pembaruan

更新时间:Jul 06, 2025

Setelah mengirimkan permintaan pembaruan batch, IoT Platform akan mendorong notifikasi pembaruan ke perangkat Anda sesuai dengan pengaturan yang telah ditentukan. Anda dapat melihat status pembaruan perangkat dan informasi terkait paket pembaruan di konsol IoT Platform.

Prasyarat

Permintaan pembaruan batch harus sudah dikirimkan. Untuk informasi lebih lanjut tentang cara melepas kebijakan tag dari objek, lihat Memulai Pembaruan Batch.

Prosedur

  1. Masuk ke Konsol IoT Platform.

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

  3. Di panel navigasi sisi kiri, pilih Maintenance > OTA Update.
    Catatan Untuk memberikan layanan yang lebih baik, IoT Platform meningkatkan fitur pembaruan OTA dan menambahkan statistik pada versi paket pembaruan. Saat pertama kali menggunakan fitur pembaruan OTA baru di konsol, Anda harus mengaitkan paket pembaruan yang diunggah dengan produk. Setiap paket pembaruan hanya dapat dikaitkan dengan satu produk. Untuk informasi lebih lanjut tentang cara mengaitkan paket pembaruan dengan produk, lihat petunjuk di konsol.
  4. Di tab Paket Pembaruan, temukan paket pembaruan yang ingin digunakan untuk pembaruan batch dan klik View di kolom Tindakan. Kemudian, Anda dapat melihat informasi dan melakukan operasi pada tab berikut:
    • Batch Management
      • Lihat jenis batch pembaruan, seperti Verifikasi Paket Pembaruan atau Pembaruan Batch.
      • Temukan batch pembaruan dan klik View di kolom Tindakan. Di halaman Batch Details, Anda dapat melihat perangkat dalam berbagai status di tab Device List.
        StatusDeskripsi
        Menunggu KonfirmasiTugas pembaruan OTA belum dikonfirmasi menggunakan aplikasi seluler.

        Jika Anda mengatur parameter APP Confirm Upgrade ke Yes saat membuat batch pembaruan, tugas pembaruan dalam batch tersebut akan berada dalam status ini.

        Akan DidorongNotifikasi pembaruan OTA belum didorong ke perangkat.

        Tugas pembaruan mungkin berada dalam status ini karena alasan berikut: 1. Perangkat offline. 2. Notifikasi dijadwalkan untuk didorong. 3. Laju dorongan melebihi ambang batas tertentu. Status berikut yang sesuai dengan alasan ini ditampilkan:

        • To Be Pushed (Device Offline)
        • To Be Pushed (Scheduled:XX XX, XXXX, XX:XX:XX)
        • To Be Pushed
        DidorongPerangkat telah menerima notifikasi pembaruan OTA tetapi belum mengirimkan kemajuan pembaruan.
        Dalam pembaruanPerangkat telah menerima notifikasi pembaruan OTA dan mengirimkan kemajuan pembaruan.
        DiperbaruiPerangkat telah mengirimkan nomor versi yang valid setelah pembaruan.
        Catatan Setelah perangkat diperbarui, pastikan perangkat mengirimkan nomor versi yang valid secepat mungkin. Jika tidak, pembaruan mungkin gagal karena masalah waktu habis.
        Pembaruan GagalPembaruan OTA mungkin gagal karena alasan berikut:
        • Sebagai contoh, Anda memulai pembaruan batch baru untuk perangkat dan Anda tidak menimpa tugas pembaruan sebelumnya yang belum selesai di perangkat.

          Dalam kasus ini, Anda dapat melakukan operasi berikut:

          • Setelah tugas pembaruan sebelumnya selesai, mulai pembaruan baru.
          • Sebelum Anda memulai pembaruan baru untuk perangkat, timpa tugas sebelumnya yang sedang berjalan di perangkat.
            Catatan Jika perangkat berada dalam status In upgrade, tugas pembaruan yang sedang berjalan di perangkat tidak dapat ditimpa.
        • Perangkat mengirimkan nilai -1, nilai -2, nilai -3, atau nilai -4 yang menunjukkan bahwa terjadi kegagalan saat perangkat menggunakan topik tertentu untuk mengirimkan kemajuan pembaruan ke IoT Platform. Deskripsi nilai:
          • -1: Pembaruan gagal.
          • -2: Unduhan gagal.
          • -3: Verifikasi gagal.
          • -4: Flashing gagal.
        • Selama pembaruan perangkat, pertama kali perangkat mengirimkan kemajuan pembaruan, sistem mulai menghitung durasi pembaruan. Jika perangkat gagal mengirimkan nomor versi yang diperbarui dalam periode timeout yang ditentukan, pembaruan gagal.
        • Perangkat yang berada dalam status In upgrade mengirimkan nomor versi yang bukan versi sumber atau versi tujuan.

        Jika Anda menentukan nomor versi yang akan diperbarui dan menentukan interval ulang saat Anda memulai pembaruan batch, ulangan dilakukan setelah pembaruan gagal. Pembaruan mungkin gagal karena salah satu alasan berikut:

        • Perangkat yang berada dalam status In upgrade mengirimkan nomor versi yang bukan versi sumber atau versi tujuan.
        • Perangkat mengirimkan salah satu nilai berikut saat perangkat menggunakan topik tertentu untuk mengirimkan kemajuan pembaruan ke IoT Platform: -1, -2, -3, dan -4.

        Selama ulangan otomatis, status pembaruan perangkat di IoT Platform tetap tidak berubah. Sebagai contoh, jika ulangan dilakukan pada perangkat yang berada dalam status Pushed, status perangkat ditampilkan sebagai Pushed di konsol IoT Platform. Jika ulangan dilakukan pada perangkat yang berada dalam status In upgrade, status perangkat masih ditampilkan sebagai In upgrade di konsol IoT Platform.

        Catatan

        Jika pembaruan gagal karena salah satu alasan berikut, ulangan otomatis tidak dilakukan oleh IoT Platform:

        • Pembaruan habis waktu.
        • Pembaruan dibatalkan.
        DibatalkanPembaruan untuk perangkat dibatalkan.

        Jika batch pembaruan berada dalam status In upgrade, tombol Edit akan ditampilkan di kolom Actions batch pembaruan. Anda dapat mengklik Edit. Di langkah Konfigurasi Kebijakan Pembaruan halaman yang muncul, Anda dapat mengubah nilai parameter Update at Constant Rate jika parameter Update Package Push Rate diatur ke Constant Rate, atau mengubah nilai parameter yang diperlukan jika parameter Update Package Push Rate diatur ke Laju Variabel. Anda juga dapat memodifikasi tag yang ada atau menambahkan tag baru. Untuk informasi lebih lanjut, lihat Memulai Pembaruan Batch.

        Anda juga dapat mengklik tab Batch information untuk melihat informasi dasar tentang batch. Jika batch pembaruan berada dalam status In upgrade, tombol Edit akan ditampilkan di sebelah Tag Information. Anda dapat mengklik Edit untuk memodifikasi atau menambahkan tag.

        Modify a tag
      • Temukan batch pembaruan dan klik Cancel di kolom Tindakan.
        • Jika Anda membatalkan batch pembaruan statis, semua tugas pembaruan dalam batch secara otomatis dibatalkan, termasuk tugas yang berada dalam status Menunggu Konfirmasi, Akan Didorong, Didorong, dan Diperbarui.
        • Jika Anda membatalkan batch pembaruan dinamis, hanya kebijakan pembaruan dinamis yang dibatalkan. Anda dapat membatalkan semua tugas pembaruan yang sedang berlangsung berdasarkan kebutuhan bisnis Anda, termasuk tugas yang berada dalam status Akan Didorong, Didorong, dan Dalam Pembaruan.

        Anda dapat membatalkan semua tugas pembaruan perangkat yang berada dalam status Pending Confirmation, To Be Pushed, atau Pushed.

    • Device List

      Lihat informasi tentang perangkat ke mana paket pembaruan didorong, termasuk status pembaruan perangkat, serta informasi statistik tentang pembaruan yang berhasil, gagal, dan dibatalkan.

      Temukan perangkat dan klik View di kolom Tindakan. Di halaman Batch Details, Anda dapat membatalkan tugas pembaruan perangkat.

    • Update Package Information
      • Lihat informasi dasar tentang paket pembaruan, seperti ID, nama, tanda tangan, algoritma tanda tangan, nomor versi, status, dan modul paket pembaruan.
      • Untuk mendapatkan paket pembaruan, klik Download di sebelah Update Package Signature.

Apa yang harus dilakukan selanjutnya

Lihat Statistik Versi Paket Pembaruan dan Tingkat Keberhasilan: Setelah tugas pembaruan OTA selesai, Anda dapat membuka tab Analisis Data untuk melihat distribusi versi paket pembaruan dan informasi statistik tentang tingkat keberhasilan pembaruan.

Operasi API terkait

APIDeskripsi
ListOTAJobByFirmwareMengquery batch pembaruan dari paket pembaruan.
ListOTAJobByDeviceMengquery batch pembaruan dari paket pembaruan berdasarkan perangkat.
ListOTATaskByJobMengquery tugas pembaruan perangkat berdasarkan batch pembaruan.
QueryOTAJobMengquery detail tugas pembaruan.

Untuk informasi lebih lanjut tentang operasi API terkait fitur pembaruan OTA, lihat Pembaruan OTA.