← Sair
Seguidor de Linha ESP32 (MicroPython + PID)
Modo Bancada · Plugada

Seguidor de Linha ESP32 (MicroPython + PID)

Seguidor de Linha ESP32 (MicroPython + PID)

🎯 O que vamos aprender
  • Montar e programar (em MicroPython) um seguidor de linha de alto desempenho com ESP32: ler 8 sensores QTR-8RC, calcular a posição da linha e usar um controle PID para seguir curvas suavemente, com recuperação quando a linha é perdida.
🧰 O que vamos usar

1× ESP32 (placa WROOM-32 DevKit) 1× Driver de motor TB6612FNG 1× Régua de sensores QTR-8RC (8 canais) 2× Motor DC com caixa de redução 1× Roda + roda boba (esfera) 1× Bateria Li-Po + interruptor (e regulador) 1× PCB do projeto (ESP32 seguidor) ou protoboard 1× Chassi (impressão 3D) 1× Pista: fita isolante preta sobre fundo branco 1× Jumpers, parafusos e cabos

🪜 Passo 1 de 5

Introdução / Contextualização

Apresente o seguidor de linha avançado: ESP32 em MicroPython, 8 sensores (QTR-8RC) e controle PID. Pergunta: por que um robô simples ziguezagueia e este segue a curva suave? Resposta: o PID corrige proporcional ao tamanho do erro.

🪜 Passo 2 de 5

Montagem do Circuito / Hardware

1) Montar chassi, motores e a régua de sensores na frente. 2) Ligar o TB6612 ao ESP32 (motor A: AIN1 G18, AIN2 G19, PWMA G4 · motor B: BIN1 G21, BIN2 G22, PWMB G5; STBY/VCC no 3V3; VM na bateria). 3) Ligar a régua QTR-8RC nos GPIO 13,12,14,27,26,25,33,32. Energia: bateria → regulador → ESP32; GND comum.

🪜 Passo 3 de 5

Programação / Codificação

Instalar o MicroPython no ESP32 e enviar o código com a IDE Thonny. Explicar o PID: P corrige proporcional ao erro, D antecipa pela velocidade do erro, I corrige desvios acumulados. A posição da linha vira um número (0–7000, centro 3500). Ajustar Kp, Kd, Ki e a velocidade base.

🪜 Passo 4 de 5

Teste, Depuração e Ajustes

Calibrar na pista: se ziguezagueia, baixar Kp ou subir Kd; se corrige devagar, subir Kp; se sai nas curvas, reduzir a velocidade base. Testar a recuperação quando a linha some.

🪜 Passo 5 de 5

Encerramento / Socialização

Roda de conversa: o que é uma malha de controle (PID)? Onde mais existe (chuveiro, drone, carro)? Encerrar com uma corrida cronometrada e comparação de ajustes entre as equipes.

🔌 Montagem do robô

Placa: ESP32 (WROOM-32)

⬇ baixar SVG
🧰 Montagem do robôPlaca: ESP32 (WROOM-32) · 4 componentes · 20 ligações detectadas do códigoESP32 (WROOM-32)⚡ Barramento de alimentação · 5V (+) / GND (–)GPIO13 · sensor 1GPIO12 · sensor 2GPIO14 · sensor 3GPIO27 · sensor 4GPIO26 · sensor 5GPIO25 · sensor 6GPIO33 · sensor 7GPIO32 · sensor 8Régua QTR-8RCGPIO18 · direção AGPIO19 · direção AGPIO4 · PWM velocidade AGPIO21 · direção BGPIO22 · direção BGPIO5 · PWM velocidade BDriver de motor(TB6612)AO1·AO2Motor DC esquerdoBO1·BO2Motor DC direitoLEGENDA DOS FIOSAlimentação (+5V)PWM (velocidade)Saída de motorOutro / dados
🧰 Montagem do robôESP32 (WROOM-32)placa controladoraDriver de motor (TB6612)GPIO18GPIO19GPIO4GPIO21GPIO22GPIO53V3bateria +Régua QTR-8RCGPIO13GPIO12GPIO14GPIO27GPIO26GPIO25GPIO33GPIO32Motor DC esquerdoAO1AO2Motor DC direitoBO1BO2
💻 O código
aula.py
# Seguidor de Linha — ESP32 (MicroPython) + driver TB6612 + régua QTR-8RC
# Controle PID com filtro de média móvel e recuperação de linha perdida.
# (código original; comentários traduzidos para o português)
from machine import Pin, PWM
import time

# ------------------ Pinos dos Motores (TB6612) ------------------
PWMA = PWM(Pin(4), freq=5000, duty=0)   # PWM do motor A
PWMB = PWM(Pin(5), freq=5000, duty=0)   # PWM do motor B

AIN1 = Pin(18, Pin.OUT)
AIN2 = Pin(19, Pin.OUT)
BIN1 = Pin(21, Pin.OUT)
BIN2 = Pin(22, Pin.OUT)

# ------------------ Pinos dos Sensores QTR-8RC ------------------
sensors = [
    Pin(13, Pin.IN), Pin(12, Pin.IN), Pin(14, Pin.IN), Pin(27, Pin.IN),
    Pin(26, Pin.IN), Pin(25, Pin.IN), Pin(33, Pin.IN), Pin(32, Pin.IN)
]
NUM_SENSORS = len(sensors)

# ------------------ Parâmetros do PID ------------------
cruzero = 300  # velocidade base (0–1023)
Kp = 0.2
Kd = 10.0
Ki = 0.005

PRO = 0
DER = 0
INT = 0
LAST = 0

# ------------------ Filtro dos sensores ------------------
history = [3500] * 5  # histórico inicial para a média móvel

def read_qtr_digital():
    """Devolve a posição com base nos sensores digitais (0 ou 1)."""
    values = [s.value() for s in sensors]
    weighted_sum = 0
    total = 0
    for i, v in enumerate(values):
        weighted_sum += v * i * 1000
        total += v
    if total == 0:
        return 3500  # centro por padrão
    return int(weighted_sum / total)

def read_qtr_filtered():
    """Filtra a leitura dos sensores usando média móvel."""
    pos = read_qtr_digital()
    history.pop(0)
    history.append(pos)
    return sum(history) // len(history)

# ------------------ Controle dos motores ------------------
def set_motor(left, right):
    """Controla os motores esquerdo e direito com valores de -1023 a 1023."""
    # Motor A (esquerdo)
    if left >= 0:
        AIN1.value(1); AIN2.value(0); PWMA.duty(min(left, 1023))
    else:
        AIN1.value(0); AIN2.value(1); PWMA.duty(min(-left, 1023))
    # Motor B (direito)
    if right >= 0:
        BIN1.value(1); BIN2.value(0); PWMB.duty(min(right, 1023))
    else:
        BIN1.value(0); BIN2.value(1); PWMB.duty(min(-right, 1023))

# ------------------ Programa principal ------------------
print("Iniciando o seguimento de linha...")
time.sleep(2)

last_time = time.ticks_ms()

while True:
    now = time.ticks_ms()
    dt = max((now - last_time) / 1000, 0.001)  # evita divisão por zero
    last_time = now

    # Leitura de posição filtrada
    pos = read_qtr_filtered()
    PRO = pos - 3500

    # Linha perdida -> giros suaves para reencontrar
    if PRO < -3500:
        vel_loss = int(cruzero * 0.8)
        set_motor(-vel_loss, vel_loss)
        INT = 0  # zera o integral
    elif PRO > 3500:
        vel_loss = int(cruzero * 0.8)
        set_motor(vel_loss, -vel_loss)
        INT = 0
    else:
        # PID
        DER = (PRO - LAST) / dt
        INT += PRO * dt
        INT = max(min(INT, 3000), -3000)  # anti-windup

        vel = (PRO * Kp) + (DER * Kd) + (INT * Ki)
        vel = max(min(vel, cruzero), -cruzero)

        # Ajuste dinâmico da velocidade base nas curvas
        baseSpeed = cruzero
        if abs(PRO) > 1500:
            baseSpeed = int(cruzero * 0.7)

        left = baseSpeed - vel
        right = baseSpeed + vel
        set_motor(int(left), int(right))

        LAST = PRO

    time.sleep_ms(5)
🔀 Como o programa pensa
flowchart TD A(["Início"]) --> CFG["Configurar TB6612, PWM e 8 sensores QTR"] CFG --> L["Ler posição da linha (filtro de média móvel)"] L --> E["erro = posição - 3500"] E --> Q{"Linha perdida?"} Q -->|Sim| R["Girar suave para reencontrar"] Q -->|Não| PID["PID: Kp·erro + Kd·derivada + Ki·integral"] PID --> M["Motores: esq = base - correção · dir = base + correção"] R --> L M --> L
🧱 Em blocos
quando @greenFlag for clicado
configurar TB6612, PWM e os 8 sensores QTR
sempre
  ler a posição da linha (8 sensores, com filtro de média móvel)
  somar (erro) a (posição) - (3500)
  se <linha perdida para um lado?> então
    girar suave para reencontrar a linha
  senão
    somar (derivada) a (erro - erro anterior) / (dt)
    somar (integral) a (integral) + (erro × dt)
    somar (correção) a (Kp×erro) + (Kd×derivada) + (Ki×integral)
    acionar motor esquerdo com (base - correção)
    acionar motor direito com (base + correção)
  end
end
🖨️ Peças 3D

Toque para ver em 3D · gire com o dedo.

Corpo/chassi
Suporte
Pra fechar

Você chegou ao fim! 🎉

O que foi mais difícil? O que você faria diferente? Conte pra turma!

✓ Sair