Why nRF24 Scanner Apps Black-Screen on Dual-Chip PINGEQUA 2-in-1 Flipper Boards — and How We Fixed It

Por qué las apps de escáner nRF24 ponen la pantalla en negro en las placas PINGEQUA 2 en 1 de doble chip para Flipper, y cómo lo solucionamos

Un escáner de canales nRF24 genérico puede dejar en negro la pantalla de un Flipper Zero a mitad del escaneo en placas 2 en 1 de doble chip — esta es la causa en el arbitraje del bus SPI, y la solución que lanzamos en RF Lab.

Respuesta rápidaLa pantalla en negro ocurre porque las apps de escaneo nRF24 diseñadas para un solo chip nunca deseleccionan el segundo chip en un bus SPI compartido, dejando sin recursos a la tarea de actualización de pantalla del Flipper. PINGEQUA solucionó esto en RF Lab (ahora v0.5.4, 2026-06-12) enrutando cada transacción a través de un único furi_hal_spi_bus_handle_external y llevando siempre a alto (high) el CSN del chip inactivo antes de cualquier acceso. Es un .fap gratuito y de código abierto creado para la placa PINGEQUA 2-in-1 nRF24 + CC1101 RF Devboard.
Placa PINGEQUA 2-in-1 nRF24 + CC1101 con doble antena sobre un Flipper Zero, con el Channel Scanner en ejecución

El síntoma

En una placa de doble chip, iniciar un escáner de canales nRF24 de terceros y comenzar un escaneo de señal puede dejar en negro la pantalla del Flipper a mitad del proceso.

Pantalla del Flipper llenándose de negro desde abajo durante un escaneo nRF24 en una placa de doble chip
Un escáner de canales nRF24 de terceros en una placa 2 en 1 — la pantalla se llena de negro desde abajo a mitad del escaneo.

Esto no es exclusivo de nuestro hardware. La app nRF24 de la comunidad con más forks tiene un informe abierto que describe la misma clase de fallo:

«la pantalla a veces se pone completamente en negro durante unos 5 segundos durante el escaneo. Si se reduce el tiempo de escaneo, el apagón se observa con más frecuencia.»
flipperzero-nrf24 issue #15, abierto desde 2022

Por qué afecta más a las placas de doble chip

Una placa 2 en 1 conecta el nRF24 y el CC1101 en paralelo en un mismo bus SPI, seleccionados por software mediante la línea CSN dedicada de cada chip. Un escáner escrito para un único nRF24 solo controla su propia CSN — nunca deselecciona el segundo chip. Ambos chips pueden entonces responder a la vez en el bus compartido, y un escáner que retiene el bus SPI de forma continua puede dejar sin recursos a la tarea de actualización de pantalla. El resultado que ves es una pantalla en negro.

No somos los únicos en señalar esta carencia de las apps heredadas — hasta nuestras propias notas de producto advierten que las aplicaciones heredadas pueden tener definiciones de pines codificadas de forma fija, y recomiendan apps con un manejo adecuado de GPIO/SPI.

Esta descripción de la causa raíz es nuestro análisis de ingeniería del comportamiento observado, no un defecto confirmado por el fabricante.

Por qué reescribimos en lugar de parchear

Parchear las peculiaridades de un solo fork no resuelve el problema subyacente de arbitraje del bus, y no sobrevive a la siguiente actualización de firmware. Por eso, a principios de 2026 reconstruimos el toolkit sobre el Furi SDK oficial — sin símbolos privados de ningún fork, un único árbitro SPI limpio.

Qué cambió

  • Árbitro SPI de handle único — cada transacción pasa por un único handle de bus (furi_hal_spi_bus_handle_external), el mismo que incluye cualquier firmware.
  • El chip inactivo siempre queda deseleccionado — antes de cualquier acceso, la CSN del otro chip se lleva a alto. El bus nunca queda en estado ambiguo, así que la pantalla nunca se queda sin recursos.
  • Un solo .fap, cualquier firmware — funciona en el firmware oficial de Flipper (OFW), Momentum, Unleashed, RogueMaster y Xtreme. Sin recompilar.
PINGEQUA RF Lab Channel Scanner funcionando sin problemas — espectro de 2,4 GHz en vivo, sin pantalla en negro
El mismo hardware ejecutando RF Lab — espectro completo de 126 canales, sin que la pantalla se quede sin recursos.

Historial de versiones y compatibilidad de firmware

Qué cambió en cada versión

Versión Qué aportó
Reescritura sobre el Furi SDK (principios de 2026) Reconstruido sobre el Furi SDK oficial; handle de bus SPI único (furi_hal_spi_bus_handle_external); la CSN del chip inactivo siempre se lleva a alto antes de cualquier acceso.
v0.5.2 Nombres de archivo de exportación legibles (p. ej. scan_2026-05-15_143022_ch42.csv); pantalla «Acerca de» en el propio dispositivo con códigos QR escaneables hacia la tienda y el repositorio de código fuente.
RF Lab v0.5.4 (2026-06-12) Añade un generador de señal de 2,4 GHz solo para pruebas autorizadas; potencia de salida deliberadamente limitada para cumplir con FCC §15 / ETSI EN 300 328.
RF Lab está en desarrollo activo — descarga siempre la última build desde GitHub Releases en lugar de una copia antigua en caché.
Pantalla «Acerca de» de RF Lab con un código QR escaneable hacia la tienda
La pantalla «Acerca de» en el dispositivo — escanea el QR para abrir la tienda o el repositorio de código fuente.

Compatibilidad de firmware

Firmware Notas
Firmware oficial de Flipper (OFW) API mínima ≥ 87.1
Momentum Compatible, sin recompilar
Unleashed Compatible, sin recompilar
RogueMaster Compatible, sin recompilar
Xtreme Compatible, sin recompilar

Se distribuye como un único .fap de ~44 KB que cubre los cinco firmwares de destino de fábrica.

Véelo en acción

Navegación por el menú principal de RF Lab en el Flipper Zero
Menú principal — Scanner, Signal Generator, About
Menú principal de RF Lab en un Flipper Zero con la placa 2 en 1
Sobre el hardware
Modo generador de señal de 2,4 GHz de RF Lab, solo para pruebas autorizadas
Generador de señal de 2,4 GHz (solo para pruebas autorizadas)

Pruébalo en tu equipo

  1. Descarga pingequa_rf_toolkit.fap desde GitHub Releases
  2. Arrástralo a /ext/apps/GPIO/ en qFlipper
  3. Ábrelo desde Apps → GPIO → PINGEQUA RF Lab

Sin remapeo de GPIO, sin configuración específica por firmware.

Lo que viene después depende de ti

La hoja de ruta de v0.6 está abierta. ¿Quieres una vista de espectro Sub-GHz, un barrido de doble banda o presets de escaneo personalizados? Abre un issue — la próxima versión se construye a partir de lo que la gente realmente pide.

Hardware abierto. Código abierto.

nRF24L01+PA y CC1101 en un único bus SPI — para el Flipper Zero.

Descargar el FAP (gratis) Consigue el hardware

Preguntas frecuentes

¿Por qué las apps de escaneo nRF24 genéricas dejan la pantalla en negro en placas 2 en 1 de doble chip?
Una placa 2 en 1 conecta el nRF24 y el CC1101 en paralelo en un mismo bus SPI, seleccionados por software mediante la línea CSN dedicada de cada chip. Un escáner escrito para un único nRF24 solo controla su propia CSN — nunca deselecciona el segundo chip. Ambos chips pueden entonces responder a la vez en el bus compartido, y un escáner que retiene el bus SPI de forma continua puede dejar sin recursos a la tarea de actualización de pantalla del Flipper. El resultado visible es una pantalla que se pone en negro a mitad del escaneo. Este es nuestro análisis de ingeniería del comportamiento observado, no un defecto confirmado por el fabricante.
Mi pantalla se pone en negro durante un escaneo — ¿está roto mi módulo nRF24?
No. Esto no es exclusivo de nuestro hardware, ni es una señal de que el módulo esté roto. La app nRF24 de la comunidad con más forks tiene un informe abierto (issue #15, abierto desde 2022) que describe la misma clase de fallo — la pantalla se pone en negro unos segundos durante el escaneo, con más frecuencia cuando se reduce el tiempo de escaneo. Es un problema de arbitraje del bus propio del software de la era de un solo chip, no un fallo de hardware.
¿Qué versión de la app soluciona el problema de la pantalla en negro, y cómo se solucionó?
RF Lab lo soluciona — la versión actual es v0.5.4 (2026-06-12), basada en la reescritura de principios de 2026. En lugar de parchear las peculiaridades de un solo fork (algo que no sobreviviría a la siguiente actualización de firmware), el toolkit se reconstruyó sobre el Furi SDK oficial con un único árbitro SPI limpio. Cada transacción pasa por un único handle de bus (furi_hal_spi_bus_handle_external) que incluye cualquier firmware, y la CSN del chip inactivo siempre se lleva a alto antes de cualquier acceso — así el bus nunca queda en estado ambiguo y la pantalla nunca se queda sin recursos. Se distribuye como un solo .fap que funciona en el firmware oficial (OFW, API ≥ 87.1), Momentum, Unleashed, RogueMaster y Xtreme, sin recompilar.
¿Puede RF Lab transmitir, o es solo de recepción?
Ambas cosas. El analizador de espectro de 2,4 GHz (126 canales, max-hold, exportación a CSV) recibe, y v0.5.4 también incluye un generador de señal de 2,4 GHz exclusivamente para pruebas de RF autorizadas. Su potencia de salida está deliberadamente limitada para cumplir con FCC §15 / ETSI EN 300 328. Usa el generador de señal solo en frecuencias y entornos para los que estés autorizado a hacer pruebas.
¿Funcionará esto en mi firmware sin recompilar?
Sí. RF Lab se distribuye como un único .fap de ~44 KB que funciona de fábrica en el firmware oficial (OFW, API ≥ 87.1), Momentum, Unleashed, RogueMaster y Xtreme — sin remapeo de GPIO y sin configuración específica por firmware. Descárgalo desde GitHub Releases, arrástralo a /ext/apps/GPIO/ en qFlipper, y ábrelo desde Apps → GPIO → PINGEQUA RF Lab.

Fuentes y lecturas adicionales: flipperzero-nrf24 #15 · Documentación del Furi SDK de Flipper

Regresar al blog