Lecciones y el juego de aprendizaje

Escribe un emulador de CHIP-8

Construye el clásico primer emulador en C++ en una consola portátil ESP32-C3: memoria, fetch y decode, sprites con XOR, teclas, temporizadores y un juego original de 151 bytes.

Cómo funciona

Escribe un emulador de CHIP-8 es un curso avanzado de Programación en siete lecciones. CHIP-8 es una computadora de 1977 que solo existió como software, con 35 instrucciones, una pantalla de 64 por 32 y un teclado de 16 teclas, lo que lo convierte en el emulador que todos escriben primero.

Cada lección corre en la consola portátil: una ESP32-C3, un panel ILI9341 que muestra la pantalla del CHIP-8 a tres píxeles del panel por cada uno, los seis botones del mando y un piezo en el GPIO 7. El sketch de cada lección es el emulador de la lección anterior más una parte nueva, y cada uno ejecuta una ROM escrita para este curso, como bytes con su listado en los comentarios.

Las lecciones

  1. La máquina: 4 KB de memoria, dieciséis registros, PC, I y la pila, la fuente hexadecimal en 0x050 y una ROM cargada en 0x200, leída de vuelta byte por byte.
  2. Leer, decodificar y ejecutar: dos bytes, big-endian, cortados en nibbles. Una ROM de cuenta regresiva corre línea por línea, se detiene en una instrucción que el emulador no conoce (70FF) y corre hasta el final cuando la agregas. Luego editas la ROM a mano.
  3. Pantalla: DXYN, la única instrucción de dibujo: sprites dibujados por XOR, colisiones en VF, la fuente como etiquetas y un cohete cuya llama redibujas en hexadecimal.
  4. Keypad: seis botones que hacen el papel de las teclas 2, 8, 4, 6, 5 y 0, pulsaciones nuevas, las instrucciones de saltar si está presionada, FX0A esperando una tecla y una tecla remapeada.
  5. Timers and sound: el temporizador de retardo medido a 60 tics en 1000 ms, un zumbador que sigue al temporizador de sonido y una edición de la ROM para un pitido más largo.
  6. Debugging ROMs: una ROM que escribe BAD en vez de 600D, un desensamblador y un depurador serie con paso a paso, puntos de interrupción y registros que encuentra el nibble equivocado.
  7. Jefe final: juega un juego: el final.

El catálogo lista una ESP32 clásica, un teclado y un zumbador. El curso corre en cambio en la portátil con ESP32-C3: Mokxi no tiene un circuito de teclado para la C3, así que los seis botones de la portátil hacen el papel de las teclas que más usan los juegos, y su piezo es el zumbador.

El gran final

Space Dodge es un juego original de CHIP-8 escrito para este curso, 151 bytes de código máquina. Caen rocas; izquierda y derecha maniobran la nave. Una roca esquivada es un punto y un pitido corto; un golpe es la bandera de colisión XOR, un pitido largo y el puntaje en la esquina gracias a FX33 y la fuente. Lo ejecutas, lo haces fallar a propósito y haces que las rocas caigan más rápido cambiando un byte.

Lo que hace distinto el motor de la C3

  • Los cuadros se ajustan con el reloj. El emulador corre 60 cuadros por segundo, con 12 instrucciones de CHIP-8 cada uno, y duerme entre cuadros, así que una ROM corre a la misma velocidad a la que lo haría en una C3 real.
  • El panel se maneja por bits. El SPI no está modelado, así que el emulador envía solo los píxeles que cambia un sprite, cada uno como un cuadro de 3 por 3. Redibujar toda la pantalla del CHIP-8 costaría mucho más.
  • El sonido es una sola nota. tone() reproduce 440 Hz por el hardware PWM del LED de la C3 mientras corre el temporizador de sonido, que es todo el sonido que CHIP-8 tiene.
  • Las ROM son originales. Cada ROM del curso fue escrita para él. La fuente es el conjunto estándar de dígitos hexadecimales que todo intérprete de CHIP-8 lleva.