This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
wiki:v2:building_the_libpixyusb_example_on_linux2 [2018/06/29 04:47] hohenheim [1. Introduction] |
wiki:v2:building_the_libpixyusb_example_on_linux2 [2018/06/29 14:38] hohenheim [3.1. Color Identification Example (GetBlocksCPPDemo)] |
||
---|---|---|---|
Line 5: | Line 5: | ||
The libpixyusb library provides a software application programming interface (API) for communicating\\ | The libpixyusb library provides a software application programming interface (API) for communicating\\ | ||
- | with Pixy over USB. This allows you to write software that interfaces with Pixy like the PixyMon application. | + | with Pixy2 over USB. This allows you to write software that interfaces with Pixy2 like the PixyMon application. |
The following procedure will outline the steps required for building the libpixyusb library and some example projects using the library. This procedure assumes the following: | The following procedure will outline the steps required for building the libpixyusb library and some example projects using the library. This procedure assumes the following: | ||
Line 14: | Line 14: | ||
The Mint-17 distribution of Linux can be downloaded here: http://www.linuxmint.com | The Mint-17 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]] | + | Instructions for updating the Pixy2 firmware are here: [[wiki:v2:Uploading_New_Firmware|Uploading New Firmware]] |
Although this procedure uses Linux Mint-17, it //should// work with any Linux distribution that uses the Debian package manager (e.g. Ubuntu). | Although this procedure uses Linux Mint-17, it //should// work with any Linux distribution that uses the Debian package manager (e.g. Ubuntu). | ||
Line 27: | Line 27: | ||
{{wiki:img:78184a8b63cf10782c18339b791db9f85a0d8bc0.png?400}} | {{wiki:img:78184a8b63cf10782c18339b791db9f85a0d8bc0.png?400}} | ||
- | |||
- | |||
- | ==== 2.1.1. Install git ==== | ||
In the terminal window type: | In the terminal window type: | ||
- | ''%%sudo apt-get install git libusb-0.0-0-dev g++%%'' | + | ''%%sudo apt-get install git libusb-1.0-0-dev g++%%'' |
Line 40: | Line 37: | ||
+ | ===== 2.2. Build libpixyusb2 ===== | ||
- | ==== 2.1.5. Install cmake ==== | ||
- | In the terminal window type: | + | ==== 2.2.1 Download Pixy2 source code ==== |
- | + | ||
- | ''%%sudo apt-get install cmake%%'' | + | |
- | + | ||
- | {{wiki:img:3ee2278e34e6576a7ff030e21718e71c9da9b447.png?400}} | + | |
- | + | ||
- | + | ||
- | ===== 2.2. Build and install libpixyusb ===== | + | |
- | + | ||
- | + | ||
- | ==== 2.2.1 Download Pixy source code ==== | + | |
In the terminal window type: | In the terminal window type: | ||
- | ''%%git clone https://github.com/charmedlabs/pixy.git%%'' | + | ''%%git clone https://github.com/charmedlabs/pixy2%%'' |
- | + | ||
- | {{wiki:img:dcf634a40148751c2a5f59668335e326013c2183.png?400}} | + | |
+ | {{:wiki:v2:git_clone.png?400|}} | ||
==== 2.2.2. Build the library ==== | ==== 2.2.2. Build the library ==== | ||
In the terminal window type: | In the terminal window type: | ||
- | ''%%cd pixy/scripts%%''\\ | + | ''%%./pixy2/scripts/build_libpixyusb2.sh%%'' |
- | ''%%./build_libpixyusb.sh%%'' | + | |
- | {{wiki:img:a636c182eec2a7d020e836738a7d629fa4b5bb13.png?400}} | + | {{:undefined:build_libpixyusb2.png?400|}} |
- | ==== 2.2.3. Install the library ==== | ||
- | |||
- | Installing the library files requires root privileges. | ||
- | |||
- | In the terminal window type: | ||
- | |||
- | ''%%sudo ./install_libpixyusb.sh%%'' | ||
- | {{wiki:img:d35f59500541f5c21f6aa117ae10b1ecb6af8fba.png?400}} | ||
====== 3. Example projects ====== | ====== 3. Example projects ====== | ||
- | Before trying the examples below, connect Pixy to your Linux system using a USB Mini cable: | + | Before trying the examples below, connect Pixy2 to your Linux system using a USB Micro-B cable: |
- | {{wiki:img:e0e66b6f1b2c5231027c1d03c811e16207772021.jpg?400}} | + | {{:undefined:connect_pixy_usb.png?400|}} |
- | ===== 3.1. hello_pixy: A Simple IO Example ===== | + | ===== 3.1. Color Identification Example (GetBlocksCPPDemo) ===== |
The example does the following: | The example does the following: | ||
- | - Connects to Pixy using USB | + | - Connects to Pixy2 using USB |
- | - Displays firmware version installed on Pixy | + | - Displays firmware version installed on Pixy2 |
- | - Block information is displayed (as shown in the image above) if color signatures have been set and if the signatures are currently being detected by Pixy. | + | - Block information is displayed (as shown in the image above) if color signatures have been set and if the signatures are currently being detected by Pixy2. |