Attributes to Configure in the Scan Device Point

Most of these attributes need to specified only if their associated message is to be sent out upon initialization (see init).

Attribute Name Description
elevation mask Specifies the elevation mask, 0-60 in &one-half; degree steps (0-30 degrees).
nav mode Specifies the navigation mode as either static (one), kinematic (two), or clock (three).
GDOP limit Specifies the GDOP value.
sample rate Specifies the sample interval, 1 to 15 seconds.
osc steering Specifies oscillator steering as either external (zero) or internal (on).
time base Specifies the time base as either UTC (zero) or GPS (one).
configure Specifies the configuration as either OSS0 (zero), OSS2 (one), or Normal (two).
enable sv Specifies which SV to enable as either a number between 1-32, or 0 indicates allowance of unhealthy SVs, and 255 all SVs.
disable sv Specifies which SV to disable as either a number between 1-32, or 0 indicates allowance of unhealthy SVs, and 255 all SVs.
data format Specifies data format for exchange between GPS receiver and host. Currently only turbo binary (zero) is supported.
data blocks Specifies which blocks the GPS receiver is send asynchronously as either none (zero), observation data (one), antenna data (two), or ephemeris data (four). The value is a logical or of the values to send.
reference Vector that specifies the X, Y and Z ECEF coordinates in meters.
clock offset This attribute receives the current real clock offset from the GPS receiver and is also used as the output value for the real clock initialization (see below).
init

This table contains the following information that determines what information is sent out to the GPS receiver on startup:

Field Number Field Name DE Type Possible Values
0 request rtUINT8 0 to 16
1 status rtINT8 (see below)

Where:

Request Value Description
0 Nothing sent.
1 Send reset command.
2 Send elevation mask as specified in "elevation mask" attribute.
3 Send navigation mode as specified in "nav mode" attribute.
4 Send the baud rate as specified in the rs232 info table.
5 Send GDOP limit as specified in the "GDOP limit" attribute.
6 Send enable sv as specified in the "enable sv" attribute.
7 Send disable sv as specified in the "disable sv" attribute.
8 Send data format as specified in the "data format" attribute.
9 Send data blocks as specified in the "data blocks" attribute.
10 Send the sample interval as specified in the "sample rate" attribute.
11 Send oscillator steering as specified in the "osc steering" attribute.
12 Send time base as specified in the "time base" attribute.
13 Send a terminate tracking message.
14 Send a configure message as specified in the "configure" attribute.
15 Send Go2Defs message.
16 Send reference values as specified in the "reference" attribute.
17 Send the real clock offset value as specified in the "clock offset" attribute.
18 Send the RTCFix command.
19 Send the real clock offset value of zero.

The order specified in the table determines the order that the message will be sent to the GPS receiver. For example, record zero will be sent before record 1. The "status" field contains either -1, indicating that the message could not be sent, or the returned status from the GPS receiver defined as:

Status Value Description
0 OK - command received and successfully executed.
1 INVALID - argument to command not a valid value.
2

UNAVAILABLE - requested data was not available.

[note] In response to read configuration command, this means receiver is not tracking at present.
3 BAD CHECKSUM - incoming message failed checksum test.
4 FAILED - the Turbo Rogue failed to execute the message.
5 GDOP BAD - data had GDOP outside current GDOP limit.

 

[warning] There should be no intermediate records that contain zero. Once the scan task sees a zero for a request, the initialization is complete.
debug level A debug level used to determine the amount of information printed to the debug device. Higher debug levels print more detailed information. A debug level of zero indicates that no debug information is to be printed to the debug device.
clear stats Indicates whether the device stats vector will be zero'ed the next time it is read from the database.