Objetivo da aula

• Compreender a estrutura básica de um programa em Python.
• Entender como o PyBricks organiza o código e interpreta os comandos.
• Aprender a sequência lógica de execução de um programa no hub LEGO® SPIKE Prime.
• Reconhecer as partes fundamentais de um código em PyBricks.

O que é um programa em Python?

Um programa em Python é um conjunto de instruções escritas em texto que dizem ao computador (ou ao robô, no nosso caso) o que fazer.
O PyBricks lê cada linha do código e executa os comandos na ordem em que foram escritos, de cima para baixo.

Essa sequência é chamada de fluxo de execução.
Aprender a organizar esse fluxo corretamente é o primeiro passo para dominar a programação em Python.

As três partes principais de um programa em PyBricks

Todo programa, por mais simples que seja, segue uma estrutura básica dividida em três partes:

1. Importações – onde o Python é informado sobre quais bibliotecas e funções serão utilizadas.
2. Inicializações – onde o programador define quais dispositivos estão conectados ao hub (motores, sensores, luzes, etc.).
3. Execução – onde o robô realmente realiza as ações planejadas (movimentos, medições, decisões).

Exemplo de estrutura básica

Abaixo temos um exemplo simples de código com as três partes identificadas:

# ---------------------------
# 1. Importações
# ---------------------------
from pybricks.hubs import PrimeHub
from pybricks.pupdevices import Motor
from pybricks.parameters import Port
from pybricks.tools import wait

# ---------------------------
# 2. Inicializações
# ---------------------------
hub = PrimeHub()               # Cria a comunicação com o hub
motor_esquerdo = Motor(Port.A) # Define o motor da porta A
motor_direito = Motor(Port.B)  # Define o motor da porta B

# ---------------------------
# 3. Execução
# ---------------------------
motor_esquerdo.run_angle(300, 360)
motor_direito.run_angle(300, 360)
wait(1000)
hub.speaker.beep()

Entendendo cada parte

1. Importações

As importações dizem ao Python quais módulos do PyBricks serão usados no programa.
Pense nisso como “ferramentas” que você carrega antes de começar o trabalho.

Cada módulo tem uma função:

• pybricks.hubs – controla o hub e suas luzes, sons e sensores internos.
• pybricks.pupdevices – permite o uso de motores e sensores conectados.
• pybricks.parameters – contém constantes como portas, cores e direções.
• pybricks.tools – traz funções auxiliares, como o wait() (pausa o programa).

2. Inicializações

Nessa parte, o programador define quais dispositivos estão conectados ao hub e cria objetos para controlá-los.
Cada dispositivo precisa ser declarado uma vez no início do código.

Exemplo:

hub = PrimeHub()
motorA = Motor(Port.A)
sensor_cor = ColorSensor(Port.C)

Esses comandos criam as “conexões” entre o código e o hardware do robô.

3. Execução

É o momento em que o robô realiza as ações definidas.
Aqui entram os comandos de movimento, leitura de sensores e tomadas de decisão.

O Python lê o código linha por linha, executando tudo na sequência.
Se um comando depende do outro, é importante respeitar a ordem correta.

Fluxo de execução

Podemos visualizar o fluxo de um programa em três etapas:

Erros comuns de iniciantes

• Esquecer uma importação: se o módulo não for carregado, o comando não funcionará.
• Errar a indentação: o Python exige que blocos de código tenham o mesmo recuo.
• Inverter a ordem: declarar um motor depois de usá-lo causa erro, pois o Python ainda não “conhece” esse objeto.

Atividade prática

1. Crie um novo arquivo no PyBricks com o nome estrutura_basica.py.
2. Escreva um código com as três partes (importações, inicializações e execução).
3. Faça o robô girar uma volta completa e emitir um som ao final.
4. Adicione comentários explicando o que cada parte do código faz.