`gnss` – Global Navigation Satellite System

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

Available on these boards

SPRESENSE

class gnss.GNSS(system: SatelliteSystem | List[SatelliteSystem])

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

Turn on the GNSS.

Parameters:: system – satellite system to use

deinit() → None: Turn off the GNSS.

update() → None: Update GNSS positioning information.

latitude: float: Latitude of current position in degrees (float).

longitude: float: Longitude of current position in degrees (float).

altitude: float: Altitude of current position in meters (float).

timestamp: time.struct_time: Time when the position data was updated.

fix: PositionFix: Fix mode.

class gnss.PositionFix

Position fix mode

Enum-like class to define the position fix mode.

INVALID: PositionFix: No measurement.

FIX_2D: PositionFix: 2D fix.

FIX_3D: PositionFix: 3D fix.

class gnss.SatelliteSystem

Satellite system type

Enum-like class to define the satellite system type.

GPS: SatelliteSystem: Global Positioning System.

GLONASS: SatelliteSystem: GLObal NAvigation Satellite System.

SBAS: SatelliteSystem: Satellite Based Augmentation System.

QZSS_L1CA: SatelliteSystem: Quasi-Zenith Satellite System L1C/A.

QZSS_L1S: SatelliteSystem: Quasi-Zenith Satellite System L1S.

gnss – Global Navigation Satellite System

`gnss` – Global Navigation Satellite System