Integrate Over the air updates

3min
OTA update has become a critical requirement for devices being deployed remotely. This guide covers everything you need to know about Over the Air Firmware Upgrades with bytebeam-esp-idf-sdk.
Enabling OTA Updates
OTA updates can be integrated into application by adding action handler for OTA updates.
C++
|
/* Below function call adds action handler for "update_firmware" action */
/* handle_ota is the pointer to action handler*/

bytebeam_add_action_handler(&bytebeam_client, handle_ota, "update_firmware");

/* Use the bytebeam_remove_action_handler api to remove the handler for the update 
 * firmware action at any point of time in the code , Also you can  mantain the add 
 * update firmware action handler and remove update firmware action handler flow as per 
 * you application needs.
 */
// bytebeam_remove_action_handler(&bytebeam_client, "update_firmware");
/* Below function call adds action handler for "update_firmware" action */
/* handle_ota is the pointer to action handler*/

bytebeam_add_action_handler(&bytebeam_client, handle_ota, "update_firmware");

/* Use the bytebeam_remove_action_handler api to remove the handler for the update 
 * firmware action at any point of time in the code , Also you can  mantain the add 
 * update firmware action handler and remove update firmware action handler flow as per 
 * you application needs.
 */
// bytebeam_remove_action_handler(&bytebeam_client, "update_firmware");
﻿
Have a look at basic_ota example app for reference.
Follow the below steps to trigger OTA updates-
Upload a .bin file and create a new firmware version on Bytebeam as per the instructions mentioned in the Creating new Firmware Version﻿ guide.  
 Once, new firmware version is created, trigger OTA update as per the instructions mentioned in the Triggering OTA update﻿ guide. 
Progress of the firmware update can be monitored on Bytebeam platform using Action status.
OTA Rollback
You can create a checkpoint in your app to either mark the newly updated firmware image as active or rollback to previous firmware version. Have a look at basic_ota_rollback example app for reference.
Note: For production cases,
 please tune the checkpoint behavior as per end application requirement.
Updated 01 Sep 2023
Did this page help you?
Receiving actions
Update Configurations
TABLE OF CONTENTS
Enabling OTA Updates
OTA Rollback