Tools for the Piksi GNSS receiver.
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
misc update macos compatibility notes Aug 17, 2018
piksi_tools Add settings documentation for can termination resistor (#973) Feb 7, 2019
scripts Instrument running of built executable. (#952) Jan 17, 2019
tasks Bionic support (#901) Oct 5, 2018
tests Remove the obsolete cli tool sbp2rinex [EX-465] (#972) Feb 6, 2019
.appveyor.yml Have CI build command line tools Mar 1, 2018
.coveragerc Relocate to piksi_tools Apr 1, 2015
.flake8 flake8: exclude testing/gdb_chibios Jul 5, 2017
.gitignore Ignore .eggs/ Feb 21, 2018
.gitmodules testing: ChibiOS thread support in core dumps. Jul 20, 2015
.pre-commit-config.yaml Added pre-commit to automate linting and avoid travis failures Jul 11, 2018
.travis.yml change travis clone depth (#895) Oct 3, 2018 Update Changelog Oct 12, 2018
Dockerfile Dockerfile for containerized piksi_tools. Jun 22, 2015 console rename: fixup last mentions of "Piksi Console" Jan 10, 2017
LICENSE Relocate to piksi_tools Apr 1, 2015
MANIFEST.IN working versioning. Jun 8, 2015
Makefile Add make release target for generating changelog Oct 25, 2017
README.rst Bionic support (#901) Oct 5, 2018
requirements.txt Add tentative python 3 support to the most important command line too… Jan 17, 2019
requirements_gui.txt remove unneded wsgiref dep Mar 7, 2018
setup.cfg Relocate to piksi_tools Apr 1, 2015 Fix setuptools_scm for tags that don't conform (#882) Sep 18, 2018
tox.ini tell flake8 to ignore select warnings (#915) Oct 29, 2018 Rename Piksi Console to Swift Console Dec 16, 2016
win_make.bat More explicit with setting paths May 27, 2016


Tools for the Piksi GNSS receiver

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 create a virtualenv, run:

virtualenv py2
source py2/bin/activate

Or, on Linux Mint, run:

virtualenv py2 --system-site-packages
source py2/bin/activate

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

To install the dependencies for the console GUI, first run make deps to install the systemwide deps and then pip install -r requirements_gui.txt pyside for the python deps.

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

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 and check for coverage:


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 © 2015 Swift Navigation

Distributed under LGPLv3.0.