Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.




====== LEGO Chase Demo ======

This page describes how to make a LEGO robot that chases things, like a ball. It's the same robot and program that's used in the [[https://www.youtube.com/watch?v=HZ_0qk7Yd7A|Pixy LEGO video]]. This robot and program is a good launching point for other projects, and it's a good introduction to PID control, which is used throughout robotics and engineering in general.


===== Building the robot =====

The robot we're going to build can be found in Laurens Valk's book [[http://robotsquare.com/books/ev3discovery|LEGO Mindstorms EV3 Discovery Book]]. The robot is called the Explor3r and it uses parts that are available in the retail Mindstorms EV3 kit.

  - Assemble Explor3r through step 11. [[http://robotsquare.com/2015/10/06/explor3r-building-instructions/|Click here for instructions on how to build Explor3r]]." That is, stop short of mounting the IR Sensor (step 12). Instead of the IR Sensor, we'll be mounting Pixy. If you are using an NXT brick, your instructions will be very similar.
  - Locate these LEGO parts and your LEGO-mounted Pixy. (There are instructions on how to mount Pixy to LEGO [[wiki:v1:Mounting_Pixy_with_LEGO.|here]])\\
{{wiki:img:0ce334b7f975bd1bc2a8ff02364c66bab884f45e.jpg?400}}\\
 
  - \\
{{wiki:img:4700af4039676ed890a5b07d73f88c66aa2adeb5.jpg?400}}\\
 
  - \\
{{wiki:img:c57f4f15003d90419bd269594dd44be85e151068.jpg?400}}\\
 
  - \\
{{wiki:img:3d1acda20f7e4fdad7ff81c7af3c6b56085068d4.jpg?400}}\\
 
  - \\
{{wiki:img:1a172eb992784b7e8b99ca2a72b48e86669d908d.jpg?400}}\\
 
  - Attach Pixy as shown.\\
{{wiki:img:1d6bdb767ebf4c690f2ab91c35d30b6819ad0572.jpg?400}}\\
 
  - Connect the Pixy cable. Plug one end of the cable into Pixy and the other end into port 1 of your brick.\\
{{wiki:img:7a4ceae022477335cae33edf506435c88303588f.jpg?400}}


==== Cables (IMPORTANT!) ====

  - The motors connect to motor ports A and B on your brick. Don't "cross" the cables. That is, if you are facing the motor ports (the back of the robot), the left motor connects to port B, the right motor connects to port A.
  - Pixy connects to sensor port 1.\\
 


===== Teach Pixy an object =====

Go ahead and [[wiki:v1:Teach_Pixy_an_object_2|teach Pixy an object]]. You might try using the button press method. Using the button press method doesn't require that you hook up a USB cable to Pixy and run PixyMon, so it's much more convenient!


===== Load Chase example =====

  - Turn on your LEGO brick if you haven't done so, and hook up a USB cable between your computer and your LEGO brick.
  - From the LEGO Mindstorms EV3 Software, go to the **File** menu and select **Open Project**.\\
{{wiki:img:3e3b64f2ff052ac58280fa2315eff9d803714e6e.png?400}}\\
 
  - Browse to the location where you unzipped the "LEGO blocks and examples" file (which you can download [[https://pixycam.com/downloads-pixy1/|on this page]]), and then to the **examples** directory and then either to the **EV3** or **NXT** directory depending on your brick version. Select "chase.ev3" and click on **Open**.
  - Click on the "track" tab. You should see a program that looks like this (below).\\
{{wiki:img:043148247c8d379fb867582e6230deb13bba5371.png?400}}\\
 
  - Run the program! Click on the play icon in the lower right corner of your EV3 software window. If you don't see the play icon, make sure your LEGO brick is powered on, finished booting, and connected to you computer via a USB cable.\\
{{wiki:img:aa5d26848e8509a94a41c8bc66ed36125ee5af36.png?400}}\\
 .
  - If you are running PixyMon, make sure you are running the "Default program" by clicking on the home icon.\\
{{wiki:img:0cb61d054b661f140bf4037bae3a8f67a95494cd.png?400}}\\
 
  - Move the object that you taught Pixy in front its camera lens. The track program simply adjusts the angle of the robot so that it always faces your object. It doesn't chase your object, it just "faces" your object, but it's quick!\\
 


===== What's going on in the track program? =====

The track program uses **X centroid** output of the [[wiki:v1:Pixy_LEGO_Block|Pixy block]]\\
{{wiki:img:9396b60542bb7b47d8badfd066bcbb250754fc9d.png?400}}\\
to adjust the heading of the robot by using a [[wiki:v1:PID_LEGO_Block|PID controller]].\\
{{wiki:img:b081d3680dbafee48b02da203d65785b8c937eec.png?400}}\\
That is, the **X centroid** output of the Pixy block ranges between 0 and 255, depending on where the detected object is in Pixy's image. The "center pixel" is therefore 128. The PID controller tries to move the motors such that the detected object is always centered in the image. It does this by comparing the **X centroid** value to 128 (the PID controller's **Set Point** input).

The **Control Output** of the PID controller is fed directly into the left wheel controller (the **Power Left** input of the Move Tank controller block). The **Power Right** input is fed the inverted output of the PID controller by subtracting the PID controller's output from 0. Why are the wheels controlled in opposite directions? We are interested in controlling only the rotation of the robot, and rotating the robot is achieved by powering the motors in opposite directions at the same power/speed. It is in this way that the robot "tracks" the object and always faces it. The program is surprisingly simple!

There is some additional logic in the program to make sure that if there are no detected objects, the robot doesn't move. This is done by comparing the **Signature Output** of the Pixy block with 0. If the **Signature Output** is zero, Pixy has not detected an object. If the **Signature Output** is non-zero, Pixy has detected an object. The Switch block selects between these two possibilities, and feeds the PID controller output into the motors when an object is detected, and feeds 0 into the motors when no objects are detected.


===== Some notes on adjusting the PID gains =====

The appeal of the PID controller is it's flexibility. By adjusting the three gain values, one for proportional, one for integral, and one for derivative, lots of different systems can be controlled. So what's up with the PID values? How were they chosen?\\
{{wiki:img:2bb44d78a22d7e61c4a92f31ddd0d4b5e680082c.png}}

These were "tuned" by experimentation. You can tune the PID loop yourself. In fact, it's a good way to familiarize yourself with PID control.

Go ahead and set all of the PID gains to 0. That is, click on **Proportional** input of the PID block and set the value to 0. Do the same for the **Integral** and **Derivative** inputs. Now all of the PID gains are 0. You can try to run the program now. And if you guessed that your robot won't move, you're correct!

The proportional gain "does most of the work" as they say, so tuning should begin by adjusting this value. Start with a small value of 0.1 and run the program. Notice how the robot is now very slow and sluggish. That is, when trying to track the object (which you're moving around) the robot seems to be trying, but it's heart doesn't seem to be into it. This is telling you that your proportional gain is too small.

Try settnig the proportional gain to 1.0 and run the program. You might notice that the robot does a shimmy after it faces your object. In other words you move the object quickly, and the robot responds by turning to face the object, and instead of stopping when it faces your object, it keeps on going. It overshoots. In fact, it may overshoot several times before coming to a rest, finally facing your object like it was programmed to do. This is oscillation, and it's a very common problem.

To reduce the oscillation, you need to increase the derivative gain. Increasing the derivative gain is like adding friction to your system, which may sound like something you should avoid. However, increasing the derivative gain does not adversely affect the efficiency of your system as friction does. Start by setting the derivative gain to the same value as the proportional gain. And continue to increase the derivative gain until the oscillation is under control.

However, if increasing the derivative gain does not remove the oscillation, the proportional gain may be too high. Try reducing the proportional gain (cutting it in half, say), then setting the derivative gain to zero again, and starting over by increasing the derivative gain until the oscillation is removed.

If you're successful in removing the oscillation, you might try your luck by increasing the proportional gain again (not as high as before) and seeing if you can still bring the oscillation under control with derivative gain. And if you're unsuccessful in removing the oscillation, you can always reduce the proportional gain and try different derivative gains as before.

Our goal is to have our robot that tracks the object quickly, but without oscillation. This is usually the goal, but you may want a robot that oscillates or is sluggish. It's all up to you!

What about the integral gain? Integral gain is useful when the system has trouble reaching the goal. Say if our robot tended to get close to facing our object and then stopped, we could try adding a little integral gain. The integral gain would then make sure that the robot would face the object, eventually. The integral gain is zero in this example because the the LEGO motors have their own built-in control loops that make sure that we always reach our goal.


===== Chasing the object =====

Click on the "chase" tab. You should see a program that looks like this (below).\\
{{wiki:img:4c2db0b428995f2e1d1c0139a4d990e814f89032.png?400}}

Notice that it's very similar to the track program. In fact, the track program is mostly intact in the top half of the chase program, but there's an additional PID controller in the bottom half of the program. This PID controller adds the "chase" element.

To run the chase program:

  - Make sure you have a fair amount of space for your robot to move around in.
  - Make sure Pixy can reliably detect/track your object. (Look at Pixy's LED. Does it glow when the object is present?)
  - Tilt Pixy's lens down such that it is looking slightly down at the ground, like in the final assembled picture above.
  - Place the object that you taught Pixy on the ground in front of the robot, but such that Pixy can still see it. (A ball is perfect for this.)
  - Now run the program by clicking on the play icon in the lower right corner of your EV3 software window.

You should notice that the robot chases the object. Or more specifically, it will maintain a certain distance from the object. If the object is farther away, the robot will approach (chase) the object. If the object is too close, the robot will back up until the correct distance to the object is reestablished. The program is more complicated than the track program, but not by much!


===== What's going on in the chase program? =====

If you read and understood the section on how the track program works, much of the chase program should make sense. The main difference is the extra PID controller. The new controller takes the **Y Centroid** output of the Pixy block and compares it to 150. Why 150? The **Y Centroid** output varies between 0 and 199 depending on the position of the detected object in the image. If the object is higher in the image, the **Y Centroid** value is lower, and if the object is lower in the image, the **Y Centroid** value is higher. It's backwards in a sense, but many cameras follow this same scheme.

Now consider that Pixy is angled slightly such that it is looking downward. This allows your robot to use a simple distance-measuring technique. Assuming the object of interest is resting on the ground, if the object is higher in the image, it is farther away from Pixy. If the object is lower in the image, it is closer to Pixy. In fact, you can estimate the actual distance by performing a simple calculation: distance = constant * 1/(1 + Y Centroid). You just need to figure out the value of the constant by doing some simple calibration with a known distance. Anyway, by choosing the value of 150, we are choosing the lower part of the image, or when the object is relatively close. You can change this value if you like. In particular, if you lower the value (to 100, for example), the robot will stop when it is farther away. If you raise the value (no greater than 199 though!), the robot will stop when it is closer.

How is the output of the new PID controller used to control the motors? The track program was already controlling the motors such that it controlled the rotation of the robot. The new PID controller must somehow control the translation (forward/backward) motion of the robot while not interfering with the rotation motion. It does this by using a simple set of equations.

<code>
rotation = left_motor - right_motor
translation = left_motor + right_motor
</code>
If you've ever driven a tank, these equations probably make sense. But we're interested in the "inverted" equations. We want expressions for the left_wheel and the right_wheel in terms of rotation and translation. That is, we already know how we want our robot to rotate and translate -- these are the outputs of our PID controllers. So rotation and translation are our **knowns**. Our **unknowns** are left_wheel and right_wheel. Using some algebra, we get the inverted equations.

<code>
right_motor = (translation - rotation)/2
left_motor = (rotation + translation)/2
</code>
If you look at the program, these equations are implemented in the math blocks that feed into the Move Tank block. The divide-by-two's are missing, but since these are just multiplicative constants (ie multiply by one-half), they end up being taken up in the PID gain values when the gain values are chosen (tuned). (How convenient!)


===== Some notes on the PID block =====

By putting the PID controller in a block, we make things simpler. It's now very easy to make programs with PID control loops. In fact, you can use the PID block for other programs that don't use Pixy. Use the PID block to control your robot's distance to the wall for a wall-following robot. That is, use the IR sensor (in proximity mode) as an input to the PID controller. And feed the output of the PID controller into the steering control of your robot.

But by making the PID controller a block, we hide the implementation details. These details are simple though, and can be summarized with a few simple expressions.

<code>
error = Value_In - Set_Point
d_error = error - previous_error                                             // Simple derivative of error
i_error = i_error + error                                                    // Simple integral of error
previous_error = error                                                       // Remember the error from the previous control cycle
Control_Output = Proportional*error + Integral*i_error + Derivative*d_error  // This is "belly of the beast".  Not much of a beast though... :)
</code>
Using these expressions as a guide, you can try creating your own PID block in the LEGO EV3 programming environment.


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

You've created a robot that can chase things. Using the same concepts you can create a robot that goes over to an object and picks it up. Or you can create a robot that launches projectiles at things. Or you can create a robot that goes over to its charger and plugs itself in. Or you can create the worlds first (as far as we know) soccer-playing LEGO robot. The programs to create these robots are more complicated, but armed with these concepts, much of the added complexity is in the interleaving of these concepts.

So think about what you want your robot to do, then do it! (And by all means tell us about it! <support@pixycam.com>)
Documentation

User Tools

Site Tools

Page Tools
