====== Pixy2 LEGO Quick Start ======

This guide will get you up and running quickly with Pixy2 and LEGO Mindstorms
EV3. You must have a LEGO Mindstorms EV3 brick with a fresh set of batteries.
We try to be as detailed as possible in this guide, but it helps if you are
somewhat familiar with how to use your LEGO Mindstorms system.

//If you have LEGO Mindstorms NXT, we're sorry, but we no longer support NXT.//

Please follow this guide closely and by all means, **don't skip any steps**!

===== 1. Install PixyMon v2 on your PC (Windows, Mac or Linux) =====

If you're just getting started with Pixy2, you should install PixyMon on your
PC. It will allow you to configure Pixy2 and see what it sees. Choose your
platform below:
  * [[wiki:v2:Install_PixyMon_on_Mac|PixyMon on Mac]]
  * [[wiki:v2:Install_PixyMon_on_Windows_Vista_7_8|PixyMon on Windows Vista, 7, or 8]]
  * [[wiki:v2:Install_PixyMon_on_Windows_XP|PixyMon on Windows XP]]
  * [[wiki:v2:Installing_PixyMon_on_Linux|PixyMon on Linux]]

===== 2. Teach Pixy2 an object =====

After you install PixyMon and get it running, the next step is to
[[wiki:v2:Teach_Pixy_an_object_2|teach Pixy an object]], or 2, or 3...

===== 3. Hook Pixy2 up to your LEGO brick =====

Your Pixy2 should now be locating and tracking the object(s) that you taught
it. You're now ready to connect Pixy2 to your LEGO brick. Use the supplied
cable and the pictures below as a guide.

{{wiki:v1:img_5325_result.jpg?400}}

{{wiki:v1:img_5323_result.jpg?400}}\\

===== 4. Build and run a program =====

There are two ways to build and run a program for Pixy2. Follow the instructions
on one of these pages:
  * Using the [[wiki:v2:lego_home_edition|LEGO Mindstorms EV3 Home Edition]] software.
  * Using [[wiki:v2:python|Python or MicroPython]].

The LEGO Mindstorms EV3 Home App is not supported at this moment. Contact us
if you think you can help us with this.

===== Troubleshooting =====

  * [[wiki:v2:Some_Tips_on_Generating_Color_Signatures_2|Some Tips on Improving Detection Accuracy]] - must read!
  * [[wiki:v2:I_get_the_message_%22No_Pixy_devices_have_been_detected%22_in_PixyMon|I get the message "No Pixy devices have been detected" in PixyMon]]

If the above links don't solve your issue, or if you have questions or suggestions, please send them to <support@pixycam.com>. We also have a [[https://forum.pixycam.com/|public forum]] where you can ask technical questions about the Pixy2 software or hardware, and learn what the Pixy community is up to.


===== Where to go from here =====

  * Try running the [[wiki:v2:LEGO_line_tracking_test|LEGO Line Tracking Test]].
  * Try running the [[wiki:v2:LEGO_RGB_sensing_test|LEGO RGB Sensing Test]].
  * The [[wiki:v2:LEGO_Chase_Demo|LEGO Chase Demo Tutorial]] is a great way learn how to use Pixy2 with LEGO.
  * Learn [[wiki:v2:Mounting_Pixy_with_LEGO|how to mount Pixy2 to your LEGO creation]].
  * The [[wiki:v2:LEGO_Wiki|Pixy LEGO Wiki index]] has lots of additional information.
  * Check out the [[wiki:v2:LEGO_software_modules|Pixy2 LEGO software blocks reference]].

Thanks again for your support!