====== Installing PixyMon on Linux ======


====== 1. Introduction ======

The following procedure will walk you through building PixyMon for Linux. This procedure assumes the following:

  * Your system has Linux Mint installed
  * Pixy firmware has been updated to 1.0.2
  * Your system is connected to the internet

The Mint distribution of Linux can be downloaded here: http://www.linuxmint.com

Instructions for updating the Pixy firmware are here: [[wiki:v2:Uploading_New_Firmware|Uploading New Firmware]]

Although this procedure uses Linux Mint, it //should// work with any Linux distribution that uses the Debian package manager (e.g. Ubuntu).


====== 2. Procedure ======


===== 2.1. Install dependencies for building PixyMon =====

Start the terminal application:

{{wiki:img:78184a8b63cf10782c18339b791db9f85a0d8bc0.png?400}}


==== 2.1.1. Install git ====

In the terminal window type:

''%%sudo apt-get install git%%''


==== 2.1.2. Install libusb-1.0-0-dev ====

In the terminal window type:

''%%sudo apt-get install libusb-1.0-0-dev%%''

{{wiki:img:da64e20cd40baefbd00b8bb4fce081a0f9b76abd.png?400}}


==== 2.1.3. Install QT ====

In the terminal window type:

''%%sudo apt-get install qt5-default%%''\\

''%%sudo apt-get install qt5-qmake%%''\\

''%%sudo apt-get install qtbase5-dev-tools%%''\\

==== 2.1.4. Install g++ (compiler) ====

In the terminal window type:

''%%sudo apt-get install g++%%''

{{wiki:img:208f77c0feb60df1b578d0a67c31972a6e32e285.png?400}}


===== 2.2. Building PixyMon =====


==== 2.2.1. Download Pixy source code ====

In the terminal window type:

''%%git clone https://github.com/charmedlabs/pixy2.git%%''\\
{{wiki:img:dcf634a40148751c2a5f59668335e326013c2183.png?400}}


==== 2.2.2. Run the build script ====

Change directory to the pixy build tools folder and run the build script.

In the terminal window type:

''%%cd pixy2/scripts%%''\\
''%%./build_pixymon_src.sh%%''

The script will probably take a few minutes to complete. Perhaps this is a good time to make a cup of tea?
==== 2.2.3. Add permissions for Pixy USB interface ====

In order to communicate with Pixy over USB as a non-root user you must set permissions for Pixy.

To do this copy the 'pixy.rules' file to '/etc/udev/rules.d'

In the terminal window type:

''%%cd ../src/host/linux/%%''\\
''%%sudo cp pixy.rules /etc/udev/rules.d/%%''

{{wiki:img:4a97375dee1ace2c3a8c6059e99c9c2200f9a342.png?400}}


===== 2.3. Running PixyMon =====


==== 2.3.1. Connect Pixy to your Linux system using a USB micro cable ====

{{wiki:v2:img_5249_result.jpg?400}}


==== 2.3.2. Change directory to the PixyMon build folder ====

In the terminal window type:

''%%cd ../../../build/pixymon/bin/%%''


==== 2.3.3. Run PixyMon ====

In the terminal window type:

''%%./PixyMon%%''

{{wiki:img:c3853354ec6a7f9c9f843996e1e05d615a0e355c.png?400}}

What's next? Let's [[wiki:v2:Teach_Pixy_an_Object_2|teach Pixy an object]]!