Ticker cripto con ESP32 y MAX7219: piezas y conexiones

Construye un ticker cripto con ESP32 y matriz MAX7219: pinout de la XIAO ESP32-S3, flasheo desde el navegador, portal cautivo y clave CoinGecko gratis.

Publicado
Tiempo de lectura
10 min
Categoría
Proyectos
Un maker sonríe ante una matriz LED que muestra el símbolo de Bitcoin y 67342, conectada a una placa ESP32, con un soldador y una protoboard cerca.

En resumen

Un Gizmo Ticker necesita una XIAO ESP32-S3, una matriz MAX7219 FC16 4 en 1, cinco cables y una clave Demo gratuita de CoinGecko. Lleva unos 60 minutos y el firmware se flashea desde el navegador.

Un ticker cripto con ESP32 es una Seeed Studio XIAO ESP32-S3 conectada con cinco cables a una matriz LED MAX7219 4 en 1 FC16. Su firmware obtiene los precios de Bitcoin o Kaspa de la API de CoinGecko cada 6 minutos y los hace desfilar por la matriz. El montaje lleva unos 60 minutos y requiere algo de soldadura.

Esta guía sigue el Gizmo Ticker real, un proyecto de código abierto de OpenGizmo. Los pines, las versiones de las librerías y los tiempos de abajo salen de su código fuente del firmware, así que puedes comprobarlos uno por uno, y cada paso te dice qué deberías ver antes de seguir.

Proyecto open source ESP32 + MAX7219
Gizmo 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
Echar un vistazo

¿Cómo llega un precio a la matriz?

En dos saltos, y conviene conocerlos antes de conectar nada. La placa llama a CoinGecko por HTTPS desde una tarea en segundo plano, guarda la última respuesta en memoria, y un bucle que nunca se bloquea la hace desfilar por la matriz mediante SPI. El teléfono no forma parte del camino de los precios: solo lo usas para cambiar ajustes, que se guardan en la flash de la placa.

Flujo desde CoinGecko por HTTPS hasta la XIAO ESP32-S3, luego por SPI hasta el MAX7219, con un teléfono que envía ajustes a gizmo-ticker.local

¿Qué necesitas para construir un ticker cripto con ESP32?

Cinco cosas, más una computadora con Chrome o Edge para el paso del flasheo.

PiezaCant.Notas
Seeed Studio XIAO ESP32-S31Viene con una antena FPC. La placa no tiene antena propia
Matriz LED MAX7219 4 en 1 FC161Cuatro módulos 8x8 en una sola PCB, 32x8 píxeles
Cable plano de 6 hilos1Solo se usan cinco hilos
Cable USB-C de datos1Para flashear y para la alimentación. Un cable solo de carga no sirve
Tornillos M3 x 84Solo para la carcasa impresa

La XIAO ESP32-S3 tiene un Xtensa LX7 de doble núcleo de hasta 240 MHz y Wi-Fi de 2,4 GHz, según la wiki de Seeed Studio. Es la placa en la que funcionan todos los dispositivos de OpenGizmo. Si aún estás eligiendo placa, qué ESP32 comprar compara las opciones.

Un MAX7219 es un chip controlador que enciende hasta 64 LED, una matriz de 8x8, desde un bus serie corto, y se encadena con otros MAX7219 (página de producto de Analog Devices). La placa 4 en 1 FC16 ya trae cuatro encadenados.

¿Cómo se conecta el MAX7219 a la XIAO ESP32-S3?

Con el puerto USB-C hacia arriba y los componentes de cara a ti, el borde derecho de la XIAO dice 5V, GND, 3V3, D10, D9, D8, D7. Es casi el orden de la entrada de la matriz (VCC, GND, DIN, CS, CLK), así que el firmware usa los pads junto a 5V y GND, y un cable plano va directo de un lado al otro. El cable del 3V3 simplemente queda suelto.

Conexiones desde los pads de la XIAO ESP32-S3 a la entrada del MAX7219 FC16: 5V a VCC, GND a GND, D10 a DIN, D9 a CS, D8 a CLK, con el cable del 3V3 sin conectar

Entrada del MAX7219Pad de la XIAO ESP32-S3GPIO del ESP32-S3Función
VCC5VningunoAlimentación de la matriz
GNDGNDningunoMasa
DIND10GPIO9Datos SPI (MOSI)
CSD9GPIO8Selección de chip
CLKD8GPIO7Reloj SPI (SCK)

El firmware inicia el SPI sin pin MISO, porque la pantalla nunca devuelve nada. Eso libera D9, que es el pad MISO por defecto, para que haga de CS. Las constantes de los pines están en config.h.

Tres cosas antes de dar corriente:

  • Conecta la antena FPC al conector U.FL, o la placa no se unirá a tu Wi-Fi.
  • El pad 5V es la alimentación USB, así que la matriz se alimenta por el mismo cable que la placa. El repositorio no da ninguna cifra de corriente, y el consumo crece con el brillo y con el número de módulos, así que empieza con poco brillo.
  • Los GPIO de la XIAO trabajan a 3,3 V mientras que la matriz se alimenta a 5 V. El proyecto los conecta directamente, sin convertidor de nivel. Eso queda por debajo de los 3,5 V de nivel de entrada que garantiza la hoja de datos (datasheet) del MAX7219, así que añade un convertidor de nivel si la pantalla muestra basura. MAX7219 FC16 con ESP32: conexiones, lógica de 3,3 V, imagen invertida tiene los números.

En la placa de la matriz, si piensas imprimir la carcasa, suelda los cables a los pads de entrada en lugar de usar la tira de pines: los pines rectos sobresalen unos 7 mm por cada extremo (medidos en las notas de piezas del proyecto) y estorban a la cubierta.

¿Cómo se flashea el firmware desde el navegador?

No necesitas un IDE. El firmware publicado se flashea con ESP Web Tools, que habla con la placa por Web Serial, así que funciona en Chrome y Edge.

  1. Conecta la XIAO a tu computadora con el cable USB-C de datos.
  2. Abre la página del proyecto Gizmo Ticker y baja hasta la tarjeta de flasheo del firmware.
  3. Pulsa Flash firmware, elige el puerto serie de la placa y espera a que termine.

La placa se reinicia sola, y un flasheo desde la web conserva los ajustes que ya tenga guardados. El botón lee un manifiesto de la última versión, así que siempre obtienes el firmware más reciente. Tras el reinicio, la matriz hace desfilar Initializing..., y justo después deberías ver un mensaje sobre el Wi-Fi.

¿Prefieres compilarlo tú? El repositorio usa PlatformIO con la placa seeed_xiao_esp32s3, y Node.js 24.21 o superior para la aplicación web. Las librerías están fijadas en platformio.ini: MD_Parola 3.7.5, MD_MAX72XX 3.5.1, ESPAsyncWebServer 3.12.1, ArduinoJson 7.2.2 y la librería compartida gizmo-common 2.5.1. Si te preguntas por qué PlatformIO y no el Arduino IDE, hay una comparativa de Arduino IDE y PlatformIO.

Compilar y flashear desde el código fuente
cd webapp && npm ci && npm run build:embeddedcd ../microcontrollerpio run --target uploadpio run -e debug --target upload && pio device monitor

El último comando flashea en cambio el perfil debug, que activa el registro serie para que pio device monitor muestre lo que está haciendo el firmware. El firmware publicado lo mantiene apagado.

¿Cómo funciona la primera configuración del Wi-Fi?

La placa todavía no conoce tu Wi-Fi, así que crea el suyo. Un portal cautivo es una página que se abre sola cuando te unes a un hotspot, el mismo truco que usan los Wi-Fi de los hoteles.

  1. Unos 12 segundos después de arrancar sin una red que funcione, la placa abre un hotspot abierto llamado Gizmo-Ticker, sin contraseña. La matriz hace desfilar Not connected to Wi-Fi. Use the 'Gizmo-Ticker' access point to enter the Wi-Fi credentials.
  2. Únete desde tu teléfono. La página de configuración debería abrirse sola. Si no lo hace, abre en el navegador cualquier dirección http:// (no https://).
  3. Elige tu red, escribe la contraseña y confirma. Las nuevas credenciales solo se guardan cuando la placa llega a conectarse de verdad.

El hotspot y el portal vienen de la librería compartida gizmo-common, que documenta este flujo. Si la página nunca aparece, portal cautivo del ESP32 que no funciona repasa las causas una por una.

Ahora vuelve a unirte a tu red de siempre y abre http://gizmo-ticker.local. Algunos routers y versiones de Android no resuelven los nombres .local. En ese caso, usa la dirección IP de la placa que verás en la lista de clientes de tu router, o lee la guía de solución de problemas de mDNS.

¿Cómo se consigue una clave de API de CoinGecko y se añade?

El ticker muestra API key is not present. Use the web page to insert the key and try again. hasta que le das una clave. Crea una cuenta Demo gratuita en CoinGecko y copia la clave desde su Developer Dashboard.

Abre la página API Key de la aplicación web, pega la clave y guarda. El campo acepta hasta 34 caracteres y quita los espacios de lo que pegas. Después la página muestra la clave enmascarada, y la placa la guarda en su flash. Guardar una clave nueva lanza una consulta de inmediato, así que el primer precio debería aparecer poco después.

¿Qué envía realmente la placa? Una petición GET a https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=bitcoin&price_change_percentage=24h, con la clave en la cabecera x-cg-demo-api-key, que la documentación de autenticación Demo de CoinGecko recomienda frente a la cadena de consulta. Puedes probar tu clave antes desde una computadora:

Probar la clave
curl -H "x-cg-demo-api-key: YOUR_KEY" "https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=bitcoin"

Sobre los límites: en noviembre de 2026, la página de límites de uso de CoinGecko da al plan Demo 100 llamadas por minuto, y su página de precios un tope mensual de 10.000 créditos de llamada. Una llamada cada 6 minutos son 10 por hora, unas 7.200 en 30 días, así que el ticker queda por debajo del tope. Para las cuentas y lo que pasa con un 429, mira API de CoinGecko en ESP32: límites gratuitos y frecuencia de consulta.

¿Cómo se configura el ticker?

Cuando el precio ya desfila, la página Ticker controla lo que ves. Los cambios se guardan en la placa, así que nunca tienes que reflashear para cambiar un ajuste.

Tres pantallas del teléfono con la aplicación web del Gizmo Ticker: Wi-Fi, clave de API y ajustes del Ticker

AjusteOpcionesPor defecto
MonedaBitcoin o KaspaBitcoin
SeccionesPrecio, variación del precio, capitalización de mercado, máximo/mínimo del día, máximo/mínimo histórico, precio de apertura, volumenLas siete activadas
Formato de númerosEstilo US o EUUS
Brillode 0 a 151
Velocidad de desplazamientode 0 a 15, asignada a un retardo de desplazamiento de 100 ms (0) hasta 20 ms (15)1
Módulosde 4 a 32, de 4 en 44

La matriz recorre las secciones activadas, un mensaje tras otro. Si desactivas todas las secciones, te dice que actives al menos una. Cambiar el número de módulos reinicia la placa.

Solo hay dos monedas integradas. Añadir una tercera implica editar la búsqueda de monedas en market_data.cpp y la lista de monedas de la aplicación web, y luego recompilar.

¿Cómo hace el firmware para desplazar el texto mientras obtiene los precios?

Una petición HTTPS bloqueante congelaría la animación durante toda la llamada. Por eso el bucle principal nunca la hace. Le pregunta a la librería MD_Parola si el mensaje actual ha terminado, y una tarea separada de FreeRTOS hace la llamada de red.

microcontroller/src/main.cpp
microcontroller/src/main.cpp
void loop() {
    // Restart the device if the web server asked for it
    gizmo::manageDevice();

    // Manage the WiFi connection
    manageWiFiConnection();

    // Wait until the current matrix animation cycle finishes before preparing the next message
    if (!isLedMatrixReadyForNextMessage()) {
        return;
    }
    ...
}
Lín. 13, col. 1UTF-8cpp

isLedMatrixReadyForNextMessage() termina en displayAnimate() de MD_Parola, que avanza un poco el desplazamiento y devuelve si el mensaje ha terminado. Cuando la caché está vacía o caducada, api.cpp lanza una tarea marketDataFetch, que con un filtro de ArduinoJson analiza solo los campos que usa la pantalla, guarda el resultado y se elimina a sí misma. Mientras tanto, el bucle sigue mostrando los últimos datos buenos.

Si las actualizaciones siguen fallando, los datos envejecen. A los 12 minutos, la matriz abre cada ciclo con Prices from N min ago. y el último error. Una limitación, dicha con honestidad: el firmware llama a setInsecure() en su cliente HTTPS, así que cifra el tráfico hacia CoinGecko pero no verifica el certificado del servidor.

¿Qué haces cuando el ticker se porta mal?

Cambia una sola cosa a la vez y deja que los mensajes de la matriz te digan qué capa está fallando.

La matriz está en blanco o muestra basura

Comprueba primero las conexiones con la tabla: DIN, CS y CLK en D10, D9 y D8, y que 5V y GND estén bien firmes. Después verifica que el número de módulos de los ajustes coincida con tu hardware. Una discrepancia entre ambos es una de las primeras cosas que hay que descartar.

El texto sale invertido o los módulos están en el orden equivocado

El firmware está configurado con FC16_HW en config.h, que corresponde a las placas FC-16 4 en 1 comunes. La librería MD_MAX72XX también tiene PAROLA_HW, GENERIC_HW y ICSTATION_HW. No los he probado en este proyecto, pero cambiar la constante y recompilar es la solución habitual.

La placa nunca se une al Wi-Fi

Mira la antena. La XIAO necesita su antena FPC en el conector U.FL, y sin ella la placa no logra conectarse. Luego confirma que tu red es de 2,4 GHz, ya que el ESP32-S3 no tiene radio de 5 GHz.

La matriz dice "Error while calling the API" o "Prices from N min ago"

El mensaje nombra el síntoma, así que deduce la causa desde fuera. Ejecuta la prueba con curl de arriba con tu clave. Un 401 significa clave equivocada o un error al escribirla, y un 429 significa demasiadas llamadas. Si curl funciona, el problema está en la placa: vuelve a guardar la clave, o comprueba que la placa tenga acceso a internet.

Necesito empezar de cero

Mantén pulsado el botón BOOT durante 10 segundos mientras la placa está en marcha. Olvida el Wi-Fi y los ajustes y se reinicia en el hotspot de configuración. BOOT y RESET están en la parte superior de la XIAO, así que dentro de la carcasa cerrada quedan fuera de alcance: abre primero la tapa trasera.

¿Se puede poner en una carcasa impresa?

Sí, y el proyecto trae una. Una cubierta blanca con un difusor de 1 mm de cinco capas convierte los LED en píxeles suaves, y una tapa trasera naranja la cierra con cuatro tornillos M3 x 8. La huella es de 153,6 x 53,6 mm y la altura de 28,2 mm. La matriz se desliza en su alojamiento desde atrás, y la XIAO queda sujeta por nervaduras de presión, con su puerto USB-C a ras de la pared del extremo.

Plano de la carcasa del Gizmo Ticker con llamadas numeradas para el difusor, el marco, la matriz, los postes de tornillo, el puerto USB-C, las rejillas y la placa trasera

Las reglas de diseño que hay detrás están en Reglas de diseño de carcasas ESP32 impresas en 3D que encajan.

¿Qué has construido y cuáles son los límites?

Ahora tienes una XIAO ESP32-S3 que se une a tu Wi-Fi, obtiene datos de Bitcoin o Kaspa de CoinGecko cada 6 minutos y los hace desfilar por una matriz MAX7219, con todo ajustable desde el teléfono. Saqué estos detalles del código fuente del firmware y de la documentación de los fabricantes. El repositorio documenta las conexiones solo para una única placa 4 en 1, así que las cadenas más largas y la corriente que necesitan te toca probarlas a ti.

Para profundizar en la parte de la pantalla, empieza por la guía de conexiones del MAX7219 FC16. Si quieres otro aparato construido del mismo modo, controlar un NVR de Reolink con un ESP32 usa la misma placa y el mismo flujo de configuración, o consulta qué es OpenGizmo.

Preguntas frecuentes

Encuentra respuestas rápidas a las preguntas más comunes sobre este tema.

En el firmware del Gizmo Ticker, el pin DIN del MAX7219 va a D10 (GPIO9, MOSI), CS a D9 (GPIO8) y CLK a D8 (GPIO7, SCK). VCC va al pad 5V y GND a GND. El pad 3V3 queda sin conectar y la pantalla solo recibe datos, así que no hace falta ningún cable MISO.

Publicado Actualizado

¿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.

Lee también

Explora las categorías