====== Pixy Quick Start ======


==== Install PixyMon ====

If you're just getting started with Pixy, you should install PixyMon first. It will allow you to configure Pixy 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]]


==== Teach Pixy ====

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]]...


==== Hook up to your microcontroller ====

Your Pixy should now be locating and tracking the objects that you taught it. (hooray!) You're now ready to do something useful with Pixy, which usually involves connecting Pixy to your favorite microcontroller:

  * [[wiki:v2:hooking_up_pixy_to_a_microcontroller_-28like_an_arduino-29|Arduino]]
  * [[wiki:v2:Hooking_up_Pixy_to_a_Raspberry_Pi|Raspberry Pi]]
  * [[wiki:v2:Hooking_up_Pixy_to_a_Beaglebone_Black|BeagleBone Black]]
  * [[wiki:v2:Porting_Guide|Other controller]]


==== Assemble and test the pan/tilt mechanism ====

If you purchased a [[http://charmedlabs.com/default/pan-tilt-kit/|pan/tilt kit]], build it using these [[wiki:v2:Assembling_pantilt_Mechanism|assembly instructions]], then [[wiki:v2:Run_the_Pantilt_Demo|run the pan/tilt demo]]. You can run the demo on Pixy by itself (without a microcontroller) or from your microcontroller (e.g. Arduino) so you can easily modify/extend the code.


==== Troubleshooting ====

  * [[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]]
  * [[wiki:v2:I_don%27t_see_any_video_when_I_run_PixyMon|I don't see any video when I run PixyMon]]
  * [[wiki:v2:Pixy_is_detecting_the_wrong_objects|Pixy is detecting the wrong objects]]
  * [[wiki:v2:Pixy_isn-27t_detecting_the_objects_I_taught_it|Pixy isn't detecting the objects I taught it]]
  * [[wiki:v2:My_arduino_isn-27t_receiving_data_from_Pixy|My Arduino isn't receiving data from Pixy]]
  * [[wiki:v2:My_pantilt_is_acting_sort_of_crazy|My pan/tilt is acting sort of crazy]]
  * [[wiki:v2:PixyMon_is_crashing%21|PixyMon is crashing!]]
  * [[wiki:v2:The_image_in_PixyMon_is_out_of_focus|The image in PixyMon is out of focus]]

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 [[http://forum.pixycam.com|public forum]] where you can ask technical questions about the Pixy software or hardware, and learn what the Pixy community is up to.


==== Digging deeper ====

[[../../start|Click here for the wiki index]] - there's tons of info here, including pointers on [[wiki:v2:Mounting_Pixy|how to mount Pixy to your robot creation]], talking to your Pixy via the [[wiki:v2:Building_libpixyusb_as_a_Python_module_on_Linux|Python API]], and much much more.

One final thing - we need your help to tell people about Pixy. Please take 15 seconds to [[https://www.amazon.com/review/create-review?ie=UTF8&asin=B00IUYUA80|leave a product review]] on Amazon! It really helps our small business.

Thanks again for your support!