:mod:`gnss`
===========

.. py:module:: gnss

.. autoapi-nested-parse::

   Global Navigation Satellite System

   The `gnss` module contains classes to control the GNSS and acquire positioning information.





.. py:class:: GNSS

   Get updated positioning information from Global Navigation Satellite System (GNSS)

   Usage::

       import gnss
       import time

       nav = gnss.GNSS([gnss.SatelliteSystem.GPS, gnss.SatelliteSystem.GLONASS])
       last_print = time.monotonic()
       while True:
           nav.update()
           current = time.monotonic()
           if current - last_print >= 1.0:
               last_print = current
               if nav.fix is gnss.PositionFix.INVALID:
                   print("Waiting for fix...")
                   continue
               print("Latitude: {0:.6f} degrees".format(nav.latitude))
               print("Longitude: {0:.6f} degrees".format(nav.longitude))

   .. attribute:: latitude
      :annotation: :Any

      Latitude of current position in degrees (float).


   .. attribute:: longitude
      :annotation: :Any

      Longitude of current position in degrees (float).


   .. attribute:: altitude
      :annotation: :Any

      Altitude of current position in meters (float).


   .. attribute:: timestamp
      :annotation: :Any

      Time when the position data was updated.


   .. attribute:: fix
      :annotation: :Any

      Fix mode.


   .. method:: deinit(self)


      Turn off the GNSS.


   .. method:: update(self)


      Update GNSS positioning information.



.. py:class:: PositionFix

   Position fix mode

   .. attribute:: INVALID
      :annotation: :Any

      No measurement.

      :type gnss.PositionFix:


   .. attribute:: FIX_2D
      :annotation: :Any

      2D fix.

      :type gnss.PositionFix:


   .. attribute:: FIX_3D
      :annotation: :Any

      3D fix.

      :type gnss.PositionFix:



.. py:class:: SatelliteSystem

   Satellite system type

   .. attribute:: GPS
      :annotation: :Any

      Global Positioning System.

      :type gnss.SatelliteSystem:


   .. attribute:: GLONASS
      :annotation: :Any

      GLObal NAvigation Satellite System.

      :type gnss.SatelliteSystem:


   .. attribute:: SBAS
      :annotation: :Any

      Satellite Based Augmentation System.

      :type gnss.SatelliteSystem:


   .. attribute:: QZSS_L1CA
      :annotation: :Any

      Quasi-Zenith Satellite System L1C/A.

      :type gnss.SatelliteSystem:


   .. attribute:: QZSS_L1S
      :annotation: :Any

      Quasi-Zenith Satellite System L1S.

      :type gnss.SatelliteSystem: