Un juego de snake en dos matrices LED de 8x8
Avanzado
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las placas
Snake es el juego de los celulares antiguos: una línea de puntos recorre la pantalla, come una manzana, crece y muere cuando choca contra una pared o contra sí misma. Es un paso más allá de Simon, porque necesita una imagen en movimiento, una dirección, un cuerpo que crece y lectura de la entrada entre cuadros.
El circuito de arriba lo juega en un Arduino Uno con dos módulos de matriz LED 8x8 MAX7219, uno encima del otro, para un campo de ocho puntos de ancho por dieciséis de alto. Un joystick lo dirige. Presiona Ejecutar y la serpiente espera, con tres puntos de largo y una manzana en algún lugar del campo. Empuja la palanca, o prísala, y la serpiente arranca. Si la dejas sola, se mete derecha en la pared de abajo en unos tres segundos y medio; el monitor serie dice "bitten". Presiona el joystick para volver a jugar.
Lo que necesitas
- Un Arduino Uno
- Dos módulos de matriz LED 8x8 MAX7219
- Un módulo de joystick (dos potenciómetros y un botón pulsador)
- Una protoboard y cables jumper
Cableado
| Componente y pin | Va a | Nota |
|---|---|---|
| DIN de ambas matrices | Pin 11 | Datos compartidos |
| CLK de ambas matrices | Pin 13 | Reloj compartido |
| CS de la matriz superior | Pin 10 | Cada módulo tiene su propio chip select |
| CS de la matriz inferior | Pin 9 | |
| VCC y GND de las matrices | 5 V y GND | El MAX7219 necesita 4 V o más |
| VRX del joystick | A0 | Izquierda y derecha |
| VRY del joystick | A1 | Arriba y abajo |
| SW del joystick | Pin 2 | Presiona para empezar o reiniciar |
| VCC y GND del joystick | 5 V y GND |
La pantalla
Un MAX7219 guarda ocho bytes, uno por fila de la matriz, y los explora por su cuenta, así que el Uno solo escribe un byte cuando algo cambia. Los dos módulos comparten datos y reloj, y cada uno tiene su propio chip select. Todo lo que el Uno envía mientras un pin CS está en bajo va solo a ese módulo.
Eso cuesta un pin más que encadenar los módulos (DOUT de uno a DIN del siguiente, como lo hace el juego de torres), y aquí se compensa: un paso de la serpiente cambia dos puntos, la cabeza nueva y la cola vieja, normalmente en la misma mitad. Con un select cada uno, un paso reescribe un módulo y deja el otro en paz.
El ejemplo usa mokxi_max7219.h, un controlador pequeño que viene con Mokxi: setPixel(), clear() y show(). En una placa real la opción habitual es la biblioteca LedControl del Gestor de bibliotecas, que Mokxi también tiene como LedControl.h, con setLed(module, row, col, state) haciendo el mismo trabajo que setPixel().
El cuerpo, la manzana y las paredes
The snake is a ring buffer: an array of 128 cell numbers, one per dot on the field, with an index for the head. A cell number is row times 8 plus column. Each step works out the next cell from the heading, writes it at the head, and lights it. If the snake did not just eat, it also turns off the tail cell, so the snake moves without being redrawn. Two dots change per step, and the other 126 are left as they are.
Comer es una comparación: si la celda de la cabeza nueva es la celda de la manzana, el largo aumenta en uno, el tiempo del paso baja 8 ms (desde 240 ms, hasta quedar por debajo de 90) y se coloca una manzana nueva en una celda libre. Morir son dos verificaciones: la celda nueva está fuera del campo, o ya es parte del cuerpo. Aquí las paredes son paredes, no hay vuelta por el otro lado, así que puedes perder.
La posición de la manzana viene de un generador de números aleatorios diminuto (un LFSR de 16 bits). Su estado se mezcla con millis() cuando el jugador reinicia, así que cada partida es distinta.
Dirigir con un joystick
Un joystick reporta una posición, dos números de 0 a 1023, pero una serpiente necesita una dirección. Así que el sketch lee el joystick como un empuje: gana el eje que esté más lejos del centro, y solo si pasa de 160 cuentas más allá de la zona muerta. Si sueltas, la palanca regresa sola y la serpiente sigue.
Un giro directo hacia el cuello de la propia serpiente se rechaza. Sin esa regla, un movimiento rápido de abajo hacia arriba terminaría el juego en el acto.
El joystick se lee cada pocos milisegundos entre pasos, no solo una vez por paso. Si no, se perdería un movimiento que empieza y termina dentro de un solo paso de 240 ms.
static void steer() {
int16_t x = stick.dx();
int16_t y = stick.dy();
int8_t wantX = 0, wantY = 0;
int16_t ax = x < 0 ? -x : x;
int16_t ay = y < 0 ? -y : y;
if (ax > ay) {
if (ax > THROW) wantX = x > 0 ? 1 : -1;
} else if (ay > THROW) {
wantY = y > 0 ? 1 : -1;
}
if (wantX == 0 && wantY == 0) return;
waiting = false; // the first push starts the game
if (wantX != 0 && dx != 0) return; // no reversing into the neck
if (wantY != 0 && dy != 0) return;
dx = wantX;
dy = wantY;
}Errores comunes
La mitad del campo queda apagada. Normalmente el cable CS de ese módulo está flojo o en el pin equivocado, o su VCC está en 3.3 V. El MAX7219 necesita 4 V o más.
La serpiente gira sola en cuanto empieza el juego. Un joystick real no descansa exactamente en 512, así que compara contra la posición de reposo leída al encender, no contra 512, y agrega una zona muerta. Leer dos pines analógicos seguidos en un Uno tiene una segunda trampa: la primera lectura después de cambiar de canal puede traer el valor del canal anterior, así que descártala.
El juego termina antes de que lo toques. En un campo de dieciséis filas de alto, una serpiente que avanza cada 240 ms llega a la pared en unos tres segundos. Por eso el sketch espera el primer empuje.
Usar delay() para el tiempo del paso. Un delay de 240 ms significa que el joystick no se lee durante 240 ms. Usa millis() y lee el joystick entre pasos.
Un arreglo del cuerpo demasiado pequeño. Dimensiónalo para todo el campo, 128 celdas, para que una serpiente larga nunca escriba más allá del final.
Abre este circuito en el editor. Arduino Uno: snake en dos matrices LED, cableado tal como corre en la parte superior de esta página. Cambia un componente o un valor y vuelve a ejecutarlo.
Abrir el circuitoPreguntas
¿Cómo hago un juego de snake en una matriz LED de 8x8 con Arduino?
Maneja la matriz con un MAX7219 y LedControl, guarda la serpiente como un arreglo de celdas, mueve la cabeza una celda por paso, apaga la cola salvo que la serpiente acaba de comer, y termina el juego cuando la cabeza sale de la cuadrícula o cae sobre el cuerpo.
¿Puedo jugar snake en una sola matriz de 8x8?
Sí. Cambia el campo a 8 filas y quita el segundo módulo. Es un juego corto en 64 puntos, por eso este usa dos módulos para 128.
¿Puedo usar una OLED o una TFT en su lugar?
Sí. La lógica es la misma; solo cambian las llamadas de dibujo. Mokxi también tiene una versión TFT, en una ILI9341 de 240x320, enlazada debajo de esta página.
¿Puedo usar botones en lugar de un joystick?
Sí. Cuatro botones en pines INPUT_PULLUP, cada uno fijando dx y dy, con la misma verificación de no invertir la dirección.
Sigue así
Á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.