Lecciones y el juego de aprendizaje

Juegos de MicroPython en una pantalla diminuta

Construye juegos espaciales en MicroPython en una Raspberry Pi Pico con una OLED, dos botones y un piezo, desde un primer píxel hasta una serpiente espacial.

Empieza el curso. Es un curso para principiantes: si puedes escribir una línea de Python, puedes seguirlo.

La consola

Todas las lecciones usan la misma consola pequeña, así que el cableado nunca cambia:

  • Una Raspberry Pi Pico con el firmware oficial de MicroPython.
  • Una SSD1306 OLED de 128 x 64 en I2C0: SDA en GP4, SCL en GP5.
  • Botón A en GP15 y botón B en GP14, cada uno a tierra, leídos con las pull-up de la Pico.
  • Un piezo en GP16, controlado por PWM.

El controlador, ssd1306.py de micropython-lib, está en una pestaña junto a main.py, tal como Thonny lo copia a una Pico real.

Lección por lección

  1. Dibujar en una OLED. Píxeles, líneas, rectángulos, texto y círculos, y por qué no aparece nada hasta el show(). El programa cuenta sus propios píxeles encendidos, para que puedas predecir un número y comprobarlo.
  2. Mover un punto. El bucle de juego: limpiar, dibujar, mostrar, mover. Haz rebotar una nave contra las paredes, predice el cuadro en que da la vuelta y mide tus cuadros por segundo (la transferencia I2C es el límite).
  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. Un puntaje. Colisiones de rectángulos en una línea, un puntaje dibujado con formato %, y un game over tras tres fallos.
  5. Enemigos al azar. Un campo de asteroides hecho de listas, random.randint, semillas para juegos repetibles, tres vidas y niveles que aceleran.
  6. Sonido. Tonos por PWM en un piezo: un jingle de inicio, un sonido de choque descendente, la nota más grave que puede producir el PWM del RP2040, y una melodía guardada como lista de pares.
  7. Proyecto: snake. Todo junto.

El final: snake espacial

La pantalla se convierte en una cuadrícula de 32 x 16. La serpiente es una lista de celdas, la cabeza primero: cada movimiento inserta una cabeza y saca la cola, salvo que acabe de comer. El botón A gira a la izquierda y el B a la derecha, la serpiente acelera al crecer, la comida nunca cae dentro de ella y, en el último paso, los bordes te teletransportan al otro lado, como en Asteroids. Luego agregas una función propia.

En qué difiere el motor de la Pico

La Pico del lienzo arranca el firmware real de MicroPython v1.29 sobre un RP2040 simulado, así que el código es exactamente lo que ejecutarías en una placa real. Algunas cosas que debes saber:

  • El tiempo es real. Un oled.show() completo tarda unos 26 ms a 400 kHz, así que las tasas de cuadros coinciden con una consola real.
  • Los botones rebotan. Como los interruptores reales, los pulsadores vibran unos milisegundos. Los juegos los leen una vez por cuadro, lo que lo disimula.
  • El azar es repetible. Las lecciones siembran random para que cada ejecución sea igual. Sin semilla, MicroPython se siembra a sí mismo desde el chip.
  • Un solo núcleo. El simulador ejecuta un núcleo del RP2040, así que _thread no está disponible. Estos juegos nunca lo necesitan.

Qué sigue

Concurrencia: tareas, carreras y async lleva la misma Pico más lejos: interrupciones, asyncio y colas. MicroPython en la Pico cubre los demás componentes de la placa: el ADC, fundidos por PWM y sensores.