Raspberry Pi Robotic Blueprints - Sample Chapter
Raspberry Pi Robotic Blueprints - Sample Chapter
ee
pl
C o m m u n i t y
"Community
Experience
Distilled"
Sa
m
Richard Grimmett
Raspberry Pi Robotic
Blueprints
E x p e r i e n c e
D i s t i l l e d
Raspberry Pi Robotic
Blueprints
Utilize the powerful ingredients of Raspberry Pi to bring to life
amazing robots that can act, draw, and have fun with laser tag
Richard Grimmett
Preface
Robotics have really come into the public spotlight in the past few years. Ideas that,
just a few years ago, would have lived only in the government research center or
university lab, such as robotic vacuum cleaners, drones that cover the sky, and
self-driving cars, are now making their way into everyday life. This movement is
fueled, at least in part, by scores of enterprising individuals, without significant
technical training, who undertake building their idea with inexpensive hardware
and free, open-source software.
This book celebrates this effort by detailing how to get started on building the project
that you always wanted to build but didn't think you had the expertise for. The heart
of these projects is Raspberry Pi B version 2, a cable microprocessor-based system
that can run Linux and provides a platform for a significant number of open source
modules. Combine Raspberry Pi with these open source modules and low cost
hardware, and you can build robots that can walk, role, draw, and even fly.
Preface
Chapter 5, A Robot That Can Draw, introduces the capability of external dedicated
servo controllers that can make controlling the arms and legs of the robot much
easier. This is done using servos, whose position can be controlled using our system.
Chapter 6, A Robot That Can Play Air Hockey, explains how to use stepper motors and
an advanced vision system to build a robot that can plan air hockey using more
power and precision.
Chapter 7, A Robot That Can Fly, explains that after building a robot that can walk,
talk, or play air hockey, you can build a robot that can fly.
Adding Raspberry Pi
to an RC Vehicle
The introduction of powerful, inexpensive processors that also provide a wide range
of functionality through free open-source software has caused the do-it-yourself
electronic project work to expand far beyond the simple, less than inspiring projects
of the past. Now the developers can, with very low cost, create amazingly complex
projects that were almost unthinkable a few years ago.
Many in this community are using Raspberry Pi as the basis for this revolution. This
book provides simple, easy-to-follow instructions on how to use the Raspberry Pi in
some very complex and sophisticated projects. Now enough of the introduction, let's
start building something.
In this chapter, you'll learn the following:
How to set break into the control circuitry of the car and use Raspberry Pi to
control it
[1]
As this is an advanced projects book, you have already spent some time with
Raspberry Pi and know how to write Raspbian/Wheezy on an SD card and boot
your Raspberry Pi. If you don't, feel free to go to the Raspberry Pi website at
https://www.raspberrypi.org/. Here you'll find all the instructions that you need
to get your Raspberry Pi B 2 up and running.
Note that you may want to install your system on a microSD card that has at least
8 GB of memory. In some of the projects that you'll be building, you'll be installing
some fairly significant pieces of open source software and you may not want to run
out of memory.
Now you are ready to start with some simple product modification. Let's start
with an RC car; you'll replace the transmitter and control the car with a wireless
connection on Raspberry Pi.
[2]
Chapter 1
This particular car is an Xmods car, sold by Radio Shack, also available at other retail
and online outlets. You can certainly use other RC cars as well. The advantage of this
particular set is that the inputs to the drivetrain and steering are very easy to access.
[3]
There are two connections that you will want direct access to. The first is the drive
motor, and the second is the steering mechanism. For this particular model of RC car,
the drive mechanism is in the rear. What you are normally looking for is two wires
that will directly drive the DC motor of the car. On this system, there is a connector
in the rear of the car, it looks as shown in the following image:
[4]
Chapter 1
In the main control section of the car, you can see that there is a connector that plugs
in these two wires in order to control the speed of the car, as shown here:
Remove this plug and these wires; you'll use Raspberry Pi and a motor controller to
provide the voltage to the drive system of the car. The motor will run faster or slower
based on the level of voltage that is applied to these wires and the polarity of the
voltage will determine the direction. Raspberry Pi will need to provide a positive or
negative 6 volt signal to control the speed and direction of the car.
You'll also need to replace the control signals that go to the front of the car for the
steering. This is a bit more difficult. The following is the connector that goes to the
front of the car:
[5]
The five-pin connector that comes from the control module is shown in the
following:
The trick is to determine how the wires control the steering. One way to determine
this is by opening up the unit, the following is how it looks from inside:
[6]
Chapter 1
As you can see in the previous image, the blue and yellow wires are attached to a
DC motor and the orange, brown, and red wires are attached to another control
circuit. The motor will drive the wheels left or right, the polarity of the voltage will
determine the direction, and its magnitude will cause the wheels to turn more or
less sharply. The orange, brown, and red wires are interesting as their purpose is a
bit difficult to discover. To do this, you can hook up a voltmeter and an oscilloscope.
The orange and brown wires are straightforward, they are 3.5 volt and GND,
respectively. The red wire is a control wire, the signal is a Pulse Width Modulation
(PWM) signal, a square wave at 330 Hz and 10 percent duty cycle, and it is an enable
control signal. Without the signal, the turning mechanism is not engaged.
Now that you understand the signals that are used in the original system to control
the car, you can replicate those with Raspberry Pi. To control the steering, Raspberry
Pi needs to provide a 3.3 volt DC signal, a GND signal, a 330 Hz, a 3.3 volt PWM
signal, and the +/- 6 volt drive signal to the turning mechanism. To make these
available, you can use the existing cables, solder some additional cable length, and
use some shrink-wrap tubing to create a new connector with the connector that is
available in the car:
[7]
You'll also need the access to the rear wheel compartment of your car to drive the
two rear wheels. The following is how the access will look:
Also, you'll need to connect the battery power to Raspberry Pi, here is the modified
connection to get the battery power from the car:
[8]
Chapter 1
To control the car, you'll need to provide each of the control signals. The +/- 6 volt
signals cannot be sourced directly by Raspberry Pi. You'll need some sort of motor
controller to source the signal to control the rear wheel drive of the car and turning
mechanism of the car. The simplest way to provide these signals is to use a motor
shield, an additional piece of hardware that installs at the top of Raspberry Pi and can
source the voltage and current to power both of these mechanisms. The RaspiRobot
Board V2 is available online and can provide these signals. Here is a picture:
[9]
1. First, connect the battery power connector to the power connector on the
board, as shown in the following:
2. Next, connect the rear drive signal to the motor 1 connectors on the board,
similar to the following image:
[ 10 ]
Chapter 1
3. Connect the front drive connector to the motor 2 connectors on the board, as
given in the following image:
4. Connect the 3.3 volt and GND connectors to the General Purpose Input/
Output (GPIO) pins of Raspberry Pi. Here is the layout of these pins:
[ 11 ]
5. You'll use Pin 1 3.3V for the 3.3 volt signal and Pin 9 GND for the ground
signal. You'll connect one of the GPIO pins so that you can create the 320 Hz,
10 percent duty cycle signal to enable the steering. Connect Pin 12 GPIO18,
as shown in the following:
raspirobotboard2/raw/master/python/dist/rrb2-1.1.tar.gzthis
[ 12 ]
Chapter 1
Now you'll create some Python code that will allow you to access both the drive
motor and the steering motor. The code will look similar to the following:
import RPi.GPIO as GPIO: This will import the RPi.GPIO library, allowing
you to send out a PWM signal to the front steering mechanism.
import time: This will import the time library, allowing you to use the
time.sleep(number_of_milliseconds), which causes a fixed delay.
from rrb2 import *: This will import the rrb2 library, allowing you to
control the two DC motors. The rrb2 is the library you just downloaded
from GitHub.
pwmPin = 18: This will set the PWM pin to GPIO Pin 18, which is physically
dc = 10: This will set the duty cycle to 10 percent on the PWM signal.
[ 13 ]
pwm = GPIO.PWM(pwmPin, 320): This will initialize the PWM signal on the
print("Loop, press CTRL C to exit"): This will instruct the user how to
GPIO.cleanup(): This will cleanup the GPIO driver and prepare for
shutdown.
Now you can run the program by typing sudo python xmod.py. LED 1 on the
control board should turn on, the rear wheels should move in the forward direction,
and the steering should turn. This confirms that you have connected everything
correctly. To make this a bit more interesting, you can add more dynamic control of
the motors by adding some control code. The following is the first part of the python
code:
[ 14 ]
Chapter 1
Before you start, you may want to copy your python code in a new file, you can
call it xmodControl.py. In this code you'll have some additional import statements,
which will allow you to sense key presses from the keyboard without hitting the
enter key. This will make the real-time interface seem more real time. The getch()
function senses the actual key press.
[ 15 ]
The rest of this code will look similar to the previous program. Now the second part
of this code is as follows:
The second part of the code is a while loop that takes the input and translates it into
commands for your RC car, going forward and backward and turning right and left.
This program is quite simple, you'll almost certainly want to add more commands
that provide more ways to control the speed and direction.
[ 16 ]
Chapter 1
You should now be able to connect to your Raspberry Pi via the Wireless Access
Point. Once you've created the wireless access point, you can login via a VNC
connection, this way you can add a USB webcam to your car to make it even easier to
control. To do this, first download an application that can support a VNC connection.
You can get this on your Raspberry Pi using an application called vncserver. You'll
need to install a version of this on your Raspberry Pi by typing sudo apt-get
install tightvncserver in a terminal window on your Raspberry Pi.
TightVNC Server is an application that will allow you to remotely view your
complete graphical desktop. Once you have it installed, you can do the following:
1. You need to start the server by typing vncserver in a terminal window on
Raspberry Pi.
2. You will be prompted for a password and then asked to verify it, then you
will be asked if you'd like to have a view-only password. Remember the
password that you have entered, you'll need it to remotely login via a
VNC Viewer.
3. You'll need a VNC Viewer application for your remote computer. One choice
for Windows users is RealVNC, available at http://www.realvnc.com/
download/viewer/. When you run it, you will see the following:
[ 17 ]
4. Enter the VNC Server address, which is the IP address of your Raspberry
Pi, and click on Connect. You will get a warning about an unencrypted
connection, select Continue and you will get the following pop-up window:
5. Type in the password that you entered while starting the vncserver, and
you will then get a graphical view of your Raspberry Pi, which looks like the
following screenshot:
[ 18 ]
Chapter 1
You can now access all the capabilities of your system; however, they may be slower
if you are doing a graphics-intense data transfer. To avoid having to type vncserver
each time you boot your Raspberry Pi, use the instructions given at http://www.
havetheknowhow.com/Configure-the-server/Run-VNC-on-boot.html.
Vncserver is also available via Linux. You can use an application called Remote
Desktop Viewer to view the remote Raspberry Pi GUI system. If you have not
installed this application, install it using the update software application based
on the type of Linux system you have. Once you have the software, perform the
following steps:
1. Run the application and you will get the following result:
[ 19 ]
2. Make sure vncserver is running on Raspberry Pi; the easiest way to do this is
to log in using SSH and run vncserver at the prompt. Now click on Connect
on Remote Desktop Viewer. Fill in the screen as follows, under the Protocol
selection, choose VNC, and you will see the following screenshot:
3. Now enter the host IP address, make sure you include a :1 at the end and
then click on Connect. You'll need to enter the vncserver password that you
created when you first ran vncserver on Raspberry Pi, like this:
[ 20 ]
Chapter 1
You can see the graphical screen of Raspberry Pi. Now you are ready to observe the
output of a USB webcam connected to your car. This is quite straightforward, simply
plug in a USB webcam and download a video viewer. One such video viewer that
works well is luvcview. To install this, type sudo apt-get install luvcview.
With all these tools installed, you can now run vncview, bring up a luvcview
window so you can see what your RC Car is seeing and control it remotely by
running the xcmodControl.py program that you wrote earlier. The screen will
look similar to the following:
There are a lot of additions that you can make to your Raspberry Pi controlled car,
such as adding the joystick control or more autonomy. However, let's move on to the
next project.
[ 21 ]
Summary
Now you know how to work with Raspberry Pi to add its capability to an existing
piece of hardware, in this case, an RC Car. In the next chapter, you'll learn how to
add Raspberry Pi to a toy robot that can walk, and make it talk and listen to the voice
commands.
[ 22 ]
www.PacktPub.com
Stay Connected: