Raspberry Pi Library
Raspberry Pi Library
Menu Cart
Search for…
Handy Links
New Products
Sale Items
Raspberry Pi Store
The Raspberry Pi
Projects
Gaming
Robotics
Audio
Programming
One of the biggest selling points of the Raspberry Pi is its GPIO, or General Purpose Input/Output ports.
They are the little pins sticking out of the circuit board and allow you to plug various devices into your
Raspberry Pi. With a little programming, you can then control them or detect what they are doing.
In this tutorial I am going to show you how to light an LED. In addition to your Raspberry Pi running
Raspbian, what you will need is:
A Breadboard
An LED
You can get all these, and more, in the £5 CamJam EduKit from The Pi Hut, which teaches you more
about LEDs, buzzers and switches, and includes all the hardware and eight well-written worksheets about
using the GPIO pins on your Raspberry Pi.
The Breadboard
The breadboard is a way of connecting electronic components to each other without having to solder them
together. They are often used to test a circuit design before creating a Printed Circuit Board (PCB).
With the breadboard in the CamJam EduKit, the top row of holes are all connected together – marked with
red dots. And so are the second row of holes – marked with blue dots. The same goes for the two rows of
holes at the bottom of the breadboard.
In the middle, the columns of wires are connected together with a break in the middle. So, for example, all
the green holes marked are connected together, but they are not connected to the yellow holes, nor the
purple ones. Therefore, any wire you poke into the green holes will be connected to other wires poked into
the other green holes.
https://thepihut.com/blogs/raspberry-pi-tutorials/27968772-turning-on-an-led-with-your-raspberry-pis-gpio-pins 2/11
24/01/2019 Turning on an LED with your Raspberry Pi's GPIO Pins | The Pi Hut
The LED
When you pick up LED stands for Light Emitting Diode, and glows when electricity is passed through it.
the LED, you will
notice that one leg
is longer than the
other. The longer
leg (known as the ‘anode’), is always connected to the positive supply of the circuit. The shorter leg (known
as the ‘cathode’) is connected to the negative side of the power supply, known as ‘ground’.
LEDs will only work if power is supplied the correct way round (i.e. if the ‘polarity’ is correct). You will not
break the LEDs if you connect them the wrong way round – they will just not light. If you nd that they do
not light in your circuit, it may be because they have been connected the wrong way round.
The Resistor
You must ALWAYS use resistors to connect LEDs up to the GPIO pins of the Raspberry Pi. The Raspberry
Pi can only supply a small current (about 60mA). The LEDs will want to draw more, and if allowed to they
will burn out the Raspberry Pi. Therefore putting the resistors in the circuit will ensure that only this
small current will ow and the Raspberry Pi will not be damaged.
Resistors are a way of limiting the amount of electricity going through a circuit; speci cally, they limit the
amount of ‘current’ that is allowed to ow. The measure of resistance is called the Ohm (Ω), and the larger
the resistance, the more it limits the current. The value of a resistor is marked with coloured bands along
the length of the resistor body.
You will be using a 330Ω resistor. You can identify the 330Ω resistors by the colour bands along the body.
The colour coding will depend on how many bands are on the resistors supplied:
If there are four colour bands, they will be Orange, Orange, Brown, and then Gold.
If there are ve bands, then the colours will be Orange, Orange, Black, Black, Brown.
It does not matter which way round you connect the resistors. Current ows in both ways through them.
Jumper Wires
Jumper wires are used on breadboards to ‘jump’ from one connection to another. The
ones you will be using in this circuit have di erent connectors on each end. The end
with the ‘pin’ will go into the Breadboard. The end with the piece of plastic with a hole
in it will go onto the Raspberry Pi’s GPIO pins.
https://thepihut.com/blogs/raspberry-pi-tutorials/27968772-turning-on-an-led-with-your-raspberry-pis-gpio-pins 3/11
24/01/2019 Turning on an LED with your Raspberry Pi's GPIO Pins | The Pi Hut
https://thepihut.com/blogs/raspberry-pi-tutorials/27968772-turning-on-an-led-with-your-raspberry-pis-gpio-pins 4/11
24/01/2019 Turning on an LED with your Raspberry Pi's GPIO Pins | The Pi Hut
You will be using one of the ‘ground’ (GND) pins to act like the ‘negative’ or 0 volt ends of a battery. The
‘positive’ end of the battery will be provided by a GPIO pin. Here we will be using pin 18. When they are
‘taken high’, which means it outputs 3.3 volts, the LED will light. Now take a look at the circuit diagram
below.
You should turn your Raspberry Pi o for the next bit, just in case you accidentally short something out.
Use one of the jumper wires to connect a ground pin to the rail, marked with blue, on the
breadboard. The female end goes on the Raspberry Pi's pin, and the male end goes into a hole on the
breadboard.
Then connect the resistor from the same row on the breadboard to a column on the breadboard, as
shown above.
Next, push the LEDs legs into the breadboard, with the long leg (with the kink) on the right.
Lastly, complete the circuit by connecting pin 18 to the right hand leg of the LED. This is shown here
with the orange wire.
https://thepihut.com/blogs/raspberry-pi-tutorials/27968772-turning-on-an-led-with-your-raspberry-pis-gpio-pins 5/11
24/01/2019 Turning on an LED with your Raspberry Pi's GPIO Pins | The Pi Hut
The Code
You are now ready to write some code to switch the LED on. Turn on your Raspberry Pi and open the
terminal window.
nano LED.py
Once you have typed all the code and checked it, save and exit the text editor with “Ctrl + x” then “y” then
“enter”.
You will see the LED turn on for a second and then turn o .
If your code does not run and an error is reported, edit the code again using nano LED.py .
Explanation
So, what is happening in the code? Let’s go through it a line at a time:
import RPi.GPIO as GPIO The rst line tells the Python interpreter (the thing
that runs the Python code) that it will be using a
‘library’ that will tell it how to work with the
https://thepihut.com/blogs/raspberry-pi-tutorials/27968772-turning-on-an-led-with-your-raspberry-pis-gpio-pins 6/11
24/01/2019 Turning on an LED with your Raspberry Pi's GPIO Pins | The Pi Hut
And that's it! You are now able to turn an LED on and o .
https://thepihut.com/blogs/raspberry-pi-tutorials/27968772-turning-on-an-led-with-your-raspberry-pis-gpio-pins 7/11
24/01/2019 Turning on an LED with your Raspberry Pi's GPIO Pins | The Pi Hut
£6.00 GBP
£6.00 GBP
CamJam EduKit
£5.00 GBP
https://thepihut.com/blogs/raspberry-pi-tutorials/27968772-turning-on-an-led-with-your-raspberry-pis-gpio-pins 8/11
24/01/2019 Turning on an LED with your Raspberry Pi's GPIO Pins | The Pi Hut
£3.00 GBP
Related Posts
This guide will steer you through the process of assembling, installing, con guring and operating
the Raspberry Pi T...
READ MORE
If you’ve bought one of our a ordable EduKit Robotics kits, you’ll no doubt come to a point where
you want to advanc...
READ MORE
https://thepihut.com/blogs/raspberry-pi-tutorials/27968772-turning-on-an-led-with-your-raspberry-pis-gpio-pins 9/11
24/01/2019 Turning on an LED with your Raspberry Pi's GPIO Pins | The Pi Hut
One of the rst things you’ll need when you set up a Raspberry Pi media centre is a remote control.
Using a keyboard...
READ MORE
Subscribe
Where Is My Order?
Quick Links
Search
All Products
Raspberry Pi Store
Maker Store
Micro:Bit Store
FAQ
Delivery
Privacy Statement
Policies
Terms of Service
Company Info
Get Connected
https://thepihut.com/blogs/raspberry-pi-tutorials/27968772-turning-on-an-led-with-your-raspberry-pis-gpio-pins 10/11
24/01/2019 Turning on an LED with your Raspberry Pi's GPIO Pins | The Pi Hut
https://thepihut.com/blogs/raspberry-pi-tutorials/27968772-turning-on-an-led-with-your-raspberry-pis-gpio-pins 11/11