<< return to Pixycam.com

User Tools

Site Tools


wiki:v2:run_the_pantilt_demo

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
wiki:v2:run_the_pantilt_demo [2018/05/18 15:47]
pixycam [Running the demo from PixyMon]
wiki:v2:run_the_pantilt_demo [2018/06/07 22:58] (current)
pixycam
Line 5: Line 5:
 ====== Running the Pan-tilt Demo ====== ====== Running the Pan-tilt Demo ======
  
-OK, you've [[wiki:​v2:​Assembling_pantilt_Mechanism|assembled the pan-tilt mechanism]] and it looks cool, but it would look even cooler if it moved. One nice thing is that you don't need a battery to move the pan-tilt -- the pan-tilt can use the USB cable for power. ​ **The USB cable that came with your Pixy2 is recommended** for powering your Pixy and pan-tilt. ​ But **as long as the cable is 4 ft or shorter** (3 ft is common.) If you use a longer cable, there can be up to 1 volt of voltage drop along the cable, which is fine for Pixy, but the servos will malfunction. Also, before you run the pan-tilt demo, go ahead and [[wiki:​v2:​Teach_Pixy_an_object|teach Pixy an object]] if you haven'​t already.+OK, you've [[wiki:​v2:​Assembling_pantilt_Mechanism|assembled the pan-tilt mechanism]] and it looks cool, but it would look even cooler if it moved. One nice thing is that you don't need a battery to move the pan-tilt -- the pan-tilt can use the USB cable for power. ​ **The USB cable that came with your Pixy2 is recommended** for powering your Pixy and pan-tilt. ​ But you can use your own, **as long as the cable is 4 ft or shorter** (3 ft is common.) If you use a longer cable, there can be up to 1 volt of voltage drop along the cable, which is fine for Pixy, but the servos will malfunction. Also, before you run the pan-tilt demo, go ahead and [[wiki:​v2:​Teach_Pixy_an_object|teach Pixy an object]] if you haven'​t already.
  
 We should also mention that the pan-tilt base needs to be anchored to the table somehow before running the demo.  Attaching your pan-tilt to an Arduino is sufficient. ​ Otherwise, you might try placing the pan-tilt base between two books. ​ If you don't anchor the base, the base will tend to rotate under Pixy, leaving Pixy more or less stationary (and we want Pixy to move/​rotate!) We should also mention that the pan-tilt base needs to be anchored to the table somehow before running the demo.  Attaching your pan-tilt to an Arduino is sufficient. ​ Otherwise, you might try placing the pan-tilt base between two books. ​ If you don't anchor the base, the base will tend to rotate under Pixy, leaving Pixy more or less stationary (and we want Pixy to move/​rotate!)
Line 17: Line 17:
  
 If you're running PixyMon, you can run the demo (or any other program) at any time by selecting it in the **Program** menu. In particular, select **Program➜pan\_tilt\_demo**. If you're running PixyMon, you can run the demo (or any other program) at any time by selecting it in the **Program** menu. In particular, select **Program➜pan\_tilt\_demo**.
 +
 +
 +{{http://​pixycam.com/​wp-content/​uploads/​2018/​06/​pt2.mp4||loop,​autoplay}}
 +
 +
  
 Pixy should then track your object and plot the detected objects in the video window. Yay!  Note, Pixymon will switch to a block-only view, so the video window will turn black except for what Pixy is detecting (shown as rectangular blocks). ​ The pan-tilt demo switches to this view because it allows Pixy to process at maximum framerate (doesn'​t slow Pixy down.) ​ Pixy should then track your object and plot the detected objects in the video window. Yay!  Note, Pixymon will switch to a block-only view, so the video window will turn black except for what Pixy is detecting (shown as rectangular blocks). ​ The pan-tilt demo switches to this view because it allows Pixy to process at maximum framerate (doesn'​t slow Pixy down.) ​
 +
 +{{wiki:​v2:​image_250.png}}
  
 From PixyMon, you can also play with the pan-tilt demo parameters: From PixyMon, you can also play with the pan-tilt demo parameters:
Line 29: Line 36:
 ==== Running the demo from an Arduino ==== ==== Running the demo from an Arduino ====
  
-You can have your Arduino perform pan/tilt tracking too. The Arduino reads in the object blocks and calculates the positions of the pan and tilt servos and sends the calculated positions back to Pixy, and Pixy then updates the servo positions. This is great for getting your Pixy and Arduino better acquainted and getting them both collaborating in some kind of application that you write.+You can have your Arduino perform pan-tilt tracking too. The Arduino reads in the object blocks and calculates the positions of the pan and tilt servos and sends the calculated positions back to Pixy, and Pixy then updates the servo positions. This is great for getting your Pixy and Arduino better acquainted and getting them both collaborating in some kind of application that you write.
  
-**This requires that you run the "​default" ​Pixy program -- not the pan/tilt demo program.** The default ​program ​is the program Pixy runs upon power-up by default without pressing any buttons. You can also run the default program by selecting it in the **Actions** menu in PixyMon.+This requires that you run the **color\_connected\_components** ​Pixy program -- not the **pan\_tilt\_demo** program. ​
  
-OK, start by getting the latest Arduino-Pixy code, described [[wiki:​v2:​hooking_up_pixy_to_a_microcontroller_-28like_an_arduino-29|here]]. Load the pantilt ​demo by selecting it in **File➜Examples➜Pixypantilt** in the Arduino IDE. Upload it, and as long as Pixy is running the default ​program, you should start seeing the pan/tilt move to track any object ​that matches signature 1. (Note, you'll need to [[wiki:​v2:​Teach_Pixy_an_object_2|teach Pixy an object]] if you haven'​t done so already.)+OK, start by getting the latest Arduino-Pixy2 code, described [[wiki:​v2:​hooking_up_pixy_to_a_microcontroller_-28like_an_arduino-29|here]]. Load the pan-tilt ​demo by selecting it in **File➜Examples➜Pixy2ccc\_pantilt** in the Arduino IDE. Upload it, and as long as Pixy is running the color\_connected\_components ​program, you should start seeing the pan-tilt move to track the first object ​Pixy acquires. (Note, you'll need to [[wiki:​v2:​Teach_Pixy_an_object_2|teach Pixy an object]] if you haven'​t done so already.)
  
 You can also play with the Arduino code, such as changing the proportional and derivative gains. You can also play with the Arduino code, such as changing the proportional and derivative gains.
  
 <​code>​ <​code>​
-ServoLoop ​panLoop(300, 500); +PIDLoop ​panLoop(500, 0, 400, true); 
-ServoLoop ​tiltLoop(500, ​700);+PIDLoop ​tiltLoop(600, 0, 500, true);
 </​code>​ </​code>​
-Here, 300 is the proportional gain and 500 is the derivative gain for the pan servo. Likewise, 500 and 700 are the proportional and derivative gains for the tilt axis. Try reducing the proportional gain in half and see what happens. Many times, increasing the gains results in some erratic behavior, but don't worry -- you won't damage anything. 
- 
-With a little tweaking and modifying, this code can become a "​chasing"​ instead of a "​tracking"​ algorithm. That is, instead of calculating servo positions your Arduino can calculate motor speeds. So now your Pixy-Arduino robot creation can chase a ball, toy, etc. Adafruit created just such a robot, and they describe how to build and program one [[https://​learn.adafruit.com/​pixy-pet-robot-color-vision-follower-using-pixycam|here]]. 
- 
- 
- 
- 
  
 +Here, 500 is the proportional gain and 400 is the derivative gain for the pan servo. Likewise, 600 and 500 are the proportional and derivative gains for the tilt axis. Try reducing the proportional gain by half and see what happens. Many times, increasing the gains results in some erratic behavior, but don't worry -- you won't damage anything.
  
 +With a little tweaking and modifying, this code can become a "​chasing"​ instead of a "​tracking"​ algorithm. That is, instead of calculating servo positions your Arduino can calculate motor speeds. So now your Pixy-Arduino robot creation can chase a ball, toy, etc. The Arduino example **ccc\_zumo\_chase** does exactly this.  It controls 4 axes: pan, tilt, left and right motors to chase the object it acquires.  ​
  
wiki/v2/run_the_pantilt_demo.1526658423.txt.gz · Last modified: 2018/05/18 15:47 by pixycam