Aprender

El juego arcade de apilar en dos matrices de LEDs

Avanzado

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
ESP32-C3: el stacker de arcadeen vivo0.000 s 0.00x
Presiona Ejecutar y luego presiona el botón grande para soltar la fila
The Stacker example: two cascaded MAX7219 matrices for an 8x16 field and one arcade button. Press it to drop the row.

Stacker es la máquina de arcade con la columna alta de luces: una fila se desliza de un lado a otro, presionas el botón para soltarla, y todo lo que sobresalga de la fila de abajo se corta. Cada fila es más angosta y más rápida que la anterior, y si la recortas hasta desaparecer, se acaba el juego. Es el ejemplo más abierto en Mokxi, y es una gran construcción porque toda la máquina es un botón y dos módulos de LED baratos.

El circuito de arriba lo ejecuta en un ESP32-C3 con código de Arduino. Dos módulos de matriz MAX7219 de 8x8 colocados uno sobre otro forman un campo de ocho de ancho por dieciséis de alto. Presiona Ejecutar y un bloque de tres puntos de ancho empieza a deslizarse por la parte de abajo. Presiona el botón grande para soltarlo. Aterriza un bloque en la fila de arriba y ganas: la torre terminada se sostiene, todo el campo se llena del piso hacia arriba y parpadea, y empieza un juego nuevo. Deja el juego quieto cuatro segundos y juega solo, fallando a propósito de vez en cuando, hasta que alguien presione el botón de nuevo.

Lo que necesitas

  • Una placa ESP32-C3 (o un Arduino Uno; ver abajo)
  • Dos módulos de matriz LED 8x8 MAX7219
  • Un botón de arcade de 30 mm, o cualquier botón pulsador
  • Una protoboard y cables jumper

Cableado

Componente y pinVa aNota
DIN de la matriz de arribaGPIO 7Los datos van solo al módulo de arriba
DOUT de la matriz de arribaDIN de la matriz de abajoLa cascada
CLK de ambas matricesGPIO 5Compartido
CS de ambas matricesGPIO 6Un solo chip select para la cadena
VCC y GND de las matricesPin de 5V y GNDNo 3V3: el MAX7219 quiere 4 V o más
Botón arcadeGPIO 3La otra pata a GND, con la pull-up propia del pin

La cascada: dos módulos, tres cables

Cada MAX7219 tiene un registro de corrimiento de 16 bits y un pin DOUT en su extremo. Encadena el DOUT del módulo de arriba al DIN del de abajo y comparte el reloj y el chip select, y los dos actúan como un solo registro de 32 bits. Envía 32 bits con CS en bajo y los primeros 16 bits que enviaste terminan en el segundo chip. Un flanco de subida de CS los engancha a los dos a la vez.

Así que cada escritura es un par: primero el paquete del módulo de abajo, porque es el que más lejos tiene que viajar, y luego el del módulo de arriba. Eso es todo lo que hace write_chain(). Cuesta un pin menos que un chip select por módulo, y es así como están cableadas por dentro las placas baratas de matriz cuatro en uno.

El sketch maneja los chips con sus propias funciones cortas en lugar de una biblioteca, así que la cascada está a la vista: un paquete son cuatro bits sin usar, una dirección de registro de cuatro bits y un byte de datos, enviados empezando por el bit más significativo. En una placa real LedControl hace lo mismo con LedControl lc(DIN, CLK, CS, 2).

Un registro en cada módulo, enganchados juntos
static void shift_packet(uint8_t address, uint8_t data) {
  uint16_t packet = ((uint16_t)(address & 0x0f) << 8) | data;
  for (int8_t bit = 15; bit >= 0; bit--) {
    digitalWrite(CLK_PIN, LOW);
    digitalWrite(DIN_PIN, (packet >> bit) & 1u ? HIGH : LOW);
    digitalWrite(CLK_PIN, HIGH);
  }
}

static void write_chain(uint8_t address, uint8_t bottom, uint8_t top) {
  digitalWrite(CS_PIN, LOW);
  shift_packet(address, bottom);  // pushed through the top chip
  shift_packet(address, top);
  digitalWrite(CS_PIN, HIGH);     // both latch here
}

Cómo se juega en el código

La pila son dieciséis bytes, uno por nivel, con un bit por columna. Soltar el bloque es un solo AND: las columnas del bloque con AND la fila de abajo. Lo que sobrevive es la nueva fila, y su ancho es el nuevo ancho del bloque. Si no sobrevive nada, se acaba el juego. El piso atrapa todo, así que la primera caída siempre aterriza.

El bloque empieza con tres de ancho. Desde el nivel 7, la fila de arriba del módulo de abajo, mide a lo más dos de ancho, y en los tres niveles de arriba mide uno. El tiempo de paso baja con la altura, de 210 ms por columna abajo a 70 ms arriba, calculado como 210 menos 140 por el nivel entre 15.

El botón cuenta su flanco: el sketch recuerda si estaba presionado la última vez, así que mantenerlo presionado suelta un bloque, no uno por cada ciclo. Entre pasos el sketch duerme 2 ms a la vez, lo que aun así lee el botón 500 veces por segundo.

En un Arduino Uno

Nada en el sketch es exclusivo del ESP32: usa digitalWrite, digitalRead, millis, delay y random. Para ejecutarlo en un Uno, cambia los cuatro números de pin (por ejemplo DIN 11, CLK 13, CS 10 y el botón en 2) y alimenta los módulos desde los 5 V del Uno. Ábrelo en el editor, cambia la placa y reconecta.

Errores comunes

La mitad de abajo queda apagada. Falta el cable de cascada del DOUT del módulo de arriba al DIN del módulo de abajo, o está en el pin equivocado. Quítalo en el circuito de arriba y el bloque, que empieza abajo, desaparece; la mitad de arriba sigue funcionando, como verás cuando la pila suba hacia ella.

Las mitades están intercambiadas o muestran la imagen de la otra. Los paquetes están en el orden equivocado. El primero que se envía aterriza en el módulo más lejano.

No enciende nada. Un MAX7219 arranca apagado, escaneando una fila, con brillo en cero. El sketch escribe shutdown, scan limit, decode mode e intensity al inicio; si omites cualquiera de ellos, el panel queda oscuro.

Alimentar los módulos con 3.3 V. Necesitan 4 V o más, así que usa el pin de 5V de la placa.

El botón suelta todos los bloques mientras se mantiene presionado. Cuenta el cambio de arriba a abajo, no el nivel.

Abre este circuito en el editor. ESP32-C3: el stacker de arcade, cableado tal como se ejecuta arriba en esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Abrir el circuito

Preguntas

¿Cómo hago un juego de stacker con Arduino?

Usa dos matrices MAX7219 de 8x8 encadenadas para un campo de 8x16 y un botón. Guarda un byte por fila, desliza el bloque con millis() y, cuando se presione el botón, aplica AND entre el bloque y la fila de abajo. Lo que quede es la nueva fila.

¿Puedo hacerlo con una sola matriz de 8x8?

Sí, con ocho niveles en lugar de dieciséis. Pon LEVELS en 8, baja los niveles de estrechamiento y quita el segundo paquete de cada escritura.

¿Por qué el juego juega solo?

Después de cuatro segundos sin presionar entra en modo de atracción, como una máquina de arcade: apunta a la fila de abajo y de vez en cuando falla por una columna a propósito. Una presionada real devuelve el juego.

¿Puedo usar una tira de LEDs WS2812?

Sí. Una rejilla de LEDs WS2812 de 16x8 funciona igual con la biblioteca Adafruit NeoPixel. La lógica del juego no cambia, solo el dibujado.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.