OTA Update (Over-The-Air Firmware Update)

Fitur Over-The-Air (OTA) Update pada platform Electins dirancang untuk memperbarui logika kode atau program pada mikrokontroler Anda secara nirkabel melalui internet. Hal ini menghilangkan kebutuhan untuk mencabut perangkat dari lapangan dan menyambungkan kembali kabel USB.

Arsitektur Rollout OTA Update

Berikut adalah cara kerja ekosistem pembaruan firmware nirkabel Electins:

1. Unggah Berkas Biner: Pengembang mengunggah berkas terkompilasi .bin, menentukan nomor versi baru, dan mengisikan catatan perubahan.

2. Penyimpanan Cloud: Berkas disimpan secara aman pada penyimpanan berbasis awan (secure storage).

3. Event Dispatcher: Server menerbitkan perintah OTA_UPDATE ke saluran Pub/Sub cmd:project:[ProjectId] dengan payload URL biner pada properti metadata.

4. Background Update Execution: Mikrokontroler (melalui task background ElectinsIoT) mendeteksi perintah tersebut, mengunduh file biner, menulis ke partisi flash, memvalidasi integritas biner, dan reboot.

5. Verification & Completion: Saat perangkat kembali online dan mengirimkan sinyal (heartbeat) dengan versi terbarunya, cloud memverifikasi kesamaan versi dan menandai status deployment menjadi completed.

Langkah-Langkah Detail Melakukan OTA Update

Langkah 1: Konfigurasi Versi Firmware di Program Anda

Pastikan sketsa program Arduino IDE Anda mendefinisikan konstanta versi firmware yang sesuai pada inisialisasi awal. Contoh pada sketsa program Anda:

const char* FIRMWARE_VER = "1.0.0"; // Versi saat ini

void setup() {
    iot.beginWiFi(API_KEY, WIFI_SSID, WIFI_PASS, FIRMWARE_VER);
}

Langkah 2: Ekspor Berkas Biner Terkompilasi (.bin)

Ketika Anda telah memperbarui program Anda (misalnya, mengubah versi ke 1.0.1) dan siap untuk melakukan pembaruan:

1. Buka sketsa kode program Anda di Arduino IDE.

2. Navigasikan ke menu bar atas: Sketch > Export Compiled Binary (atau tekan pintasan keyboard Ctrl + Alt + S / Cmd + Alt + S).

3. Buka folder proyek Arduino Anda. Anda akan menemukan berkas biner terkompilasi dengan akhiran .bin (misal: StasiunCuaca.ino.esp32.bin).

Langkah 3: Unggah Berkas Firmware di Web Dashboard

1. Buka halaman proyek Anda di Web Dashboard Electins dan navigasikan ke tab OTA Update.

2. Klik tombol + Deploy New Firmware.

3. Isikan formulir dengan rincian berikut:

   • Target Project: Pilih proyek perangkat target.

   • Version: Isikan versi firmware baru secara persis (misal: 1.0.1).

   • Notes: Tuliskan catatan ringkas mengenai pembaruan program ini (misal: Perbaikan pembacaan sensor DHT dan penambahan widget switch.).

   • File: Klik area unggahan dan pilih berkas .bin yang telah Anda ekspor pada Langkah 2.

4. Klik tombol Deploy OTA Update.

Langkah 4: Pemantauan Progress Rollout

Setelah diunggah, entri deployment baru akan muncul pada bagian OTA Deployment History dengan status awal in_progress. Perangkat Anda akan otomatis mengunduh biner secara aman di latar belakang, melakukan flash, dan reboot.

Langkah 5: Penyelesaian & Verifikasi Sukses

Begitu perangkat Anda menyala kembali (boot up), ia akan melakukan handshake ke server Electins dan melaporkan versi terbarunya (1.0.1). Server akan mencocokkan laporan ini dengan versi deployment aktif. Jika cocok:

• Status pada panel riwayat OTA berubah menjadi completed dengan progress 100%.

• Sistem akan memicu Push Notification ke browser dan smartphone Anda dengan judul: "OTA Update Berhasil: 1.0.1".

Batasan & Ketentuan Keamanan

• Verifikasi Email: Demi alasan keamanan untuk mencegah penyalahgunaan firmware, akun pengembang wajib menyelesaikan verifikasi email sebelum diizinkan mengunggah berkas biner OTA.

• Ukuran Berkas Maksimum: Berkas biner firmware tidak boleh melebihi batas ukuran 4 MB.

• Ekstensi File: Server hanya menerima berkas dengan ekstensi .bin.