This wiki documents Piksi v2.3.1 which was discontinued April 1st, 2017.
Visit for newer products including Piksi Multi.

HOW-TO: Running the Piksi Console from source

From Swift Navigation Wiki
Jump to navigation Jump to search

In the piksi_tools/console directory there is a simple GUI console for visualizing various status information Piksi sends to the PC. The instructions below refer to running the last version of the console that supported piksi 2.3.1 (v0.30.9). If you require installing the swift console from the master branch from source, please refer to the readme on the repository:

If anything in this guide is incorrect or unclear, please email our mailing list.

Getting the source

If you haven't already done so, clone the piksi_tools repository from GitHub:

$ git clone
$  cd piksi_tools
$ git checkout v0.30.9

Install prerequisites

For Linux and Macintosh users, the shell script will install some of the dependencies including PyQt4 and its SIP dependency for your platform. For Windows users, see the instructions for setting up the Python development tools here: HOW-TO:_Setting_up_developer_tools_for_Piksi#Setting_up_Python.

$ cd piksi_tools

Linux and OSX only:

$ cd tasks
$ ./ -x install
$ cd ..

All platforms

$ sudo pip install -r requirements.txt

Install Piksi Tools

The following command will install Piksi tools as part of your Python site packages. This will also make it easy to use piksi_tools from other python projects.

$ sudo python install

Running the console

Plug in Piksi via USB, and then start the GUI console.

$ python piksi_tools/console/

Running with the --help option will display a list of optional command line arguments.

$ python piksi_tools/console/ --help

The default USB serial device used is /dev/ttyUSB0, to use a different device (e.g. under OS X or Windows) you may specify the -p option.

$ python piksi_tools/console/ -p /dev/tty.usbserial1234

or on Windows:

$ python piksi_tools/console/ --p COM3