Una matriz de LEDs MAX7219 con Arduino, con una pelota rebotando en ella
Intermedio
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las placas
Sesenta y cuatro LEDs necesitarían sesenta y cuatro pines si los conectaras uno por uno, y un Arduino Uno tiene veinte. El MAX7219 es el chip que resuelve eso: va en la parte trasera de los módulos baratos de matriz roja de 8x8, recibe tres cables de la placa y hace el barrido de los sesenta y cuatro LEDs por sí mismo. El circuito de arriba es un Uno que rebota un punto de dos por dos en una de esas matrices, funcionando en tu navegador con el mismo sketch que puedes leer abajo.
Cada vez que la pelota toca una pared, todo ese borde se enciende durante un cuadro y el brillo sube, así que un rebote es algo que puedes ver y no algo que debas creer a ciegas. Ábrelo en el editor y puedes cambiar la velocidad, el tamaño de la pelota o lo que dibuja.
Lo que necesitas
- Un Arduino Uno
- Un módulo de matriz de LEDs de 8x8 con un MAX7219 en la parte trasera (el tipo rojo común)
- Cinco cables dupont, de hembra a macho si el módulo tiene pines de header
- Una protoboard para los rieles de alimentación (opcional)
Cableado
| Componente y pin | Va a | Nota |
|---|---|---|
| VCC del módulo | 5 V | El MAX7219 necesita de 4 a 5.5 volts, así que usa 5 V, no 3.3 V |
| GND del módulo | GND | Compartida con la placa |
| DIN del módulo | Pin 11 | Entrada de datos serie |
| CS del módulo | Pin 10 | Marcado LOAD en algunos módulos; su flanco de subida guarda un paquete |
| CLK del módulo | Pin 13 | El reloj de corrimiento |
| DOUT del módulo | DIN del siguiente módulo | Solo se usa cuando conectas una segunda matriz en cadena |
Cómo dibuja una imagen el MAX7219
El chip guarda ocho registros de ocho bits cada uno, un registro por fila de la matriz. Un bit en 1 es un LED encendido y un bit en 0 es uno apagado, con el bit 7 como la columna más a la izquierda. Así que toda la imagen son ocho bytes, y cambiar una fila de la pantalla es escribir un byte en un registro. El chip luego enciende las filas una por una, tan rápido que tu ojo ve las ocho a la vez.
Para comunicarte con él se usa un paquete de dieciséis bits: pon CS en bajo, envía por reloj una dirección de registro y un byte de datos por DIN y CLK, y sube CS. El flanco de subida de CS es lo que hace que el chip actúe sobre el paquete. Los registros 1 a 8 son las filas; los demás ajustan el brillo (dieciséis niveles), cuántas filas barrer, si decodifica dígitos y si el chip está apagado.
Ese último punto le pasa a todo el mundo una vez. Al encender, todos los registros están en cero, lo que significa apagado, una fila barrida y brillo mínimo. Una matriz que se queda a oscuras casi siempre es un sketch que nunca escribió los registros Shutdown, Scan Limit e Intensity. La llamada a begin() en el sketch hace exactamente eso.
El sketch, cuadro por cuadro
El driver mantiene los ocho bytes de filas en la RAM del Uno. El loop mueve la pelota un píxel, la hace rebotar en cualquier pared que haya alcanzado, limpia el búfer, dibuja la pelota con fillRect, dibuja una línea a lo largo de cualquier pared que se haya golpeado y llama a show(), que envía las ocho filas al chip. Luego espera 90 milisegundos, así que la pelota se mueve unas once veces por segundo.
Mantener la imagen en RAM y enviarla toda de una vez es el patrón que usa toda biblioteca de matrices. Significa que dibujar es solo poner bits en un arreglo, y la parte lenta, la transferencia serie, ocurre una vez por cuadro en lugar de una vez por píxel.
matrix.clear();
if (flash & 0x01) matrix.fillRect(0, 0, 8, 1, true); // top wall
if (flash & 0x02) matrix.fillRect(7, 0, 1, 8, true); // right wall
if (flash & 0x04) matrix.fillRect(0, 7, 8, 1, true); // bottom wall
if (flash & 0x08) matrix.fillRect(0, 0, 1, 8, true); // left wall
matrix.fillRect(x, y, BALL, BALL, true);
matrix.show();
// A bounce is also a flicker of brightness, which costs one packet.
matrix.setIntensity(flash ? 15 : 8);
delay(FRAME_MS);El archivo auxiliar, y la biblioteca que usarías en un Uno real
El ejemplo incluye mokxi_max7219.h, un driver pequeño que viene con Mokxi: Max7219 matrix(DIN, CS, CLK, blocks), luego begin(), setPixel(), fillRect(), text() y show(). En una placa real la elección habitual es la biblioteca LedControl del Gestor de bibliotecas de Arduino, que Mokxi también incluye como LedControl.h, o MD_MAX72XX para texto en movimiento en varios módulos.
Con LedControl la misma configuración es LedControl lc(11, 13, 10, 1), luego lc.shutdown(0, false), lc.setIntensity(0, 8) y lc.clearDisplay(0) en setup(), y lc.setLed(0, row, column, true) o lc.setRow(0, row, value) para dibujar. Fíjate en el orden de los pines: LedControl recibe datos, reloj y luego CS, mientras que el driver de Mokxi recibe datos, CS y luego reloj. Confundir ese orden es la razón más común de que un primer sketch de matriz no muestre nada.
Los pines 11 y 13 son también los pines del SPI por hardware del Uno (MOSI y SCK), y por eso la mayoría de los diagramas de cableado los usa. Una biblioteca que usa SPI por hardware necesita DIN en el 11 y CLK en el 13; CS puede ser cualquier pin.
Pruébalo en el editor
Cambia FRAME_MS de 90 a 30 y la pelota acelera. Cambia BALL a 1 y se convierte en un solo píxel que puede llegar a todas las casillas.
Reemplaza la pelota con texto: matrix.text(0, 0, "A") dibuja una letra con la fuente 5x7 integrada. Luego prueba una carita feliz como ocho bytes, uno por fila, escritos con setPixel en dos ciclos.
Pon la propiedad count del módulo en 4 y el último argumento del constructor en 4, y el mismo código tiene un letrero de 32 por 8 para trabajar, que es lo que son los módulos cuatro en uno que se venden para texto en movimiento.
Dónde comprar los componentes
El módulo de matriz roja ya armado con el MAX7219 en la parte trasera se vende bajo muchas marcas genéricas, usualmente en paquetes, en los grandes mercados en línea. Si prefieres armarlo tú, Adafruit vende el chip MAX7219CNG por separado y una matriz roja miniatura de 8x8 que hace juego con él. SparkFun y DigiKey también manejan matrices de LEDs y chips controladores; busca MAX7219 en sus catálogos. Los enlaces a las páginas de Adafruit están en las fuentes de abajo. Estas son tiendas de EE. UU., mencionadas como ejemplos. Los precios y la disponibilidad varían por país, así que fuera de EE. UU. busca el mismo nombre de componente en una tienda de electrónica local o en una tienda en línea que envíe a tu país.
Errores comunes
Una matriz oscura después de cargar el sketch. El chip arranca apagado y con el brillo al mínimo. Asegúrate de que tu setup escriba Shutdown en apagado, un límite de barrido de 7 y una intensidad.
La imagen sale en espejo o girada. Los módulos se fabrican en distintas orientaciones. Voltea la coordenada x o y en tu código en lugar de recablear.
CS y CLK intercambiados. El orden de los pines en el constructor cambia entre bibliotecas, como se explicó arriba.
Alimentar varios módulos desde el pin de 5 V del Uno. Un módulo con brillo moderado no da problema; una cadena de cuatro con muchos LEDs encendidos puede consumir más de lo que el regulador de la placa o un puerto USB deberían suministrar. Dale a una cadena larga su propia fuente de 5 V con una tierra compartida.
Abre este circuito en el editor. Arduino Uno: pelota en matriz con un MAX7219, cableado como se ejecuta en la parte superior de esta página. Cambia un componente o un valor y ejecútalo de nuevo.
Abrir el circuitoPreguntas
¿Cuántos pines necesita una matriz MAX7219 en un Arduino?
Tres pines de señal (DIN, CS y CLK) más 5 V y tierra. Se pueden conectar más módulos en cadena con los mismos tres pines, del DOUT de uno al DIN del siguiente.
¿Qué biblioteca debo usar para un MAX7219 en un Arduino real?
LedControl es la más sencilla para píxeles individuales y filas. MD_MAX72XX, con MD_Parola encima, es la opción habitual para texto en desplazamiento en varios módulos. Mokxi usa su propio header pequeño, mokxi_max7219.h, y también incluye LedControl.h.
¿Mokxi muestra la multiplexión del MAX7219?
No. Un chip real enciende una fila a la vez a unos 800 Hz; el modelo muestra todas las filas habilitadas a la vez, y la intensidad es un brillo en lugar de una corriente. Los registros, el estado de encendido y el encadenamiento son los del chip.
Sigue así
De dónde vienen los datos de esta página
Á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.