Controlling a Raspberry Pi RC Car With a Keyboard

In this intermediate tutorial you will learn how to operate a hacked RC car with a keyboard using a model B Raspberry Pi device using Python. The key points in this tutorial include:

• Configuring the virtual Pulse Width Modulation (PWM) for the GPIO pins so two DC motors can run independently
• Wiring the Raspberry Pi to the RC car

I had originally planned to have the car operated through the use of an IR remote control and receiver but due to compatibility issues between the Raspberry Pi and the required libraries I had to revise my project.

Teacher Notes

Teachers! Did you use this instructable in your classroom?
Add a Teacher Note to share how you incorporated it into your lesson.

Step 1: Components

Please ensure you have the following components before continuing with the tutorial:

• Raspberry Pi Model B (
• MicroSD Card (
• Pi Cobbler Breakout and Cable (
• Any sized Breadboard (
• M/M Wires (
• F/F Wires (
• Prototyping Pi Plate (
• L293D Chip (
• Medium sized RC Car with DC Motors
• Bluetooth Keyboard
• Soldering Iron and Wire

Step 2: Prerequisites

Please ensure you meet the following prerequisites before continuing with the tutorial:

• An assembled Cobbler with GPIO Cable and Breadboard

• Soldering iron experience

• An upgraded operating system. You can achieve this by entering into the terminal:

      sudo apt-get upgrade

• Up-to-date GPIO library. You can achieve this by entering into the terminal:

      sudo apt-get update
      sudo apt-get install python-dev
      sudo apt-get install python-rpi.gpio

Step 3: The L293D Chip

The most important part of your hardware setup is the L293D chip. With the appropriate code, this chip allows you to control the speed and direction of two independent DC motors. It is crucial for you to understand how this chip works and the function of each of its pins. The ‘+Vmotor’ pin (8) provides the power for the motors while the ‘+V’ pin (16) provides the power for the chip’s logic. The ‘IN’ pins (2, 7, 10, 15) each require a connection to a GPIO pin and the ‘OUT’ pins (3, 6, 11, 14) provide the output for the two DC motors.

Step 4: Hardware

Once you understand the mechanics of the L293D chip it is time to assemble it, along with the rest of the components, onto the breadboard. The schematic has been provided for you. Please note the orientation of the L293D chip.

You may notice the LEDs on the diagram. These represent the headlights or neon underside lights on your RC car. If your car lacks these features please disregard this section of the schematic.

Step 5: Software

Below is the python code you will need in order for this program to work. Save the program as when finished.

import RPi.GPIO as io
import sys, tty, termios, time

# These two blocks of code configure the PWM settings for
# the two DC motors on the RC car. It defines the two GPIO
# pins used for the input, starts the PWM and sets the
# motors' speed to 0
motor1_in1_pin = 4
motor1_in2_pin = 17
io.setup(motor1_in1_pin, io.OUT)
io.setup(motor1_in2_pin, io.OUT)
motor1 = io.PWM(4,100)

motor2_in1_pin = 24
motor2_in2_pin = 25
io.setup(motor2_in1_pin, io.OUT)
io.setup(motor2_in2_pin, io.OUT)
motor2 = io.PWM(4,100)

# Defining the GPIO pins that will be used for the LEDs on
# the RC car and setting the output to false
io.setup(18, io.OUT)
io.output(18, False)

io.setup(23, io.OUT)
io.output(23, False)

# The getch method can determine which key has been pressed
# by the user on the keyboard by accessing the system files
# It will then return the pressed key as a variable
def getch():
    fd = sys.stdin.fileno()
    old_settings = termios.tcgetattr(fd)
        ch =
        termios.tcsetattr(fd, termios.TCSADRAIN, old_settings)
    return ch

# This section of code defines the methods used to determine
# whether a motor needs to spin forward or backwards. The
# different directions are acheived by setting one of the
# GPIO pins to true and the other to false. If the status of
# both pins match, the motor will not turn.
def motor1_forward():
    io.output(motor1_in1_pin, True)
    io.output(motor1_in2_pin, False)

def motor1_reverse():
    io.output(motor1_in1_pin, False)
    io.output(motor1_in2_pin, True)

def motor2_forward():
    io.output(motor2_in1_pin, True)
    io.output(motor2_in2_pin, False)

def motor2_reverse():
    io.output(motor2_in1_pin, False)
    io.output(motor2_in2_pin, True)

# This method will toggle the lights on/off when the user
# presses a particular key. It will then change the status
# of the lights so it will know whether to turn them on or
# off when it is next called.
def toggleLights():

    global lightStatus

    if(lightStatus == False):
        io.output(18, True)
        io.output(23, True)
        lightStatus = True
        io.output(18, False)
        io.output(23, False)
        lightStatus = False

# This method will toggle the direction of the steering
# motor. The method will determine whether the user wants
# to turn left or right depending on the key they press and
# then make the appropriate adjustment. It works as a toggle
# because the program cannot read multiple pressed keys at
# the same time. The possible positions of the wheels are
# "right", "centre" and "left". It will then update the
# status of the wheel to access next time it is called.
def toggleSteering(direction):

    global wheelStatus

    if(direction == "right"):
        if(wheelStatus == "centre"):
            wheelStatus = "right"
        elif(wheelStatus == "left"):
            wheelStatus = "centre"

    if(direction == "left"):
        if(wheelStatus == "centre"):
            wheelStatus = "left"
        elif(wheelStatus == "right"):
            wheelStatus = "centre"

# Setting the PWM pins to false so the motors will not move
# until the user presses the first key
io.output(motor1_in1_pin, False)
io.output(motor1_in2_pin, False)
io.output(motor2_in1_pin, False)
io.output(motor2_in2_pin, False)

# Global variables for the status of the lights and steering
lightStatus = False
wheelStatus = "centre"

# Instructions for when the user has an interface
print("w/s: acceleration")
print("a/d: steering")
print("l: lights")
print("x: exit")

# Infinite loop that will not end until the user presses the
# exit key
while True:
    # Keyboard character retrieval method is called and saved
    # into variable
    char = getch()

    # The car will drive forward when the "w" key is pressed
    if(char == "w"):

    # The car will reverse when the "s" key is pressed
    if(char == "s"):

    # The "a" key will toggle the steering left
    if(char == "a"):

    # The "d" key will toggle the steering right
    if(char == "d"):

    # The "l" key will toggle the LEDs on/off
    if(char == "l"):

    # The "x" key will break the loop and exit the program
    if(char == "x"):
        print("Program Ended")

    # At the end of each loop the acceleration motor will stop
    # and wait for its next command

    # The keyboard character variable will be set to blank, ready
    # to save the next key that is pressed
    char = ""

# Program will cease all GPIO activity before terminating

Step 6: Test & Configure

To test the code you must run it as a super user to access the pins. Type the following:

      sudo python

Press the W and S keys to move the car forward and backward
Press the A and D keys to toggle the steering left and right
Press the L key to toggle the lights if you have them.
Press the X key when you are ready to exit the program.

Step 7: Soldering

It is now time to solder the parts onto a protoyping plate to increase its durability, and then solder the plate onto the car connecting the battery pack and motors in the process. Remember to not connect any of the pins together with solder because it will cross the signals. It is also a good idea to colour code your wires for easy reference.

The final product should look similar to this this:

Step 8: Enjoying Your Newly Hacked RC Car

There you have it. With a Raspberry Pi and some simple bits and pieces you have made yourself a fun little toy and learnt about electronics and programming along the way. Enjoy!

2 People Made This Project!


  • Made with Math Contest

    Made with Math Contest
  • Multi-Discipline Contest

    Multi-Discipline Contest
  • Robotics Contest

    Robotics Contest

29 Discussions


Question 9 months ago

Please Help I have and error that states - File "", line 31 finally:
SyntaxError: invalid syntax

Question 1 year ago on Step 4

Hello, could you please help me with the positive wire of the battery. I'm not sure where to connect it?

1 answer
Gagana R

2 years ago

How do we download and install getch module


2 years ago

Its not working for me.. It says the code has error... Help pls


2 years ago

can I use a power bank instead of the AA batteries?

Someone help plss...

Thnx in advance


2 years ago

Hey, you've got a slight error in your schematic. The +ve power from the batteries aren't connected to anything. You have pin 8 (+VMotor) of the H-bridge connected to ground. It should be connected to the batteries.


4 years ago on Introduction

If i want ride a 12 volt motor will this post code and circuit work, because when i did it with 6v motor it worked the best.

2 replies

Reply 4 years ago on Introduction

if you wanna run a 12v motor, then you need a motor controller. If you have used a 6v motor, it might have run with the 5v supply .

12v motor can be connected to a motor controller which can be connected to a 12v power source and RPi input can be directly given to the motor controller input.

Additionally, motor controller does both forward and backward actions just by giving different signals

comment if you need any more help


Reply 2 years ago

Please I have the same issue.

my RC car has 4 DC Motors with 12v, I have tried to control motors with "L298 H-BRIDGE" but once I connect them and one motor run a little, the controller has broken down and it damage the raspberry too, thus I will not trust H-BRIDGE any more...

please do u have any other solution ... thanks a lot


3 years ago

Hey, I just did all of the wiring and programming stuff I can get the motor to run because I have a Raspberry Pi 3 and it have different gpio pinout than the model B so can you help me please?

1 reply

Reply 3 years ago

you would have to change the code at the beginning where its says "pin = (a pin)" at the beginning to match the pi 3. if you search google images you should be able to find a schematic of both GPIO pinouts online, and compare the model b pins mentioned in the code with the corresponding pins on the pi 3.


3 years ago

So I copied the code line for line and wired the breadboard exactly as in the diagram. I'm using a raspberry pi b with the correct cable, motor driver and two 9v DC motors. My power source connected to the breadboard is a 9v battery. I know the pi is getting the button signal from the keyboard because I inserted a few 'print' lines that display when you press a, s, d, or f. Unfortunately, the motors don't run at all. I know it has something to do with the pi sending a signal to the cobbler or with the breadboard, but I don't know which and I don't know how to fix it.

Also, when I run the script through command terminal, it works fine, but when I run it straight from python, it runs with 2 errors (see below). I don't understand why it doesn't work if I copied everything exactly. I can provide more info and/or pictures if necessary.

Traceback (most recent call last):

File "home/pi/", line 93, in <module>

Char = getch()

File "home/pi/Control4.oy", line 28, in getch

Fd = sys.stdin.fileno()

Unsupported operation: fileno


3 years ago

Will this work with a raspberry pi 3?


4 years ago on Step 5

I have used some part of your code, specifically where you have defined the function getchar(). After that I implemented the infinite while loop but I'm getting an error:

File "/root/BITS_People/", line 20, in <module>


File "/root/BITS_People/", line 9, in getch

fd = sys.stdin.fileno()

AttributeError: fileno

Any ideas on how to fix it? Thanks in advance

1 reply

Reply 3 years ago

I had the same problem so I fixed it by downloading and installing the getch module for python


3 years ago

How can this be used with a 4WD RC car?


4 years ago on Introduction

I connected everything now I am stuck!! I've tried to program it but I keep getting errors and i do not know how to fix them. can anyone help me with the programming, i need it asap!!

Your problem is the programs reading the crap at the top how to fix this is open up the file u get the error in in python at the top there like the time and date u want to delete that stuff so that the code starts with import RPi.GPIO as io

import sys, tty, termios, time

if you have more troubles message me i can help

also heres my code its based off this one so it will work with this set up

1 reply

Hey awesome project just what I was looking for. unfortunately its not working for me... I have raspi B+ and when I run your code I get this error.