Firmware Bruce en M5Stack: cómo flashearlo y solucionar "CC1101 / nRF24 Not Found" (2026)
Share
PINGEQUA Lab · firmware Bruce · 7 min de lectura · Actualizado 2026-06-25
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.
¿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.
- Versión actual: Bruce 1.15, publicada el 2026-05-25.
- Proyecto / documentación: bruce.computer y wiki.bruce.computer.
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:
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
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.
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"?
¿Cómo flasheo Bruce sin una toolchain de escritorio?
¿Cuál es la versión actual de Bruce?
¿Debo elegir "CC1101" o "CC1101 (Legacy)" en el menú?
¿Edito BrucePins.conf en la tarjeta SD o en el almacenamiento interno?
¿Qué valores de pines usa el Cardputer ADV?
¿Por qué mi CC1101 solo funciona después de abrir primero el nRF24?
Mi módulo dice not found justo después de comprarlo — ¿está defectuoso?
¿Un módulo de 433 MHz funciona en 868/915 MHz?
¿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.
Solo para pruebas de seguridad autorizadas y con fines educativos. Usa hardware RF únicamente en dispositivos y frecuencias que estés autorizado a operar. Eres responsable de cumplir con todas las leyes y regulaciones de radio aplicables (p. ej. FCC Part 15 en EE. UU., CE/RED en la UE). "M5Stack", "Bruce" y "Flipper Zero" se mencionan por motivos de compatibilidad; PINGEQUA es independiente y no está afiliada ni respaldada por sus respectivos propietarios.