← Todas las guías

Por qué tu panel LED HUB75 parpadea en cámara (y cómo lo arreglé en un ESP32)

Montas una matriz LED, en tu habitación se ve perfecta, y cuando la grabas con el móvil aparece llena de bandas oscuras que suben por la pantalla. O la foto sale con unas rayas que hace un segundo no estaban.

He dedicado mucho tiempo a este problema, porque construyo Frame, un marco LED de 64x64 que enseña fotos enviadas desde el móvil, y la gente va a querer grabarlo y hacerle fotos. Frame funciona con un ESP32-S3, un panel HUB75 y la librería ESP32-HUB75-MatrixPanel-DMA, así que todo lo que cuento va de esa combinación. Los números salen de mi propio banco de pruebas: un panel de 64x64 con escaneo 1/32 y chips de control Chipone ICN2037BP, grabado con un iPhone.

La versión corta: el panel nunca está encendido entero, la cámara del móvil lee la imagen fila a fila, y si el refresco es demasiado bajo para la velocidad de obturación, cada fila de la foto recoge una cantidad de luz distinta.

La respuesta corta

Por qué un panel HUB75 parpadea en cámara

El panel nunca está encendido entero

Un panel HUB75 no enciende todos sus LED a la vez. Un panel de 64x64 con escaneo 1/32 enciende dos filas a la vez (una en la mitad de arriba y otra en la de abajo), luego las dos siguientes, y así 32 veces por cada imagen completa. Cada fila solo está encendida 1/32 del tiempo. Tu ojo lo mezcla en una imagen fija. La cámara no siempre.

Los colores se hacen con tiempo, no con corriente

Cada LED está encendido o apagado. Para enseñar 256 niveles de rojo, el panel usa modulación por código binario (BCM): enseña el bit más bajo del color durante un hueco corto, el siguiente el doble de tiempo, el siguiente cuatro veces más, y así. Un píxel brillante está encendido en casi todos esos huecos y uno oscuro en pocos. Así que, incluso dentro de una fila, la luz sale como una serie de pulsos.

El brillo funciona igual. La librería atenúa el panel acortando el tiempo que la señal de habilitación de salida (OE) deja encendidos los LED en cada hueco. Menos brillo significa destellos de luz más cortos con más espacio entre ellos.

El móvil lee la foto fila a fila

Casi todas las cámaras de móvil tienen obturador rodante (rolling shutter): el sensor no captura la imagen entera de golpe, la expone y la lee fila a fila, de arriba abajo. Cada fila del sensor recoge luz durante el tiempo de exposición, pero cada una empieza un poco después que la de encima.

Si la exposición es larga comparada con un refresco del panel, cada fila recoge muchos ciclos y todas acaban con el mismo brillo medio. Si la exposición es corta, unas filas pillan un pulso de luz más que otras. Esas filas salen más claras, las demás más oscuras, y aparecen bandas horizontales. En vídeo la cámara y el panel no van sincronizados, así que las bandas se desplazan por la imagen.

Diagrama: el panel emite pulsos cortos de luz; cada fila del sensor con obturador rodante se expone durante una ventana corta que empieza un poco después que la de encima, así que unas filas pillan 3 pulsos y otras solo 2

Es una ilustración, no una medida. También explica las dos cosas que lo empeoran:

El arreglo en el lado del panel siempre es la misma idea: que el panel repita la imagen completa más veces por segundo, para que hasta una exposición corta recoja muchos ciclos.

Ilustración de la misma imagen de 64x64 en un panel LED como podría captarla un móvil, con bandas horizontales oscuras a la izquierda y limpia a la derecha

La imagen de arriba es una simulación de cómo se ven las bandas, no una foto de mi panel.

¿A qué refresco va de verdad tu panel?

El refresco de un panel HUB75 depende de tres cosas: el reloj de píxel (a qué velocidad salen los datos hacia el panel), la profundidad de color (cuántos huecos de BCM necesita cada fila) y cómo reparte la librería esos huecos.

ESP32-HUB75-MatrixPanel-DMA calcula un refresco al arrancar y lo guarda en calculated_refresh_rate. En el ESP32-S3 ese número puede estar mal, y en mi caso lo estaba. Te cuento por qué.

En el S3, la librería mueve el panel con el periférico LCD, cuyo reloj es 160 MHz dividido entre un número entero. En el código de la librería, si pides i2sspeed = HZ_20M, elige un divisor de 7, que da 160 / 7 = 22,9 MHz, no 20. Pero el cálculo del refresco usa los 20 MHz que pediste. Con la versión 3.0.14, mi configuración de producción (8 bits de color, HZ_20M) imprimía 137 Hz, cuando el reloj real da unos 157 Hz.

Dos avisos antes de comparar tus números con los míos:

Los ajustes que importan

Estos son los mandos de ESP32-HUB75-MatrixPanel-DMA que cambian el refresco. Los nombres son los del código de la librería.

La trampa de la profundidad de color

Esta es la que más tiempo me costó, porque hizo que una buena idea pareciera mala.

La librería corrige el brillo con una tabla de conversión CIE 1931, para que un valor de 128 parezca la mitad de brillo a la vista. Esa tabla se elige al compilar la librería, según PIXEL_COLOR_DEPTH_BITS, que vale 8 si no lo pones. Si solo llamas a setPixelColorDepthBits(7) en tu configuración y no compilas con -DPIXEL_COLOR_DEPTH_BITS=7, la librería se queda con la tabla de 8 bits y mete sus valores en un color de 7 bits. Los colores claros se salen de rango y la imagen parece desordenada, con manchas de arcoíris donde debería haber blancos o tonos pálidos.

Una prueba anterior que hice con 6 bits se veía fatal justo por esto, y estuve a punto de descartar bajar la profundidad de color. La prueba estaba rota, no la idea. He mirado el código de la 3.0.14 y el de la versión actual, y en las dos la tabla se sigue eligiendo con el flag de compilación.

La solución: pon siempre el flag de compilación con la misma profundidad que usas en la configuración.

Lo que probé y lo que pasó

Todo en el mismo banco: panel de 64x64, escaneo 1/32, chips Chipone ICN2037BP, ESP32-S3, librería 3.0.14, con vídeo y fotos hechos con un iPhone.

Ajustes Refresco Resultado en cámara
8 bits, HZ_20M (22,9 MHz reales) unos 157 Hz Bandas que iban y venían en vídeo con el móvil, con mi firmware completo
7 bits, lsbMsbTransitionBit 1, 26,7 MHz 343 Hz Limpio en foto y vídeo con brillo 255, 128, 64 y 40. Bandas solo al bajar mucho la exposición a mano
7 bits, lsbMsbTransitionBit 3 485 Hz Peor en cámara, y con líneas a simple vista
Reloj de 32 MHz (divisor 5) no aplica Colores rotos: la señal no da para tanto en mi panel
6 bits, bien compilado 620 Hz Funciona, pero el color pierde nitidez
100 Hz exactos 100 Hz Peor, con parpadeo visible a simple vista

Hubo cosas que me sorprendieron:

Mi configuración

Esto es con lo que me quedé para un solo panel de 64x64 en un ESP32-S3, en platformio.ini:

build_flags =
  -DPIXEL_COLOR_DEPTH_BITS=7
  -DS3_LCD_DIV_NUM=6
  -DPANEL_MIN_REFRESH=150

PANEL_MIN_REFRESH es un nombre mío, no de la librería: en mi código va a min_refresh_rate. Con el cálculo de la 3.0.14, 7 bits y un mínimo de 150 Hz a los 20 MHz nominales hacen que la librería elija lsbMsbTransitionBit 1. Después, el divisor de 6 deja el reloj real en 26,7 MHz, y eso da los 343 Hz de la tabla.

En la configuración, la profundidad de color y el refresco pedido van juntos:

HUB75_I2S_CFG mxconfig(64, 64, 1);
mxconfig.i2sspeed = HUB75_I2S_CFG::HZ_20M;
mxconfig.min_refresh_rate = PANEL_MIN_REFRESH;
mxconfig.setPixelColorDepthBits(7); // el mismo valor que -DPIXEL_COLOR_DEPTH_BITS

Antes de copiarlo, dos avisos. El reloj de 26,7 MHz está solo un 17 % por debajo de los 32 MHz que se rompieron en mi banco, que no es mucho margen. Todavía quiero probarlo con el panel caliente después de horas encendido, y en dos o tres paneles más, antes de darlo por bueno. Y si usas la versión 3.1.0, mira el log: con estos ajustes el refresco no será el mismo.

Si solo necesitas un vídeo limpio hoy

Si no puedes tocar el firmware, aún puedes ayudar a la cámara:

Dónde encaja Frame

Todo esto salió de una pregunta: ¿se ve Frame igual de bien en el móvil de alguien que en su estantería? Frame es un marco con un panel LED de 64x64 que vive en tu casa. La gente que quieres abre la app gratis (iPhone y Android, sin suscripción), hace o elige una foto, y aparece en tu Frame, estén donde estén. La gente graba sus paneles para enseñarlos, así que las bandas tenían que irse.

Lo estoy construyendo yo solo, y puedes leer la historia completa aquí o ver cómo funciona Frame. Sale en Kickstarter el 1 de febrero de 2027, así que todavía no se puede comprar. Si te interesan los paneles de 64x64, también he escrito sobre cómo convertir una foto en pixel art de 64x64 y sobre alternativas a Tidbyt.

Resumen

Y si lo que te apetece es tener en casa un panel de 64x64 que se encienda con las fotos de la gente que quieres, sin escribir una línea de firmware, deja tu email abajo. Quien está en la lista entra 24 horas antes que nadie, al precio fundador.

Un saludo,
Álvaro M.

Kickstarter · febrero de 2027
Apuntarme