GV55 @track Air Interface Firmware Update R1.04

GV55 @Track Air Interface Firmware Update
GSM/GPRS/GPS Tracker
TRACGV55FTAN001
Revision: 1.04
Contents
0. Revision History ............................................................................................................................. 2
1. Scope ............................................................................................................................................. 3
2. Message ........................................................................................................................................ 4
2.1. Command And Acknowledgement...................................................................................... 4
2.1.1. Start The Firmware Update ..................................................................................... 4
2.1.2. Stop The Firmware Update ..................................................................................... 5
2.1.3. Acknowledgement................................................................................................... 6
2.2. Report.................................................................................................................................. 6
2.2.1. Firmware Update Report in ASCII Forma ................................................................ 6
k
2.2.1.1. Update Confirmation ......................................................................................... 6
2.2.1.2. Package Downloading ....................................................................................... 7
n
2.2.1.3. Firmware Updating............................................................................................ 8
l i
2.2.2. Firmware Update Extended Status Report in ASCII Format .................................... 8
l
2.2.2.1. Update Acknowledge ........................................................................................ 8
c a
2.2.2.2. Update Differential Packet ................................................................................ 9
e i
2.2.2.3. Update Firmware............................................................................................. 10
t
3. Firmware Update Process ........................................................................................................... 11
u n
3.1. Initiation of The Update Process ....................................................................................... 11
3.2. Confirmation of The Update Process................................................................................. 11
Q fide
3.3. Downloading of The Update Package ................................................................................ 11
3.4. Updating of The Firmware................................................................................................. 12
3.5. An Example of Successful Updating................................................................................... 13
o n
C
TRACGV55FTAN001 -1-
0. Revision History
Revision Date Author Description of Change

1.00 2015-05-29 Page Zhong Initial.
1.01 2015-08-17 Bart Yuan Modify the default value of parameter <download
timeout> to 20 in command AT+GTUPD.
1.02 2017-02-22 Bart Yuan Add the <Update Type> parameter in the
command AT+GTUPD.
1.03 2017-06-15 Forrest Cao Add the parameter <Extend Status Report>, and
k
<Identifier Number>.
1.04 2017-09-05 Abert Xu Add <Code> 114 in +RESP:GTUPD.
l i n l
General Notes
c
Queclink offers this information as a service to its customers, to support application and
a
engineering efforts that use the products designed by Queclink. The information provided is based
e t i
upon requirements specifically provided to Queclink by the customers. Queclink has not
undertaken any independent search for additional relevant information, including any information
u n
that may be in the customer’s possession. Furthermore, system validation of this product designed
by Queclink within a larger electronic system remains the responsibility of the customer or the
Q fide
customer’s system integrator. All specifications supplied herein are subject to change.
Copyright
This document contains proprietary technical information which is the property of Queclink
n
Wireless Solutions Co., Ltd. The copying of this document, distribution to others, and
communication of the contents thereof, are forbidden without express authority. Offenders are
o
liable to the payment of damages. All rights are reserved in the event of a patent grant or
registration of a utility model or design. All specifications supplied herein are subject to change
C
without notice at any time.
TRACGV55FTAN001 -2-
1. Scope
This document describes the firmware update over the air for GV55. This enables to update the
firmware of GV55 remotely without having to require the end users to bring their device to the
service centre. Thus the service provider of GV55 could conveniently push new features or bug
fix to the end users and promote the customer experience.
During the firmware updating, three equipments are involved:

 the terminal: GV55 whose firmware is to be updated
k
 the backend server: the server which remotely controls the terminal and receives report
from the terminal
n
 the file server: the server which hosts the packages of the update
l i l
The file server and the backend server could host on the same machine.
c a
This document describes the process of the firmware update and the necessary message
e i
exchanged during the updating, while below information are not covered:
t
 The timing and the strategy that the backend server to initiate the updating.
u n
 The deployment method of the update package.
 How to setup a file server.
Q fide
 The communication between the backend server and the file server.
o n
C
TRACGV55FTAN001 -3-
2. Message
2.1. Command And Acknowledgement
The command AT+GTUPD is used to start and stop the firmware update remotely.
2.1.1. Start The Firmware Update
k
To start the firmware update, the backend server sends AT+GTUPD (sub:0) command to the
device. Upon this command, the device is informed of where to download the update package
n
and how to download the package.
l i l
 Start: AT+GTUPD=
c a
Example:
e i
AT+GTUPD=gv55,0,0,20,0,,,http://fota.queclink.com/GV55_0201_0205.bin,,0,1,00000001,00
t
01$
u n
Parameter Length(byte) Range/Format Default value
password 4~6 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ gv55
Q fide
sub-command 1 0
max download retry 1 0–3 0
download timeout 2 10 – 30 min 20
download protocol 1 0 0
download user <=6 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’
n
name
o
download password <=6 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’
download URL 100 legal URL
C
reserved 0
update type 1 0|1 0
Extend Status 1 0|1 0
Report
Identifier Number 8 00000000-FFFFFFFF
serial number 4 0000-FFFF
tail character 1 $ $
 <password>: the valid character of password is ‘0’-9’, ‘a’-‘z’, ‘A’-‘Z’. The default value is
“GV55”.
 <sub-command>: sub-command of AT+GTUPD, 0 means to start the firmware update.
 <max download retry>: specifies the maximum time of retrying to download the update
package upon downloading failure.
 <download timeout>: specifies the expiration timeout of one single downloading. If the
downloading expires, it is considered to be failure.
TRACGV55FTAN001 -4-
 <download protocol>: the protocol used to download the package. Only HTTP is supported
now. Set to 0.
 <download user name>: if the file server uses authentication, specifies the user name here.
It’s only used when <update type> is 0.
 <download password>: if the file server uses authentication, specifies the password here. It’s
only used when <update type> is 0.
 <download URL>: specifies the URL to download the package.
 <reserved>: reserved for future extension.
 <update type>: specifies the firmware type to update, 0 means BB firmware, 1 means MCU
firmware.
 < Extend Status Report >: The type to express messages report.
k
 0: Report the message +RESP:GTUPD to inform the firmware updating status.
 1: Report the message +RESP:GTEUD to inform the firmware updating status.
n
 <Identifier Number>: A numeral to identify the firmware updating request command. This
l i
will be included in the message +RESP:GTEUD to inform the request it is related to.
l
 <serial number>: As the command reference, the exact serial number will be sent back to the
c a
platform in ACK. It is in hexadecimal format. It should begin from 0000 and increases by
e i
1 every time. It should roll back after “FFFF”.
t
 <tail character>: A character to indicate the end of the command. Must be “$”.
u n
Note: +RESP:GTEUD has the same message format with +RESP:GTUPD in hex format.
Q fide
2.1.2. Stop The Firmware Update
Before the device finishes downloading the update package, the backend server could use the
AT+GTUPD (sub:1) command to cancel the current firmware updating. If the package is
n
downloaded successful, this command is ignored.
o
 Stop: AT+GTUPD=
C
Example:
AT+GTUPD=GV55,1,,,,,0001$
Parameter Length(byte) Range/Format Default value
password 4~6 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ gv55
sub-command 1 1
reserved 0
reserved 0
reserved 0
reserved 0
 <sub-command>: sub-command of AT+GTUPD, 1 means to cancel the current firmware
update process.
TRACGV55FTAN001 -5-
2.1.3. Acknowledgement
The acknowledgement message of AT+GTUPD command:

 +ACK:GTUPD,
Example:
+ACK:GTUPD,2F0200,135790246811220,,0001,20090101000002,11F0$
Parameter Length(byte) Range/Format Default
protocol version 6 XX0000 – XXFFFF, X∈{'A'
– 'Z', '0' – '9'}
unique ID 15 IMEI
device name <=10 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’
k
send time 14 YYYYMMDDHHMMSS
i n
count number 4 0000-FFFF
l l
c
 <Protocol Version>: The protocol version that the terminal conforms to. The first two
ia
characters XX point out the device type. 2F means GV55N. The middle two characters point
e t
out the main version number and the last two characters point out the minimum version
u
number. And both of the main version and the minimum version are hex digital. For example,
n
020A means version 2.10

Q fide
<unique ID>: The terminal’s IMEI.
 <device name>: An ASCII string for the name of the device.
 <serial number>: The <serial number> in the AT+GTUPD command.
 <send time>: The terminal local time to send the message.
 <count number>: The self-increasing count number will be put into every acknowledgment
n
message. The count is beginning from 0000 and increases by 1 every time. It will roll back
after “FFFF”.
o
2.2. Report
C
During the firmware updating process, the device reports its status to the backend server by
message +RESP:GTUPD upon different phases, including the update confirmation information,
package downloading information and firmware updating information.
2.2.1. Firmware Update Report in ASCII Forma
2.2.1.1. Update Confirmation
The device sends update confirmation information to the backend server if:
 the update command is confirmed by the device.
 the update command is refused by the device.
 the update process is canceled by the backend server.
 the update command is refused because the battery is low.
TRACGV55FTAN001 -6-
 Confirmation: +RESP:GTUPD,
Example:
+RESP:GTUPD,2F0200,135790246811220,,100,,20090101000000,11F0$
protocol version 6 XX0000 – XXFFFF,
X∈{'A' – 'Z', '0' – '9'}
unique ID 15 IMEI
device name <=10 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’
code 3 100|101|102|103
reserved 0
k
n
tail character 1
i
$ $
l l
 <code>: the confirmation information
 100/110: the update command is confirmed by the device.
c a
 101/111: the update command is refused by the device.
e i
 102/112: the update process is canceled by the backend server or refused because of an
t
incorrect URL.
u n
 103/113: the update process is refused because the battery is low.
 114: The MCU model does not support upgrades.
Q fide
2.2.1.2. Package Downloading
The device sends package downloading information to the backend server if:
n
 the device starts to download the package
 the device finishes downloading the package successfully
o
 the device fails to download the package
C
 Downloading: +RESP:GTUPD,
Example:
+RESP:GTUPD,2F0200,135790246811220,,200,1,20090101000000,11F0$
X∈{'A' – 'Z', '0' – '9'}
unique ID 15 IMEI
device name <=10 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’
code 3 200|201|202
download times 1 1|2|3|4
 <code>: the downloading information
TRACGV55FTAN001 -7-
 200/210: the device starts to download the package

 201/211: the device finishes downloading the package successfully
 202/212: the device fails to download the package
 <download times>: the count number of the package downloading
2.2.1.3. Firmware Updating
The device sends firmware updating information to the backend server if:
 the device starts to update the firmware
 the device finishes update the firmware successfully
 the device fails to update the firmware
k
 the update process does not start because the battery is low
 Updating: +RESP:GTUPD,
i n
Example:
l
+RESP:GTUPD,2F0200,135790246811220,,300,,20090101000000,11F0$
l
c a
e i
X∈{'A' – 'Z', '0' – '9'}
t
unique ID 15 IMEI
u n
device name <=10 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’
code 3 300|301|302|303
Q fide
reserved 0
n
 <code>: the updating information
 300/310: the device starts to update the firmware
o
 301/311: the device finishes updating the firmware successfully
 302/312: the device fails to update the firmware
C
 303/313: the update process does not start because the battery is low
2.2.2. Firmware Update Extended Status Report in ASCII Format
2.2.2.1. Update Acknowledge
At the follow conditions, the terminal device will send the Acknowledge to the back end server.
 The terminal confirms this update command.
 The terminal refuses this update command.
 The back end server cancels this update process.
 The terminal refuses this request as the low battery.
 +RESP:GTEUD,
EXAMPLE:
TRACGV55FTAN001 -8-
+RESP:GTEUD,2F0403,135790246811220,,100,,2,,,,,20090101000000,11F0$
Parameter Length (byte) Range/Format Default
protocol version 6 XX0000–XXFFFF,
X∈{'A'–'Z','0'–'9'}
Unique ID 15 IMEI
Device Name <=10 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’
Code 3 100|101|102|103
Reserved 0
Reserved 0
Reserved 0
k
Reserved 0
n
Reserved 0
i
Send Time 14 YYYYMMDDHHMMSS
l l
Count Number 4 0000-FFFF
c
Tail Character 1
a
$ $
i

e
<Code>: Confirm information code.
t
 100/110: The terminal confirms this update command.
u
 101/111: The terminal refuses this update command.
n
 102/112: The back end server cancels this update process.
Q fide
 103/113: The terminal refuses this request as the low battery.
2.2.2.2. Update Differential Packet
At the follow conditions, the terminal device will send the Acknowledge to the back end server：
n
 The terminal device starts to download differential packet.
 The terminal device downloads the differential packet successful.
o
 The terminal device downloads the differential packet failed.
C
 +RESP:GTEUD,
Example:
+RESP:GTEUD,2F0403,135790246811220,,200,1,2,,,,,20090101000000,11F0$
Parameter Length (byte) Range/Format Default
Protocol Version 6 XX0000–XXFFFF,
X∈{'A'–'Z','0'–'9'}
Unique ID 15 IMEI
Device Name <=10 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’
Code 3 200|201|202
Download Times 1 1|2|3|4
Reserved 0
Reserved 0
TRACGV55FTAN001 -9-
Reserved 0
Reserved 0
Send Time 14 YYYYMMDDHHMMSS
Count Number 4 0000-FFFF
Tail Character 1 $ $
 <Code>: Update information code.
 200/210: The terminal starts to upgrade differential packet.
 201/211: The terminal upgrades differential packet.
 202/212: The terminal upgrades differential packet failed.
 <Download Times>: The number of times to upgrade differential packet successfully.
k
2.2.2.3. Update Firmware
i n
At the follow conditions, the terminal device will send the Acknowledge to the back end server
l l
 The terminal device starts to replace firmware.
c
 The terminal device replaces the firmware successful.
ia
 The terminal device replaces the firmware failed.
e t
 The update process cancels firmware update as the low battery.
u n
 +RESP:GTEUD,
Q fide
Example:
+RESP:GTUPD,2F0403,135790246811220,,300,,2,,,,,20090101000000,11F0$
protocol version 6 XX0000–XXFFFF,
X∈{'A'–'Z','0'–'9'}
n
unique ID 15 IMEI
device name <=10 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’
o
code 3 300|301|302|303
Reserved 0
C
Reserved 0
Reserved 0
Reserved 0
Reserved 0
 <Code>: Update information code.
 300/310: The terminal device starts to replace the firmware.
 301/311: The terminal device replaces the firmware successful.
 302/312: The terminal device replaces the firmware failed.
 303/313: The terminal device cancels the firmware update as low battery.
TRACGV55FTAN001 - 10 -
3. Firmware Update Process
The firmware update process includes four steps.
3.1. Initiation of The Update Process
The backend server sends the AT+GTUPD (sub:0) command to the device to initiate the update
process. Along with this command, the backend server sends necessary information for the
device to start the update process.
k
It’s the backend server’s duty to decide when and how to initiate the firmware update process to
i n
all the devices it controls. As the response messages collector and the controller, the backend
l l
server has all the information it needs to start an update process including the current firmware
versions of the devices it controls (retrieved with the AT+GTRTO command), the version of the
c a
latest available firmware and the location of the proper update packages.
u e n t i
3.2. Confirmation of The Update Process
Q fide
Upon the AT+GTUPD (sub:0) command, the device will first check the current battery capacity.
If the battery capacity can not support the update process, it will report +RESP:GTUPD (code:
103) to notify the backend server that the update process is to be aborted because of low
battery. If the battery capacity is ample, the device will send +RESP:GTUPD with confirmation
n
information to the backend server. Then the update process proceeds to the next step.
o
If the update command is confirmed, the device will turn into a non-interactive mode. That is,
the end user can no longer make phone call, all incoming call are rejected automatically until the
C
update process finishes. At the meantime, the device will ignore all the command received
from the backend server if it is not related to the update process. Also the device will stop all
the reports that are not related to the update process.
3.3. Downloading of The Update Package
If the update command is confirmed, the device will use the information sent by the backend
server to download the update package. If the downloading fails, it will retry the specified
times. If all attempts fail, the updating process is aborted and the device will automatically
reboot to go back to the normal working mode. If the downloading successes, the update
process proceeds to the next step. Either way, the device will send +RESP:GTUPD with
downloading information to the backend server.
Before the package is downloaded, the backend server could send AT+GTUPD (sub:1) command
to cancel the current update process. This is the only chance to abort during the update
process.
3.4. Updating of The Firmware
After downloading the package successfully, the device will check the battery capacity again. If
the battery can not support the update process, the device will report +RESP:GTUPD (code: 303)
to notify the backend server that the update process is to be aborted because of low battery. If
the battery capacity is ample, the device will send +RESP:GTUPD (code:300) to the backend
k
server to inform of the start of the updating. Then it uses the update package to update the
firmware. After the updating, success or failure, the device will reboot automatically. After
i n
the device boots up, it sends +RESP:GTUPD with updating information to the backend server and
l l
woks as usual.
e c t ia
u
Q fide n
o n
C
3.5. An example of Successful Updating
i n k
cl ia l
u e n t
Q fide
o n
C
Queclink
Grace Wang
2017.09.29

GV55 @track Air Interface Firmware Update R1.04

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

GV55 @track Air Interface Firmware Update R1.04

Uploaded by

Copyright:

Available Formats

GV55 @Track Air Interface Firmware Update

Revision Date Author Description of Change

During the firmware updating, three equipments are involved:

2.1. Command And Acknowledgement

2.1.1. Start The Firmware Update

The acknowledgement message of AT+GTUPD command:

2.2.1. Firmware Update Report in ASCII Forma

2.2.1.1. Update Confirmation

 200/210: the device starts to download the package

2.2.1.3. Firmware Updating

2.2.2. Firmware Update Extended Status Report in ASCII Format

2.2.2.1. Update Acknowledge

2.2.2.2. Update Differential Packet

3. Firmware Update Process

The firmware update process includes four steps.

3.1. Initiation of The Update Process

3.3. Downloading of The Update Package

3.4. Updating of The Firmware

3.5. An example of Successful Updating

You might also like