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

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

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

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>

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