GPIO breakout board and breadboard guide

What is a breakout board?

A GPIO breakout board (also called a T-cobbler or GPIO adapter) connects your Raspberry Pi's GPIO pins to a breadboard using a ribbon cable. This gives you:

• Labeled pins: Each pin is clearly marked on the breadboard, preventing wiring mistakes.
• Safety: No risk of accidentally shorting pins on the Pi's GPIO header.
• Easy prototyping: Build and test circuits on the breadboard before soldering.
• Reusable connections: Swap components quickly without unplugging from the Pi.

What you need

• Raspberry Pi (any model with 40-pin GPIO header)
• GPIO breakout board or T-cobbler
• 40-pin ribbon cable (usually included with breakout board)
• Half-size or full-size breadboard
• Jumper wires
• LEDs, resistors, buttons, or other components for your project

Connect the breakout board

1. Shut down your Pi

Always power off and unplug your Raspberry Pi before connecting or disconnecting GPIO devices.

2. Connect the ribbon cable

The ribbon cable has a connector at each end:

• One end connects to your Pi's GPIO header. The cable is keyed and will only fit one way. Align the connector so the cable extends away from the Pi, not over the board.
• The other end connects to the breakout board. Make sure the connector is fully seated.

3. Insert the breakout board into the breadboard

The breakout board straddles the center gap of the breadboard, with pins on both sides. Press it firmly until all pins are fully inserted. The board should sit flat and secure.

4. Power on your Pi

Once everything is connected, you can power on your Pi. The breakout board has no active components, so there's nothing to configure in software.

Build your first circuit

Let's build a simple LED circuit to test your breakout board.

Materials needed

• 1 × LED (any color)
• 1 × 330Ω resistor (orange-orange-brown)
• 2 × jumper wires

Wiring

1. Locate GPIO 17 (physical pin 11) on the breakout board.
2. Insert the resistor into the breadboard, connecting GPIO 17 to an empty row.
3. Insert the LED's long leg (anode, +) into the same row as the resistor.
4. Connect the LED's short leg (cathode, −) to the GND pin using a jumper wire.

Test the circuit with Python

Run this simple script to turn the LED on and off:

from gpiozero import LED
from time import sleep

led = LED(17)

while True:
    led.on()
    sleep(1)
    led.off()
    sleep(1)

If the LED blinks, your breakout board is working correctly!

Safety tips

• Never connect or disconnect GPIO devices while the Pi is powered on. This can damage the Pi or your components.
• Always use resistors with LEDs. Connecting an LED directly to a GPIO pin without a resistor can burn out the LED or damage the Pi.
• Don't connect 5V to 3.3V pins. The Pi's GPIO pins are 3.3V logic. Applying 5V can permanently damage your Pi.
• Double-check your wiring before powering on. Use the breakout board's labels to verify connections.
• Start with simple circuits. Test one component at a time before building complex projects.