+ All Categories
Home > Documents > PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom...

PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom...

Date post: 24-Apr-2018
Category:
Upload: vutram
View: 261 times
Download: 5 times
Share this document with a friend
24
PSIM Command for MTK GNSS Platform
Transcript
Page 1: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

PSIM Command for MTK GNSS Platform

Page 2: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 2 / 24 2015.6.22

Document Title: PSIM Command for MTK GNSS Platform

Version: V1.04

Date: 2015-06-22

Status: Release

Document Control ID: PSIM Command for MTK GNSS Platform V1.04

General Notes

SIMCom offers this information as a service to its customers, to support application and engineering efforts

that use the products designed by SIMCom. The information provided is based upon requirements specifically

provided to SIMCom by the customers. SIMCom has not undertaken any independent search for additional

relevant information, including any information that may be in the customer’s possession. Furthermore, system

validation of this product designed by SIMCom within a larger electronic system remains the responsibility of

the customer or the customer’s system integrator. All specifications supplied herein are subject to change.

Copyright

This document contains proprietary technical information which is the property of SIMCom Limited., copying

of this document and giving it to others and the using or communication of the contents thereof, are forbidden

without express authority. Offenders are liable to the payment of damages. All rights reserved in the event of

grant of a patent or the registration of a utility model or design. All specification supplied herein are subject to

change without notice at any time.

Copyright © Shanghai SIMCom Wireless Solutions Ltd. 2015

Page 3: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 3 / 24 2015.6.22

Version History

Version Chapter What is new

V1.00 Original version Original

V1.01 2.10, 2.13 Modify PSIMSN, PSIMIO support module

V1.02 2.4, 2.14 Modify 2.4 PSIMGEO units, remove style; add 2.14

V1.03 2.1,2.3,2.4,2.15,2.16 Remove useless comments; 2.1 Index15 GPS Satellites Used; modify

2.3 PSIMONE onte; 2.4 PSIMGEO shape; Add 2.15 and 2.16

V1.04 2.17 Add 2.17

Page 4: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 4 / 24 2015.6.22

Contents

VERSION HISTORY..................................................................................................................................................3 

1  INTRODUCTION...............................................................................................................................................5 

1.1  SCOPE OF THE DOCUMENT .............................................................................................................................5 

1.2  RELATED DOCUMENTS ...................................................................................................................................5 

1.3  TERM ABBREVIATION.....................................................................................................................................5 

2  GNSS APPLICATION........................................................................................................................................6 

2.1  PSIMFIX CURRENT FIX INFORMATION........................................................................................................7 

2.2  PSIMLST LATEST SUCCESS FIXED INFORMATION........................................................................................8 

2.3  PSIMONE ONE NMEA MESSAGE OUTPUT MODE .......................................................................................9 

2.4  PSIMGEO GEO FENCE.............................................................................................................................10 

2.5  PSIMSPD SPEED ALARM..........................................................................................................................12 

2.6  PSIMDBG DEBUG INFORMATION OUTPUT CONTROL ................................................................................13 

2.7  PSIMMOD GNSS MODULE MODE SELECTION..........................................................................................14 

2.8  PSIMODO ODOMETER .............................................................................................................................15 

2.9  PSIMIPR NMEA PORT DATA RATE ..........................................................................................................16 

2.10  PSIMSN SERIAL NUMBER OPERATION .....................................................................................................16 

2.11  PSIMINI INITIALIZE USER DATA BLOCK...................................................................................................17 

2.12  PSIMPPS 1PPS CONFIGURATION ............................................................................................................17 

2.13  PSIMIO IO OPERATE COMMAND ...............................................................................................................18 

2.14  PSIMANT ANTENNA DETECT COMMAND .................................................................................................19 

2.15  PSIMNAV NAVIGATION MODE COMMAND ................................................................................................21 

2.16  PSIMECEF ECEF SENTENCE CONTROL COMMAND ..................................................................................21 

2.17  PSIMNMEA NMEA SENTENCES OUTPUT CONTROL COMMAND ...............................................................23 

Tables

TABLE 1-1: TERM ABBREVIATION ...................................................................................................................................5 

TABLE 2-1: GNSS APPLICATION RELATED COMMANDS ...................................................................................................6 

TABLE 2-2: MESSAGE STYLE ...........................................................................................................................................6 

TABLE 2-3: COMMAND AND COMMAND RESPONSE TABLE ..............................................................................................7 

TABLE 2-4: RETURN PARAMETERS ..................................................................................................................................7 

Figures

FIGURE 2-1: SYSTEM CONNECTION.................................................................................................................................6 

Page 5: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 5 / 24 2015.6.22

1 Introduction

1.1 Scope of the document

This document describes how to use PSIM serial command, which include the GEO fence, speed alarm and IO

operate function etc. Examples are also given for reference.

This document is subject to change without notice at any time.

1.2 Related documents

SN Document name Remark

[1]

1.3 Term abbreviation

Table 1-1: Term abbreviation

Abbreviation Definition

URC Unsolicited Result Code

GNSS Global Navigation Satellite System

GPS Global Positioning System

AGPS Assisted GPS

DGPS Differential Global Positioning System

GSA GNSS DOP and Active Satellites

GSV GNSS Satellites in View

GGA Global Positioning System Fixed Data

GLL Geographic Position - Latitude/Longitude

VTG Course Over Ground and Ground Speed

ZDA Time & Date

HPA Horizontal Position Accuracy

VPA Vertical Position Accuracy

GEO-Fence A geographic area

HDOP Horizontal Dilution of Precision

HTTP Hypertext Transfer Protocol

NMEA National Marine Electronics Association

PDOP Position Dilution of Precision

PDP Packet Data Protocol

RMC Recommended Minimum Specific GNSS Data

VDOP Vertical Dilution of Precision

Page 6: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

2 GNSS Application

GNSS application provides a method to interact with a SIMCOM GNSS module.

Figure 2-1: System connection

PSIM serial commands as follows:

Table 2-1: GNSS application related commands

Index Commands Operation Description

1 PSIMFIX [R] Current fix information

2 PSIMLST [R]/W Latest success fixed information

3 PSIMONE T/W/R One NMEA message output mode

4 PSIMGEO T/W/R/Q/U GEO fence

5 PSIMSPD T/W/R/Q/U Speed Alarm

6 PSIMDBG T/W/R Debug information

7 PSIMMOD T/W/R GNSS module mode selection

8 PSIMODO T/W/R Odometer

9 PSIMIPR T/W/R NMEA port data rate

10 PSIMSN T/W/R Serial number operation

11 PSIMINI W initialize user data block (fill zero)

12 PSIMPPS[1] T/W/R 1PPS configuration

13 PSIMIO T/W/R IO operate

14 PSIMANT T/W/R/Q Antenna detect

Note

1. PSIMPPS command need firmware support.

2. Command are case sensitive.

See below table for these commands or URC message style.

Table 2-2: message style

Value Alias Char Description

1 T Test format command

2 W Write command

3 R Read command

4 Q Query command

UART

HOST

GNSS (SIMXX)

PSIM Command for MTK GNSS Platform V1.04 6 / 24 2015.6.22

Page 7: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 7 / 24 2015.6.22

5 U URC Message

Note

1. Alias char is case insensitive.

command response

Table 2-3: Command and command response Table

Value Return String Description

- Ok Command Execution Success

- Error Command Execution Error

2.1 PSIMFIX Current fix information

PSIMFIX Current fix information of GNSS

Example: $PSIMFIX*50

Response

PSIMFIX,R,Ok,

<Fix status>,

<UTC date &Time>,<Latitude>,<Longitude>,

<MSL Altitude>,<Speed Over Ground>,

<Course Over Ground>,<Fix Mode>,

<Reserved1>,

<HDOP>,<PDOP>,<VDOP>,

<Reserved2>,

<GNSS Satellites in View>,<GNSS Satellites Used>,

<Reserved3>,< Reserved4>,< Reserved5>,

<HPA>,<VPA>

Read Command

PSIMFIX[,R]

Parameter

See below table.

Table 2-4: return Parameters

Index Parameter Unit Range Max

Length

1 Fix status -- 0: no fix

1:2-dimensional fix

2:3-dimensional fix

1

2 UTC date &Time DyyMMTddhh

mmss.sss

D: char 'D' ,refer to date

yy: [80,99] and [00,39][1]

MM : [1,12]

dd: [1,31]

T: char 'T', refer to time

18

Page 8: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 8 / 24 2015.6.22

hh: [0,23]

mm: [0,59]

ss.sss:[0.000,60.999]

3 Latitude ±dd.dddddd [-90.000000,90.000000] 10

4 Longitude ±ddd.dddddd [-180.000000,180.000000] 11

5 MSL Altitude meters 8

6 Speed Over Ground Km/hour [0,999.99] 6

7 Course Over Ground degrees [0,360.00] 6

8 Fix Mode[2] -- 0 : No fix

1 : Estimated mode

2 : Position fixed

3 : Position fixed in DGPS mode

1

9 Reserved1 0

10 HDOP -- [0,99.99] 5

11 PDOP -- [0,99.99] 5

12 VDOP -- [0,99.99] 5

13 Reserved2 0

14 GNSS Satellites in

View

-- [0,99] 2

15 GPS Satellites Used -- [0,99] 2

16 Reserved3 0

17 Reserved4 0

18 Reserved5 0

19 HPA meters [0,999999.0] 8

20 VPA meters [0,999999.0] 8

Total:(91) chars (not include parameter seperate char ',')

Note:

1. Range from 1980 to 2039, corresponding to 80~99~00~39.

2. The range of < Fix Mode >depends on the GNSS part used:

1 : SPS mode;

2 : DGPS mode.

2.2 PSIMLST Latest success fixed information

PSIMLST Latest success fixed information

Example: $PSIMLST*4C

Read Command

PSIMLST[,R]

Response

Page 9: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 9 / 24 2015.6.22

PSIMLST, R,Ok,

<current UTC date & Time>,

<Fix status>,

<UTC date &Time>,<Latitude>,<Longitude>,

<MSL Altitude>,<Speed Over Ground>,

<Course Over Ground>,<Fix Mode>,

<Reserved1>,

<HDOP>,<PDOP>,<VDOP>,

<Reserved2>,

<GNSS Satellites in View>,<GNSS Satellites Used>,

<Reserved3>,< Reserved4>,< Reserved5>,

<HPA>,<VPA>

Parameter

See PSIMFIX command parameters

Write Command

PSIMLST,W

Response

This command will write latest fixed information to Flash

If success, return :

PSIMLST,W,Ok

If error, return :

PSIMLST,W,Error

2.3 PSIMONE One NMEA message output mode

PSIMONE One NMEA message mode

Example: $PSIMONE,W,1*25

Response

PSIMONE,T ,(0-1)

Test Command

PSIMONE,T

Parameters

See Write Command

Write Command

PSIMONE,W,<mode>

Response

If success, return :

PSIMONE,W,Ok

If error, return :

PSIMONE,W,Error

Parameters

<mode>

1: One NMEA message output mode

0: Normal NMEA output mode

Page 10: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 10 / 24 2015.6.22

Response

TA returns the current debug information output control

PSIMONE,R,Ok,

<mode>

Parameters

See Write Command

Note: if the return value is not 0 or 1 indicates the user is not set

yet.

Read Command

PSIMONE,R

URC message

PSIMONE,U,

< parameters the same as PSIMFIX>

Parameter

See PSIMFIX command parameters

If turn on one sentence mode , module will output PSIMONE sentence every Fix interval only.

Note

1. Enter one sentence mode: need module reset or Cold/Warm/Hot/Full cold restart to take effect.

2. Back to normal mode: need module reset or Full cold restart to take effect.

2.4 PSIMGEO GEO fence

PSIMGEO GEO fence

Example: $PSIMGEO,W,0,1,1,,31.221939,121.354110,1000.,0.0,0.0,0,0,0,0,0*2E

Response

PSIMGEO,T,(0-9),(0-3),(0-4),,

(-90-90),(-180-180),

(-90-90\0-6000000),(-180-180),

(-90-90),(-180-180),

(-90-90),(-180-180),

(-90-90),(-180-180)

Test Command

PSIMGEO,T

Parameter

See below table.

Response

If success, return :

PSIMGEO,W,Ok

If error, return :

PSIMGEO,W,Error

Write Command

PSIMGEO,W,

<GEO ID n>,<mode>,

<shape>,<reserved>,

<latitude0>,<longitude0>,

<latitude1\radius>,<longitude1

>,<latitude2>,<longitude2>,<la

titude3>,<longitude3>,<latitud

e4>,<longitude4>

Parameters

<GEO ID n>

GEO-fence ID from 0 to 9.

Page 11: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 11 / 24 2015.6.22

<mode>

0: Disable Geo-Fence.

1: Reports when enters the Geo-Fence.

2: Report when leaves the Geo-Fence.

3: Report when enters or leaves the Geo-Fence.

<shape>

0: Not active

1: Circularity set by center and radius

2: Circularity set by center and one point on the circle

3: Triangle

4: Quadrangle

<reserved>

Reserved for future use

<latitude0>

The latitude of a point which is defined as the center of the

Geo-Fence circular region or first point.

<longitude0>

The longitude of a point which is defined as the center of

the Geo-Fence circular region or first point.

<latitude1\radius>

The radius(unit:meters,>0) of a circular or latitude of 2nd

point.

<longitude1>

The longitude of 2nd point.

<latitude2>

The latitude of 3rd point.

<longitude2>

The longitude of 3rd point.

<latitude3>

The latitude of 4th point.

<longitude3>

The longitude of 4th point.

<latitude4>

The latitude of 5th point, this parameter is reserved.

<longitude4>

The longitude of 5th point, this parameter is reserved.

Response

PSIMGEO,R,Ok,

<GEO ID n[1]>,<mode>,

<shape>,<reserved>,

<latitude0>,<longitude0>,

<latitude1\radius>,<longitude1>,<latitude2>,<longitude2>,

<latitude3>,<longitude3>,<latitude4>,<longitude4>

Read Command

PSIMGEO,R, <GEO id>

Parameters

See Write Command

Page 12: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 12 / 24 2015.6.22

Query Command

PSIMGEO,Q,<GEO id>

Response

Return the current status of this GEO fence

PSIMGEO,Q,Ok, <GEO id>,<status>

PSIMGEO,U,

<GEO id n[1]>, <status>, < parameters the same as PSIMFIX>

URC Message

Parameters

<status>

0: not active 1: enter a GEO fence 2: leave a GEO fence

Other parameter please see Write Command

Note

1. n is from 0 to 9.

2. Only in Tracker mode (see PSIMMOD command,< mode>parameter is 1),PSIMGEO commands will

take effect.

3. If customer want to use this function, must set it first (use $PSIMGEO,W command).

2.5 PSIMSPD Speed Alarm

Clients can use up to 4 speed alarm setting:

PSIMSPD Speed Alarm

Example: $PSIMSPD,W,1,1.1,1,2.2,1,3.3,1,4.4*3B

Response

PSIMSPD,T,

(0-2),(0-999.99)[,(0-2),(0-999.99)[,(0-2),(0-999.99)[,(0-2),(0-999.99)]]

]

Test Command

PSIMSPD,T

Parameters

See Write Command

Write Command

PSIMSPD,W,

<alarm 1 mode>,

<alarm 1 speed>,

<alarm 2 mode>,

<alarm2 speed>,

<alarm 3 mode>,

<alarm 3 speed>,

<alarm 4 mode>,

<alarm 4 speed>

Response

If success, return :

PSIMSPD,W,Ok

If error, return :

PSIMSPD,W,Error

Parameters

< alarm n mode>

0: disabled

1 :enabled ,and send alarm URC when speed is less than < alarm n

speed>

2: enabled ,and send alarm URC when speed is large than < alarm

Page 13: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 13 / 24 2015.6.22

n speed>

< alarm n speed>

current speed, and unit is km/hour

< alarm n speed status>

0 : disabled

1: speed is less than < alarm n speed>

2: speed is large than < alarm n speed>

Response

TA returns the current speed alarm config:

PSIMSPD,R,Ok,

<alarm 1 mode>,< alarm 1 speed>,

<alarm 2 mode>,< alarm 2 speed>,

<alarm 3 mode>,< alarm 3 speed>,

<alarm 4 mode>,< alarm 4 speed>

Read Command

PSIMSPD,R

Parameters

See Write Command

Query Command

PSIMSPD,Q

Response

Return the current status of speed alarm

PSIMSPD,Q,Ok,

<alarm 1 mode>,< alarm 1 speed>,<status>, <alarm 2 mode>,< alarm 2 speed>,<status>, <alarm 3 mode>,< alarm 3 speed>,<status>, <alarm 4 mode>,< alarm 4 speed>,<status>, <Fix status>

URC Message

PSIMSPD,U,

< alarm id >, <alarm n mode>,< alarm n speed>,<status>, < parameters the same as PSIMFIX>

Parameters

<status>

0: not active 1: speed is not large than speed alarm n setting 2: speed is large than speed alarm n setting

Other parameter please see Write Command

Note

1. n is from 1 to 4.

Note

1. Need module reset or Cold/Warm/Hot/Full cold restart to take effect.

2. Only in Tracker mode (see PSIMMOD command,< mode>parameter is 1),PSIMSPD commands will

take effect.

2.6 PSIMDBG Debug information output control

PSIMDBG Debug information output control

Example: $PSIMDBG,W,1*20

Page 14: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 14 / 24 2015.6.22

Response

PSIMDBG,T,(0-1)

Test Command

PSIMDBG,T

Parameters

See Write Command

Write Command

PSIMDBG,W,<mode>

Response

If success, return :

PSIMDBG,W,Ok

If error, return :

PSIMDBG,W,Error

Parameters

<mode>

0: disabled

1 :enabled

Response

TA returns the current debug information output control

PSIMDBG,R,Ok,

<mode>

Read Command

PSIMDBG,R

Parameters

See Write Command

Note

1. No effect after power recycle.

2.7 PSIMMOD GNSS module mode selection

PSIMMOD GNSS module mode selection

Example: $PSIMMOD,W,1*27

Response

PSIMMOD,T ,(0-1)

Test Command

PSIMMOD,T

Parameters

See Write Command

Write Command

PSIMMOD,W,<mode>

Response

If success, return :

PSIMMOD,W,Ok

If error, return :

PSIMMOD,W,Error

Parameters

<mode>

Page 15: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 15 / 24 2015.6.22

1: Tracker defined mode

0: Normal GNSS module mode

Response

TA returns the current debug information output control

PSIMMOD,R,Ok,

<mode>

Read Command

PSIMMOD,R

Parameters

See Write Command

Note

1. Need module reset or Cold/Warm/Hot/Full cold restart to take effect.

2. Only in Tracker mode (< mode>parameter is 1),PSIMGEO PSIMODO and PSIMSPD commands will

take effect.

2.8 PSIMODO Odometer

PSIMODO Odometer

Example: $PSIMODO,W,0*24

Response

PSIMODO,T ,(0-1e10)

Test Command

PSIMODO,T

Parameters

See Write Command

Write Command

PSIMODO,W,<init

diatance>

Response

If success, return :

PSIMODO,W,Ok

If error, return :

PSIMODO,W,Error

Parameters

<init distance> initialize original distance, range [0,1e10],

unit: meter

<current distance> current distance, unit: meter

Response

TA returns the current distance

PSIMODO,R,Ok,

<current distance>

Read Command

PSIMODO,R

Parameters

See Write Command

Note

1. Only in Tracker mode (see PSIMMOD command,< mode>parameter is 1),PSIMODO commands

will take effect.

Page 16: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 16 / 24 2015.6.22

2.9 PSIMIPR NMEA port data rate

PSIMIPR NMEA port data rate

Example: $PSIMIPR,W,115200*1C $PSIMIPR,W,9600*14

Response

PSIMIPR,T,(0,4800,9600,14400,19200,38400,57600,115200)

Test Command

PSIMIPR,T

Parameters

See Write Command

Write Command

PSIMIPR,W,<baud rate>

Response

If success, return :

PSIMIPR,W,Ok

If error, return :

PSIMIPR,W,Error

Parameters

<baud rate> support default baud rate(0) or

4800,9600,14400,19200,38400,57600,115200

Response

TA returns the current debug information output control

PSIMIPR,R,Ok,

< baud rate>

Read Command

PSIMIPR,R

Parameters

See Write Command

Note

1. 0 refer to firmware default baud rate.

2. Need module reset or Cold/Warm/Hot/Full cold restart to take effect.

2.10 PSIMSN Serial number operation

PSIMSN Serial number operation

Example: $PSIMSN,R*64

Response

PSIMSN,T ,string

Test Command

PSIMSN,T

Parameters

See Write Command

Page 17: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 17 / 24 2015.6.22

Response

TA returns the current debug information output control

PSIMSN,R,Ok,

<string>

Read Command

PSIMSN,R

Parameters

SN string

2.11 PSIMINI initialize user data block

PSIMINI initialize user data block (fill zero)

Example: $PSIMINI,W*32

Write Command

PSIMINI,W

Response

If success, return :

PSIMINI,W,Ok

If error, return :

PSIMINI,W,Error

Note

1. Initialize application user data excluding:

(1) PSIMMOD

(2) PSIMSN

(3) PSIMIPR

(4) PSIMPPS

(5) PSIMONE

(6) PSIMANT (if support)

(7) PSIMNAV (if support)

(8) PSIMECEF(if support)

(9) PSIMNMEA(if support)

2.12 PSIMPPS 1PPS configuration

PSIMPPS 1PPS configuration

Example: $PSIMPPS,W,2,100,0*30

Response

PSIMPPS,T,(0-4)[,(0-999)[,(0-2000)]]

Test Command

PSIMPPS,T

Parameters

See Write Command

Write Command

PSIMPPS,W,<type>,<width

>,<delay>

Response

If success, return :

PSIMPPS,W,Ok

If error, return :

Page 18: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 18 / 24 2015.6.22

PSIMPPS,W,Error

Parameters

<type>

0 Disable 1PPS output

1 PPS After TTFF

2 PPS After 3D_FIX (default:2)

3 PPS After 2D_FIX

4 PPS Always output

<width>

From 0 to999 millisecond (default: 100)

<delay>

From 0 to 2000nanosecond(default: 0)

Response

TA returns the current debug information output control

PSIMPPS,R,Ok, <type>,<width>,<delay>

Read Command

PSIMPPS,R

Parameters

See Write Command

Note

1. Need module reset or Cold/Warm/Hot/Full cold restart to take effect.

2.13 PSIMIO IO operate command

PSIMDBG for IO operate, config write read

Example: $PSIMIO,W,2,0,1*65

Response

$PSIMIO,T,SimcomIoCanOutput,(range-0,1,2,3,7,8,9,10,11,12,

13,15,16,18,20),(0-output),(0-1)*59

$PSIMIO,T,SimcomIoCanInput,(range-0,1,2,3,7,8,9,10,11,12,13

),(1-input)[,(0-1)]*56

Test Command

PSIMIO,T

Parameters

See Write Command

Write Command

PSIMIO,W,<num>,<dir>[,

<val>]

Response

If write success, return :

PSIMIO,W,port_dir,Ok

PSIMIO,W,port_val,Ok

If have one or more write error, return :

PSIMIO,W,port_dir,Error

PSIMIO,W,port_val,Error

IF have one or more parameter error, return :

PSIMIO,W,Error,check port_val

PSIMIO,W,Error,check,para,<num>,<dir>,<val>

Page 19: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 19 / 24 2015.6.22

Parameters

<num> port number

when dir=0: 0,1,2,3,7,8,9,10,11,12,13,15,16,18,20

when dir=1: 0,1,2,3,7,8,9,10,11,12,13

<dir> port number

0: output

1: input

[,<val>] port value(when output mode)

0-1

Response

returns the port value

IF write success:

PSIMIO,R,port_val,Ok,<val>

IF read error:

PSIMIO,R,port_val,Error,<val>

IF parameter error:

PSIMIO,R,Error,check,port_num,<num>

Returns contain 255: means a error

Example1, write GIO2 to 0:

$PSIMIO,W,2,0,0*64

$PSIMIO,W,port_dir,Ok*67[0D][0A]

$PSIMIO,W,port_val,Ok*63[0D][0A]

Example2, write GIO2 to 1:

$PSIMIO,W,2,0,1*65

$PSIMIO,W,port_dir,Ok*67[0D][0A]

$PSIMIO,W,port_val,Ok*63[0D][0A]

Read Command

PSIMIO,R, <num>

Parameters

See Write Command

Note

1. No effect after power recycle.

2. Now only SIM68E support 3. User can only write/read GIOs that used as IO, IO which has been used for special purposes should

not be write/read(e.g EINT0,EINT1)

2.14 PSIMANT Antenna detect command

PSIMANT for antenna detect

Example: $PSIMANT,W,1*3A

Response

$PSIMANT,T,(0-1)*25

Test Command

PSIMANT,T

Parameters

See Write Command

Page 20: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 20 / 24 2015.6.22

Write Command

PSIMANT,W,<mode>

Response

If write success, return :

PSIMANT,W,Ok

If have one or more write error, return :

PSIMANT,W,Error

If have one or more parameter error, return :

PSIMANT,W,Error,<mode>

Parameters

<mode> antenna detect mode

0: disable

1: enable

When enable, will output sentence like as:

$GPTXT,01,01,02,ANTSTATUS=OPEN*2B

$GPTXT,01,01,02,ANTSTATUS=OK*3B

Example1, enable:

$PSIMANT,W,1*3A

Example2, disable:

$PSIMANT,W,0*3B

Response

returns the mode

IF write success:

PSIMANT,R,Ok,<mode>

IF read error:

PSIMANT,R,Error

Example:

Send: $PSIMANT,R*22

Reponse: $PSIMANT,R,Ok,1*37[0D][0A]

Read Command

PSIMANT[,R]

Parameters

See Write Command

Query Command

PSIMANT,Q

Query antenna detect pin’s logic level

Response

PSIMANT,Q,Ok,<level>

Return the current level of antenna detect pin(e.g. Sim68R pin20

which named DET_N)

Example:

Send: $PSIMANT,Q*21

Response:

$PSIMANT,Q,Ok,1*34, level HIGH means antenna open

$PSIMANT,Q,Ok,0*35, level LOW means antenna ok

Note

1. <mode> change need module reset or Cold/Warm/Hot/Full cold restart to take effect.

2. The GNSS modules which support active antenna have this feature.

Page 21: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 21 / 24 2015.6.22

2.15 PSIMNAV Navigation mode command

PSIMNAV for set/get navigation mode

Example: $PSIMNAV,W,3*3A

Response

$PSIMNAV,T,(0-3)*25

Test Command

PSIMNAV,T

Parameters

See Write Command

Write Command

PSIMNAV,W,<mode>

Response

If write success, return :

PSIMNAV,W,Ok

If have one or more error, return :

PSIMNAV,W,Error

Parameters

<mode> navigation mode

0: normal mode

1: fitness mode

2: aviation mode

3: balloon mode

Example1, change to balloon mode:

$PSIMNAV,W,3*3A

Example2, change to normal mode:

$PSIMNAV,W,0*39

Response

returns the navigation mode

IF read success:

PSIMNAV,R,Ok,<mode>

IF read error:

PSIMNAV,R,Error

Example:

Send: $PSIMNAV,R*20

Reponse: $PSIMNAV,R,Ok,0*34

Read Command

PSIMNAV[,R]

Parameters

See Write Command

Note

1. The GNSS modules which support navigation mode switch have this feature.

2.16 PSIMECEF ECEF sentence control command

PSIMECEF for enable/disable ECEF sentence output

Example: $PSIMECEF,W,1*64

Test Command

PSIMECEF,T

Example, send: $PSIMECEF,T*7A

Response:

Page 22: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 22 / 24 2015.6.22

$PSIMECEF,T,(0-1)*7B[0D][0A]

Parameters

See Write Command

Write Command

PSIMECEF,W,<mode>

Response

If write success, return :

PSIMECEF,W,Ok

If have one or more error, return :

PSIMECEF,W,Error

Parameters

<mode> ECEF sentence mode

0: disable ECEF sentence output

1: enable ECEF sentence output

Example1, disable ECEF sentence output:

$PSIMECEF,W,0*65

Example2, enable ECEF sentence output:

$PSIMECEF,W,1*64

ECEF sentence:

When enable, will output ECEF sentence, for example:

$ECEFPOSVEL,072015.000,-2840662.813,4662059.129,328703

5.216,0000000.001,-0000000.002,0000000.003*2E

Which means:

$ECEFPOSVEL,<data_time>,<ECEF_pos_x>,<ECEF_pos_y>,<

ECEF_pos_z>,<ECEF_vel_x>,<ECEF_vel_y>,<ECEF_vel_z>*<c

hecksum>

ECEF_pos – are the vectors of coordinates in geocentric

coordinate system, format is XXXXXXX.YYY, unit is meter.

ECEF_vel – are the vectors of velocity in geocentric coordinate

system, format is XXXXXXX.YYY, unit is m/s.

Response

returns the ECEF sentence mode

IF read success:

PSIMECEF,R,Ok,<mode>

IF read error:

PSIMECEF,R,Error

Example:

Send: $PSIMECEF,R*7C

Reponse: $PSIMECEF,R,Ok,0*68

Read Command

PSIMECEF[,R]

Parameters

See Write Command

Note

1. The GNSS modules which support ECEF sentence control have this feature.

Page 23: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 23 / 24 2015.6.22

2.17 PSIMNMEA NMEA sentences output control command

PSIMNMEA for enable/disable NMEA sentences output and output frequency

Example: $PSIMNMEA,W,0,3,0,5,0,0,0*61

Example, send: $PSIMNMEA,T*78

Response:

$PSIMNMEA,T,(0-5),(0-5),(0-5),(0-5),(0-5),(0-5),(0-5)*7D

Test Command

PSIMNMEA,T

Parameters

See Write Command

Write Command

PSIMNMEA,W,<GLL>,<R

MC>,<VTG>,<GGA>,<GS

A>,<GSV>,<ZDA>

Response

If write success, return :

PSIMNMEA,W,Ok

If have one or more error, return :

PSIMNMEA,W,Error

Parameters

<GLL> GLL sentence control:

0 - Disabled or not supported sentence

1 - Output once every one position fix

2 - Output once every two position fixes

3 - Output once every three position fixes

4 - Output once every four position fixes

5 - Output once every five position fixes

<RMC>/<VTG>/<GGA>/<GSA>/<GSV>/<ZDA> sentences

control: are similar, see <GLL>

Example:

$PSIMNMEA,W,0,3,0,5,0,0,0*61

This command set RMC output frequency to be outputting once

every 3 position fix, GGA to be outputting once every 5 position

fix, other sentences output are disabled.

Response

returns the NMEA sentences output state

IF read success:

PSIMNMEA,R,Ok,<GLL>,<RMC>,<VTG>,<GGA>,<GSA>,

<GSV>,<ZDA>

IF read error:

PSIMNMEA,R,Error

Example:

Send: $PSIMNMEA,R*7E

Reponse: $PSIMNMEA,R,Ok,0,3,0,5,0,0,0*6C

Read Command

PSIMNMEA[,R]

Parameters

See Write Command

Note

1. The GNSS modules which support NMEA sentence output control have this feature.

Page 24: PSIM Command for MTK GNSS Platform - ООО "Гамма" … Notes/PSI… ·  · 2017-04-18SIMCom offers this information as a service to its customers, to support application and

Smart Machine Smart Decision

PSIM Command for MTK GNSS Platform V1.04 24 / 24 2015.6.22

Contact us: Shanghai SIMCom wireless solutions Ltd. Address: Building A, SIM Technology Building, No. 633 Jinzhong Road, Shanghai, P. R. China 200335 Tel: +86 21 3252 3300 Fax: +86 21 3252 2030

URL: www.sim.com/wm


Recommended