FOTA update

This article describes the process of updating SigCell firmware over the air. If you have received a development kit, it is recommended to update to the latest firmware, using the instructions below.

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, we are updating from v1.0.7 to v1.1.5.

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      # VERIZON ONLY

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.

 

IMPORTANT: If you are using an AT&T SIM or any non-Verizon sim, set fotafile to the proper image:

+set,fotafile:sigcell/sigcell_ww_v1.1.0.1-ww.bin     # AT&T or MVNO

 

2. Initiate a firmware download

 

+set,fotastart:1

Wait for a `notify` message informing completion of download (+notify,fota:complete). 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