GPS Receiver

 Top  Previous  Next

The GPS functions allow the program to interact with a GPS/GNSS module if present on the specific RTCU device. Please consult the technical documentation for the actual RTCU device in use.

 

For a simple application that demonstrates the GPS functions, please have a look at the GPS Mobile application.

 

 

 

•gpsEnableNMEA

Enables NMEA data output on a specific serial port.

•gpsFix

Returns detailed information from the GPS receiver.

•gpsGetAntennaStatus

Returns the status of the GPS antenna.

•gpsGetSBAS

Returns the SBAS enable status.

•gpsNMEA

Returns the NMEA strings.

•gpsPower

Turns on power to the GPS receiver.

•gpsPowerLP

Turns on power to the GPS receiver in low power mode.

•gpsPPPStatus

Retrieves the number of satellites using Precise Point Positioning.

•gpsSetSBAS

Enables SBAS-assisted positioning.

•gpsSetSpeedThreshold

Changes the speed threshold.

•gpsUpdateFreq

Change the position update frequency.

 

Note: all values returned by the GPS functions are in the WGS-84 datum.

 

A number of functions are available to convert between coordinate systems and otherwise perform calculations on the coordinates:

•Convert

Functions to perform calculations on coordinates.

 

External GPS devices

NX32L devices without built-in GPS modules can use an external GPS device, connected via the USB host port.

This means that the GPS functions can be used with the external GPS module as if it was built-in.

Some limitations to the available information should be expected.

 

To use an external GPS module follow these steps:

1. Connect the GPS device.

2. Ensure the RTCU is aware of the device. (With usbHostEnumerate)

3. Call gpsPower(ON)

 

It should now be possible to receive GPS positions.

 

Please note, that should the connection to the GPS device be lost, then the sequence above must be repeated again after calling gpsPower(OFF).