| Table of Contents | ||
|---|---|---|
|
...
Firmware update over AT (FOAT)
Firmware update over the Air (FOTAuFOTA)
EasyFlash (restricted use)
...
FOAT is a method to update the firmware by transferring the related file from an external device (e.g.application host processor) to the module through the AT interface.
Firmware download
Two different AT commands can be used to download the firmware package:
+UFWUPD AT command: This command triggers the firmware update by using Xmodem or Xmodem-1K protocol.
+UDWNFILE AT command: This command is used to manage the module file system.
Firmware Installation
The +UFWINSTALL AT command triggers the firmware installation procedure once the firmware package has been downloaded successfully.
...
t.b.d.
Automatic Firmware update over the Air - uFOTA
uFOTA is a managed and automated FOTA service based on WM2M protocol ( by u-blox). This service uses campaigns is able to manage the upgrading of multiple modules from one to new firmware version to another with one campaign.
Functional overview
When the module powers up for the very first time (factory-programmed condition) after the module is attached to a cellular network, the LwM2M client starts and registers to the uFOTA server. The LwM2M client will then subsequently check the uFOTA server upon the expiration of the Server Registration Life Timer (SRLT).
The +ULWM2MSTAT AT command enables/disables the unsolicited result codes (URC) events which are reported back to the host. This URC is enabled by default.
Firmware package update
A firmware package (or referred to as FOTA package) can consist of the following combinations:
1. Firmware update only
2. Carrier profile update only
3. Firmware and carrier profile update
After a FOTA package is successfully downloaded, the uFOTA server shall command the device to reboot and automatically complete the Firmware Update process.
Remark:
uFOTA firmware update can take up to 20 minutes!
The AT interface is not available during the firmware upgrade
It is not possible to cancel a firmware update once in progress.
Firmware installation
...
Recommendations:
uFOTA campaign shall only be planned, if the USB connect LPWA devices are ensured to have a proper power supply while the update is conducted.
If the devices are battery powered, be aware that the uFOTA will shorten the battery lifetime.
The update of individual devices might take up to 20min.
Devices shall check for FW updates once per day (AT+UFOTACONF=2,86400)
FW updates will consume data volume from your data plan.
Remark:
By default-setting, the devices are configured not support regular uFOTA update checks.
Exelonix GmbH can not grant warranty on devices that conducted a uFOTA campaign.
Immediate uFOTA on individual Devices
Version & Profile Check
Check if you have installed the latest firmware. And the version number should now be higher than L0.0.00.00.05.08 [Apr 17 2019 19:34:02]
> ATI
Manufacturer: u-blox
Model: SARA-R410M-02B
Revision: L0.0.00.00.05.08 [Apr 17 2019 19:34:02]
SVN: 03
IMEI: 352753098853359
...
OK
uFOT requires Vodafone Global Roaming" profile (197), therefore check if the "Vodafone Global Roaming" profile (197) is present and present and has version 7.2* , otherwise import again: USB Connect LPWA - AT command cookbook
...
contact: info@exelonix.com
> AT+UMNOPROF=,1
“OKOK
> > AT+UMNOPROF=?
+UMNOPROF:
0: SW default
1: SIM ICCID select
….2: ATT 7.1
6: China Telecom 7.0
31: DT 7.0
8: Sprint 7.0
100: Standard Europe 7.0
4: Telstra 7.0
21: TELUS 7.0
5: TMO 7.0
19: Vodafone 7.0
…3: Verizon 7.0
197: Vodafone-global-roaming 7.2
OKOK”
uFOTA Preparation
Ensure that the host application closes all open sockets when or before the download complete URC (+ULWM2MSTAT: 2,100) is received. When the host device receives the download complete URC (+ULWM2MSTAT: 2,100), it should store that state in memory. When the LWM2M client receives the execute command on the update resource the module will reset to apply the update. At this stage the host cannot cancel the upgrade. Once the new firmware has been installed, the module will reboot and re-register with the network. It is good practice for the host to send a message to the application.
uFOTA campaign
To start the uFOTA upgrade process, a “campaign” must be requested for the modules to be updated. Send the request to the nearest u-blox office or sales representative.
Requirements
To specify a campaign the following information is required:
...
The product type
...
The starting and destination FW version (modem and application)
...
The IMEI list of the devices participating to the campaign
...
The MNO provider
...
The location area
...
Execute the following commands:
> ATI
Manufacturer: u-blox
Model: SARA-R410M-02B
Revision: L0.0.00.00.05.08 [Apr 17 2019 19:34:02]
SVN: 03
IMEI: 352753098853359OK
> ATI9
L0.0.00.00.05.08,A.02.04
OK
> AT+COPS?
+COPS: 0,0,"262 02 DATA ONLY",9
OK
> AT+CGDCONT?
+CGDCONT: 1,"IP","vgesace.nb.iot","10.254.46.22",0,0,0,0
OK
Activate uFOTA (must return +UFOTACONF: 1, 1)
> AT+UFOTACONF=1
+UFOTACONF: 1, 1
OK
For immediate uFOTA update: set the Timer to one update check per hour (AT+UFOTACONF=2,3600).
Shorter timers <20min are not recommended, since URC may not be presented correctly or you may experience problems with the LWM2M client.
After the uFOTA update, set the update timing back:
to one update check per day: AT+UFOTACONF=2,86400 or
deactivate uFOTA (recommended): AT+UFOTACONF=2,-1
How to specify a campaign (automated updates on multiple USB Connect LPWA devices)
Devices need to be configured to check for FW updates (i.e. once per day: AT+UFOTACONF=2,86400), otherwise a campaign of firmware updates is not possible.
The following information is required to be sent to ublox:
The product type: USB Connect LPWA (SARA-R410-02B)
Old FW version:
L0.0.00.00.05.08please specifyNew FW version:
L0.0.00.00.05.??please specifyThe IMEI list of the device participating in the campaign:please specify
The MNO provider: Vodafone
The location area: please specify
The requested schedule (date, time, duration) for the campaign
2. Application design review: Before starting the campaign a design review of the application shall be performed by u-blox support
3. Test campaign: Before all the modules in the campaign will be updated via uFOTA, it is stronglsuggested performingrm a test campaign first. This test campaign will verify the host is working for uFOTA and that the network/deployment is adequate for the uFOTA download & update.
4. Final campaign: If the test campaign is successful, u-blox will provide a report back to the customer. If the user is satisfied with the test campaign, the final campaign can start. The u-blox service team will monitor the uFOTA progress and provide a report once finished.
...
| language | xml |
|---|
...
: please specify
To initiate a uFOTA campaign (roll-out of new Firmware) send the information to support_eu@u-blox.com.
Remark:
After the confirmed start of the campaign, do not disconnect the power supply of the devices before the update has been carried out.
| Code Block | ||
|---|---|---|
| ||
ATI ATI Manufacturer: u-blox Model: SARA-R410M-02B Revision: L0.0.00.00.05.08 [Apr 17Apr 17 2019 19:34:02] SVN: 03 03 IMEI: 352753098853359 352753098853359 OK ATI9 ATI9 L0.0.00.00.05.08,A.02.04 OK AT+COPS? AT+COPS? +COPS: 0 0,0,"262 02 DATA ONLY",9 OK AT+CGDCONT? AT+CGDCONT? +CGDCONT: 1 1,"IP","vgesace.nb.iot","10.254.46.22",0,0,0,0 OK AT+UFOTACONF=1 AT+UFOTACONF=1 +UFOTACONF: 1 1, 1 1 OK AT+UFOTACONF=2,3600 AT+UFOTACONF=2,3600 OK +ULWM2MSTAT: 0 0,0 +ULWM2MSTAT: 1 1,13 +ULWM2MSTAT: 1 1,26 +ULWM2MSTAT: 1 1,39 +ULWM2MSTAT: 1 1,52 +ULWM2MSTAT: 1 1,65 +ULWM2MSTAT: 1 1,78 +ULWM2MSTAT: 1 1,91 +ULWM2MSTAT: 2 2,100 //After the successful download (+ ULWM2MSTAT: 2,100), the update may take some time (up to 20min). Manufacturer: u-blox Model: SARA-R410M-02B Revision: L9.9.00.00.05.08 [Jul 11Jul 11 2019 16:05:05] SVN: 03 03 IMEI: 352753098853359 352753098853359 OK |
...
EasyFlash
Definition
EasyFlash is a tool for the Windows OS to download the firmware from a PC through a serial interface (USB or UART).
Note : The EasyFlash Tool is not a public tool and could only be used internally !
If you are interested in this solution, contact the team of exelonix GmbH.
...