GNSS

Overview

The GNSS API will be able to will be able to access and make us of all the functionalities of the GNSS device that is installed on the equipment and it's making use of the Deeepsy Platform. The aim of this API is to supply functions and give an easy access to the different geopositioning capabilites of the GNSS module independent of its technology or the satellite possible constelations available.

A general outline of the GNSS API can be observed in the following figure:

Gnss API diagram

Main functionalities

The GNSS API provides the following functionalities:

• Request the last position that has been obtained from the GNSS module.
• Obtain GNSS next position updates
• Perform a coldstart

Remarks:
Any position will contain information about:

• FIX quality status of the module. The possible values of this field are:

  • NO_FIX
  • AUTONOMOUS_FIX
  • DIFFERENTIAL_FIX
  • RTK_FIXED
  • RTK_FLOAT
  • ESTIMATED_DEAD_RECKONING_FIX

• Number of satellites in use
• Number of satellites in view
• Current date and time in UTC

In case the module has obtained position FIX (FIX quality is different from NO_FIX) all the position related fields will be sent, which results in:

• FIX status of the module. Possible values are documented above
• Number of satellites in use
• Number of satellites in view
• Current date and time in UTC
• Latitude in decimal degrees
• Longitude in decimal degrees
• Altitude above/below mean sea level (meters)
• Horizontal dilution of precision (HDPO)
• Speed over the ground (knots)
• Track angle (degrees)

NMEA TCP published feature

Since DEEPSY version 21.17.0 there is a new feature available:
The GNSS NMEA packages are published at the TCP port 11042. Data from GNSS receiver or simulations are published.
There is no limit to the number of simultaneous clients. The service does not listen to or accept any command. Only publishes messages.