Objetivo da aula

• Compreender a estrutura básica de um programa em Python no PyBricks.
• Aprender a importar as bibliotecas necessárias para controlar motores.
• Executar um comando simples de movimento em um motor conectado ao hub LEGO® SPIKE Prime.
• Entender a lógica por trás do controle de velocidade e rotação.

Antes de começar

Verifique se o hub SPIKE Prime já está com o PyBricks Firmware instalado e se você consegue conectá-lo normalmente ao navegador no site code.pybricks.com.

Conecte um motor à porta A do hub.
Essa será a porta utilizada neste primeiro teste.
Você pode conferir a letra da porta ao lado do conector físico do motor.

Entendendo a estrutura básica

Todo programa em PyBricks segue uma estrutura simples, composta por três etapas principais:

1. Importação — onde informamos quais módulos e funções do PyBricks serão usados.
2. Inicialização — onde definimos quais dispositivos estão conectados ao hub (motores, sensores, etc.).
3. Execução — onde colocamos os comandos que dizem ao robô o que fazer.

Seu primeiro programa

Vamos começar com um exemplo simples: fazer o motor conectado à porta A girar uma volta completa para frente e depois uma volta para trás.

from pybricks.hubs import PrimeHub
from pybricks.pupdevices import Motor
from pybricks.parameters import Port, Stop
from pybricks.tools import wait

hub = PrimeHub()
motorA = Motor(Port.A)

motorA.run_angle(300, 360, then=Stop.HOLD, wait=True)
wait(300)
motorA.run_angle(300, -360, then=Stop.HOLD, wait=True)

Como o código funciona

• PrimeHub() cria a comunicação com o hub, permitindo enviar comandos.
• Motor(Port.A) define que existe um motor conectado na porta A.
• run_angle(300, 360) manda o motor girar a 300° por segundo até completar 360° (ou seja, uma volta completa).
• Stop.HOLD faz o motor segurar a posição ao final do movimento, sem girar livremente.
• wait(300) cria uma pausa de 0,3 segundos antes do próximo comando.
• Depois o comando é repetido com -360, o que faz o motor girar no sentido contrário.

Executando o programa

1. Copie o código acima no editor do PyBricks.
2. Clique em Connect e selecione o seu hub.
3. Clique em Run para enviar e executar o programa.
4. Observe o movimento do motor e o comportamento entre as pausas.

Erros comuns

• O motor não gira: confira se está conectado à porta A e se a porta foi declarada corretamente no código.
• Erro de digitação: o Python diferencia letras maiúsculas e minúsculas — escreva exatamente como está no exemplo.
• Hub não reconhecido: desconecte o cabo, reinicie o hub e tente novamente.

Atividade prática

1. Altere a velocidade do motor de 300 para 600 e observe a diferença.
2. Mude a rotação de 360 para 720 (duas voltas completas).
3. Crie uma sequência com três movimentos: frente, trás e novamente frente, usando tempos diferentes.

Desafio bônus

Faça o motor girar para frente, parar por dois segundos e depois girar para trás duas vezes mais rápido.
Dica: use o comando wait(2000) para criar uma pausa de 2 segundos.

Na próxima aula, vamos conhecer os sensores e aprender como usá-los para tornar o robô mais inteligente e preciso.