Quectel BG96 User manual

BG96 DFOTA User Guide
LTE Module Series
Rev. BG96_DFOTA_User_Guide_V1.0
Date: 2017-12-19
Status: Released
www.quectel.com

LTE Module Series
BG96 DFOTA User Guide
BG96_DFOTA_User_Guide 1 / 16
Our aim is to provide customers with timely and comprehensive service. For any
assistance, please contact our company headquarters:
Quectel Wireless Solutions Co., Ltd.
7th Floor, Hongye Building, No.1801 Hongmei Road, Xuhui District, Shanghai 200233, China
Tel: [phone]
Email: [email protected]om
Or our local office. For more information, please visit:
http://quectel.com/support/sales.htm
For technical support, or to report documentation errors, please visit:
http://quectel.com/support/technical.htm
Or email to: [e-mail]
GENERAL NOTES
QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION
PROVIDED IS BASED UPON CUSTOMERS’ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT
TO ENSURE THE QUALITY OF THE INFORMATION IT MAKES AVAILABLE. QUECTEL DOES NOT
MAKE ANY WARRANTY AS TO THE INFORMATION CONTAINED HEREIN, AND DOES NOT ACCEPT
ANY LIABILITY FOR ANY INJURY, LOSS OR DAMAGE OF ANY KIND INCURRED BY USE OF OR
RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO
CHANGE WITHOUT PRIOR NOTICE.
COPYRIGHT
THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF
QUECTEL WIRELESS SOLUTIONS CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION
AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE
FORBIDDEN WITHOUT PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF
DAMAGES. ALL RIGHTS ARE RESERVED IN THE EVENT OF A PATENT GRANT OR
REGISTRATION OF A UTILITY MODEL OR DESIGN.
Copyright © Quectel Wireless Solutions Co., Ltd. 2017. All rights reserved.

LTE Module Series
BG96 DFOTA User Guide
BG96_DFOTA_User_Guide 2 / 16
About the Document
History
Revision
Date
Author
Description
1.0
2017-12-19
Matt YE/
Lucifer YAN
Initial

LTE Module Series
BG96 DFOTA User Guide
BG96_DFOTA_User_Guide 3 / 16
Contents
About the Document...................................................................................................................................2
Contents.......................................................................................................................................................3
Table Index...................................................................................................................................................4
1Introduction..........................................................................................................................................5
2Firmware Upgrade Procedure via DFOTA.........................................................................................6
2.1. Get Delta Firmware Package......................................................................................................7
2.2. Put Delta Package on HTTP(S) Server......................................................................................7
2.3. Check APN Setting......................................................................................................................7
2.4. Check Network Status.................................................................................................................8
2.5. ExecuteAT Command to Upgrade the Firmware.......................................................................8
3Description of DFOTA AT Commands...............................................................................................9
3.1. AT+QFOTADL=<httpURL> Upgrade Firmware When Delta Package is Stored on HTTP(S)
Server ...................................................................................................................................................9
3.2. AT+QFOTADL=<para> Upgrade Firmware When Delta Package is Stored in Local File
System .................................................................................................................................................11
4Examples ............................................................................................................................................13
4.1. Upgrade Firmware from HTTPS Server by DFOTA .................................................................13
4.2. Upgrade Firmware from Local File System by DFOTA............................................................14
5Summary of Error Codes ..................................................................................................................15
6Appendix A References.....................................................................................................................16

LTE Module Series
BG96 DFOTA User Guide
BG96_DFOTA_User_Guide 4 / 16
Table Index
TABLE 1: SUMMARY OF <HTTP_ERR> CODES............................................................................................ 15
TABLE 2: SUMMARY OF <ERR> CODES........................................................................................................ 15
TABLE 3: RELATED DOCUMENTS.................................................................................................................. 16
TABLE 4: TERMS AND ABBREVIATIONS........................................................................................................ 16

LTE Module Series
BG96 DFOTA User Guide
BG96_DFOTA_User_Guide 5 / 16
1Introduction
Quectel BG96 module supports DFOTA (Delta Firmware Upgrade Over-the-air) function, which allows
customers to upgrade the firmware over the air. It can upgrade the firmware to a new version, and revert
to the old version as well.
Before firmware upgrading, customers only need to prepare the firmware package which contains only
the differences between the old and new firmware versions. This reduces the amount of data transmitted
and accelerates the speed of firmware upgrade.

LTE Module Series
BG96 DFOTA User Guide
BG96_DFOTA_User_Guide 6 / 16
2Firmware Upgrade Procedure via
DFOTA
The following chart illustrates the firmware upgrade procedure via DFOTA when the firmware package is
stored on HTTP(S) server.
1. Get delta
firmware package
HTTP(S)
Server
4. Automatically download
from HTTP(S) server via
LTE/GPRS network
LTE/GPRS
(HTTP(S))
Ext.
MCU
Quectel
Module
2. Put the package on
HTTP(S) server
3. Execute AT+QFOTADL
command
5. Automatically
upgrade the
module’s
firmware
Figure 1: Firmware Upgrade Procedure via DFOTA
As shown in the above figure, customers only need to perform the following steps to upgrade the firmware
when the firmware package is stored on HTTP(S) server:

LTE Module Series
BG96 DFOTA User Guide
BG96_DFOTA_User_Guide 7 / 16
Step 1: Get the delta firmware package from Quectel.
Step 2: Put the delta firmware on HTTP(S) server.
Step 3: Execute AT+QFOTADL command. Then the module will automatically download the package
from HTTP(S) server via LTE/GPRS network (Step 4) and finally automatically upgrade the
module’s firmware (Step 5).
2.1. Get Delta Firmware Package
Before upgrading, customers need to check the current firmware version (the old version) by executing
ATI command, and also need to know the target firmware version (the new version). Then the two
firmware versions should be provided for Quectel or the module supplier, to get the delta firmware
package.
2.2. Put Delta Package on HTTP(S) Server
When using the DFOTAfunction, customers need to setup an HTTP(S) server by themselves, for Quectel
does not provide such a server. Then please put the delta firmware package on the server, and record the
HTTP(S) path. The module will get the delta package from the path after executing corresponding AT
command.
2.3. Check APN Setting
After putting the delta firmware package on the HTTP(S) server, there is a need to check whether theAPN
is set properly. For instance, the APN for Telstra (U)SIM card should be “Telstra.internet”, and the
relevant AT commands are listed below:
QueryAPN: AT+CGDCONT?
Set APN: AT+CGDCONT=1,"IP","Telstra.internet"
For more details about AT+CGDCONT, please refer to Quectel_BG96_AT_Commands_Manual.

LTE Module Series
BG96 DFOTA User Guide
BG96_DFOTA_User_Guide 8 / 16
2.4. Check Network Status
After APN setting confirmation, please check whether the data network is registered before firmware
upgrading.
The relevant AT commands are listed below:
Query signal quality: AT+CSQ
Query network registration status: AT+CREG? or AT+CGREG?
Query the registered operator: AT+COPS?
For more details about the above commands, please refer to Quectel_BG96_AT_Commands_Manual.
2.5. Execute AT Command to Upgrade the Firmware
After APN setting and network status confirmation, customers need to execute AT+QFOTADL command.
Then the module will download the firmware package from the HTTP(S) server over the air and upgrade
the firmware automatically. For more details, please refer to Chapter 3.

LTE Module Series
BG96 DFOTA User Guide
BG96_DFOTA_User_Guide 9 / 16
3Description of DFOTA AT Commands
AT+QFOTADL command enables automatic firmware upgrade for module via DFOTA. After executing the
command, the module will automatically download the package from HTTP(S) server. After the package
download is finished, the module will automatically upgrade the module’s firmware. If firmware is
upgraded successfully, the module will reboot, otherwise it will return an error and exit from DFOTA.
3.1. AT+QFOTADL=<httpURL> Upgrade Firmware When Delta Package
is Stored on HTTP(S) Server
If the delta firmware package is stored on an HTTP(S) server, AT+QFOTADL=<httpRUL> command
should be executed to enable automatic firmware upgrade via DFOTA. Then the module will download
the delta package from the HTTP(S) server over the air and upgrade the firmware automatically.
AT+QFOTADL Upgrade Firmware via DOFTA
Test Command
AT+QFOTADL=?
Response
OK
AT+QFOTADL=<httpURL> Upgrade Firmware When Delta Package is Stored on
HTTP(S) Server
Write Command
AT+QFOTADL=<httpURL>
Response
OK
+QIND: "FOTA","HTTPSTART"
+QIND: "FOTA","HTTPEND",<http_err>
+QIND: "FOTA","START"
+QIND: "FOTA","UPDATING",<percent>
+QIND: "FOTA","UPDATING",<percent>
...
+QIND: "FOTA","RESTORE",<percent>
+QIND: "FOTA","RESTORE",<percent>
...
+QIND: "FOTA","END",<err>
If there is any error, response:
ERROR