GH3000 SMS Configuration Protocol 1.04

5/20/2018 GH3000 SMS Configuration Protocol 1.04

1/19

GH3000SMS CONFIGURATION

PROTOCOL

Document version 1.03


2/19

2

Writing rules........................................................................................................................3Device Configuration ..........................................................................................................4

General Configuration......................................................................................................4Profile configuration .........................................................................................................4Configuration of Periodical Tracking................................................................................4Configuration of Periodical Tracking by SMS ..................................................................5Configuration of AGPS options........................................................................................6Configuration of Filter.......................................................................................................6Configuration of GeoFence..............................................................................................6Configuration of Alarm .....................................................................................................7Configuration of Send Alarm by GRPS............................................................................7Configuration of Send Alarm by SMS ..............................................................................7Configuration of Send Alarm by Call................................................................................8Configuration of Keyboard ...............................................................................................9Configuration of GSM ....................................................................................................10Call In Authorization.......................................................................................................10Auto Answer function .....................................................................................................10

Configuration of Action On Call .....................................................................................11Configuration of SMS functionality and Security............................................................11Configuration of Connections & Data (GPRS)...............................................................12Configuration of Connections & Data (APN)..................................................................12Configuration of Connections & Data (Server) ..............................................................13Configuration of Notifications .........................................................................................13Configuration of Date and Time.....................................................................................18Configuration of Daylight Saving ...................................................................................18Configuration of Call Table ............................................................................................18Configuration of SMS Table...........................................................................................19


3/19

3

Writing rules

Default configuration password is ; SMS message length 160 symbols;

Each command in same massage is separated by semicolon(;);

Configuration command from parameters must be separated by colon(:);

Configuration commands parameters must be separated by comma(,); To clear Configuration commands string parameters value use(~);

SMS format in case of single message:o Last command must be RST;

SMS format in case of multiple massage:o Same configuration command parameters must be in same message;o Last message must end with RST command;

Any character is accepted in the string parameters, except for:o Comma (,) must be escaped as\,o Semicolon (;) must be escaped as\;o Backslash (\) must be escaped as\\o

Tilde (~) is generally treated as clear value sign, therefore must be also escaped as\~


4/19

4

Device Configuration

General Configuration

Settings Group Configuration command

General PSW:;CFG1;GEN:,,,;RST

Action Parameter Value Description

Device ID String

Device name or ID, Max 31symbol,

GH3000 by default

N/A message StringUp to 15 characters

N/A by default

Actuation by external power 0 1

Enable 1,

Disable 0.

Default 1.

Profile Name StringUp to 15 characters,

UNTITLED by default

Profile configuration


General PSW:;CFG1;PRF:;RSTAction Parameter Value Description

Active profile 1 5 Profile number

Configuration of Periodical Tracking


Periodical Tracking PSW:;CFG1;GPS:,,,,;RST


Enable GPS 0 1

Enable 1,

Disable 0.

Default 1.

GPS Position Timeout 30 9999Seconds.

Default 180.

GPS Logging Interval 0 2.592.000Seconds (max. 30 days).

Default 600.

External Power 0 1

Enable 1,

Disable 0.

Default 1.


5/19

5

Configuration of PeriodicalTracking by SMS


Periodical Tracking by SMS PSW:;CFG1;PTS:,,;RST


Enable Periodical tracking bySMS

0 1

Enable 1,

Disable 0.

Default 0.

SMS sending period 30 9999SMS sending interval in seconds.Default 60.

SMS sending number Number

Phone number to send SMSmessages.

Min 3 length max 31 length.

SMS format 0 9, 13 16

0 None

1 Undefined

2 FIX!

3 SMS Track turned on!

4 SMS Track turned off!

5 GEO!

6 INF!

7 MN

8 Alarm9 Alarm turned off

13 Call terminated

14 Configuration changed

15 Charge battery

16 Cross!

Default 1.


6/19

6

Configuration of AGPS options


AGPS options PSW:;CFG1;AGPS:,,,;RST


Enable AGPS 0 1

Enable 1,

Disable 0.

Default 0.

AGPS Update Interval 1, 2, 3 ,4, 5, 7, 10, 14Almanac update interval in days.

Default 7.

Server Server address

Server IP address

String length 31 symbols

default: www.u-blox.com

Port Server port Default 0.

Configuration of Filter


Filter PSW:;CFG1;FLTR:,;RSTAction Parameter Value Description

Enable 0 1

Enable 1,

Disable 0.

Default 0.

Mode 0 10 Pedestrian,

1 Automotive

Configuration of GeoFence


GeoFence Events table PSW:;CFG1;GEO:;RST


Enable GeoFence Function 0 1

Enable current Geo-Fence zone.Enable 1,

Disable 0.

Notethat enabling individual

zones is meaningful only if GlobalGeoFence functionality is enabledin Configuration of PeriodicalTracking parameter

Default 0.


7/19

7

Configuration of Alarm


Alarm PSW:;CFG1;ALM:,,,;RST


Alarm duration time 1 2.592.000Seconds.

Default 300.

Pre-Alarm delay 0 65.535Seconds.

Default 0.

Track Saving Period 1 65.535Seconds.

Default 5.

Method 0, 1, 2, 3

0 Call,

1 GPRS,

2 GPRS or SMS,

3 SMS,

Default 2.

Configuration of Send Alarm by GRPS


Send Alarm By GRPS PSW:;CFG1;AM1:;RSTAction Parameter Value Description

GPRS Send Period 0 65.535Seconds.

Default 600

Configuration of Send Alarm by SMS


Send Alarm By SMS PSW:;CFG1;AM2:,,,,,;RSTAction Parameter Value Description

Period 30 2592000 SMS sending period.

Default 60

Number - NumberPhone number to send SMSmessages

SMS format 0 9, 13 16 Default 2


8/19

8

Configuration of Send Alarm by Call


Send Alarm By CallPSW:;CFG1;AM3:,,,,,,,,

;RSTAction Parameter Value Description

No Answer time out Seconds 10 180s.

Default 30

Numbers 5 Numbers Phone numbers to call

Time for conversation 10 300s. Default 60.

Overtime 0 300s. Default 60.

Time for alarm stop 10 300s. Default 60.


9/19

9

Configuration of Keyboard


Keyboard PSW:;CFG1;KEY:,,,,,;RST


Enable 0 1Disable 0,

Enable 1.

Keyboard locking 0 1Disable 0,

Enable 1.

First function 0, 7, 20, 24, 30 - 32, 40,

50 - 54, 80, 81, 90 - 92

0 - No action

7 - Alarm on

20 - Alarm off

24 - Alarm Switch30 - SMS Track on

31 - SMS Track off

32 - SMS Track switch

40 - Send data thru GPRS

50 - NMEA on

51 - NMEA off

52 - NMEA switch

53 - Modem emulation on

54 - Modem emulation off

80 - Power off

81 - Reset

90 - Parking on

91 - Parking off

92 - Parking switch

On Ring 0, 64, 66, 69

0 - No action

64 - Hang up

66 - Normal Answer69 - Loud speaker switch

During call 0, 60 - 64, 69

0 - No action

60 - Audio volume up

61 - Audio volume down

62 - Mute on

63 - Mute off

64 - Hang up

69 - Loud speaker switch


10/19

10

Configuration of GSM


GSM PSW:;CFG1;GSM:,,;RSTAction Parameter Value Description

Enable GSM 0 1

Enable 1,

Disable 0.

Default 1.

Minute Minder Time0 60 s.

Default 60.

Enable SPY 0 1

Enable 1,

Disable 0.

Default 0.

Call In Authorization


Call InPSW:;CFG1;CIA:,,,,,,,,,,;RST


Enable Call In Authorization 0 1

Enable 1,

Disable 0.

Default 0.

Numbers -

Empty field or number

i.e. +37069911111

+ The maximum length of aphone number (including +symbol) is 15.

Auto Answer function


Auto Answer PSW:;CFG1;AA:;RSTAction Parameter Value Description

Number of calls 0, 1, 2, 3, 5, 8

Number of rings before Auto

Answer.

Default 0.

0 Auto answer off

1 Auto Answer after one ring

2 Auto Answer after two rings

3 Auto Answer after three rings

5 Auto Answer after five rings

8 Auto Answer after eight rings


11/19

11

Configuration of Action On Call


Action On Call PSW:;CFG1;AOC:,;RST


Function 7,20,24,30,31,40,75,80,81,

90,91

7 Alarm on

20 Alarm off

24 Alarm Switch

30 SMS Track on

31 SMS Track off

40 Send data thru GPRS

75 Spy

80 Power off

81 Reset

90 Parking on

91 Parking off

Activation Phone Number Empty field or number

i.e. +37069911111

+ The maximum length of aphone number (including +symbol) is 15 digits.

Configuration of SMS functionality and Security

Settings Group Configuration commandSMS PSW:;CFG1;SMS:, ,,,,,;RST


SMS send in roaming 0 1

Disable 0,

Request only 1.

Default 0.

Enable Security 0 1

Disable 0,

Enable 1.

Default 0.

SMS phone number - Empty field or number

i.e. +37069911111

+ You can define up to 5 phonenumbers. The maximum length ofa phone number (including +symbol) is 15 digits.


12/19

12

Configuration of Connections & Data (GPRS)


GPRS PSW:;CFG1;GPRS:,,,,;RST


Enable GPRS 0 1

Enable 1,

Disable 0.

Default 0.

Hold Server Connection Alive 0 1

Enable 1,

Disable 0.

Default 0.

GPRS Send Period 0 86400 sData sending period.

Default 300.

Save data to the memory 0 1

0 Then location available only,

1 Always.

Default 0.

Data order 0 1

Data sending order.

Newest 1,

Oldest 0.

Default 0.

Configuration of Connections & Data (APN)


APN PSW:;CFG1;APN:,,,;RST =[0..3]Action Parameter Value Description

Authentication type 0 2

0 None,

1 PAP,

2 CHAP

Access Point Name Empty field ~ Max. 31 characters

APN Username Empty field ~ Max. 31 characters

APN Password Empty field ~ Max. 31 characters


13/19

13

Configuration of Connections & Data (Server)


Server PSW:;CFG1;SERV:,,;RST

Action Parameter Value DescriptionServer IP Address or

Server DNS address 0.0.0.0 or DNS Numbers. Default 0.

Server Port 0 65535 Numbers. Default 0.

Protocol 0 1

0 TCP;

1 UDP.

Default 0.

Configuration of Notifications


NotificationsPSW:;CFG1;NTFY:,,,,,,,,,,,,,,,,,,,,,,,;RST

Action Parameter

Value Description

Ring Level 0 5 Ringer level

Speaker Level 0 100 Device speaker volume level

Melody 0 8 Melody number

Incoming SMS 0, 20 Disable

2 Enable audio

Outgoing SMS 0, 20 Disable

2 Enable audio

Pre-Alarm 0, 20 Disable

2 Enable audio

Alarm 0 7

0 Disable

1 Led

2 Audio

3 Led & Audio

4 Vibrator

5 Led & Vibrator

6 Audio & Vibrator

7 Led, Audio & Vibrator


14/19

14

Incoming Call 0 7

0 Disable

1 Led

2 Audio

3 Led & Audio

4 Vibrator

5 Led & Vibrator

6 Audio & Vibrator


Outgoing Call 0 7

0 Disable

1 Led

2 Audio

3 Led & Audio

4 Vibrator

5 Led & Vibrator

6 Audio & Vibrator


Full Battery 0 15

0 Disable

1 Led

2 Audio

3 Led & Audio

4 Vibrator

5 Led & Vibrator

6 Audio & Vibrator


8 SMS

9 Led & SMS

10 Audio & SMS

11 Led, Audio & SMS

12 Vibrator & SMS

13 Led, Vibrator & SMS

14 Audio, Vibrator & SMS

15 Led, Audio, Vibrator & SMS


15/19

15

Low Battery 0 15

0 Disable

1 Led

2 Audio

3 Led & Audio4 Vibrator

5 Led & Vibrator

6 Audio & Vibrator


8 SMS

9 Led & SMS

10 Audio & SMS

11 Led, Audio & SMS

12 Vibrator & SMS




Critical Battery 0 15

0 Disable1 Led

2 Audio

3 Led & Audio

4 Vibrator

5 Led & Vibrator

6 Audio & Vibrator


8 SMS

9 Led & SMS

10 Audio & SMS

11 Led, Audio & SMS

12 Vibrator & SMS





16/19

16

Button 0 15

0 Disable

1 Led

2 Audio

3 Led & Audio

4 Vibrator5 Led & Vibrator

6 Audio & Vibrator


8 SMS

9 Led & SMS

10 Audio & SMS

11 Led, Audio & SMS

12 Vibrator & SMS




Fix, No Fix 0 15

0 Disable

1 Led

2 Audio

3 Led & Audio

4 Vibrator5 Led & Vibrator

6 Audio & Vibrator


8 SMS

9 Led & SMS

10 Audio & SMS

11 Led, Audio & SMS

12 Vibrator & SMS




Low Battery level 0 100Low battery level 0 100.

Default 40 (%).

Critical Battery level 0 100Critical battery level 0-100 (%).

Default 30(%).

SMS number Empty field or numberi.e. +37069911111

+ You can define up to 5 phonenumbers. max length is 15 digits.


17/19

17

Battery Notification Interval 60 65535

Battery level notification interval inseconds.

Default 900.

SMS format Bat Full 3Outgoing SMS message format.Default 3.

SMS format Bat Low 0 100Outgoing SMS message format.Default 4.

Device On 0 15

0 Disable

1 Led

2 Audio

3 Led & Audio

4 Vibrator

5 Led & Vibrator

6 Audio & Vibrator


8 SMS

9 Led & SMS

10 Audio & SMS

11 Led, Audio & SMS

12 Vibrator & SMS




Device Off 0 15

0 Disable

1 Led

2 Audio

3 Led & Audio

4 Vibrator

5 Led & Vibrator

6 Audio & Vibrator


8 SMS

9 Led & SMS

10 Audio & SMS

11 Led, Audio & SMS

12 Vibrator & SMS





18/19

18

Configuration of Date and Time


Date and Time PSW:;CFG1;TIME:,;RST

Action Parameter Value DescriptionChange Time Zone

(Daylight Saving Disabled) From -12 to +13

i.e. 3.5 is GMT +3:30 (Tehran).

Default 0.

Change Time Format String

%Y.%m.%d %H:%M:%S

%Y year,%m Month,%d Day,%H: hour,%M: Minutes,%S Seconds.Up to 63 characters.

Configuration of Daylight Saving


Daylight Saving PSW:;CFG1;DLS:,,,;RST


Day light saving 0 1Enable 1,

Disable 0.

Delta 0 24 Time difference

Start date Date Date to start daylight saving

End date Date Date to end daylight saving

Configuration of Call Table


Call Table PSW:;CFG1;CT:,,;RSTAction Parameter Parameter Description

Id number 0 14 Call Id number

Call type Format 0 10 Normal,

1 Spy

Phone Number Phone Number max Length 15 digits


19/19

19

Configuration of SMS Table


SMS Table PSW:;CFG1;ST:,,,,;RST

Action Parameter Parameter DescriptionId number 0 14 SMS Id number

SMS format Id 0 9, 13 16

0 None

1 Undefined

2 FIX!

3 SMS Track turned on!

4 SMS Track turned off!

5 GEO!

6 INF!

7 MN

8 Alarm

9 Alarm turned off

13 Call terminated

14 Configuration changed

15 Charge battery

16 Cross!

Phone Number Phone Number max Length 15 digits

GH3000 SMS Configuration Protocol 1.04

Documents

Transcript of GH3000 SMS Configuration Protocol 1.04