R7 Serial: Other Commands
Get Firmware Version
R7+VERSION
Returns the installed firmware version
/* Check Device Firmware */
R7+VERSION\r
/* Receive response */
03.04.13\r
OK\r
03.04.13 is the firmware version number returned by the device.
Get Current GPS Position
R7+GPS
Retrieves the current GPS position from the device.
/* Request GPS Position */
R7+GPS\r
/* Receive response - example */
00310.22460W,5129.71500N,0,0,305,3,10,1.1,13:05:29,02-09-20\r
OK\r
Lat and Long are given in the following format:
Long: DDDMM.MMMMM[E|W] Lat: DDMM.MMMMM[N|S]
In the return example above: 00310.22460W,5129.71500N can be expressed as: 003° 10.22460' W, 51° 29.71500' N
The expected response for the R7+GPS command:
longitude,latitude,course,speed,altitude,mode,satellites,hdop,time,date
| Data | Format |
|---|---|
| Longitude | DegreesMinutes.decimalMinutes E or W (DDMM.MMMMM[E|W]) |
| Latitude | DegreesMinutes.decimalMinutes N or S (DDDMM.MMMMM[N|S]) |
| Course | degrees |
| Speed | knots |
| Altitude | meters |
| Mode | 1 = no fix 2 = 2D fix 3 = 3D fix |
| Satellites | count |
| HDOP | 1-20 (1 = highest precision, 20 = poorest) |
| Time | hh:mm:ss |
| Date | DD-MM-YY |
Enable or Disable GPS Streaming
R7+GPS,STREAM=n
1 = turns streaming on 0 = turns streaming off
When GPS streaming is enabled, a new position is output every second.
/* Turn ON GPS Streaming */
R7+GPS,STREAM=1\r
/* Receive Response - example */
OK\r
00310.22460W,5129.71500N,0,0,305,3,10,1.1,13:05:29,02-09-20\r
00310.22460W,5129.71500N,0,0,306,3,10,1.1,13:05:30,02-09-20\r
00310.22520W,5129.71500N,0,1,307,3,10,1.5,13:05:31,02-09-20\r
00310.22520W,5129.71500N,0,0,307,3,10,1.3,13:05:32,02-09-20\r
00310.22520W,5129.71500N,0,1,307,3,10,1.3,13:05:33,02-09-20\r
00310.22520W,5129.71440N,0,1,308,3,10,1.3,13:05:34,02-09-20\r
00310.22520W,5129.71440N,0,1,309,3,10,1.3,13:05:35,02-09-20\r
00310.22520W,5129.71440N,0,1,308,3,10,1.3,13:05:36,02-09-20\r
00310.22520W,5129.71440N,0,1,306,3,9,1.3,13:05:37,02-09-20\r
00310.22520W,5129.71440N,0,1,307,3,7,1.5,13:05:38,02-09-20\r
00310.22520W,5129.71440N,0,1,307,3,10,1.3,13:05:39,02-09-20\r
/* Turn OFF GPS Streaming */
R7+GPS,STREAM=0\r
/* Receive Response - example */
OK\r
During streaming mode, other API commands work as normal.
Tracker Settings
Get GPS Hot Status
R7+GPS,HOT
This gets the current GPS Hot status and reports 1 = ON, 0 = OFF.
Set GPS Hot Status
R7+GPS,HOT=n
Enables or disables the GPS Hot setting (1 = ON, 0 = OFF).
Get Tracking Frequency
R7+TRACK,FREQ
Will report back the current tracking frequency being used. ie GPRS, Satellite or Distress Context
| Frequency enumeration | Tracking Frequency |
|---|---|
| 1 | 5 minutes |
| 2 | 10 minutes |
| 3 | 15 minutes |
| 4 | 20 minutes |
| 5 | 30 minutes |
| 6 | 60 minutes |
| 7 | 90 minutes |
| 8 | 120 minutes (2 hours) |
| 9 | 180 minutes (3 hours) |
| 10 | 240 minutes (4 hours) |
| 11 | 360 minutes (6 hours) |
| 12 | 480 minutes (8 hours) |
| 13 | 720 minutes (12 hours) |
| 14 | Burst |
| 15 | 1 minute |
| 16 | 2 minutes |
| 17 | 3 minutes |
| 18 | 4 minutes |
| 19 | 24 hours |
| 20 | 6 minutes |
| 21 | 8 minutes |
| 22 | 12 minutes |
| 23 | 15 seconds |
| 24 | 30 seconds |
Set Tracking Frequency
R7+TRACK,FREQ=n
This command will only configure the Satellite Context tracking frequency. It is not currently possible to configure GPRS or Distress context via the Serial API.