Anda dapat mengunggah file perangkat ke IoT Platform melalui MQTT, yang mengurangi overhead sumber daya perangkat keras dan biaya pengembangan. Artikel ini menjelaskan cara mengonfigurasi Link SDK untuk C untuk mengunggah file perangkat ke IoT Platform.
Prasyarat
Informasi verifikasi perangkat telah diperoleh.
Perangkat diverifikasi menggunakan sertifikat perangkat yang diterbitkan oleh IoT Platform. Untuk informasi lebih lanjut, lihat Memperoleh informasi verifikasi perangkat.
Perangkat diverifikasi menggunakan informasi verifikasi perangkat kustom. Untuk informasi lebih lanjut, lihat Menambahkan perangkat ke produk gateway MQTT.
Saat menyesuaikan SDK di halaman SDK customization, atur opsi Advanced Capabilities ke File Uploading.
Konteks
- Untuk informasi lebih lanjut tentang fitur manajemen file dari IoT Platform, lihat Manajemen file.
- Setelah file diunggah, Anda dapat memanggil operasi API untuk mengelola file tersebut di konsol IoT Platform. Untuk informasi lebih lanjut, lihat artikel berikut:
Cara kerjanya
Aplikasi program perangkat mengunggah file ke IoT Platform melalui MQTT .
- Anda harus membuat koneksi MQTT. Untuk informasi lebih lanjut, lihat Ikhtisar.
- Gambar berikut menunjukkan prosesnya. Dalam contoh ini, program aplikasi./demos/mqtt_upload_basic_demo.c digunakan.
Catatan penggunaan
- Perhatikan konvensi penamaan berikut untuk file:
- Setiap nama file dapat berisi angka, huruf, garis bawah (_), dan titik (.).
- Setiap nama file harus dimulai dengan angka atau huruf.
- Setiap nama file dapat memiliki panjang hingga 100 byte.
- Anda dapat mengunggah beberapa file sekaligus.
- Sebuah instance IoT Platform dapat menyimpan hingga 1 GB file.
- Sebuah perangkat dapat mengunggah hingga 1.000 file untuk penyimpanan.
- Ukuran satu file dapat mencapai hingga 16 MB.
- Ketika sebuah perangkat memulai permintaan untuk mengunggah file, IoT Platform menerapkan salah satu kebijakan berikut berdasarkan nama file.
- Jika tidak ada file dengan nama yang sama di IoT Platform, tugas pengunggahan file dibuat.
- Jika file dengan nama yang sama ada di IoT Platform, operasi dilakukan berdasarkan kebijakan yang ditentukan. Untuk informasi lebih lanjut tentang kode sampel dan deskripsi, lihat Langkah 4: Memulai permintaan untuk mengunggah file.
Kebijakan pemrosesan (conflictStrategy) Deskripsi overwrite Kebijakan ini digunakan secara default. Jika Anda menggunakan kebijakan ini, IoT Platform menghapus file yang ada dan hanya menyimpan file yang baru diunggah. append Setelah perangkat memulai permintaan pengunggahan file, IoT Platform mengembalikan informasi tentang file yang ada dengan nama yang sama. Dalam hal ini, Anda dapat melakukan operasi berikut pada perangkat: - Jika proses pengunggahan file di IoT Platform belum selesai, Anda dapat melanjutkan untuk mengunggah file lokal. Catatan IoT Platform menyimpan file yang tidak sepenuhnya diunggah hanya selama 24 jam.
- Jika proses pengunggahan file di IoT Platform sudah selesai, Anda dapat mengubah kebijakan atau mengganti nama file lokal. Lalu, unggah file lagi.
reject IoT Platform mengembalikan kode kesalahan yang menunjukkan bahwa file sudah ada dan menolak permintaan untuk mengunggah file lokal. - Jika proses pengunggahan file di IoT Platform belum selesai, Anda dapat melanjutkan untuk mengunggah file lokal.