9.432 NMEA-GPS-Receiver

This page describes the device driver and the device window for GPS receivers offering the NMEA 0183 protocol through a serial interface.

The sat-nms device driver for this device family passively reads the data stream output by the GPS receiver. From the received data the driver extracts the GGA (Global Positioning System Fix Data) sentence and parses it.

Important Notice

Due to the fact that the GPS receiver perpetually sends it's data to the VLC, it is essential that the idle time of the device thread / interface serving the GPS receiver is set to 10 msecs. The default value of this parameter is 1000 msecs which leads to frequent read timeouts / misinterpretations due to overruns of the VLC serial interface input buffer. The idle time parameter may be changed with the interface properties at the device setup editor.

Device window pages

The following table shows which device window pages are available with this individual device type. Tool-bar functions not mentioned here are described at the general description of device windows .

Configuration parameters

The only configuration parameter which must be set is the line speed of the serial interface. GPS receivers usually work at 4800,N,8,1 .

Variables defined by this device driver

name type flags range
info.driver TEXT R/O StringRange R/O
lowLevel.cmd TEXT StringRange
lowLevel.reply TEXT R/O StringRange R/O
faults.99 ALARM R/O AlarmFlagRange R/O (Communication)
faults.commstat TEXT R/O StringRange R/O
info.type TEXT R/O StringRange R/O
info.port TEXT R/O StringRange R/O
info.frame TEXT R/O StringRange R/O
info.gga TEXT R/O StringRange R/O
longitude FLOAT R/O DoubleRange R/O (0.00000 .. 0.00000)
latitude FLOAT R/O DoubleRange R/O (0.00000 .. 0.00000)
altitude FLOAT R/O DoubleRange R/O (0.0 .. 0.0)
utcTime TEXT R/O StringRange R/O
rxok BOOLEAN R/O BooleanRange R/O (true false)
nsats INTEGER R/O IntegerRange R/O (0 .. 0)
faults.01 ALARM R/O AlarmFlagRange R/O (GPS receive)