Quectel BG96 User Manual

Quectel BG96 User Manual

Dfota lte series
Hide thumbs Also See for BG96:

Advertisement

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

Advertisement

Table of Contents
loading

Summary of Contents for Quectel BG96

  • Page 1 BG96 DFOTA User Guide LTE Module Series Rev. BG96_DFOTA_User_Guide_V1.0 Date: 2017-12-19 Status: Released www.quectel.com...
  • Page 2 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.
  • Page 3: About The Document

    LTE Module Series BG96 DFOTA User Guide About the Document History Revision Date Author Description Matt YE/ 2017-12-19 Initial Lucifer YAN BG96_DFOTA_User_Guide 2 / 16...
  • Page 4: Table Of Contents

    LTE Module Series BG96 DFOTA User Guide Contents About the Document ........................... 2 Contents ............................... 3 Table Index ..............................4 Introduction ............................5 Firmware Upgrade Procedure via DFOTA ..................6 2.1. Get Delta Firmware Package ...................... 7 2.2. Put Delta Package on HTTP(S) Server ..................7 2.3.
  • Page 5: Table Index

    LTE Module Series BG96 DFOTA User Guide 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 BG96_DFOTA_User_Guide 4 / 16...
  • Page 6: Introduction

    BG96 DFOTA User Guide Introduction 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.
  • Page 7: Firmware Upgrade Procedure Via Dfota

    LTE Module Series BG96 DFOTA User Guide Firmware Upgrade Procedure via DFOTA The following chart illustrates the firmware upgrade procedure via DFOTA when the firmware package is stored on HTTP(S) server. HTTP(S) Server 2. Put the package on HTTP(S) server 1.
  • Page 8: 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.
  • Page 9: Check Network Status

    LTE Module Series BG96 DFOTA User Guide 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? ...
  • Page 10: Description Of Dfota At Commands

    LTE Module Series BG96 DFOTA User Guide Description 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.
  • Page 11 +QIND: "FOTA","RESTORE",100% +QIND: "FOTA","END",0 If SSL certificates are needed while downloading the firmware package from an HTTPS server, then they should be uploaded to /datatx of BG96, and must be renamed in accordance with the following rules:  The root certificate must be renamed into fota_cacert.pem;...
  • Page 12: At+Qfotadl= Upgrade Firmware When Delta Package Is Stored In Local File System

    The storage path for delta firmware package is /fota/update.zip. Both the path and the package name cannot be modified. Customers can use the QEFS Explorer tool provided by Quectel to upload the upgrade package. If the module is powered down during "RESTORE", the module will automatically enter into forced upgrade mode when power up next time and continue upgrade from "RESTORE".
  • Page 13 LTE Module Series BG96 DFOTA User Guide +QIND: "FOTA","Last upgrade was not finished,continue upgrade" +QIND: "FOTA","START" +QIND: "FOTA","RESTORE",1% +QIND: "FOTA","RESTORE",2% +QIND: "FOTA","RESTORE",100% +QIND: "FOTA","END",0 BG96_DFOTA_User_Guide 12 / 16...
  • Page 14: Examples

    LTE Module Series BG96 DFOTA User Guide Examples 4.1. Upgrade Firmware from HTTPS Server by DFOTA //Upgrade firmware when delta firmware package is stored on an HTTPS server. //The HTTPS server address is “https://www.quectel.com:100/update.zip". AT+CGDCONT? //Query APN setting +CGDCONT: 1,"IPV4V6","Telstra.internet","0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0",0,0,0,0 AT+CSQ;+CREG?;+CGREG?;+COPS?
  • Page 15: Upgrade Firmware From Local File System By Dfota

    LTE Module Series BG96 DFOTA User Guide +QIND: "FOTA","RESTORE", 100% +QIND: "FOTA","END",0 //Finish upgrading the firmware. 4.2. Upgrade Firmware from Local File System by DFOTA //The delta firmware package has already been stored in the module’s file system. //Execute AT+QFOTADL command to enable automatic firmware upgrade via DFOTA, and then the module will start to download the firmware package and upgrade firmware automatically..
  • Page 16: Summary Of Error Codes

    LTE Module Series BG96 DFOTA User Guide Summary of Error Codes The error code indicates an error related to mobile equipment or network. The details about <http_err> and <err> are described in the following tables. Table 1: Summary of <http_err> Codes <http_err>...
  • Page 17: Appendix A References

    LTE Module Series BG96 DFOTA User Guide Appendix A References Table 3: Related Documents Document Name Remark Quectel_BG96_AT_Commands_Manual AT commands manual for BG96 Quectel_BG96_QEFS_Explorer_User_Guide User guide for QEFS Explorer tool Table 4: Terms and Abbreviations Abbreviation Description DFOTA Delta Firmware Upgrade Over-the-Air...

Table of Contents