Microloci Protocol

micro loci

∞ THE PERSONAL LOCATION SERVICES COMPANY ∞

2

GTX Corp 117 W. 9th Street # 1214 Los Angeles, CA 90015

Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

Index

1. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

1.1 Scope of this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ..4 1.2 Reference documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.3 Terms and abbreviation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 4 2. System Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3. Command Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.1 Downlink commands: The commands from platform to micro loci terminal. . . . 6

3.1.1 Server Register Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.1.2 Base Equipment Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9 3.1.3 Fixed Timing Report Information . . . . . . . . . . . . . . . . . . . . . . . ….. . .. 11 3.1.4 Safe Zone Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 3.1.5 Real Time Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 3.1.6 Special Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 3.2 Uplink command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

3.2.1 Alarm Message Response To Server . . . . . . . . . . . . . . . . . . . . . . . . .18 3.2.2 Indicate Message Send To Server . . . . . . . . . . . . . . . . . . . . . . . .. . . .23 3.2.3 Heart Beat Data for GPRS active session . . . . . . . . . . . . . . . . . .. . . . .28 4. Develop User Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

4.1 Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29 4.1.1 Connection protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

4.1.1.1 TCP mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29 4.1.1.1.1 TCP Continuous Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

4.1.1.1.2 TCP Reconnect Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . .30 4.1.1.2 UDP mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31

4.1.1.3 Force On SMS Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 4.1.2 Server Setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32

4.1.2.1 Set the IP address and port number of Main Server . . . . . . . . . . . . .32 4.1.2.2 Set the phone number of main SMS gate . . . . . . . . . . . . . . . . . . . .32 4.1.2.3 Set the IP address and port number of second server . . . . . . . . . . . .33 4.1.3 Set APN parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33

4.1.4 Set the nick name 4.2 Location by call.35 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34

4.3 Fixed Timing Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35 4.4 Geofence Alarm Setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37 4.5 Keypad Setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38 4.5.1 Power key Setting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38

4.5.2 Function Setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38 4.5.2.1 Function Key Enable/Disable . . . . . . . . . . . . . . . . . . . . . . . . . . .38

4.5.2.2 Geo-fence Mode of Function Key . . . . . . . . . . . . . . . . . . . . . . . 39


3


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

5.5.2.2 SOS Mode of Function Key . . . . . . . . . . . . . . . . . . . . . . . . . . . … .40

4.6 Movement Detect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41 4.7 Over Speed Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 4.8 Power Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 4.8.1 Power Low Alarm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

4.8.2 Charge Status Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 4.8.2 Full Power Up When Charge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 4.9 Real time Operate on micro loci terminal. . . . . . . . . . . . . . . . . . . . . . . . . . . .

44

4.9.1 Get the Latest Successful GPS Fixing Time. . . . . . . . . . . . . . . . . . . . .44 4.9.2 Real time Locate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44 4.9.3 Get All Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46 4.9.4 Reboot the micro loci terminal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

.46

4.9.5 Reset to Factory Setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47 4.9.6 Get the ICCID of SIM card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47 4.9.7 Get GSM signal level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48 4.9.8 Get Firmware Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 4.9.9 Get Hardware Version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49 4.9.9 Get the Battery Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49 4.10 Buffer Report Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50

5. Led Indication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51 Annex 1: Commands Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52


4


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

1. Overview

1.1 Scope of This Document

This document is written for the software engineer to develop the tracking platform base on micro loci tracking protocol. The micro loci tracking protocol is specific by SIMCOM.

1.2 Reference documents

1.3 Terms and Abbreviation

GSM : Global System for Mobile Communications GPRS : General Packet Radio Service TCP : Transmission Control Protocol UDP : User Datagram Protocol APN : Access Point Network


5


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

2. System Architecture

The platform can be accessed by many micro loci terminals. It should have the

following abilities:

(1) The platform should be able to access the internet and listen to the connection to micro loci terminal. It should be able to receive/send data with micro loci terminal.

(2) The platform should be able to support TCP or UDP connect with micro loci terminal.

(3) The platform should be able to receive/send SMS.


6


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

3. Command Description

3.1 Downlink commands: The commands from platform to

micro loci terminal

7.1.1 3.1.1 Server Register Information The command “AT+GTSRI” is used to configure the GPRS parameters and server information of micro loci terminal. It is also used to configure the report mode and connection mode between platform and micro loci terminal. When the micro loci terminal is configured correctly, it should be able to report data to the platform.

AT+GTSRI


7


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

Password: The valid character of password is „0‟-„9‟-„a‟-„z‟-„A‟-„Z‟ . The default value is “gl100”. Report mode: Support 3 report modes described as following.

0: Default on GPRS: Use GPRS as default. Use SMS for backup when GPRS network is not available. 1: Force on GPRS 3: Force on SMS

Connection mode: 0: “TCP reconnect mode” The connection is based on TCP protocol. The micro loci terminal will try to connect to the platform every time when it wants to send data and it will shut down the connection when the terminal finishes data sending. 1: “TCP Continuous Mode” The connection is based on TCP protocol. The micro loci terminal will connect to the platform and maintain the connection.

2: “UDP mode” The micro loci terminal will send data to the platform by UDP protocol Main server IP: Example as 192.117.16.7. Main server PORT: The valid value is 0-65535. Main SMS gateway: The correct format is (National code)+(Area Code)+(Phone number), Example as ＋8602158301576. Short code is also supported.

The response command of “AT+GTSRI”

+ACK:GTSRI

Parameter Length(byte) Range Default Value

+ACK:GTSRI,

+ACK:GTSRI +ACK:GTSRI

Unique ID, 15 IMEI

Parameter

Length(byte) Range Default

AT+GTBEI= 0 AT+GTBEI=

Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100


8


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

Unique ID: The Unique ID of micro loci terminal is IMEI code of terminal.

Send time: The send time in “AT+GTSRI” command.

ACK time: The local time of the data sending.

Count Num: The self-added sequence number will be put into every ACK

commands. The count is beginning at 0000 and it will return to 0000 when gets to

FFFF.


9


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.1.2 3.1.2 Base Equipment Information

The “AT+GTBEI” command is used to configure the base equipment information of micro loci terminal. It is also used to configure parameters of the second server.

AT+GTBEI

Password: The valid character of password is „0‟,„9‟,„a‟,„z‟,„A‟,„Z‟ . The default value is “gl100” Reserved: Reserved for future use. Reserved: Reserved for future use. Location by call: Base on the configuration the micro loci terminal will act as following steps when it receive an incoming call.

0: Disconnect the call 1: Report the position and the incoming phone number to the platform.

Please refer to the GTLBC command for report format. Main server IP: Example as 192.117.16.7. Main server PORT: The valid value is 0-65535. Main SMS gateway: The Main SMS gateway which is used to receive the SMS from micro loci terminal.


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15

Location by call, 1 0|1 0

Second server IP, <=15

Second server port, <=5

Second SMS gateway, <=20

Send time 14 YYYYMMDDHHMMSS

Parameter Length(byte) Range Default

+ACK:GTBEI, +ACK:GTBEI +ACK:GTBEI

Unique ID, 15 IMEI gl100

Send time, 14 YYYYMMDDHHMMSS

ACK time 14 YYYYMMDDHHMMSS

Count Num 4 0000-FFFF

Parameter

Length(byte) Range

Default

AT+GTTRI= AT+GTTRI= AT+GTTRI=

Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Begin Time, 4 0000-2359 0000


10


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

The response command of AT+GTBEI

+ACK:GTBEI Example: +ACK:GTBEI,135790246811220, 20090101000000, 20090101000002, 11FO

Unique ID: The Unique ID of micro loci terminal is IMEI Send time: The send time in “AT+GTBEI” command. ACK time: The local time of the data sending. Count Num: The self-added sequence number will be put into every ACK command. The count is beginning at 0000 and it will return to 0000 when gets to FFFF.


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












Parameter

Length(byte) Range

Default


Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Begin Time, 4 0000-2359 0000

End Time, 4 0000-2359 0000

Send Interval, 3 0-999 (Minute) 0

Fix Interval, 4 0-9999 (Second) 0


11


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.1.3 3.1.3 Fixed Timing Report Information The “AT+GTTRI” is used to configure the parameters of scheduled fix timing report.

AT+GTTRI:gl100,100,2300,5,60,20090101000000

Password: The valid character of password is „0‟-„9‟-„a‟-„z‟-„A‟-„Z‟ . The default value is “spark nano”

Begin Time: The start time of scheduled fix timing report. The valid format is HHMM. The value range of HH is 00-23. The value range of MM is 00-59. End time: The end time of scheduled fix timing report. The valid format is same as Begin Time. Send Interval: The send interval of scheduled fix timing report. The value range is 000-999 and the unit is minute. Fix Interval: The check interval of GPS-Value range is 0000-9999 and the unit is second. The “AT+GTTRI” is used to configure the parameters of scheduled fix timing report.

+ACK:GTTRI: 135790246811220, 20090101000000, 20090101000002,11F0


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












Parameter

Length(byte) Range

Default


Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Begin Time, 4 0000-2359 0000

End Time, 4 0000-2359 0000



Send time 14 YYYYMMDDHHMMSSt


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15



12


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

Unique ID: The Unique ID of micro loci terminal is IMEI

Send time: The send time in “AT+GTTRI” command.

ACK time: The local time of the data sending.

Count Num: The self-added sequence number will be put into every ACK

command. The count is beginning at 0000 and it will return to 0000 when gets to

FFFF.


13


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.1.4 3.1.4 Safe Zone Information

Command “AT+GTSZI” is used to configure the parameters of Geo-Fence.

AT+GTSZI

Example: AT+GTSZI=gl100,1,121.412248,31.187891,1000,10,20090101000000

AT+GTSZI=gl100,1,121.412248,31.187891,1000,10, 20090101000000

Password: The valid character of password is „0‟-„9‟-„a‟-„z‟-„A‟-„Z‟ . The default value is “gl100”

ID (Zone ID): 0,1,2,3,4.

Longitude: The Longitude of a point which is defined as the centre of Geo-fence circle region. The format is (-)xxx.xxxxxx and the value range is (-180.000000-180.000000). The unit is degree. West longitude is defined as negative and east longitude is defined as positive.

Latitude: The Latitude of a point which is defined as the centre of Geo-fence circle region. The format is (-)xx.xxxxxx and the value range is(-90.000000-90.000000). The unit is degree. South Latitude is defined as negative and north Latitude is defined as positive.

Radius: The radius of Geo-fence circle region. Value range is (0-6000000) and the unit is meter.

Check interval: The interval of GPS checking for safe zone alarm. AT+GTSZI Response

+ACK:GTSZI


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












Parameter

Length(byte) Range

Default


Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Begin Time, 4 0000-2359 0000

End Time, 4 0000-2359 0000



14


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

Unique ID: The Unique ID of @Track terminal is IMEI Zone ID: The index of safe zone. Valid value is 0,1,2,3,4 Send time: The send time in “AT+GTSZI” command. ACK time: The local time of the data sending. Count Num: The self-added sequence number will be put into every ACK command. The count is Is beginning at 0000 and it will return to 0000 when gets to FFFF.

7.1.5 3.1.5 Real Time Operation

GTRTO command is used to get some information from the micro loci terminal. It is also used to configure the over-speed alarm.

AT+GTRTO

Command option: Valid value is 0-9, A, For the definition please refer to following. Password: Valid character is „0‟ -„9‟,„a‟ -„z‟,„A‟ -„Z‟, Default value is “gl100”.

NOTE: Parameter <Speed Warn Enable> and <Speed Warn Value> is only valid when the “Command option” is 9.

0: Get the latest time of successful GPS fixing. 1: Require the micro loci terminal to report current position immediately 2: Get the current configuration of micro loci terminal. 3: Reboot the micro loci terminal.


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15








15


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

4: Reset all parameters to factory setting. Please note the following parameter will not be reset: Report mode, Main server information (IP address, port, SMS gateway), GPRS information (apn, apn username, apn password). 5: Get the ICCID of the SIM card which is inserted into the micro loci terminal.

6: Get the current GSM signal level of micro loci terminal. 7: Get the Software Version. 8: Get the Hardware Version. 9: Configure over speed alarm function.

A: Get the battery level of micro loci terminal Over speed alarm enable: 0|1, Disable | Enable over speed alarm function. Please note this parameter is only valid when the “Command option” is 9 Over Speed value: When the over speed alarm function is enabled. The micro loci terminal will report to the platform when its speed is larger than this value. Please note this parameter is only valid when the “Command option” is 9.

+ ACK:GTRTO Example:

+ACK:GTRTO,135790246811220, SPEED,20090101000000, 20090101000002,11F0


Command option: (0: LGT, 1: RTL, 2: READ, 3: REBOOT, 4: RESET, 5: CID, 6: CSQ, 7: SWV 8: HWV, 9: SPEED, A: CBC). Please refer to chapter 4.9 for detail. Send time: The send time in “AT+GTRTO” command. ACK time: The local time of the data sending. Count Num: The self-added sequence number will be put into every ACK command. The count is beginning at 0000 and it will return to 0000 when gets to FFFF.


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












16


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.1.6 3.1.6 Special Function

GTSFR command is used to configure some special function of micro loci terminal like “Enable/Disable power key”, “The function of function key”, “Movement detect”, ”Enable / disable full power up when charger connect”

AT+GTSFR

Password:Valid character is „0‟-„9‟-„a‟-„z‟-„A‟-„Z‟, Default value is “gl100”.

Power key enable: The terminal user can‟t power down the micro loci terminal by power key

when this parameter is set to 0

Function key enable: The function is disabled when this parameter is set to 0

Function key mode

0:Geo-Fence mode: Please refer to chapter 4.5.2.2 for detail.

1:SOS mode: Please refer to GTSOS command for detail.

Movement detect mode: Please refer to chapter 4.6 for detail.

Movement speed: The speed threshold of moment detect.


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












Parameter

Length(byte) Range

Default


Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Begin Time, 4 0000-2359 0000

End Time, 4 0000-2359 0000


17


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

Movement distance: The distance threshold of moment detect

Movement send number: The report times before the micro loci terminal consider itself in non-moving status.

Full Charge Boot: The micro loci will fully power on when this parameter is set to 1. Otherwise it will only enter charge mode

AT+GTSFR Response

Example:ACK:GTSFR,13579024811220, 20090101000000, 20090101000002,11F0 Example：

Unique ID: The Unique ID of micro loci terminal is IMEI Send time: The send time in “AT+GTSFR” command. ACK time: The local time of the data sending. Count Num: The self-added sequence number will be put into every ACK command. The count is

beginning at 0000 and it will return to 0000 when gets to FFFF.


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












Parameter

Length(byte) Range

Default



18


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.2 3.2 Uplink Message

7.2.1 3.2.1 Alarm Message Response to Server

The position related message include (+RESP:GTSOS), (+RESP:GTSZI), (+RESP:GTRTL), (+RESP:GTEST),

(+RESP:GTLBC),（ +RESP:GTTRIJ).

+RESP:GTSZI +RESP:GTSOS +RESP:GTRTL +RESP:GTEST


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15








19


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

Unique ID: The Unique ID of micro loci terminal is IMEI Number of report message： Will

be 1 when response to GTSZI, GTSOS, GTRTL and GTEST.

Zone ID: Only valid when response to GTSZI. Indicate this message is report for which safe

zone.

Zone Alert: Only valid when response to GTSZI . 0 means the micro loci terminal leave

the safe zone and 1 means enter the safe zone.

GPS fix: 1: Successful GPS fixing, 0: Failed on GPS fixing.

GPS accuracy: The HDOP defines in NEMA0183, Valid value is 0-50, Small value means

higher accuracy.

Mobile Country Code (mcc): Algorism format, Valid value is 000-999.

Mobile Network Code (mnc): Algorism format. The code of mobile network operator.

Valid value is 000-999.

Location area code (LAC): hex format

Cell ID (Cellid): hex format

TA: Timing advance, Reserved for future using.

Count Num: The self-added sequence number will be put into every command send to

platform. The count is beginning at 0000 and it will return to 0000 when gets to FFFF.


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












Parameter

Length(byte) Range

Default


Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Begin Time, 4 0000-2359 0000

End Time, 4 0000-2359 0000




Parameter

Length(byte) Range

Default

+ACK:GTTRI, +ACK:GTTRI +ACK:GTTRI

Unique ID, 15 IMEI


20


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

+RESP:GTLBC


Calling Number: The phone number of incoming call.

GPS fix: 1: Successful GPS fixing; 0: Failed on GPS fixing.

GPS accuracy: The HDOP defines in NMEA 0183, Valid value is 0-50. Small value means higher

accuracy.

Mobile Country Code (mcc): Algorism format. Valid value is 000-999.

Mobile Network Code (mnc): Algorism format. The code of mobile network operator, Valid value is

000-999.

Location area code (LAC): hex format

Cell ID (Cellid): hex format

TA (Timing advance): Reserved for future using.

Count Num: The self-added sequence number will be put into every command send to platform. The

count is beginning at 0000 and it will return to 0000 when gets to FFFF.


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












Parameter

Length(byte) Range

Default


Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Begin Time, 4 0000-2359 0000

End Time, 4 0000-2359 0000




Parameter

Length(byte) Range

Default


21


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com


22


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

+RESP:GTTRI


Number: Indicates how many position logs in this message.

GPS accuracy: The HDOP defines in NMEA0183，Valid value is 0-50, Small value means higher

accuracy.

Mobile Country Code (mcc): Algorism format, Valid value is 000-999.

Mobile Network Code (mnc): Algorism format. The code of mobile network operator. Valid value is

000-999.


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












Parameter

Length(byte) Range

Default


Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Begin Time, 4 0000-2359 0000

End Time, 4 0000-2359 0000




23


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

Location area code LAC）： hex format Cell ID（ Cellid）： hex format TA： Timing advance， Reserved for future using. Count Num: The self-added sequence number will be put into every command send to platform. The count is beginning at 0000 and it will return to 0000 when gets to FFFF.

Note: Every position log will include the parameter from <Reserved> to <Send time>

7.2.2 3.2.2 Indicate Message Send to Server

+RESP:GTPNA

+RESP:GTPFA

+RESP:GTPLA

+RESP:GTBTC

+RESP:GTSTC

GTPNA: Power on report

GTPFA: Power down report

GTPLA: Power low report

GTBTC: Start charging report

GTSTC: Finish charging report

Unique ID: The Unique ID of micro loci terminal is IMEI Count Num: The self-added sequence number will be put into every command send to platform. The count is beginning at 0000 and it will return to 0000 when gets to FFFF.


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15











24


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

+RESP: GTCID +RESP: GTHWV +RESP: GTLGT +RESP: GTCBC GTCID: Report the ICCID of SIM card which is inserted into the micro loci terminal. GTHWV: Report the hardware version GTLGT: Report the latest successful GPS fixing time GTCBC: Report the battery level. Unit: percent

Unique ID: The Unique ID of micro loci terminal is IMEI Content : Report content

Count Num: The self-added sequence number will be put into every command send

to platform. The count is beginning at 0000 and it will return to 0000 when gets to

FFFF.


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












Parameter

Length(byte) Range

Default


Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Begin Time, 4 0000-2359 0000

End Time, 4 0000-2359 0000


25


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

+RESP:GTCSQ +RESP: GTSWV

GTCSQ: Report GSM signal level GTSWV: Report software version

When the Indicate symbol is “GTCSQ”，Content1 indicates <rssi>，Content2 indicates <ber>.

<rssi>

0: <-113(dBm) 1: -111(dBm)

2…30: -109…-53(dBm)

31: >-51(dBm)

99: Unknown or none

<ber>

0…7 It same as RXQUAL, For RXQUAL please refer to GSM standard GSM 05.08 8.2.4.

99 Unknown or none

100

When Indicate symbol is “GTSWV”, Content1 indicates <Revision>, Content2 indicates

<SubEdition>.

<Revision>is main software version

<Sub Edition> is sub software version.


Content1: The first part of report content.

Content2: The second part of report content.

Count Num: The self-added sequence number will be put into every command send to platform.

The count is beginning at 0000 and it will return to 0000 when gets to FFFF.


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












Parameter

Length(byte) Range

Default


Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Begin Time, 4 0000-2359 0000

End Time, 4 0000-2359 0000





26


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

Read parameter

+RESP:GTALL

Example： +RESP:GTALL,135790246811220,simcom,116.228.221.61,7035,222.66.38.185,7035,

+8613122774662,+8615821660293,Geo,,,,,Area1,,,,,Area2,,,,,Area3,121.412248,31.187891,1,2,

Area4,,,,,0100,2359,15,60,1,1,0,1,1,80,100,5,0,1,100,20090101000000,11F0


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












Parameter

Length(byte) Range

Default


Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Begin Time, 4 0000-2359 0000

End Time, 4 0000-2359 0000





27


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

Count Num: The self-added sequence number will be put into every command send

to platform. The count is beginning at 0000 and it will return to 0000 when gets to

FFFF.

+RESP:GTGEO

Example：

Unique ID: The Unique ID of micro loci terminal is IMEI Active: 0 means disable Geo-

fence and 1 means enable Geo-fence. Count Num: The self-added sequence

number will be put into every command send to platform. The count is beginning

at 0000 and it will return to 0000 when gets to FFFF.


+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












Parameter

Length(byte) Range

Default


Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Begin Time, 4 0000-2359 0000


28


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.2.3 3.2.3 Heart Beat Data for GPRS Active Session

The heart beat data from @Terminal to platform:

AT+GTHBD


Count Num: The self-added sequence number will be put into every command send to platform. The

count is beginning at 0000 and it will return to 0000 when gets to FFFF.

The heart beat data from platform to @Terminal.

+RESP:GTHBD

Count Num: The self-added sequence number will be put into every command send to platform. The count is beginning at 0000 and it will return to 0000 when gets to FFFF.



+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15












Parameter

Length(byte) Range

Default


Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Begin Time, 4 0000-2359 0000

End Time, 4 0000-2359 0000





+ACK:GTSRI,


Unique ID, 15 IMEI

Parameter



Password, 4 ~ 8 „0‟ -„9‟ , „a‟ -„z‟ , „A‟ -„Z‟ gl100

Reserved, <=8

Reserved, <=15









29


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

4. Develop Guide

7.3 4.1 Register to Platform

The platform can configure the connection parameter by command “AT+GTSRI” and “AT+GTBEI”. All functions of micro loci terminal are based on the connection.

7.3.1 4.1.1 Connection Mode

7.3.1.1 4.1.1.1 TCP Mode

7.3.1.1.1 4.1.1.1.1 TCP Continuous Mode

• Set connection mode to “TCP Continuous Mode” by command “AT+GTSRI” (Please refer to chapter 3.1.1); • In the “TCP Continuous Mode”, the micro loci terminal will connect to the platform by TCP protocol after power on, maintain the connection and never disconnect by itself. If the connection drops by the network, the micro loci terminal will try to connect again. • In the “TCP Continuous Mode”, the micro loci terminal will check the connection status by heartbeat data. (For heartbeat please refer to chapter 3.2.3).

• In “TCP Continuous Mode”, the micro loci terminal will not try to connect second

server or SMS gateway when main server can‟ t be accessed.

• In “TCP Continuous Mode” all data will be sent by GPRS. Set “Report mode” to “Force

on SMS” will be un-useful.

• The heart beat data only be used in “TCP Continuous Mode”.

• About the heart beat data： In the “TCP Continuous Mode”，the micro loci terminal will

send “AT+GTHBD” command to the platform every dedicated time period. (For

“AT+GTHBD” please refer to chapter 3.2.3). The platform shall reply with “+RESP:GTHBD”

command. If the micro loci terminal can‟ t get response from the platform, the

connection will be considered as dropped. (For “+RESP:GTHBD” please refer to chapter

3.2.3)


30


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

• Example:

Configure the micro loci terminal with:

AT+GTSRI= gl100,0,1,cmnet,cmnet,cmnet,116.228.221.61,4321,+8613888888888,

20080807100001

The configuration is done when the platform receives the following message.

+ACK:GTSRI,098765432123454,20080807100001,20090112104725,000a

Please note the boldfaced “1” in command “AT+GTSRI” means “TCP Continuous Mode”

7.3.1.1.2 4.1.1.1.2 TCP Reconnect Mode

• How about the reconnect? • Set the “Connection Mode” to “TCP Reconnect Mode” by command AT+GTSRI (Please refer to chapter 3.1.1). • In “TCP Reconnect Mode” the micro loci terminal will establish a socket with the platform for every message. • In “TCP Reconnect Mode” the report mode can be set to “Default on GPRS” or “Force on GPRS”. If the report mode is set to” Force on SMS”, the setting of “TCP Reconnect Mode” on connection mode will be ignored and all report message will be sent by SMS. • If the connection mode is set to “TCP Reconnect Mode” and the report mode is “Default on GPRS”. When main server can‟ t be accessed the micro loci terminal will use second server and SMS gate for backup. • If the connection mode is set to “TCP Reconnect Mode” and the report mode is “Force on GPRS”. The micro loci terminal will only use second server for backup. SMS gate will not be used. • Example Configure the micro loci terminal with command:

AT+GTSRI=gl100,0,0,cmnet,cmnet,cmnet,116.228.221.61,4321,+8613888888888,

20080807100001

The configuration is done when the platform receives the following message. +ACK:GTSRI,098765432123454,20080807100001,20090112104725,000a

Please note the boldfaced “0” means “TCP Reconnect Mode”.


31


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.3.1.2 4.1.1.2 UDP Mode

Set the “Connection Mode” to “UDP Mode” by command AT+GTSRI (Please refer to chapter 3.1.1). In “UDP Mode”, all messages will be sent by UDP protocol. In “UDP

Mode”, the “Force on SMS” setting on report mode will be ignored. Example：

Configure the micro loci terminal with command:


20080807100001

The configuration is done when the platform receives the following message:

+ACK:GTSRI,098765432123454,20080807100001,20090112104725,000a

Please note the boldfaced “2” means “UDP mode”

7.3.1.2 4.1.1.2 UDP Mode

Set the “Connection Mode” to “Force on SMS Mode” by command AT+GTSRI (Please refer to chapter 3.1.1). In “Force on SMS Mode” message will be sent by SMS. In “Force on SMS Mode”, “Emergency Fixed timing report” will be sent by TCP. Limit to the length of SMS, report of “+RESP： GTALL” and “+RESP:GTTRI” which contain multi-positions won‟ t be sent. Example：



20080807100001

Please note the boldfaced “2” means “Force on SMS”

The configuration is done when the platform receives the following message: +ACK:GTSRI,098765432123454,20080807100001,20090112104725,000a


32


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.3.2 4.1.2 Connect to Server Setting

7.3.2.1 4.1.2.1 Set the IP Address and Port of Main Server

• Set the IP address and port of main server with command <AT+GTSRI>,lease refer to 3.1.1.

• The main server will be the first choice of data sending, Except in “Force on SMS mode” • Example:

Configure the micro loci terminal with command: AT+GTSRI=gl100,0,1,cmnet,cmnet,cmnet,116.228.221.61,4321,+8613888888888,

20080807100001 In the command “116.228.221.61” is IP address ，“4321” is port

number


7.3.2.2 4.1.2.2 Set the Phone Number of Main SMS

• Set the phone number of main SMS gateway with command <AT+GTSRI> (ease refer to 3.1.1)

• SMS gateway will be the backup channel of data sending when “Force on SMS mode” or GPRS is unavailable. • Example:

Configure the micro loci terminal with command: AT+GTSRI=gl100,2,0,cmnet,cmnet,cmnet,116.228.221.61,4321,+8613888888888,

20080807100001 In the command “+8613888888888” is the phone number of SMS

gateway. Short code like “10086” is also supported



33


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.3.2.3 4.1.2.3 Set the IP Address and Port of Second Server

Set the IP address and port number of second server with command <AT+GTBEI>(Please refer to 3.1.2)

In <TCP Reconnect mode>, If the main server can’ t be accessed. The micro loci terminal will try to send data to second server. Example:


AT+GTBEI=gl100,,GL100,0,116.228.221.61,7799,+8615921881331,20080807100001 In the

command “116.228.221.61” is the IP address of second server, “7799” is the port number of second server.

The configuration is done when the platform receives the following message: +ACK:GTBEI,098765432123454,20080807100001,20090112104725,000a

7.3.3 4.1.3 Set APN Parameter

Set APN parameter with command <AT+GTSRI>(Please refer to chapter 3.1.1); Parameters:APN, User Name, Password; Example：


AT+GTSRI=gl100,0,1,cmnet,User Name, Password,

116.228.221.61,4321,+8613888888888,20080807100001

In the command “cmnet” is the APN of GPRS network, “User Name” is the user name of

APN, “Password” is the password of APN. The terminal user can get the APN information

from the network provider



34


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.4 4.2 Location by Call

The scope of “Location by call” function is providing a quick way for surveillant to get the position of micro loci terminal.

The “Location by call” function can be configured by command <AT+GTBEI>

Mode 0: The micro loci terminal will reject all incoming call. Mode 1: The micro loci terminal will reject the incoming call first. Then try to get the

GPS position, send the position and the phone number of incoming call to the platform.

Example: The example for Mode 1:

(1)Setting Configure the micro loci terminal with command: AT+GTBEI=gl100, ,

,1, 222.66.38.185,6082,13888888888,20090101000000

(2) Response First the micro loci terminal will response to <AT+GTBEI> with message: +ACK:GTBEI,135790246811220, 20090101000000, 20090101000002,0010 (3)Get GPS fix and report After Called, the micro loci terminal will report the GPS

information and the phone number of incoming call to the platform:

+RESP:GTLBC,135790246811220,02132523415,1,4.3,92,70.0,1,121.354335,31.222073,04

60,0000,18d8,6141,00,20090101000112,0011

If the micro loci terminal fails on GPS fixing, It will report the latest position of successful

GPS fixing:

+RESP:GTLBC,135790246811220,02132523415,0,4.3,92,70.0,1,121.354335,31.222073,

0460,0000,18d8,6141,00,20090101000112,0011

Command related: AT+GTBEI +ACK:GTBEI

+RESP:GTLB


35


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.5 4.3 Fixed Timing Report

AT+GTTRI=gl100,1000,2300,5,60, 20090101000000

Start time End time Send interval Fix interval

“Fixed timing report” is the basic function of micro loci terminal. The platform can configure the “Start time” and “End time” to schedule periodical position report. In the pre-defined time period the micro loci terminal will power on GPS every “Fix interval” and report recorded position log to platform every “Send interval” Base on the “Fix interval” the micro loci terminal will have two modes on how to operate GPS module:

• Normal mode: If the <Fix interval> is longer than 60 seconds the micro loci terminal will

The rules of Fixed Timing Report: In the command AT+GTTRI=<Password>,<Begin time>,<End time>,<Send interval>,<Fix interval>,<Send Time>: 1. (Begin Time < End Time) means to report in time period (Begin Time,End Time,

every day. (Begin Time > End Time), means to start from the “Begin time”

and stop at “End time” in the next day.

(Begin Time = End Time) means to report during the whole day. 2. If the micro loci terminal is in “Force on SMS” mode, it will only send fixed timing report when Send interval = Fix Interval, it means the report message will only include one position record. 3. Please make sure “Send interval / Fix Interval <= 15” 4. If Send interval or Fix Interval is 0, the fixed timing report will be disabled. 5. If Fix interval<60, the micro loci terminal will go to emergency mode, the GPS module will never be stopped. In emergency mode, the “Send interval” = “Fix interval”, the micro loci terminal will report every “Fix interval”, and the “Fix interval” will be forced to more than “5”.

power off the GPS module every time after successful GPS fixing to save power. • Emergency mode: If the <Fix interval> is shorter than 60 seconds the micro loci terminal will never power off the GPS module. Please note that in this mode the “Send interval” will be forced to be the same as “Fix interval” and the standby time will be limited.


36


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

Examples: (1)AT+GTTRI=gl100,1000,2300, 5, 60, 20090101000000 Report from 10:00 to 23:00 every day. Power on GPS every 60 seconds and power off it after successful GPS fixing. Send fixed timing report every 5 minutes. Please note in this example each fixed timing report message will include 5 position records. (2)AT+GTTRI=gl100,1000,2300, 5, 30, 20090101000000 The micro loci terminal will go to emergency mode. The GPS module will never be power off. Report real time position every 30 seconds. (3)AT+GTTRI=gl100,1000,1000, 5, 60, 20090101000000 Report during the whole day. (4)AT+GTTRI=gl100,1000, 2300, 0, 60, 20090101000000 The fixed timing report is disabled.

For the detail of report message please refer to chapter 3.2.1. Commands related:

AT+GTTRI +ACK: GTTRI +RESP: GTTRI


37


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.6 4.4 Safe Zone Alarm Setting

User can define up to 5 safe zones on micro loci terminal. The micro loci terminal will

report the status when it enter or leave one of the safe zones.

Each safe zone is defined as a cycle base on centre point and radius. The first zone is Geo-fence region. Besides the command <AT+GTSZI> from platform, user can also control Geo-fence region by function key. (Please refer to chapter 4.5.2.2)

Note： (1) The safe zone checking only happens after successful GPS fixing. The check interval indicates how often the micro loci terminal will check GPS position. (2) The micro loci terminal will report a leave status to platform when it leaves any of the safe zone. (3) The micro loci terminal will report an enter status to platform when it enters any of the safe zone. (4) The report will only happen when the micro loci terminal enter or leave a safe zone. (5) Before the first successful GPS fixing after power on, The micro loci terminal will consider itself out of all safe zone. This means if the micro loci terminal power on in one of the safe zone it will report an enter status to platform. Otherwise it will not report until the safe zone status changes.

AT+GTSZI=gl100, 1, 121.412248, 31.187891, 1000, 10, 20090101000000 Safe Zone Id Longitude latitude

Radius Check interval

The example for report message:

+RESP:GTSZI,135790246811220,0,3,0,1,4.3,92,70.0,1,121.354335,31.222073,20090101000

000,0015 The 3 indicates Safe Zone 3, 0 means leave, This report message means the micro

loci terminal left Safe Zone 3, It‟ s current position is（ 121.354335,31.222073).

Commands related:

AT+GTSZI +ACK: GTSZI +RESP:GTSZI


38


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.7 4.5 Key Setting

7.7.1 4.5.1 Power Key Setting

• Configure the function of power key with command <AT+GTSFR> (Please refer to chapter 3.1.6)

• This command is used to enable/disable power key • If the power key is disabled the terminal user can‟t power off the micro loci terminal by power key when it is power on. But if the micro loci terminal is already power off. The terminal user can power on it by power key even when the power key is disabled.

• Examples:

If you want to disable the power key, Configure the micro loci terminal with

command: AT+GTSFR=gl100,0,1,0,0,0,0,0,5,0,20080102112233 The “0” means

disable power key.

The configuration is done when the platform receives the following message: +ACK:GTSFR,098765432123454,20080102112233,20090112104725,000a

7.7.2 4.5.2 Function Key Setting

7.7.2.1 4.5.2.1 Function Key Enable/Disable

The function key has two different modes: Geo-Fence mode and SOS mode

• Configure the function with command <AT+GTSFR> (Please refer to 3.1.6);

• This command is used to enable/disable the function key. • Geo-Fence mode and SOS mode is only useful when the function key is enabled.

• Examples:

If you want to disable the function key, configure the micro loci terminal with

command: AT+GTSFR=gl100,1,0,0,0,0,0,0,5,0,20080102112233 In the command “0”

means disable the function key



39


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.7.2.2 4.5.2.2 Geo-Fence Mode of Function Key

• Set the function key to Geo-fence mode with command <AT+GTSFR> (Please refer to chapter 3.1.6)

• When the function key is in Geo-fence mode, double press on function key in 2 seconds will change the on/off status of Safe Zone 0 • Status of indicate led: When the function key is in Geo-Fence mode, press the function key, the indicate LED2 will turn blue for 2 seconds, If the terminal user press the function key again in 2 seconds. The on/off status of safe zone 0 will be reversed. • The Gen-Fence mode is only useful when the function is enabled.

• Example 1

If you want to set Geo-fence mode by function key, configure the micro loci terminal

with command: AT+GTSFR=gl100,1,1,0,0,0,0,0,5,0,20080102112233 In the command

“0” means Geo-Fence mode


• Example 2

When the function key is in Geo-fence mode and the safe zone 0 is enabled. Double press the function key in 2 seconds will disable the status report of safe zone 0.

The configuration is done when the platform receives the following message:

+RESP:GTGEO,357344020001500,0,20090202085415,000a In the command “0” means the

Geo-fence status report on safe zone 0 has been disabled.


40


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.7.2.3 5.5.2.2 SOS Mode of Function Key

• Set the function key to SOS mode with command <AT+GTSFR> ( Please refer to chapter 3.1.6)

• When the function key is in SOS mode, Press the function key for 3 seconds. Then the micro loci terminal will report a SOS message to platform which includes the position information • Indicate led status: When the function key is in SOS mode. Press the function key, then the indicate led2 will turn blue, If the user release the function key in 3 seconds, the indicate led2 will be off, nothing will be reported. If the user press the function for more than 3 seconds, then the indicate led2 will be off after 3 seconds and the SOS report will be sent to platform. • The SOS mode is only useful when the function is enabled.

• Example 1 If you want the function key go to SOS mode. Configure the micro loci terminal

with command: AT+GTSFR=gl100,1,1,1,0,0,0,0,5,0,20080102112233 In the

command “1” means SOS mode.


• Example 2

When the function is in SOS mode. Press function key for 3 seconds. The platform will receive the GTSOS message after successful GPS fixing of micro loci terminal.

+RESP:GTSOS,352134010664994,0,0,0,1,0.0,124,32.0,8,121.354532,31.221943,2009022707

1039,0460,0000,18d8,6141,00,000c


41


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.8 4.6 Movement Detect

The “Movement Detect” function is used to disable fixed timing report when the micro loci terminal stays in a place without moving for long time. This will reduce data stream which is sent by GPRS/SMS greatly.

AT+GTSFR=gl100,1,1,0,0,1,20,500,3,0,20090101000000

Movement detect mode

Move Speed

Move Distance MoveNum

The parameter <Movement detect mode> is used to enable/disable movement detect function.

The micro loci terminal will check the movement status base on <Move Speed> and <Move Distance>

How to judge the movement status:

If the distance between current position and previous is longer than <Move Distance>. The micro loci terminal will be considered as in moving status. If the current speed is faster than <Move Speed>, the micro loci terminal will be considered as in moving status.

How to report:

• If(Send interval = Fix interval). Every report message includes 1 position record. The micro loci terminal will report “MoveNum” messages to platform when it is not moving. • If(Send interval != Fix interval). Every report message includes several position log, the

micro loci terminal will report all position logs to platform. But the speed of non-moving points will be set to -1.

Commands related: AT+GTSFR +ACK: GTSFR +RESP:GTTRI


42


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.9 4.7 Over-speed Alarm

The platform can set a speed threshold to the micro loci terminal. The micro loci terminal will report its position and speed to platform when it is over speed.

Please note the micro loci terminal will check the speed every time after successful GPS fixing.

The setting of over speed alarm is done by command <AT+GTRTO>

Example: (1) Enable over-speed alarm

AT+GTRTO=gl100, 9, 1, 10,20090101000000

Command option Speed Warn Enable Speed threshold

This command will enable over speed alarm and the speed threshold is 10km/h.

(2)The response from micro loci terminal

+ACK:GTRTO,135790246811220,SPEED,20090101000000, 20090101000002,0017

(3)The over-speed report message from micro loci terminal

+RESP:GTEST,135790246811220,0,0,0,1,12.3,92,70.0,1,121.354335,31.222073,0460,0000,

18d8,6141,00,20090101000112,0018 (4)Disable over-speed alarm

AT+GTRTO=gl100,9,0,10,20090101000000

Command Related: AT+GTRTO +ACK:GTRTO +RESP:GTEST


43


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.10 4.8 Power Management

7.10.1 4.8.1 Power Low Alarm

•When the battery level of micro loci terminal is low, it will report a power low alarm to platform.

•Example: +RESP:GTPLA,357344020001500,20080111223344,000a

7.10.2 4.8.2 Charge Status Report

• When the charge status of micro loci status is changed, it will report a message to platform (Please refer to chapter 3.2.2)

• Example 1: When the micro loci terminal goes from normal mode to charge mode, it

will report a GTBTC message to platform as following:

• Example 2: When the charge completes the micro loci platform will also send a

GTSTC command to platform as following.

+RESP:GTSTC,001000000000000,20030101120615,000b

7.10.3 4.8.2 Power Up When Charging

• Set “Full Power Up When Charge” function to micro loci terminal with command <AT+GTSFR> (Please refer to chapter 3.1.6).

• If the “Full Power Up When Charge” is enabled, the micro loci terminal will be fully powered up by charger. (Include GSM protocol stack and RF). Otherwise it will only go to charge mode.

• Example: If the platform wants to configure the “Full Power Up When

Charge” function of micro loci terminal. Send the following command to terminal.

+RESP:GTBTC,001000000000000,20030101120615,000a

AT+GTSFR=gl100,1,1,1,0,0,0,0,5,1,20080102112233 In the

command “1” means enable “Full Power Up When Charge”


44


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com


7.11 4.9 Real Time Operation on micro loci terminal

7.11.1 4.9.1 Get the Latest Successful GPS Fixing Time

• If the micro loci terminal use to has a successful GPS fixing. It will record the latest UTC time of it. The platform can get this record by command < AT+GTRTO >; The platform will get the default GPS time if the GPS fixing failed after the terminal is on.

• Example: If the platform wants to get the latest successful GPS fixing time of micro loci terminal.

Send the following command to terminal. AT+GTRTO=gl100, 0, 20090202170812

In the command “0” means get the latest successful GPS fixing time.

The command is accepted by micro loci terminal when the platform receives the following message:

+ACK:GTRTO,357344020001500,LGT,20090202170812,20090202170812, 000a

After that the micro loci terminal will report the latest successful GPS fixing time to

platform with following commands: +RESP:GTLGT,357344020001500,20090202091014,20090202170812, 000a

7.11.2 4.9.2 Real time Locate

• Example:

If the platform wants to get real time location of micro loci terminal, send the following

command to terminal. AT+GTRTO=gl100, 1, 20090202172647 In the command “1” means get

the real time location of micro loci terminal. The command is accepted by micro loci terminal when the platform receives the following message:


45


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

+ACK:GTRTO,357344020001500,RTL,20090202172647,20090202172647,000a After that

the micro loci terminal will report real time position to platform with following

commands:

+RESP:GTRTL,357344020001500,0,0,0,1,0.0,189,32.0,6,121.354647,31.222080,20090227

071327,0460,0000,18d8,3072,00,000f


46


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.11.3 4.9.3 Get All Configuration Parameters

• Example

If the platform wants to get all configurations parameters of micro loci terminal, send

the following command to terminal. AT+GTRTO=gl100, 2, 20090202172647

In the command “2” means get all configuration of micro loci terminal.


+ACK:GTRTO,357344020001500,READ,20090202172647,20090202172647,000a

After that the micro loci terminal will report all parameters with following commands: +RESP:GTALL,357344020001500,,116.228.221.51,4321,,,13671500000,,0,Geo,121,31,1000,

0,Area1,,,,,Area2,,,,,Area3,,,,,Area4,,,,,0000,0000,60,3600,1,1,0,0,0,0,0,5,0,1,0,20090203 094859,000a

Please be note that “+RESP:GTALL” won‟ t be sent through SMS.

7.11.4 4.9.4 Reboot the micro loci terminal

• Example

If the platform wants reboot the micro loci terminal. Send the following command to

terminal. AT+GTRTO=gl100, 3, 20090202170812 In the command “3” means reboot the

micro loci terminal.


+ACK:GTRTO,357344020001500,REBOOT,20090202172647,20090202172647,000a

After that the micro loci terminal will reboot.


47


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.11.5 4.9.5 Reset to Default Setting

• Reset the configuration with command <AT+GTRTO>. Then all configuration will be reset to factory setting except : Main server address and port number, APN,APN user Name, APN Password, Report mode, Main SMS gate;

• Example Reset the configuration to factory setting with command:

AT+GTRTO=gl100,4, 20090202172647 In the command “4” means

reset configuration to factory setting.


+ACK:GTRTO,357344020001500,RESET,20090202172647,20090202172647,000a

Platform can also check the parameters of micro loci terminal by command <AT+GTRTO>

7.11.6 4.9.6 Get the ICCID of SIM Card

• Example

If the platform wants get the ICCID of SIM card which is inserted in micro loci terminal,

send the following command to terminal. AT+GTRTO=gl100, 5, 20090202172647

In the command “5” means this command is used to get the ICCID of SIM card inserted in

micro loci terminal.


+ACK:GTRTO,357344020001500,CID,20090202172647,20090202172647,000a

The micro loci terminal will then report the ICCID with follow message.

+RESP:GTCID,357344020001500,898600120907F6015733,20090203094907,000a


48


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.11.7 4.9.7 Get GSM Signal Level

• Example

If the platform wants get the GSM signal level of micro loci terminal, send the following

command to terminal. AT+GTRTO=gl100, 6, 20090202172647

In the command “6” means this command is used to get the GSM signal level of micro

loci terminal.


+ACK:GTRTO,357344020001500,CSQ,20090202172647,20090202172647,000a

The micro loci terminal will then report the GSM signal level with follow

message. +RESP:GTCSQ,357344020001500,19,0,20090203094910,000a

7.11.8 4.9.8 Get Firmware Version

• Example

If the platform wants get the software version of micro loci terminal, send the

following command to terminal. AT+GTRTO=gl100, 7, 20090202172647

In the command “7” means this command is used to get the firmware version.


+ACK:GTRTO,357344020001500,SWV,20090202172647,20090202172647,000a

The micro loci terminal will then report the firmware version with follow message.

+RESP:GTSWV,357344020001500,1604B01GL100M32_SST34HF3284,V01,20090203094913,0

0 0a


49


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.11.9 4.9.9 Get Hardware Version

• Example

If the platform wants get the hardware version of micro loci terminal, send the

following command to terminal. AT+GTRTO=gl100, 8, 20090202172647

In the command “8” means this command is used to get the hardware version.


+ACK:GTRTO,357344020001500,HWV,20090202172647,20090202172647,000a

The micro loci terminal will then report the hardware version with follow message. +RESP:GTHWV,357344020001500,GL100V0103,20090203094914,000a

7.11.10 4.9.9 Get the Battery Level

• Example

If the platform wants get the battery level of micro loci terminal, send the following command to terminal.

AT+GTRTO=gl100, A, 20090202172647

In the command “A” means this command is used to read the battery level. The command is

accepted by micro loci terminal when the platform receives the following message:

+ACK:GTRTO,001000000000000,CBC,20080711094300,20090210071841,000a The micro loci

terminal will then report the battery level with follow message.

+RESP:GTCBC,001000000000000,94,20090210071841,0008 In the message “94” means 94

percents left.


50


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

7.12 4.10 Buffer Report Function

If the micro loci terminal is not in GSM network coverage, the micro loci terminal will record the messages need to be sent to platform. The messages will be sent to platform when the micro loci terminal back to GSM coverage. The micro loci terminal can record up to 720 messages. “#BUF#” will be added to all buffered message. Buffered message only can be sent by TCP or UDP protocol. It can‟ t be sent by SMS. Sending priority: The buffered messages will be sent after normal messages.

Example The example for buffered messages is as following.

#BUF#+RESP:GTTRI,001000000000000,1,0,0,0,6.7,148,37.0,50,121.354647,31.22171

3 ,20090119020919,0460,0000,18d8,3072,000b


51


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

5. Led Indication

The right LED on the Spark Nano is called LED1. The left LED is called LED2. Blue LED2 means LED2 is blue.

LED1 Red Case 1: The power key has been pressed

Case 2:The device receives a valid configuration command

Green Case 1: Fast flash means network searching

Case 2: Slow flash means network is registered

Case 3: Solid means SIM pin locked (Three is a bug in the current firmware on this case )

Blue Fast flash means the GPS is in fixing

Blue LED1 will be solid for 2 seconds when GPS is fixed

LED2 Red Case 1: Solid means power is low

Case 2: Slow flashes when charging

Green Case 1: Solid means charge completed

Case 2: After inserting the serial port, the led will light in the 8 seconds during. It means that the device is checking the battery status.

Blue Case 1: Geo-Fence mode Blue led2 will be solid if the function key is pressed. After that if the user press the function key one more time in 2 seconds the blue LED2 will be off and he new Geo-Fence center will be set after successful GPS fix.

Case 2: SOS The blue led2 will be solid when the function key is pressed. It will be off after the function key released. User should press the function key for at least 3 seconds to start SOS report.


52


Phone: (213) 489-3019 Fax: (213) 489-3062

www.gtxcorp.com

8 Annex 1:Commands Index

AT+GTSRI +ACK:GTSRI AT+GTBEI +ACK:GTBEI AT+GTTRI +ACK:GTTRI AT+GTSZI +ACK:GTSZI AT+GTRTO +ACK:GTRTO AT+GTSFR +ACK:GTSFR +RESP:GTSZI +RESP:GTSOS +RESP:GTRTL +RESP:GTEST +RESP:GTLBC +RESP:GTTRI +RESP:GTPNA +RESP:GTPFA +RESP:GTPLA +RESP:GTBTC +RESP:GTSTC +RESP:GTCID +RESP:GTHWV +RESP:GTLGT +RESP:GTCBC +RESP:GTCSQ +RESP:GTSWV +RESP:GTALL +RESP:GTGEO AT+GTHBD +RESP:GTHBD

Date post:	18-Nov-2014
Category:	Documents
Upload:	askmeagain
View:	516 times
Download:	3 times

Microloci Protocol

Documents