Aulas e o jogo de aprendizado

Jogos em MicroPython em uma telinha

Construa jogos espaciais em MicroPython num Raspberry Pi Pico com um OLED, dois botões e um piezo, do primeiro pixel a uma cobra espacial.

Comece o curso. É um curso para iniciantes: se você consegue digitar uma linha de Python, você consegue acompanhar.

O console

Toda aula usa o mesmo consolezinho, então a ligação nunca muda:

  • Um Raspberry Pi Pico rodando o firmware oficial do MicroPython.
  • Um SSD1306 OLED de 128 x 64 no I2C0: SDA no GP4, SCL no GP5.
  • Botão A no GP15 e botão B no GP14, cada um ligado ao terra, lidos com os pull-ups da Pico.
  • Um piezo no GP16, acionado por PWM.

O driver, ssd1306.py da micropython-lib, fica numa aba ao lado de main.py, do jeito que o Thonny o copia para uma Pico de verdade.

Aula por aula

  1. Desenhando num OLED. Pixels, linhas, retângulos, texto e círculos, e por que nada aparece até o show(). O programa conta seus próprios pixels acesos, então você pode prever um número e conferir.
  2. Movendo um ponto. O laço do jogo: limpar, desenhar, mostrar, mover. Faça uma nave quicar nas paredes, preveja o quadro em que ela vira e meça seus quadros por segundo (a transferência I2C é o limite).
  3. Reading buttons. Pull-ups and why pressed reads 0, held versus tapped, edge detection, and the 3 ms of contact bounce that reading once a frame steps over.
  4. Uma pontuação. Colisões de retângulos em uma linha, uma pontuação desenhada com formatação %, e um fim de jogo após três erros.
  5. Inimigos aleatórios. Um campo de asteroides feito de listas, random.randint, sementes para jogos repetíveis, três vidas e níveis que aceleram.
  6. Som. Tons por PWM num piezo: uma musiquinha de início, um som de queda na colisão, a nota mais grave que o PWM do RP2040 consegue fazer, e uma melodia guardada como uma lista de pares.
  7. Projeto: snake. Tudo de uma vez.

O gran finale: snake espacial

A tela se torna uma grade de 32 x 16. A cobra é uma lista de células, começando pela cabeça: cada movimento insere uma cabeça e remove a cauda, a não ser que ela acabe de comer. O botão A vira para a esquerda e o B para a direita, a cobra acelera conforme cresce, a comida nunca cai dentro dela e, no último passo, as bordas te levam para o outro lado, como em Asteroids. Depois você adiciona um recurso próprio.

Como o motor do Pico é diferente

O Pico no canvas inicializa o firmware real do MicroPython v1.29 em um RP2040 simulado, então o código é exatamente o que você rodaria numa placa de verdade. Alguns pontos importantes:

  • O tempo é real. Um oled.show() completo leva cerca de 26 ms a 400 kHz, então as taxas de quadros correspondem às de um console real.
  • Os botões oscilam. Como chaves reais, os botões de pressão vibram por alguns milissegundos. Os jogos os leem uma vez por quadro, o que disfarça o efeito.
  • O aleatório é repetível. As aulas definem a semente do random para que toda execução seja igual. Sem semente, o MicroPython gera a própria semente a partir do chip.
  • Um núcleo. O simulador roda um núcleo do RP2040, então _thread não está disponível. Esses jogos nunca precisam dele.

Para onde ir agora

Concorrência: tarefas, disputas e async leva o mesmo Pico mais longe: interrupções, asyncio e filas. MicroPython no Pico cobre os outros componentes da placa: o ADC, fades de PWM e sensores.