Getting Started with GPIO Pins on Raspberry Pi (Beginners guide)

GPIO pins on Raspberry Pi are a main feature you need to know.
As I’m a Linux administrator, I mainly used the Raspberry Pi for testing systems and software in the first months. But to go further and create your own electronic systems and programs, you need to learn how to use them.

GPIO pins allow adding extensions to your Raspberry Pi, whether with HATs or to create circuits. The easiest way to use them is to create Python scripts, but Scratch or other software are good options to consider.

In this beginner guide, I’ll really start with the basics, for people who never tried GPIO pins. If you already made some tests, you can use the content table below to get directly to the paragraph you want to read.

You’ll need a few items to complete this tutorial. If you don’t have anything yet, please check this great kit from Sunfounder. This might be a bit too much for this tutorial, but it’s worth it on the long run, as you won’t need anything else for your first few projects.

I answer your questions - Raspberry...
I answer your questions - Raspberry Pi FAQ

GPIO Basics

Download the Pi Glossary!
If you are lost in all these new words and abbreviations, request my free Raspberry Pi glossary here (PDF format)!

Let’s start with the basics about GPIO.

What are GPIO Pins?

GPIO stands for General Purpose Input/Output.
It’s the 40 pins you can see on the Raspberry Pi, near the edge:

raspberry pi gpio

The goal of the GPIO Pins is to add some extensions to your Raspberry Pi.
For example, most of the Raspberry Pi HATs use these pins to connect with the Raspberry Pi (you can find here my Raspberry Pi HATs recommendations if you want to try one).
You can also create your electronic circuit by using these GPIO pins with cables, LED, and other accessories. We’ll see that later.

GPIO Pinout

As you may have guessed, each pin has a specific role, and you can use it only for that role.
Some of them are input/output, power (3.3V or 5V), or ground.
There are even more complex things we’ll see later.
So, it’s important to know what is what.

Here is an illustration:

raspberry pi pinout
Raspberry Pi Bootcamp
Sale: 10% off today.
Take it to the next level.
I'm here to help you get started on Raspberry Pi.
Learn all the skills you need in the correct order.

The website is useful for this.
It gives you the exact layout and role of each pin.

If you don’t have it with your breadboard or GPIO kit, I recommend printing this image to use it later.

Raspberry Pi Configuration

Before starting with the GPIO pins practice, we need to do a few steps on the Raspberry Pi to make sure that everything is ready:

  • Start by updating your system
    sudo apt update sudo apt upgrade
  • Install the rpi.gpio package
    sudo apt install rpi.gpio
  • Enable I2C and SPI in raspi-config
    You don’t need them in this tutorial, so you can skip this step.
    But if you go further after this one it may save you time, as nobody explains this 🙂
    sudo raspi-config

    Go into “Interface Options”
    And enable I2C and SPI in each submenu.

I2C and SPI pins are specific GPIO pins.
You may need them with some hardware modules that need them (a screen like this one for example).

Required Hardware

Here is the recommended hardware you need to have to follow the rest of this tutorial (Amazon links):

These components will be useful for many projects later, it’s a long list of things you need to get started, but you’ll use them every time after that 🙂

That’s it, once you have everything ready, you can move to the next part.

Breadboard Basics

Let’s start with the breadboard.
If it’s your first time with it, you may have a hard time understanding how it works.

Breadboard Installation

If you are using the breadboard kit I recommended above, the first step is to install it in the blue plastic case.
Generally, you have to stick it in the large space and screw the Raspberry Pi to the corresponding location.

At this point your setup must look like this:

raspberry pi breadboard installation

Don’t plug in the Raspberry Pi power cable for the moment.

Breadboard Schema

Before going further, you need to understand how a breadboard works.
Each hole is a pin you can use to plug something.

Power Input

On the edges of the board, there are two lines:

  • The red line is for the power input
  • The blue line is for the ground

Each port is connected with all the pins from the same line.

Master your Raspberry Pi in 30 days
Sale: 10% off today.
Download the eBook.
Uncover the secrets of the Raspberry Pi in a 30 days challenge.
Learn useful Linux skills and practice multiples projects.

Attention, with some breadboards (like mine), there is a separation in the middle, you can see a gap in the red line for example.
If you plug near port 0, it will not work near port 50.

Other Ports

The other ports are used for everything else (LEDs, resistors, other modules).
A wire connects them in columns.
If you take one number on the board, it connects each port from the same column with the others.


It will be clearer with this picture:

breadboard schema

I have squared each connected ports.

The red square corresponds to a power input line.
There are four lines of this type on the board.
If you input power in one of the squared ports, you can use it from any other highlighted ports.

For the ground ports it’s the same thing (blue square).

And for the other ports, you can see the green square how they are connected together.
It’s the same for each column, for both side of the middle line.

If needed, here is a complete schema:

breadboard schema

Support me: Join the community on Patreon to show your support, get behind-the-scenes content and other awesome perks!

Your First Circuit: Blink the LED!

Get My Cheat Sheet!
Grab your free PDF file with all the commands you need to know on Raspberry Pi!

Ok, that’s the end of the theory part, and the beginning of your first circuit tutorial.
Let’s practice 🙂

Breadboard Configuration

As always, start to plug the pins without a power source plugged.

To get started you need:

  • 1x LED
  • 2x male/female jumper wires
  • 1x resistor

Take the two jumper wires and plug them like this:

  • One from the ground line to a ground pin of the Raspberry Pi (for example, the third one from the second row, port 6)
  • The other from an input/output port (for example, the fourth one of the first row, port 7)
gpio pins

You now have two cables, connected to only one side.
On the other side, you need to connect them to the breadboard.

Master Python on Raspberry Pi
Sale: 10% off today.
Get the eBook.
Do more with your Raspberry Pi, learn the useful concepts and take the shortcuts.
You miss half of the fun of using a Raspberry Pi if you don’t know anything about Python.

Plug the ground jumper wire to the ground line of the breadboard (any port).
Plug the other cable into one column of the breadboard (anywhere).

It should look like this:

breadboard wires

Finally, put the resistor between the ground line and the column near the other cable.
And put a light with one foot on each column, the shorter in the resistor/ground column.

Something like this:

breadboard led

Yes, I know my resistor seems to be having a hard time 🙂

You can now boot the Raspberry Pi and jump into SSH (or GUI if you prefer) to create the Python script.
As soon as the Raspberry Pi is on, avoid touching the circuit.

Python script

The first basic script we can code is to turn on the LED light to check that everything works.
To do this, Raspberry Pi OS already includes any libraries you need.

  • In a terminal, or with your favorite code editor, create a new python file:
  • Paste these lines inside:
    #import libraries
    import RPi.GPIO as GPIO
    import time

    #GPIO Basic initialization

    #Use a variable for the Pin to use
    #If you followed my pictures, it's port 7 => BCM 4

    led = 4
    #Initialize your pin

    #Turn on the LED
    print "LED on"

    #Wait 5s

    #Turn off the LED
    print "LED off"

    I commented on everything so it should be clear.
    The only trap is the pin number to use in the LED variable.
    You may have a different numeration in your breadboard expansion board or sticker, but you have to use the BCM number from

  • Save and Exit (CTRL+X)
  • Run the script with:

The LED will turn on for 5 seconds and then turn off.
If not, double-check every previous paragraph to see what you have missed.
If your circuit seems good, check the LED direction, there is a + and – side.


That’s it, you now have learned the basics about GPIO pins and breadboard.
You’re able to build basic circuits and you’re ready for the next level 🙂

If you like this kind of tutorial, stay tuned because I’ll talk more about it in the weeks or months to come.

This tutorial doesn't work anymore? Report the issue here, so that I can update it!

5 1 vote
Article Rating

Patrick Fromaget

I'm the lead author and owner of My goal is to help you with your Raspberry Pi problems using detailed guides and tutorials. In real life, I'm a Linux system administrator with a web developer experience.

Notify of
Newest Most Voted
Inline Feedbacks
View all comments
3 years ago


I used your excellent tips on how to install a print server on a the pi, and it works great.
Thank you.
I like coming back to you website, for more tips and things to try, It’s just great!!!

1 year ago

Hello! I wired everything in as listed and ran the program (though I did have to put parenthesis on the ‘print’ lines) and this is what I got:

Python 3.7.3 (/usr/bin/python3)
>>> %Run ‘led’
Traceback (most recent call last):
File “/home/pi/Desktop/led”, line 12, in
NameError: name ‘led’ is not defined

I tried installing a module named ‘led’ and adding ‘import led’ into the program and got this:

>>> %Run ‘led’
Traceback (most recent call last):
File “/home/pi/Desktop/led”, line 4, in
import led
File “/home/pi/.local/lib/python3.7/site-packages/led/”, line 24, in
from led import api
File “/home/pi/.local/lib/python3.7/site-packages/led/”, line 21, in
from led import core
File “/home/pi/.local/lib/python3.7/site-packages/led/”, line 35, in
from led.config import config
File “/home/pi/.local/lib/python3.7/site-packages/led/”, line 25, in
import acme
ModuleNotFoundError: No module named ‘acme’

Yeah. And I took one final try and imported the ‘acme’ module and got this:

>>> %Run ‘led’
Traceback (most recent call last):
File “/home/pi/Desktop/led”, line 4, in
import led
File “/home/pi/.local/lib/python3.7/site-packages/led/”, line 24, in
from led import api
File “/home/pi/.local/lib/python3.7/site-packages/led/”, line 21, in
from led import core
File “/home/pi/.local/lib/python3.7/site-packages/led/”, line 35, in
from led.config import config
File “/home/pi/.local/lib/python3.7/site-packages/led/”, line 25, in
import yaml
ModuleNotFoundError: No module named ‘yaml’

I tried to import the ‘yaml’ module and got this:

pi@raspberrypi:~ $ python3 -m pip install yaml
Looking in indexes:,
Collecting yaml
Could not find a version that satisfies the requirement yaml (from versions: )
No matching distribution found for yaml
pi@raspberrypi:~ $

So yeah. Thanks for reading this, and do you have any suggestions for how to solve this? That would be very helpful 😀

Thanks! L.M.

Recent Posts

Master your Raspberry Pi - 10% off