PSIM Command for MTK GNSS Platform
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
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
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
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
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
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
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
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
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.
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
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
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
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>
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.
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
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 :
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>
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
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.
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:
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.
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.
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