Skip to main content

Python tools for the Piksi GNSS receiver.

Project description

Python tools for the Piksi GNSS receiver. This repository includes a Swift console UI application, as well as a variety of command line utilities (firmware bootloader, serial port data logging, etc.).


It is advised to install piksi_tools inside a virtualenv to avoid modifying global system state. To setup a python 3.5 virtual environment first install python 3.5 via your package manager if needed, and then run:

virtualenv -p python3.5 ~/py3
source ~/py3/bin/activate

To install the dependencies for the basic tools: pip install -r requirements.txt

To install the dependencies for the console GUI, run make deps. Besides system packages, this also installs python dependencies into the current (virtual) environment, and includes the deps for the aforementioned basic tools.

Finally, pip install -e . to set up a dev install in the local dev environment.

To run the installed console from the current env, use python -m piksi_tools.console.console

Python version support

  • The most important command line tools -,,, and - support Python 2.7, 3.5, and 3.7
  • Console GUI under Linux supports 2.7 and 3.5. Experimental support for Python 3.7
  • Console GUI under MacOS and Windows is tested against Python 3.5 but probably would support all versions that Linux GUI supports, but some of those might need a manual GUI backend change/installation
  • Pre-built (pyinstaller) binaries for most platforms use Python 3.5. On Ubuntu, Python 3.6 is used.

Usage Examples

Console example

To just use the Swift console, download binary installers for Windows and OS X.

Latest console for Piksi Multi

Older versions of console for use with Piksi v2

For x86-64 Linux, tar.gz distributions are available for Swift Console Piksi Multi

To run the console GUI from the command line, install dependencies and run PYTHONPATH=. python piksi_tools/console/

For command line arguments, see


To run the tests (excluding some graphical ones) and check for coverage:


This by default attempts to run tests for all supported Python versions. To skip those versions that you don’t have installed, run:

$ PYTHONPATH=. tox --skip-missing-interpreters

To run some extra tests for the GUI (excluding the non-graphical tests):

$ PYTHONPATH=. tox -e gui35,gui37

Finally, to run all tests for all supported Python versions:

$ PYTHONPATH=. tox -e py35,py37,gui35,gui37

USB issues on OS X

The ftdi USB drivers are finicky on some versions of OS X. See their docs for help debugging (tl;dr if you try to plug in multiple USB devices to the same port, the subsequent ones may not appear through ftdi even if they appear in the result of sudo dmesg. Only restarting your machine will fix this.)


Copyright (C) 2019 Swift Navigation Distributed under LGPLv3.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Built Distribution

piksi_tools-3.1.4-py2.py3-none-any.whl (197.4 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page