FOTA update

This article describes the process of updating SigCell firmware over the air.

The steps are

1. Setup the details about the update server and update image. 

2. Initiate a firmware download

3. Inform the system to apply firmware update on next reboot

4. Initiate a Reboot to run the newly downloaded firmware

For purposes of illustration, let's assume we are updating from v1.0.7 to v1.0.8.

1. Setup the details about the update server and update image. 

+set,fotahostname:fota.signetik.com

+set,fotahost:fota.signetik.com

+set,fotafile:sigcell/sigcell_v1.1.5.bin

NOTE: In the last line above, replace with the firmware version you are updating to. The target firmware of the FOTA process is communicated to you by the Signetik Support team directly or via  a Product Change Notification.

 

 

2. Initiate a firmware download

 

+set,fotastart:1

Wait for a `notify` message informing completion of download. See example below for expected notify message.

3. Inform the system to apply firmware update on next reboot

+set,fwupdate:1

4. Initiate a Reboot to run the newly downloaded firmware

+set,reboot:1

The system will reboot into new  firmware.

NOTE: A manual power cycle / hardware reboot/restart is not required and should be avoided. 

Example log

A firmware update session from UART API would look like this. Note the responses and notifications during this process: `rsp` messages and `notify` messages

+notify,event:init,result:0,firmware:v1.0.7
+notify,carrier:connecting
+notify,carrier:connected
+notify,imei:xxxxxxxxxxxxxxxxxxxx
+notify,event:coap,init:1

+set,fotahostname:fota.signetik.com
+rsp,fotahostname:fota.signetik.com

+set,fotahost:fota.signetik.com
+rsp,fotahost:fota.signetik.com

+set,fotafile:sigcell/sigcell_v1.1.5.bin
+rsp,fotafile:sigcell/sigcell_v1.1.5.bin

+set,fotastart:1
+rsp,fotastart:1

+notify,fota:start,result:0

+notify,fota:0
+notify,fota:0
...

+notify,fota:1

...

+notify,fota:99
+notify,fota:100

+notify,fota:complete

+set,fwupdate:1
+rsp,fwupdate:1

+notify,dfu:success:1


+set,reboot:1

+notify,event:init,result:0,firmware:v1.1.5
+notify,carrier:connecting
+notify,carrier:connected
+notify,imei:xxxxxxxxxxxxxxxxxx
+notify,event:coap,init:1