Home | Posts | Projects | About

A More Accurate Coordinate System


RPI health and safety inspections did not take kindly to my door mounted Robo-Schwarzenegger. Apparently I’m not breaking any rules with an internet controlled webcam hanging from my door, but the power cord across the doorway is a tripping hazard. I took Arnold down and brought him home with me over the break with the goal of teaching myself some python and jumping into OpenCV.

I played with both OpenCV and Python a few years ago when I more or less followed this tutorial, but ultimately could not get decent control of the camera. I figured the first step in doing this the right way was to get better control over the camera. Below I’ll describe how I accomplished this.

The Arduino

The old way I had of doing things on the Arduino was very simplistic and took no advantage of any Arduino libraries. Essentially the protocol between the computer and the arduino was a single character corresponding to a single action. Like many modern PC games, movement of the camera was set up in standard WASD fashion (“W” moved the Y axis up, “S” moved it down, “A” moved the X axis left, etc). Using PWM this was straightforward to code: an if-else block that would do things like “if W comes down the serial line, increment the current Y pulse width by 10”. At the end of the if-else block, if it was time to make a pulse the program would bring the pins connected to the servo high, wait for the pulse width, then bring it back low. There was also a hard coded center, and limits set up so the servos did not go past their limits. All in all, very simple, but it got the job done.

The new way of doing things is a little more complicated, but is much more useful in terms of precision. It takes inspiration from this wonderful tutorial to take advantages of the Arduino servo libraries and simplifies things. First, a three part protocol between the PC and Arduino is established:

  1. The PC sends a ‘255’ to the Arduino to let it know that we want to move servos. This is good for future expansion because we can use 0-254 to do other things with the micro-controller. For example, send something like ‘254’ to move speed controllers or get a reading from a GPS. 255 is essentially the servo “channel”.
  2. The PC sends a number corresponding to the index of a servo on the Arduino it wants to move. In my setup, 1 means the X axis and 2-means the Y axis.
  3. Last, an angle between 0 and 180 is sent telling the Arduino where to move the servo.

When implementing this protocol, in that list is used to pick a servo object to apply the servo write() function that takes the angle in number three as its argument. The Arduino does the rest! There is a catch though – in order for the Arduino to properly instantiate a servo object, you need to use the attach() function. Since there are minimum and maximum pulse widths (hardware limits) we care about so the pan tilt module doesn’t rip itself apart, those minimum and maximum pulse widths need to be known. I actually used the old version of my code and a couple print statements to write a diagnostic program I could use to figure out the pulse width limits. I have that attached as well as the real code.

The Python

Now not to diss PHP or anything (which is what I have most of my experience with at this point), but python just seems like a more grown up language. There is a lot to like about it. Every time I read or hear about something cool being done, it is almost always involves python! So far with the tutorials out there it has been awesome. The python segments here are short and not very advanced. I wrote one important function - move(). It takes an angle and a servo as arguments and – you guessed it – moves the specified servo to their specified angle. One problem though – due to me being an imperfect craftsman and not mounting the servos perfectly straight, the angular position of (90, 90) does not make the camera point straight ahead as one would expect. Therefore I wrote another simple diagnostic function to allow the interactive centering of the servos. Once I had the middle for the X and Y axis, I could use this in the move function to shift the centers.

Once move() was done, I wrote some test code and it worked like a champ! I then started stacking calls to move() inside of loops and I wrote some code to make the camera move in simple rectangles. Some problems then became clear: the pan tilt module either moves too slow, too fast or just spazzes out if you issue enough commands to it. Increasing the baud rate helped to speed things up, however it would still freak out if you told it to move really fast. I determined that there needs to be some delay between move() calls. Once again, I wrote some diagnostic code to determine this. The pan tilt module would move in rectangles with increasingly longer pauses between move() calls. At some critical delay value, the pan tilt module stopped jittering and moved smoothly (but still pretty fast) around the perimeter of the rectangle (turned out to be 0.003 seconds). As a final example of what the system can do, I wrote the spiral code that appears in the video above. It is only a few lines of python, but I spaced them out and commented them for ease of understanding:

def spiral():
    a = .01;  # "stretch" factor for sin and cosine
    t = 0;    # time value

    # time loop that stops when the stretch factor is 1
    while (a < 1) :

        # increase the time step

        # if 50 time steps have gone by, increment a
        if (t % 50 == 0) : a+=.01

        # move the servos to middle, plus or minus some scaled
        # value of sin or cosine. Change 'a' to something fixed
        # between 0 and 1 and the spiral is now a circle
        servo.move(1, 90 + a * math.degrees(math.cos(math.radians(t))))
        servo.move(2, 90 + a * math.degrees(math.sin(math.radians(t))))

        # delay between the move calls

Conclusion & Attachments

So that was it! Now I have unrestricted access to use python to do (almost) whatever I want! Looking at the python bindings for OpenCV next!

Tags: Robots | Computer vision | Python | Arduino

Read this next:

Face Tracking with Stonebot

I finally have it working! Very excited as I write this. So glad spring break exists otherwise I’d never have the time for this. Long story short, I have face detection working on my personal robot...

Lucas DoyleWritten by Lucas Doyle, a robotics engineer who does a lot of web development in San Francisco.