Quectel BG96 Manuale utente

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

Altri manuali per BG96

Indice

Altri manuali Quectel Unità di controllo

Quectel

Quectel Smart EVB Manuale utente

Quectel

Quectel AG35 SMTP Manuale di installazione

Quectel

Quectel GNSS Module Series Manuale utente

Quectel

Quectel LTE Module Series Istruzioni per l'installazione

Quectel

Quectel EP06 Manuale utente

Quectel

Quectel GSM UART Port Istruzioni per l'installazione e il funzionamento

Quectel

Quectel EC25-AUX Supplemento

Quectel

Quectel M16 EVB Manuale utente

Quectel

Quectel EG915U-EU Manuale utente

Quectel

Quectel 5G Module Series Supplemento

Quectel

Quectel WCDMA UG FILE Series Manuale di installazione

Quectel

Quectel LC76F Manuale utente

Quectel

Quectel EC200U Series Istruzioni per l'installazione e il funzionamento

Quectel

Quectel BG96 Supplemento

Quectel

Quectel MC90-TE-A Manuale utente

Quectel

Quectel LTE Standard Istruzioni per l'installazione e il funzionamento

Quectel

Quectel EC2 Series Istruzioni per l'installazione

Quectel

Quectel FCM561D-P Supplemento

Quectel

Quectel UC15 Supplemento

Quectel

Quectel LTE Module Series Manuale utente

Quectel

Quectel WCDMA UG Series Manuale utente

Quectel

Quectel EM12-G Supplemento

Quectel

Quectel M35 Manuale utente

Quectel

Quectel BG96 Istruzioni per l'installazione e il funzionamento

Manuali Unità di controllo popolari di altre marche

Festo

Festo Compact Performance CP-FB6-E Manuale elenco delle parti

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Manuale utente

JS Automation

JS Automation MPC3034A Manuale utente

JAUDT

JAUDT SW GII 6406 Series Guida rapida

Spektrum

Spektrum Air Module System Manuale utente

BOC Edwards

BOC Edwards Q Series Manuale utente

KHADAS

KHADAS BT Magic Manuale utente

Etherma

Etherma eNEXHO-IL Manuale utente

PMFoundations

PMFoundations Attenuverter Manuale utente

GEA

GEA VARIVENT Manuale utente

Walther Systemtechnik

Walther Systemtechnik VMS-05 Manuale utente

Altronix

Altronix LINQ8PD Istruzioni per il montaggio

Eaton

Eaton Powerware Series Manuale utente

WAGO

WAGO 750-407/040-000 Manuale utente

Sony

Sony CCU-590 Manuale utente

Graco

Graco 25D614 Manuale utente

Task Force Tips

Task Force Tips YE-RF-900 Manuale di programmazione

Shini

Shini SPV-U Series Manuale utente