Desbravando o PyBricks: Programando o SPIKE Prime em Python do Zero
Aula

Objetivo da aula

  • Aprender a instalar o PyBricks no hub LEGO® SPIKE Prime.
  • Compreender o que é o firmware e por que ele precisa ser atualizado.
  • Conectar o hub ao navegador para programar em Python.
  • Conhecer a interface do ambiente PyBricks.

O que é o firmware do PyBricks?

O firmware é o sistema interno do hub LEGO®, responsável por controlar motores, sensores e comunicações.
Para que ele possa executar programas em Python, é necessário substituir o firmware original da LEGO® pelo firmware do PyBricks.

Esse processo é seguro e reversível — ou seja, você pode voltar ao software original da LEGO® a qualquer momento.
Depois de instalado, o hub passa a reconhecer e executar programas escritos em Python diretamente, sem precisar do aplicativo oficial.

Passo a passo para instalar o PyBricks

  1. Acesse o site: abra o navegador (de preferência, o Google Chrome) e entre em
    www.pybricks.com.
  2. Abra o editor: no menu principal, clique em “Start coding” ou acesse diretamente o editor em code.pybricks.com.
  3. Conecte o hub: ligue o seu SPIKE Prime e conecte-o ao computador com um cabo USB (ou, se disponível, via Bluetooth).
  4. Autorize a conexão: o navegador vai pedir permissão para acessar o dispositivo USB. Clique em “Permitir”.
  5. Instale o firmware: o editor mostrará a opção de instalar o PyBricks Firmware. Clique em “Install PyBricks Firmware” e aguarde o processo.

Quando a instalação for concluída, o hub reiniciará automaticamente.
A luz do botão principal piscará, indicando que ele está pronto para receber programas do PyBricks.

Reconhecendo o ambiente PyBricks

O ambiente do PyBricks é simples e direto. Ele é dividido em três partes principais:

  • Área de código: é onde você escreve o programa em Python.
  • Menu lateral: contém botões para criar, salvar e enviar programas para o hub.
  • Console: exibe mensagens e erros de execução, ajudando na depuração do código.

Configurações básicas

Antes de começar a programar, é importante verificar as seguintes configurações:

  • Certifique-se de que o hub está com carga suficiente na bateria.
  • Conecte o hub apenas a um dispositivo por vez (evite Bluetooth e USB simultâneos).
  • Use sempre o mesmo navegador e cabo para evitar falhas de comunicação.
  • Se o hub não for reconhecido, desligue-o, reconecte e aguarde alguns segundos.

Interface do editor PyBricks

O editor possui um visual limpo, desenvolvido especialmente para estudantes e equipes de robótica.
Abaixo, um resumo das principais opções:

Elemento Função
Botão Connect Usado para conectar o hub ao computador via USB ou Bluetooth.
Botão Run Envia e executa o programa Python no hub.
Botão Stop Interrompe a execução do programa.
Botão Save Permite salvar o arquivo .py no computador.
Console Mostra mensagens e erros de execução do código.

Verificação final

Para confirmar que o hub está pronto, veja se:

  • A luz do botão acende normalmente quando ligado.
  • O navegador reconhece o hub como dispositivo conectado.
  • O botão Connect do PyBricks fica ativo (em azul).

Problemas comuns

  • O hub não aparece na lista de dispositivos: troque o cabo USB ou tente outra porta do computador.
  • Erro de instalação: verifique se o navegador está atualizado.
  • Hub desconecta sozinho: recarregue a bateria e mantenha o cabo firme.