GPS: 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.

 

 

 


gpsPower

Turns on power to the GPS receiver.


gpsPowerLP

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


gpsFix

Returns detailed information from the GPS receiver.


gpsPointInPolygon

Checks whether a point is within a defined polygon.


gpsEnableNMEA

Enables NMEA data output on a specific serial port.


gpsDistance

Calculates the distance and bearing between two points.


gpsDistanceX

Calculates the distance and bearing between two points.


gpsGetAntennaStatus

Returns the status of the GPS antenna.


gpsNMEA

Returns the NMEA strings.


gpsSetSBAS

Enables SBAS-assisted positioning.


gpsGetSBAS

Returns the SBAS enable status.


gpsPPPStatus

Retrieves the number of satellites using Precise Point Positioning.


gpsSetSpeedThreshold

Changes the speed threshold.


gpsUpdateFreq

Change the position update frequency.


gpsPositionToUtm

Converts a position to Universal Transverse Mercator (UTM) format.


gpsUtmToPosition

Converts a position from Universal Transverse Mercator (UTM) format.


gpsSemicircleToUtm

Converts a position to Universal Transverse Mercator (UTM) format.


gpsUtmToSemicircle

Converts a position from Universal Transverse Mercator (UTM) format.

 

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

 

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).