Qwiic_Ublox_Gps_Py¶
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 I2C, 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.
Supported Platforms¶
The u-blox gps Python package currently supports the following platforms:
- Raspberry Pi <!– Platforms to be tested
- NVidia Jetson Nano
- Google Coral Development Board –>
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.