MAX7219 FC16 con ESP32: conexiones, lógica 3,3 V y espejo
Conecta una matriz MAX7219 FC16 a un ESP32 con cinco cables, revisa la lógica de 3,3 V y arregla el texto en espejo con el tipo de hardware de MD_MAX72XX.
- Autor
Mauro Brambilla- Publicado
- Tiempo de lectura
- 12 min
- Categoría
- Proyectos

En resumen
Un módulo MAX7219 FC16 se conecta a un ESP32 con cinco cables: 5 V, GND, DIN, CS y CLK. Elige FC16_HW en MD_MAX72XX; si el texto sale en espejo o al revés, el tipo de hardware no coincide con tu placa.
Un módulo FC16 MAX7219 4 en 1 se conecta a un ESP32 con cinco cables: 5 V, GND, DIN, CS y CLK. Lo manejas con la librería MD_MAX72XX y pones el tipo de hardware en FC16_HW. Si el texto aparece en espejo, volteado o en el orden equivocado, el tipo de hardware no coincide con tu placa, y cambiarlo es la solución.
Esta es la referencia concreta detrás del Gizmo Ticker, que mueve una matriz FC16 con una XIAO ESP32-S3. Los pines y las versiones de las librerías salen de su firmware, la tabla de tipos sale del código fuente de MD_MAX72XX y las medidas de las piezas salen de mis notas de componentes. La construcción completa, con el flasheo y la clave de API, está en la guía para construir el crypto ticker.
Un display de criptomonedas con Wi-Fi, construido con un ESP32, una matriz LED MAX7219 y una aplicación web Nuxt 4 para configurarlo desde el navegador.
- Ticker cripto en tiempo real
- Matriz LED MAX7219
- Configuración desde el navegador
¿Qué es un módulo FC16 MAX7219 4 en 1?
El MAX7219 es un chip controlador que enciende hasta 64 LED, una matriz de 8x8, desde un bus serie corto, y se puede encadenar con otros MAX7219 (página del producto en Analog Devices). Un módulo FC16 es la placa común que te encadena cuatro: cuatro matrices rojas de 8x8, cada una con su propio MAX7219, en un solo PCB alargado. La documentación de MD_MAX72XX dice que un FC-16 se reconoce por el "FC-16" impreso en el PCB y que la mayoría de los juegos de cuatro módulos que se venden como una sola pieza son de este tipo (página FC-16).
En el que uso para el ticker, el PCB mide 132 x 32 mm, y los bloques de LED cubren toda la longitud, aunque cuatro bloques de 32 mm sumarían solo 128 mm. Los vendedores no se ponen de acuerdo en la longitud (de 128 a 132 mm), así que mide el tuyo antes de diseñar nada a su alrededor. Los pines rectos sobresalen unos 7 mm en cada extremo. Esas cifras vienen de mis notas de componentes para esta placa, medidas y confirmadas en las impresiones de prueba del ticker.
¿Cómo se conecta un ESP32 a un módulo MAX7219 FC16?
Necesitas los cinco pines del lado de entrada del módulo: VCC, GND, DIN, CS y CLK. La librería los nombra así: DIN es la entrada de datos serie, CLK marca el ritmo de los datos y CS (llamado LD en la documentación de la librería) selecciona toda la cadena, y los datos se capturan cuando vuelve a subir (notas de conexión de la librería). El otro lado de la placa tiene DOUT, que alimenta al siguiente módulo, así que déjalo en paz.

Este es el mapa de pines que usa el Gizmo Ticker. Los números GPIO son los del propio chip, y las etiquetas D son los nombres de los pads de la XIAO, que se explican en la guía del pinout de la XIAO ESP32-S3.
| Entrada FC16 | Pad XIAO ESP32-S3 | GPIO ESP32-S3 | Función |
|---|---|---|---|
| VCC | 5V | ninguno | Alimentación de la matriz |
| GND | GND | ninguno | Masa |
| DIN | D10 | GPIO9 | Salida de datos SPI (MOSI) |
| CS | D9 | GPIO8 | Selección de chip |
| CLK | D8 | GPIO7 | Reloj SPI (SCK) |
Los pads junto a 5V y GND siguen el orden de la entrada del módulo, de modo que un cable plano va en línea recta y el cable de 3V3 queda libre. En cualquier otra placa ESP32, elige tres GPIO libres cualesquiera: la librería tiene un constructor que recibe directamente los pines de datos, reloj y CS, y otro que usa el SPI por hardware de la placa. El SPI por hardware es más rápido, y la propia documentación de la librería describe la versión por software como más lenta.
Este es el código de inicialización real del ticker, de matrix.cpp:
SPI.begin(CLK_PIN, -1, DATA_PIN); // The display only writes: no MISO, so its default pin stays free (MD_MAX72XX then reuses this bus)
matrix = new MD_Parola(HARDWARE_TYPE, CS_PIN, config.matrixModules);
matrix->begin(); // Start the LED matrixImportan dos detalles. El -1 significa "sin MISO", porque la pantalla nunca devuelve nada, y eso libera D9 para que haga de CS. La constante HARDWARE_TYPE es MD_MAX72XX::FC16_HW, definida en config.h. El código fuente de MD_MAX72XX 3.5.1 inicia cada transacción SPI a 8 MHz en modo 0, por debajo del límite de reloj de 10 MHz de la hoja de datos del MAX7219, pero conviene tenerlo presente si tus cables son largos.
Si no usas la XIAO, la misma idea cabe en unas pocas líneas. Este sketch mínimo sigue la configuración del ticker y la API documentada de la librería, con los pines del ticker; no he compilado este sketch exacto, así que tómalo como punto de partida y cambia los tres números de pin por los de tu placa:
#include <MD_Parola.h>
#include <MD_MAX72xx.h>
#include <SPI.h>
constexpr MD_MAX72XX::moduleType_t HARDWARE_TYPE = MD_MAX72XX::FC16_HW;
constexpr uint8_t MODULES = 4; // one 4-in-1 board
constexpr uint8_t CS_PIN = 8;
MD_Parola display(HARDWARE_TYPE, CS_PIN, MODULES);
void setup() {
SPI.begin(7, -1, 9); // SCK, no MISO, MOSI
display.begin();
display.setIntensity(1); // 0-15
display.displayText("HELLO", PA_CENTER, 50, 1000, PA_SCROLL_LEFT, PA_SCROLL_LEFT);
}
void loop() {
if (display.displayAnimate()) display.displayReset();
}Antes de celebrar, alimenta la placa y busca algún texto, el que sea. Una pantalla en blanco con las conexiones correctas es un problema distinto del texto en espejo, y las siguientes secciones los tratan por separado.
¿Funciona la lógica de 3,3 V con una placa MAX7219 de 5 V?
Normalmente sí en la práctica, pero queda fuera de lo que garantiza la hoja de datos. La matriz funciona con 5 V, mientras que los GPIO del ESP32 señalizan a 3,3 V, así que lo que importa es si un nivel alto de 3,3 V cuenta como alto para el MAX7219.
Las cifras, de las fuentes primarias:
| Fuente | Parámetro | Valor | Condiciones |
|---|---|---|---|
| Hoja de datos del MAX7219 | Tensión de entrada lógica alta (VIH), DIN, CLK, CS | 3,5 V mínimo | V+ = 5 V, más o menos 10 % |
| Hoja de datos del MAX7219 | Tensión de entrada lógica baja (VIL) | 0,8 V máximo | V+ = 5 V, más o menos 10 % |
| Hoja de datos del MAX7219 | Tensión de alimentación de operación | de 4,0 a 5,5 V | ninguna |
| Hoja de datos del ESP32-S3 v2.2 | Tensión de salida de nivel alto (VOH) | 0,8 x VDD mínimo, 2,64 V a 3,3 V | VDD = 3,3 V, 25 C |
Ambas vienen de los fabricantes: la hoja de datos del ESP32-S3 de Espressif (tabla 5-4) y la hoja de datos del MAX7219 de Maxim, revisión 4. La página de Analog Devices para ese chip no cargó cuando revisé este artículo, así que leí la misma revisión en una copia alojada por SparkFun; la página del producto en Analog Devices puede mostrar una más reciente.
Así que el nivel alto garantizado del ESP32-S3 (2,64 V) queda por debajo del mínimo garantizado del MAX7219 (3,5 V). Las hojas de datos no prometen que esto funcione. Lo que hace el Gizmo Ticker se ve claro en su repositorio: DIN, CS y CLK van directamente de los pines de 3,3 V de la XIAO a la matriz, que cuelga del pad 5V, sin adaptador de nivel. El README documenta las conexiones y no ofrece un análisis de márgenes, y no afirmo ninguna prueba más allá de eso. Los chips reales suelen conmutar por debajo del nivel garantizado, pero no puedes contar con ello con otro lote, un cable largo o una alimentación ruidosa.
Si ves basura, parpadeo o píxeles aleatorios, pon un adaptador de nivel en las tres líneas de señal (DIN, CS, CLK). Solo necesita funcionar en un sentido, porque la pantalla nunca habla de vuelta. El riesgo contrario no existe en este cableado: las entradas del ESP32-S3 toleran como máximo VDD más 0,3 V, pero ningún cable lleva datos de la matriz al ESP32. La misma duda aparece con una placa I2C de 5 V en ESP32 con LCD I2C 16x2 que no funciona. Revisa también la alimentación, como explica la guía del brownout del ESP32.
¿Por qué mi texto del MAX7219 sale en espejo o al revés?
Todas las placas de estilo FC16 llevan los mismos chips, pero el cableado entre la matriz LED y el MAX7219 cambia de una familia de placas a otra. La documentación de MD_MAX72XX dice que los circuitos son esencialmente iguales y que la diferencia está en cómo se cablea la matriz al chip, algo que la librería resuelve por software con un valor moduleType_t (página de hardware).

Cada tipo es una combinación de tres interruptores, descritos en la página de nombres estructurados: DR (dígitos como filas), CR (columnas invertidas) y RR (filas invertidas). Así los fija el código fuente 3.5.1 en setModuleParameters():

| Tipo de hardware | Dígitos como filas (DR) | Columnas invertidas (CR) | Filas invertidas (RR) | Nombre estructurado |
|---|---|---|---|---|
| FC16_HW | sí | no | no | DR1CR0RR0 |
| GENERIC_HW | no | sí | no | DR0CR1RR0 |
| PAROLA_HW | sí | sí | no | DR1CR1RR0 |
| ICSTATION_HW | sí | sí | sí | DR1CR1RR1 |
Las inversiones de columnas y filas actúan sobre un bloque de 8x8 a la vez: el código fuente asigna un píxel a COL_SIZE - 1 - c y ROW_SIZE - 1 - r, donde ambos tamaños valen 8. Por eso arreglan los glifos en espejo o volteados dentro de cada bloque. La tabla de abajo es mi lectura de esos indicadores, no una prueba de banco, así que tómala como una lista corta de lo que probar primero, un tipo por compilación.
| Lo que ves | Qué interruptor probablemente está mal | Prueba esto |
|---|---|---|
| Cada letra en espejo de izquierda a derecha, pero derecha | Columnas invertidas (CR) | Cambia FC16_HW por PAROLA_HW, que solo se diferencia en CR |
| Cada letra volteada de arriba abajo | Filas invertidas (RR) | Usa el nombre estructurado DR1CR0RR1_HW, que no tiene alias en la librería |
| Cada letra girada 180 grados | CR y RR a la vez | Prueba ICSTATION_HW, que es FC16_HW con ambas inversiones añadidas |
| Letras tumbadas de lado o revueltas | Dígitos como filas (DR) | Prueba GENERIC_HW y luego ejecuta el ejemplo HW_Mapper |
El orden de los módulos es una cuestión aparte de las tres inversiones. La página FC-16 de la librería dice que la pantalla se orienta con el lado DIN a la derecha, y la página de nombres estructurados dice que los módulos se encadenan de derecha a izquierda. También avisa de que el texto impreso en el PCB puede verse boca abajo, así que juzga la placa por lo que muestran los LED, no por la serigrafía. Mis notas de componentes dan por bueno el mismo diseño con DIN a la derecha para el ticker y lo marcan como pendiente: no lo he confirmado en todas las placas. Si palabras enteras salen en el orden de módulos equivocado, comprueba que has conectado los pads de entrada (DIN) y no los de salida (DOUT), y que el número de módulos de tu código coincide con los que tienes.
Si ningún tipo con nombre funciona, la librería incluye una utilidad llamada MD_MAX72xx_HW_Mapper: ejecútala con un solo módulo y te imprime a qué dígito y segmento pertenece cada píxel encendido, para que puedas construir el nombre DR#CR#RR#_HW correcto. La librería advierte de que las combinaciones sin alias no están garantizadas si no se prueban.
¿Se puede arreglar por software? MD_Parola tiene los efectos de zona PA_FLIP_UD y PA_FLIP_LR, que se fijan con setZoneEffect(). Su cabecera dice que PA_FLIP_UD funciona con todos los efectos de texto, pero PA_FLIP_LR no funciona con SCROLL_LEFT, SCROLL_RIGHT ni SLICE, y el ticker se desplaza a la izquierda (PA_SCROLL_LEFT en config.cpp). En una pantalla con desplazamiento, el espejo de izquierda a derecha se arregla con el tipo de hardware, no con un flip.
En el Gizmo Ticker, eso significa editar la línea HARDWARE_TYPE de config.h y compilar tú mismo el firmware. La versión que se flashea desde el navegador viene fija en FC16_HW.
¿Por qué mi matriz MAX7219 está en blanco, tenue o muestra basura?
Una pantalla FC16 en blanco o con ruido casi siempre es un problema de alimentación, de conexiones o de que el código no coincide con la placa, y el orden de abajo va de la comprobación más barata a la que da más trabajo. Cambia una sola cosa a la vez.
| Lo que ves | Causa probable | Qué revisar |
|---|---|---|
| No se enciende nada | Sin alimentación, sin masa común o cables en el lado equivocado | 5 V en VCC, GND unida a la del ESP32, cables en los pads de entrada, no en DOUT |
| No se enciende nada, pero las conexiones parecen correctas | El CS o el número de módulos difiere del código | El pin CS del constructor coincide con el cable CS, y el número de módulos es 4 por placa |
| Texto muy tenue | Intensidad configurada baja | setIntensity() acepta de 0 a 15, y el valor por defecto del ticker es 1 |
| Píxeles aleatorios, parpadeo o basura | Lógica de 3,3 V al límite o alimentación débil | Adaptador de nivel en DIN, CS y CLK, cables más cortos, una alimentación de 5 V estable |
| El texto se lee pero sale en espejo o volteado | Tipo de hardware equivocado | La tabla de síntomas de la sección del espejo de arriba, un tipo a la vez |
La hoja de datos del MAX7219 da una alimentación de operación de 4,0 a 5,5 V, así que una matriz conectada al pad 3V3 queda por debajo de su rango. El ticker mantiene libre ese pad por la misma razón. La guía del brownout del ESP32 cubre el caso en que lo que se reinicia es toda la placa.
¿Cómo se encadenan módulos MAX7219 y cuánta corriente consumen?
Una cadena es una línea de registros de desplazamiento: DOUT de un módulo va a DIN del siguiente, mientras que CS y CLK son compartidos por todos. Las notas de conexión de la librería dicen que los datos se desplazan en un registro de 16 bits y se capturan en el flanco de subida de la señal de carga, y que la línea CS selecciona toda la cadena. Una placa FC16 ya encadena sus cuatro módulos; para ampliar la pantalla, une los pads de salida de una placa con los pads de entrada de la siguiente.
Le dices a la librería cuántos módulos de 8x8 hay, y el resto viene solo. El Gizmo Ticker guarda ese número en la flash y acepta de 4 a 32 en pasos de 4, porque las placas vienen de 4 en 1. Su valor por defecto es 4, una placa, que además es para lo que está dibujada la carcasa. El firmware se reinicia después de cambiar el número, porque el objeto de la pantalla se crea una sola vez al arrancar.
Sobre la corriente no tengo una cifra medida para la placa FC16. El repositorio del ticker no da ninguna, y mis notas de componentes tampoco. La hoja de datos del MAX7219 da un peor caso para un chip: hasta 330 mA con todos los segmentos encendidos a 40 mA, y una placa FC16 tiene cuatro chips, así que el techo se multiplica, pero el consumo real depende del ajuste de brillo y de la resistencia que fija la corriente en la propia placa. La documentación de la librería solo dice que la alimentación debe dar corriente suficiente para los módulos conectados. Lo que puedo decir a partir del firmware: el brillo es el ajuste setIntensity(), de 0 a 15, y el ticker arranca en 1. Si encadenas más placas, mide el consumo con un medidor de potencia USB a tu brillo antes de fiarte del puerto de una computadora portátil, y lee la guía del brownout si la placa se reinicia cuando la pantalla sube de brillo. Yo alimentaría las cadenas largas con una fuente de 5 V adecuada, con las masas unidas, pero es una preferencia mía, no algo que haya probado.
¿Qué librería elegir para una pantalla MAX7219 con ESP32?
Dos librerías del mismo autor, una encima de la otra. MD_MAX72XX habla con los chips y trata la cadena como una única superficie de píxeles: pones un píxel, dibujas un mapa de bits, cambias la intensidad. MD_Parola construye el texto encima: desplazamiento, alineación, pausas y animaciones, y necesita tener MD_MAX72XX instalada. El ticker usa MD_Parola 3.7.5 y MD_MAX72XX 3.5.1, fijadas en platformio.ini, porque lo único que muestra es texto.
Para texto, empieza con MD_Parola. Para gráficos, un juego o una animación propia, usa MD_MAX72XX directamente. Las dos reciben el mismo argumento moduleType_t, así que todo lo anterior vale para cualquiera. Si todavía dudas entre este tipo de pantalla y un panel más grande, MAX7219 vs HUB75 los compara.
¿Qué hemos verificado y qué queda abierto?
Ya tienes el mapa de cinco cables para un módulo FC16 en una XIAO ESP32-S3, el código que lo arranca y una tabla que convierte "mi texto sale en espejo" en el siguiente tipo que probar. Los pines, las versiones fijadas de las librerías y el ajuste SPI de 8 MHz vienen del ticker y del código fuente de la librería. El nivel de salida de 2,64 V viene de la hoja de datos de Espressif, y el nivel de entrada de 3,5 V de la hoja de datos del MAX7219, revisión 4.
Quedan tres límites. El cableado a 3,3 V funciona en el ticker, pero está por debajo del nivel de entrada garantizado por la hoja de datos, así que un adaptador de nivel es la solución segura cuando da problemas. La tabla de síntomas se deduce de los indicadores de la librería y no se ha probado en todas las familias de placas. Y la longitud de la cadena y la corriente no están probadas aquí más allá de una sola placa 4 en 1. Para ver el dispositivo completo construido alrededor de esta matriz, lee la construcción del crypto ticker, y API de CoinGecko en ESP32: límites gratuitos y frecuencia de consulta para ver cómo obtiene sus precios. Echa también un vistazo a qué es OpenGizmo para conocer los demás proyectos.
Preguntas frecuentes
Encuentra respuestas rápidas a las preguntas más comunes sobre este tema.
Usa FC16_HW de la librería MD_MAX72XX para las placas 4 en 1 más comunes, con FC-16 impreso en el PCB. El firmware del Gizmo Ticker configura justo ese. Si el texto sigue saliendo en espejo o volteado, prueba PAROLA_HW, GENERIC_HW o ICSTATION_HW de uno en uno y vuelve a compilar.
Autor
Mauro Brambilla¿Listo para montar tu propio gizmo?
Elige un proyecto open source con ESP32 y sigue su guía paso a paso, desde la lista de componentes y el cableado hasta el firmware y el primer arranque.







