M5Stack Cardputer RF module with CC1101 and nRF24 for Bruce firmware

Firmware Bruce en M5Stack: cómo flashearlo y solucionar "CC1101 / nRF24 Not Found" (2026)

Un módulo RF completamente nuevo que muestra "not found" da la sensación de hardware muerto — pero en placas M5Stack casi nunca lo es. Esta es la causa real, con los ajustes exactos de Bruce y los valores de pines que lo solucionan.

Respuesta rápida Si tu módulo RF de M5Stack muestra "CC1101 not found" o "nRF24 not detected" en Bruce, el radio casi nunca está muerto. Las dos causas más comunes: (1) aún no has flasheado el firmware Bruce — o usas una build antigua con un bug conocido de SPI/alimentación — y (2) el mapa de pines de BrucePins.conf no coincide con tu placa. La solución: flashea la versión actual de Bruce (1.15, mayo de 2026) desde bruce.computer/flasher, configura los pines correctos, luego en la app ve a RF → Config → RF Module y elige CC1101 (on SPI / Legacy), y reinicia.

¿Qué es Bruce, y qué dispositivos son compatibles?

Bruce es un firmware de seguridad ofensiva de código abierto para dispositivos ESP32, mantenido por pr3y en BruceDevices/firmware. Funciona en M5Stack Cardputer, StickC Plus 1.1 / Plus 2, StickS3, M5Core / Core2, además de placas Lilygo T-Deck / T-Embed. Es el firmware que convierte estos handhelds en herramientas RF de Sub-GHz (CC1101) y 2.4 GHz (nRF24L01+) — por eso un módulo RF de PINGEQUA necesita tener Bruce flasheado antes de que aparezcan los radios.

Paso 1 — Flashear Bruce (tres formas, la más fácil primero)

No necesitas ninguna toolchain de escritorio ni lidiar con puertos COM.

Método Cómo Ideal para
Flasher web Abre bruce.computer/flasher en Chrome o Edge, conecta por USB, elige tu placa, haz clic en flash Para todos — sin instalación
M5Launcher OTA Instala M5Launcher, actualiza Bruce por aire (OTA) Actualizaciones rápidas en un dispositivo ya flasheado
m5burner Flashea desde la app de escritorio m5burner de M5Stack Si ya usas M5Burner

Elige la build que coincida exactamente con tu placa (p. ej. m5stack-cardputer, m5stack-cplus2, m5stack-sticks3). Usar el target de placa incorrecto es en sí mismo una causa de "not found." PINGEQUA también aloja un flasher desde el navegador en flash.pingequa.com para sus placas.

Paso 2 — Por qué ocurre "not found" (las causas reales, en orden)

Según el propio wiki de Bruce y los issues recurrentes en GitHub, el error se reduce a:

  1. Bruce no está flasheado, o es una build antigua/con errores — con diferencia, la causa nº 1. Algunas builds tempranas (p. ej. 1.12 / 1.13) traían regresiones de timing SPI y gestión de energía que causaban falsos "not found" en hardware en buen estado; actualizar lo soluciona.
  2. El mapa de pines de BrucePins.conf no es correcto para tu placa — los radios están cableados a pines de chip-select/IRQ que deben declararse correctamente.
  3. El módulo no está seleccionado en el menú — los valores por defecto de Bruce pueden no apuntar a tu CC1101/nRF24 externo hasta que lo elijas.
  4. Módulo del modelo equivocado o mal asentado — un módulo ADV sobre un v1.1 (o un asentamiento flojo) nunca se detecta. Consulta Compatibilidad Cardputer ADV vs v1.1.
  5. La configuración no se aplicó al almacenamiento correcto — en algunos dispositivos, BrucePins.conf debe editarse tanto en la tarjeta SD como en LittleFS, y luego reiniciar el dispositivo.
  6. Un módulo realmente defectuoso — raro, y lo último que hay que sospechar.

Paso 3 — La checklist de solución

1. Flashear / actualizar Bruce a la build más reciente

Usa bruce.computer/flasher con el target de placa correcto. Solo esto ya elimina los bugs de SPI/alimentación de las builds antiguas.

2. Configurar el mapa de pines (BrucePins.conf)

Bruce lee la asignación de pines de los radios desde BrucePins.conf. Los radios no se detectarán hasta que los pines chip-select (CS) e IO0 coincidan con el cableado de tu placa.

Valores de pines para el Cardputer ADV (para los módulos PINGEQUA Cardputer ADV CC1101 + nRF24):

Sección Pin CS Pin IO0
CC1101_Pins 13 5
NRF24_Pins 6 4

Dos cosas que se suelen pasar por alto: edita AMBAS copias — BrucePins.conf existe en la raíz de la tarjeta SD y en la LittleFS del dispositivo; Bruce lee una u otra según la build, así que pon los mismos valores en ambas y reinicia. Y el editor más sencillo es la WebUI: en el dispositivo ve a Files → WebUI, conéctate a tu Wi-Fi, abre en un navegador la IP que aparece en pantalla (login por defecto admin / bruce), edita ahí brucepins.conf, y fuerza un reinicio.

El RF Pack S3 para StickS3 incluye una tarjeta de inicio rápido con la ruta exacta del menú de Bruce y la referencia de pines, así que te saltas este paso.

3. Seleccionar el módulo en Bruce

Ve a RF → Config → RF Module y elige CC1101 (on SPI). En placas/builds que lo necesiten, elige el driver (Legacy)CC1101 (Legacy) y nRF24 (Legacy) —, que usa la ruta SPI más antigua y ampliamente compatible.

Peculiaridad que conviene conocer — "el CC1101 solo funciona si antes abro el nRF24." En placas de doble radio que comparten un mismo bus SPI, el CC1101 puede fallar al iniciar si entras directamente a él, porque su código de inicialización asume que el bus SPI ya está configurado — al abrir primero el nRF24 se configura el bus, y entonces el CC1101 funciona (Bruce issue #1909). La solución por hardware es un SPI bufferizado/aislado, de modo que el orden no importa — que es justo lo que hace el buffer SN74 del RF Pack S3.

4. Reasentar y confirmar la banda

Apaga el dispositivo, reasienta el módulo firmemente en el header correcto, enciéndelo y vuelve a abrir el menú RF. Confirma que la antena y la banda coinciden con el módulo (una placa de 433 MHz está sintonizada para 433, no para 868/915).

5. ¿Sigue apareciendo "not found"?

Ahora sí vale la pena contactar con soporte. Incluye tu modelo de dispositivo, versión de Bruce, target de placa y BrucePins.conf para que la causa (casi siempre de configuración) se identifique rápido.

Notas específicas por dispositivo

Dispositivo Target de build de Bruce Notas
Cardputer ADV (módulos Hydra RF) m5stack-cardputer Flashea el Bruce más reciente, actualiza brucepins.conf vía WebUI, luego fuerza un reinicio. El ADV usa su header trasero de 2×7 para SPI.
Cardputer v1.1 (módulo 3-en-1) m5stack-cardputer Plug-and-play en los headers del v1.1; flashea Bruce, selecciona CC1101/nRF24 en el menú RF.
StickS3 (RF Pack S3) m5stack-sticks3 Usa la build de Bruce m5stack-sticks3 (mapa de pines nativo) y los drivers (Legacy). El soporte de StickS3 se estabilizó en builds de Bruce de finales de 2025 a inicios de 2026 (issue #2148) — así que aquí una build actual importa especialmente.
StickC Plus / Plus 2 (Stick RF 424) m5stack-cplus / cplus2 Usa la build correspondiente m5stack-cplus / cplus2.

Preguntas frecuentes

¿Por qué Bruce muestra "CC1101 not found" / "nRF24 not detected"?
La mayoría de las veces el firmware no está flasheado (o es una build antigua con un bug conocido de SPI/alimentación), o el mapa de pines de BrucePins.conf no coincide con tu placa. Flashea la versión actual de Bruce, corrige los pines, selecciona el módulo en RF → Config → RF Module, y reinicia. Rara vez el módulo está realmente muerto.
¿Cómo flasheo Bruce sin una toolchain de escritorio?
Usa el flasher web oficial en bruce.computer/flasher desde Chrome o Edge — conecta por USB, elige tu placa, haz clic en flash. Sin esptool, sin configurar puertos COM.
¿Cuál es la versión actual de Bruce?
1.15, publicada el 2026-05-25. Mantenla actualizada — varios reportes de "not found" se deben a builds desactualizadas.
¿Debo elegir "CC1101" o "CC1101 (Legacy)" en el menú?
Prueba primero CC1101 (on SPI); si el radio sigue sin detectarse, cambia a CC1101 (Legacy) (y nRF24 (Legacy)), que usa la ruta de driver SPI más antigua y ampliamente compatible.
¿Edito BrucePins.conf en la tarjeta SD o en el almacenamiento interno?
Ambas opciones pueden aplicar. Si editar solo una no surte efecto, edita BrucePins.conf tanto en la tarjeta SD como en LittleFS, y luego reinicia. El editor más simple es la WebUI del propio dispositivo (Files → WebUI, abre la IP en un navegador, login admin / bruce).
¿Qué valores de pines usa el Cardputer ADV?
Para los módulos PINGEQUA Cardputer ADV CC1101 + nRF24: CC1101_Pins → CS 13, IO0 5; NRF24_Pins → CS 6, IO0 4. Configura estos valores en BrucePins.conf (ambas copias) y reinicia.
¿Por qué mi CC1101 solo funciona después de abrir primero el nRF24?
En placas de doble radio que comparten un bus SPI, la inicialización del CC1101 asume que el bus ya está configurado; al abrir primero el nRF24 se configura el SPI, así que el CC1101 funciona después (Bruce issue #1909). Una placa con SPI bufferizado/aislado (p. ej. el SN74 del RF Pack S3) evita por completo el problema de orden.
Mi módulo dice not found justo después de comprarlo — ¿está defectuoso?
Casi seguro que no. Confirma que flasheaste Bruce, configuraste el mapa de pines correcto, y que el módulo coincide con tu modelo exacto de dispositivo (ADV vs v1.1). Un fallo de hardware es lo último que hay que sospechar.
¿Un módulo de 433 MHz funciona en 868/915 MHz?
El chip CC1101 cubre esas bandas, pero una placa y antena sintonizadas para 433 rinden mal fuera de ese rango. Usa un módulo y antena que coincidan con la banda.

¿Quieres una placa lista para Bruce desde el primer momento?

Cada módulo RF de PINGEQUA para M5Stack incluye el mapa de pines y la ruta del menú documentados, para que "not found" no te cueste una noche entera.

RF Pack S3 (StickS3) → Cardputer ADV — Hydra RF → Cardputer v1.1 — 3-in-1 →

Fuentes y lecturas adicionales: firmware Bruce — BruceDevices/firmware, releases; configuración de CC1101 — wiki de Bruce; reportes de "not found" — #2035, #1909, #2148. Versiones verificadas en junio de 2026 — consulta la página de releases para lo más reciente.

Regresar al blog