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
- Las bandas en cámara son normales en los paneles HUB75, y empeoran con exposiciones cortas (escenas con mucha luz) y con el brillo del panel bajo.
- Sube el refresco real. En mi panel, pasar de unos 157 Hz a 343 Hz quitó las bandas en foto y en vídeo con todos los brillos que uso.
- No te fíes del refresco que sale en el log en un ESP32-S3. La librería lo calcula con el reloj que le pides, no con el que de verdad genera el chip.
- Bajar la profundidad de color de 8 a 7 bits es la forma más barata de ganar refresco, pero también hay que fijarla al compilar, o los colores se rompen.
- Un reloj de píxel más rápido ayuda hasta que la señal se rompe. En mi panel, 26,7 MHz funcionó y 32 MHz desordenó los colores.
- Subir lsbMsbTransitionBit no sale gratis. Sube el número de hercios, pero empeoró la cámara y también lo que se ve a simple vista.
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.

Es una ilustración, no una medida. También explica las dos cosas que lo empeoran:
- Escenas con mucha luz y exteriores. La cámara elige una exposición corta, así que cada fila ve menos ciclos de refresco.
- Brillo del panel bajo. Los pulsos se acortan y los huecos se alargan, así que un pulso de más o de menos se nota más.
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.

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:
- Todos mis números son de la versión 3.0.14. La versión actual (la 3.1.0 mientras escribo esto) cambió cómo se construyen las pasadas de BCM y cómo se calcula el refresco, así que con los mismos ajustes te saldrán otros hercios. Mira el log de tu propia compilación.
- Si el búfer DMA está en la PSRAM, la librería limita el reloj del S3 (divisor 12, unos 13,3 MHz) para que la memoria dé abasto. Solo con eso el refresco baja mucho.
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.
i2sspeedenHUB75_I2S_CFG: el reloj de píxel que pides (HZ_8M,HZ_10M,HZ_15M,HZ_16M,HZ_20M). En el S3 se traduce a un divisor de 160 MHz, como he contado arriba.S3_LCD_DIV_NUM: un flag de compilación que sustituye ese divisor en el S3.-DS3_LCD_DIV_NUM=6da 160 / 6 = 26,7 MHz. El divisor es el campoLCD_CAM.lcd_clock.lcd_clkm_div_num, que también se puede escribir después debegin(), útil para probar valores sin recompilar.PIXEL_COLOR_DEPTH_BITS(flag de compilación) ysetPixelColorDepthBits()(en la configuración): la profundidad de color, 8 por defecto. Cada bit que quitas reduce más o menos a la mitad el tiempo que necesita cada fila, así que el refresco sube rápido.min_refresh_rateenHUB75_I2S_CFG: el refresco mínimo que quieres. Si la librería no llega con el BCM completo, subelsbMsbTransitionBit: los bits de color más bajos dejan de tener sus propios huecos cortos y se enseñan con el mismo tiempo. Eso gana hercios, pero los tonos más oscuros pierden precisión, y la versión 3.0.14 avisa en el log de que la profundidad de color percibida puede bajar.lsbMsbTransitionBitno se fija a mano: sale demin_refresh_rate, y la librería imprime en el log el valor que ha elegido.
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:
- Más hercios no siempre es mejor. Subir lsbMsbTransitionBit a 3 dio el número más alto con 7 bits, pero lo consigue haciendo muy cortos los pulsos de OE, y los pulsos cortos fueron peores tanto en cámara como en persona.
- Cuadrar con la frecuencia de la red no ayudó. Los móviles ajustan la exposición para evitar el parpadeo de las luces de 50 Hz y 60 Hz, así que probé un refresco de 100 Hz exactos para encajar con eso. Fue peor, y el parpadeo se veía sin cámara.
- El reloj tiene techo. A 32 MHz los colores se fundieron. Hasta dónde puedes llegar depende de tu cableado, tus cables y tu panel, así que no hay un número universal.
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:
- Usa una exposición más larga. Cuanto más tiempo recoge luz cada fila, más ciclos de refresco promedia. Con mis ajustes de 343 Hz, las bandas solo volvían al bajar mucho la exposición a mano, así que lo contrario también vale: no dejes que la cámara elija un obturador muy corto.
- Evita grabar con muchísima luz. En exteriores o junto a una ventana con sol, la cámara acorta la exposición.
- Sube el brillo del panel para el vídeo. Los pulsos más largos perdonan más.
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
- Los paneles HUB75 parpadean en cámara porque encienden unas pocas filas a la vez con pulsos de luz, y el móvil lee la imagen fila a fila.
- Las bandas empeoran con exposiciones cortas y con el brillo del panel bajo.
- En un ESP32-S3, el refresco del log puede estar mal; calcúlalo con el reloj real (160 MHz entre un número entero).
- Lo mejor en mi panel: 7 bits de color, lsbMsbTransitionBit 1 y un reloj de 26,7 MHz, para 343 Hz.
- Si cambias la profundidad de color, pon
-DPIXEL_COLOR_DEPTH_BITSa juego, o los colores se rompen. - Prueba cualquier reloj más rápido en más de un panel y con el panel caliente.
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.
