Quectel BG96 Manual de usuario

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

Otros manuales para BG96

Tabla de contenidos

Otros manuales de Unidad de control de Quectel

Quectel

Quectel WCDMA Instrucciones de instalación y funcionamiento

Quectel

Quectel SC262R Series Suplemento

Quectel

Quectel EC25 series Guía

Quectel

Quectel SC606T Series Suplemento

Quectel

Quectel EG91 Series Suplemento

Quectel

Quectel M85 Suplemento

Quectel

Quectel M16 EVB Manual de usuario

Quectel

Quectel LTE Standard Instrucciones de instalación y funcionamiento

Quectel

Quectel BC95 Manual de usuario

Quectel

Quectel EC2 Series Instrucciones de instalación

Quectel

Quectel M.2 EVB Manual de usuario

Quectel

Quectel EG9 Series Guía

Quectel

Quectel LTE-A Series Suplemento

Quectel

Quectel MC60-TE-A Manual de usuario

Quectel

Quectel BC660K-GL Manual de usuario

Quectel

Quectel SC20-A Manual de usuario

Quectel

Quectel LTE Module Series Manual de usuario

Quectel

Quectel EM06 Manual de usuario

Quectel

Quectel LTE Module Series Instrucciones de instalación

Quectel

Quectel BC95 Suplemento

Quectel

Quectel L76 Manual de usuario

Quectel

Quectel M35 Manual de usuario

Quectel

Quectel GNSS Module Series Manual de usuario

Quectel

Quectel EC200U Series Instrucciones de instalación y funcionamiento

Manuales populares de Unidad de control de otras marcas

Festo

Festo Compact Performance CP-FB6-E Manual de lista de piezas

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Manual de usuario

JS Automation

JS Automation MPC3034A Manual de usuario

JAUDT

JAUDT SW GII 6406 Series Guía rápida

Spektrum

Spektrum Air Module System Manual de usuario

BOC Edwards

BOC Edwards Q Series Manual de usuario

KHADAS

KHADAS BT Magic Manual de usuario

Etherma

Etherma eNEXHO-IL Manual de usuario

PMFoundations

PMFoundations Attenuverter Manual de usuario

GEA

GEA VARIVENT Manual de usuario

Walther Systemtechnik

Walther Systemtechnik VMS-05 Manual de usuario

Altronix

Altronix LINQ8PD Instrucciones de montaje

Eaton

Eaton Powerware Series Manual de usuario

WAGO

WAGO 750-407/040-000 Manual de usuario

Sony

Sony CCU-590 Manual de usuario

Graco

Graco 25D614 Manual de usuario

Task Force Tips

Task Force Tips YE-RF-900 Manual de programación

Shini

Shini SPV-U Series Manual de usuario