Quectel BG96 Manuel utilisateur

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: +86 21 5108 6236

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: support@quectel.com

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.

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.

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

AT+QFOTADL=<httpURL> Upgrade Firmware When Delta Package is Stored on

HTTP(S) Server

Write Command

AT+QFOTADL=<httpURL>

Response

+QIND: "FOTA","HTTPSTART"

+QIND: "FOTA","HTTPEND",<http_err>

+QIND: "FOTA","START"

+QIND: "FOTA","UPDATING",<percent>

...

+QIND: "FOTA","RESTORE",<percent>

...

+QIND: "FOTA","END",<err>

If there is any error, response:

ERROR

Autres manuels pour BG96

Table des matières

Autres manuels Quectel Unité de contrôle

Quectel

Quectel RMU500-EK Manuel utilisateur

Quectel

Quectel M66 Supplément

Quectel

Quectel BG772A-GL Supplément

Quectel

Quectel UC200T-GL Supplément

Quectel

Quectel EC25 series Supplément

Quectel

Quectel EG06 Series Manuel utilisateur

Quectel

Quectel UG Series Instructions d'installation

Quectel

Quectel WCDMA UG FILE Series Manuel d'installation

Quectel

Quectel MC90-TE-A Manuel utilisateur

Quectel

Quectel EM160R-GL Supplément

Quectel

Quectel FGM842D Supplément

Quectel

Quectel EC200U Series Supplément

Quectel

Quectel EC20 Manuel de service

Quectel

Quectel FC909A Manuel utilisateur

Quectel

Quectel BG96 Manuel d'installation

Quectel

Quectel SC20-EL Manuel utilisateur

Quectel

Quectel BG95 Series Supplément

Quectel

Quectel QuecOpen AG525R-GL Supplément

Quectel

Quectel EM06 Manuel utilisateur

Quectel

Quectel BC660K-GL Manuel utilisateur

Quectel

Quectel RM510Q-GL Supplément

Quectel

Quectel EC2 Series Instructions d'installation

Quectel

Quectel SA800U-WF Manuel utilisateur

Quectel

Quectel LTE-A Series Supplément

Manuels Unité de contrôle populaires d'autres marques

Festo

Festo Compact Performance CP-FB6-E Manuel de la liste des pièces

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Manuel utilisateur

JS Automation

JS Automation MPC3034A Manuel utilisateur

JAUDT

JAUDT SW GII 6406 Series Guide rapide

Spektrum

Spektrum Air Module System Manuel utilisateur

BOC Edwards

BOC Edwards Q Series Manuel utilisateur

KHADAS

KHADAS BT Magic Manuel utilisateur

Etherma

Etherma eNEXHO-IL Manuel utilisateur

PMFoundations

PMFoundations Attenuverter Manuel utilisateur

GEA

GEA VARIVENT Manuel utilisateur

Walther Systemtechnik

Walther Systemtechnik VMS-05 Manuel utilisateur

Altronix

Altronix LINQ8PD Instructions de montage

Eaton

Eaton Powerware Series Manuel utilisateur

WAGO

WAGO 750-407/040-000 Manuel utilisateur

Sony

Sony CCU-590 Manuel utilisateur

Graco

Graco 25D614 Manuel utilisateur

Task Force Tips

Task Force Tips YE-RF-900 Manuel de programmation

Shini

Shini SPV-U Series Manuel utilisateur