Programmatic Interface - Status Commands
|
|
All of these commands (except one) display some information from the
NetRS. The information can be a static item, like a serialnumber, or
something dynamic like the current time or receiver position.
List of all commands
Programmatic Overview
Show SystemName
Returns the currently assigned System Name. This value
should be a unique identifier for each NetRS receiver.
Parameters:
No parameters are available.
Response:
SystemName name=RS1234567890
- Name will be a maximum of 12 characters.
Set SystemName
Sets the System Name on this NetRS receiver. This value
should be a unique identifier for each NetRS receiver.
Parameters:
name=NewName |
Specifies the new system name.
Limited to 12 characters. Can only include letters, numbers and
underscores.
|
Response:
OK: SystemName name=NewName
Show SerialNumber
Returns the Serial Number for this NetRS.
Parameters:
No parameters are available.
Response:
SerialNumber sn=1234567890
Show UtcTime
Returns the current UTC date and time.
Parameters:
No parameters are available.
Response:
UtcTime year=2003 month=11 day=6 hour=17 minute=19
second=8 julianDay=310
- The response is actually a single line of text. For clarity,
It is shown as multiple lines in this sample.
- Month range is 1 through 12 (January through December).
- Day is the day within the month, starting with 1.
- JulianDay is the day within the year, starting with 1 (01/Jan)
Show GpsTime
Returns the current GPS weeknumber and seconds within week.
The response is in the GPS time scale which is slightly offset from
UTC time. GPS weeks start at Midnight between Saturday and Sunday.
Parameters:
No parameters are available.
Response:
GpsTime gpsweek=1243 weekseconds=408258
- Gpsweek is the number of weeks since Sunday 1980/Jan/06, the start
of GPS week zero.
- Weekseconds is the number of seconds elapsed since the beginning of
the current week. Range is from 0 to 604799.
Show Position
Returns a multi-line response showing information about the most recent
position fix, including timetag, location, velocity, clock measurements,
and DOPs.
Parameters:
No parameters are available.
Response:
<Show Position>
GpsWeek 1243
WeekSeconds 408644.9
Latitude 37.3891262386 deg
Longitude -122.0368444587 deg
Altitude -3.866 meters
Qualifiers WGS84,3D,WAAS-DGPS
Satellites 1,2,3,8,13,16,20,27
ClockOffset 0.000000 msec
ClockDrift 0.000222 ppm
VelNorth 0.01 m/sec
VelEast 0.01 m/sec
VelUp 0.05 m/sec
PDOP 1.9
HDOP 1.1
VDOP 1.6
TDOP 1.0
<end of Show Position>
- GpsWeek and WeekSeconds are the timetag when this position was
determined.
- Latitude and Logitude in Decimal Degrees..
- Altitude is in meters above the WGS84 Ellipsoid.
- ClockOffset is in milliseconds.
- ClockDrift is in parts per million.
- Velocities are in meters per second.
- DOP values are unitless.
- Qualifiers can contain several strings, separated by commas:
- 'WGS84' specifies the coordinate system.
- '3D' specifies the type of fix done. Could be 2D if there are
insufficient satellites for a 3D fix.
- 'WAAS-DGPS' specifies that differential corrections from a WAAS
or EGNOS satellite were used to correct the position fix.
- 'Autonomous' specifies that no differential corrections were made.
Show Voltage
Returns the currently measured voltage on one of the power input ports.
Parameters:
input=PowerPort |
Specifies the port to measure.
Limited to '1' or '2'.
|
Response:
Voltage input=2 volts=18.22
Show Temperature
Returns a measurement of the temperature inside the NetRS box. This
is mainly for diagnostic purposes, and should not be used as an
indication of external temperature.
Parameters:
No parameters are available.
Response:
Temperature temp=32
- temp is in degrees Celsius.