Qwiic_Ublox_Gps_Py¶


SparkFun GPS-RTK2 - ZED-F9P (GPS-15136)	SparkFun GPS-RTK - NEO-M8P-2 (GPS-15005)	SparkFun ZOE-M8Q Breakout (GPS-15193)	SparkFun SAM-M8Q Breakout (GPS-15210)

SparkFun GPS-RTK Dead Reckoning - ZED-F9R (GPS-16344)	SparkFun GPS-RTK Dead Reckoning Phat- ZED-F9R (GPS-16475)	SparkFun GPS Dead Reckoning - NEO-M9N (GPS-15733)

This is a Python module for the SparkFun GPS products based on u-blox GPS modules.

This package is included in the overall SparkFun qwiic Python Package. While the module itself does not use I²C, it may none the less join the ranks when the Raspberry Pi has better support for clock stretching. None the less, a Qwiic connector has been included onboard so the GPS module can be used with our along side SparkFun’s Qwiic products.

Contents¶

Supported Platforms
Dependencies
Installation
Documentation
Example Use

Supported Platforms¶

The u-blox gps Python package currently supports the following platforms:

Documentation¶

The SparkFun u-blox gps module documentation is hosted at ReadTheDocs

Installation¶

PyPi Installation¶

This repository is hosted on PyPi as the sparkfun-ublox_gps package. On systems that support PyPi installation via pip, this library is installed using the following commands

For all users (note: the user must have sudo privileges):

sudo pip install sparkfun-ublox-gps

For the current user:

sudo pip install sparkfun-ublox-gps

Local Installation¶

To install, make sure the setuptools package is installed on the system.

Direct installation at the command line:

python setup.py install

To build a package for use with pip:

python setup.py sdist

A package file is built and placed in a subdirectory called dist. This package file can be installed using pip.

cd dist
pip install sparkfun_ublox_gps-<version>.tar.gz

Example Use¶

from ublox_gps import UbloxGps
import serial
# Can also use SPI here - import spidev
# I2C is not supported

port = serial.Serial('/dev/serial0', baudrate=38400, timeout=1)
gps = UbloxGps(port)

def run():

  try:
    print("Listenting for UBX Messages.")
    while True:
      try:
        coords = gps.geo_coords()
        print(coords.lon, coords.lat)
      except (ValueError, IOError) as err:
        print(err)

  finally:
    port.close()

if __name__ == '__main__':
  run()

Examples Directory¶

geo_coords_ex1.py
- Simple example showing how to get and print out latitude, longitude, and
  
  heading.
gps_time_ex2.py
- Simple example showing how to UTC time and how to check its’ validity.
dead_reckoning_ex3.py
- Simple example showing how to use dead reckoning on dead reckoning modules.
  
  Make sure to take a look at our hookup guide for a detailed explanation on where to attach the module and how to calibrate it.
stream_nmea_gps_ex4.py
- Simple example showing how to stream NMEA data from Ublox Modules.
modifying_configuration_settings_ex5.py
- Simple example showing how change the configuration settings for the Ublox
  
  Module.
using_spi_ex6.py
- Simple example showing how to use SPI.
  
  Module.

Attribution¶

This code is dependent on the work by daylomople and the awesome parsing capabilities of ubxtranslator.

To Do¶

[ ] Some bugs associated with SPI writes.
[ ] Add more Classes and Messages to sparkfun_predefines.py so that a

greater variety of messages can be parsed.
[ ] Fix bug when getting configuration settings.

Table of Contents¶

Contents:

Qwiic_Ublox_Gps_Py

API Reference

API Reference

Examples