Domine GPIO do Raspberry Pi com Python: Tutorial Passo a Passo

Os pinos GPIO (General Purpose Input/Output) são a principal interface de expansão de todos os modelos de Raspberry Pi. Eles permitem conectar o computador de placa única (SBC) ao mundo físico: sensores, atuadores, displays e muito mais. Neste tutorial, exploramos o GPIO em detalhes e mostramos como controlá-lo com Python.

O que é GPIO e Como Funciona?

GPIO (General Purpose Input/Output) é a interface padrão em microcontroladores e SBCs como o Raspberry Pi. São terminais de entrada e saída digitais que permitem:

• Saída (Output): Controlar LEDs, relés, motores, buzzers, displays.
• Entrada (Input): Ler estado de botões, chaves, sensores digitais (movimento, porta, chuva), sinais de outros dispositivos.

Para funcionar corretamente, dois passos são essenciais:

1. Hardware: Conexões elétricas corretas (níveis lógicos 3.3V, resistores pull-up/down, proteção).
2. Software: Configuração do sistema operacional (Raspberry Pi OS) e bibliotecas de controle.

Pinout (Mapa dos Pinos) do Raspberry Pi GPIO

Modelos atuais (Pi Zero, 1 B+, 2, 3, 4, 5) possuem header de 40 pinos. Modelos antigos (Pi 1 Model A/B) tinham 26 pinos.

Importante: Nem todos os 40 pinos são GPIO programáveis. O header inclui:

• Alimentação: 3.3V (pinos 1, 17), 5V (pinos 2, 4), GND (pinos 6, 9, 14, 20, 25, 30, 34, 39).
• GPIO programáveis: ~26 pinos (ex: GPIO2 a GPIO27).
• Funções alternadas: I2C (GPIO2/3), SPI (GPIO7-11), UART (GPIO14/15), PWM (GPIO12/13/18/19), PCM, etc.

Durante a configuração inicial, é imperativo consultar o pinout oficial do seu modelo para evitar curto-circuitos (ex: ligar 5V num pino GPIO de 3.3V).

Como Programar GPIO do Raspberry Pi com Python

Configuração de Hardware (Exemplo: LED + Botão)

Recomenda-se um Pi Wedge (kit breakout) para prototipagem segura. Alternativamente, use jumpers macho-fêmea e uma protoboard.

Componentes necessários:

• Protoboard e jumpers
• Resistor 330Ω (limite corrente LED)
• Resistores Pull-up/Pull-down (10kΩ) para botões (ou use internos via software)
• LED difuso ou sensor PIR (movimento)

Biblioteca Python: GPIO Zero (Recomendada para Iniciantes)

A biblioteca gpiozero é a forma moderna, pythonica e simples de controlar GPIO. Vem pré-instalada no Raspberry Pi OS. Abstrai detalhes de baixo nível (como numeração BCM/BOARD) e oferece classes de alto nível: LED, Button, MotionSensor, PWMLED, Servo, etc.

Exemplo simples (pisca LED no GPIO17):

from gpiozero import LED
from time import sleep

led = LED(17)  # Numeração BCM (padrão gpiozero)
while True:
    led.on()
    sleep(1)
    led.off()
    sleep(1)

Biblioteca Legada: RPi.GPIO (Ainda Muito Usada)

Se você usa Raspberry Pi OS, RPi.GPIO já vem instalada. Caso contrário: pip install RPi.GPIO.

Importação e configuração básica:

import RPi.GPIO as GPIO
import time

# Escolha numeração: BCM (pelo chip Broadcom) ou BOARD (pelo header físico)
GPIO.setmode(GPIO.BCM)  # Recomendado: BCM

# Configura pino 17 como saída
GPIO.setup(17, GPIO.OUT)

try:
    while True:
        GPIO.output(17, GPIO.HIGH)
        time.sleep(1)
        GPIO.output(17, GPIO.LOW)
        time.sleep(1)
except KeyboardInterrupt:
    GPIO.cleanup()  # Libera pinos ao sair com Ctrl+C

Dica: Sempre use GPIO.cleanup() no final para evitar avisos de "channel already in use" na próxima execução.

Projetos Práticos com Raspberry Pi GPIO

Com hardware e software configurados, você pode criar:

• Detector de movimento com sensor PIR (alarme, câmera, luz automática).
• Estação meteorológica (sensor BME280: temp, umidade, pressão via I2C).
• Controle de relé para automação residencial (lâmpadas, portão, irrigação).
• Display OLED/LCD via I2C para mostrar dados de sensores.
• Servo motor controlado por joystick ou potenciômetro (ADC externo necessário, ex: MCP3008).
• Projetos de imagem com Raspberry Pi Camera Module (timelapse, vigilância, IA na borda).

Conclusão

O header GPIO de 40 pinos transforma o Raspberry Pi numa plataforma versátil de computação física. Dominar sua configuração (hardware + software) e as bibliotecas Python (gpiozero para começar, RPi.GPIO para controle fino) abre portas para infinitos projetos de IoT, robótica, automação e instrumentação. Para dúvidas ou suporte avançado, entre em contato.