Bruce-Firmware auf dem M5Stack: So flasht man sie und behebt „CC1101 / nRF24 Not Found" (2026)
Share
PINGEQUA Lab · Bruce-Firmware · 7 Min. Lesedauer · Aktualisiert 2026-06-25
Ein brandneuer RF-Aufsatz, der "not found" meldet, fühlt sich nach toter Hardware an — bei M5Stack-Boards ist das aber fast nie der Fall. Hier ist die eigentliche Ursache, mit den genauen Bruce-Einstellungen und Pin-Werten, die das Problem beheben.
Was ist Bruce, und welche Geräte werden unterstützt?
Bruce ist eine Open-Source-Firmware für Offensive Security auf ESP32-Geräten, gepflegt von pr3y unter BruceDevices/firmware. Sie läuft auf M5Stack Cardputer, StickC Plus 1.1 / Plus 2, StickS3, M5Core / Core2 sowie Lilygo T-Deck / T-Embed Boards. Es ist die Firmware, die aus diesen Handhelds Sub-GHz-(CC1101)- und 2.4-GHz-(nRF24L01+)-Funkwerkzeuge macht — deshalb muss bei einem PINGEQUA-RF-Aufsatz erst Bruce geflasht sein, bevor die Funkmodule erscheinen.
- Aktuelle Version: Bruce 1.15, veröffentlicht am 2026-05-25.
- Projekt / Doku: bruce.computer und wiki.bruce.computer.
Schritt 1 — Bruce flashen (drei Wege, der einfachste zuerst)
Du brauchst dafür keine Desktop-Toolchain und musst dich nicht mit COM-Ports herumärgern.
| Methode | Vorgehen | Am besten für |
|---|---|---|
| Web-Flasher | Öffne bruce.computer/flasher in Chrome oder Edge, per USB anschließen, dein Board auswählen, auf Flash klicken | Für alle — keine Installation nötig |
| M5Launcher OTA | M5Launcher installieren, Bruce over-the-air aktualisieren | Schnelle Updates auf einem bereits geflashten Gerät |
| m5burner | Über die M5Stack-Desktop-App m5burner flashen | Wenn du M5Burner ohnehin schon nutzt |
Wähle den Build, der genau zu deinem Board passt (z. B. m5stack-cardputer, m5stack-cplus2, m5stack-sticks3). Das falsche Board-Target ist selbst eine mögliche Ursache für "not found." PINGEQUA betreibt für seine Boards zusätzlich einen Browser-Flasher unter flash.pingequa.com.
Schritt 2 — Warum "not found" auftritt (die eigentlichen Ursachen, der Reihe nach)
Laut Bruces eigenem Wiki und wiederkehrenden GitHub Issues lässt sich der Fehler auf Folgendes zurückführen:
- Bruce nicht geflasht oder ein alter/fehlerhafter Build — mit Abstand Ursache Nr. 1. Einige frühe Builds (z. B. 1.12 / 1.13) enthielten Regressionen beim SPI-Timing und Power-Management, die auf einwandfreier Hardware fälschlich "not found" auslösten; ein Update behebt das.
- Die Pin-Zuordnung in BrucePins.conf passt nicht zu deinem Board — die Funkmodule hängen an Chip-Select-/IRQ-Pins, die korrekt deklariert sein müssen.
- Modul im Menü nicht ausgewählt — Bruce zeigt standardmäßig eventuell nicht auf dein externes CC1101/nRF24, bis du es auswählst.
- Falsches Aufsatz-Modell oder schlechter Sitz — ein ADV-Aufsatz auf einem v1.1 (oder ein lockerer Sitz) wird nie erkannt. Siehe Cardputer ADV vs. v1.1 Kompatibilität.
- Konfiguration nicht im richtigen Speicher übernommen — bei manchen Geräten muss BrucePins.conf sowohl auf der SD-Karte als auch in LittleFS bearbeitet werden, gefolgt von einem Neustart des Geräts.
- Ein tatsächlich defektes Modul — selten, und das Letzte, was man vermuten sollte.
Schritt 3 — Die Checkliste zur Behebung
1. Bruce auf den neuesten Build flashen / aktualisieren
Nutze bruce.computer/flasher mit dem korrekten Board-Target. Das allein behebt schon die SPI-/Power-Bugs alter Builds.
2. Die Pin-Zuordnung festlegen (BrucePins.conf)
Bruce liest die Pin-Zuordnung der Funkmodule aus BrucePins.conf. Die Module werden erst erkannt, wenn die Chip-Select-(CS)- und IO0-Pins zur Verkabelung deines Boards passen.
Pin-Werte für den Cardputer ADV (für die PINGEQUA Cardputer ADV CC1101 + nRF24 Aufsätze):
| Abschnitt | CS-Pin | IO0-Pin |
|---|---|---|
CC1101_Pins |
13 | 5 |
NRF24_Pins |
6 | 4 |
Zwei Dinge werden oft übersehen: BEIDE Kopien bearbeiten — BrucePins.conf liegt sowohl im Root der SD-Karte als auch im LittleFS des Geräts; je nach Build liest Bruce die eine oder die andere, also in beiden dieselben Werte setzen und neu starten. Und der einfachste Editor ist die WebUI: Auf dem Gerät zu Files → WebUI gehen, mit deinem WLAN verbinden, die angezeigte IP im Browser öffnen (Standard-Login admin / bruce), dort brucepins.conf bearbeiten und einen Neustart erzwingen.
3. Das Modul in Bruce auswählen
Gehe zu RF → Config → RF Module und wähle CC1101 (on SPI). Bei Boards/Builds, die es benötigen, wähle den (Legacy)-Treiber — CC1101 (Legacy) und nRF24 (Legacy) —, der den älteren, breit kompatiblen SPI-Pfad nutzt.
4. Neu aufsetzen und das Frequenzband prüfen
Gerät ausschalten, den Aufsatz fest auf den richtigen Header setzen, wieder einschalten und das RF-Menü erneut öffnen. Prüfe, ob Antenne und Frequenzband zum Modul passen (ein 433-MHz-Board ist auf 433 abgestimmt, nicht auf 868/915).
5. Immer noch "not found"?
Jetzt lohnt sich der Support-Kontakt. Gib dabei Gerätemodell, Bruce-Version, Board-Target und BrucePins.conf an, damit die Ursache (fast immer die Konfiguration) schnell gefunden werden kann.
Gerätespezifische Hinweise
| Gerät | Bruce-Build-Target | Hinweise |
|---|---|---|
| Cardputer ADV (Hydra RF Aufsätze) | m5stack-cardputer |
Neuestes Bruce flashen, brucepins.conf über die WebUI aktualisieren, dann Neustart erzwingen. Der ADV nutzt seinen rückseitigen 2×7-Header für SPI. |
| Cardputer v1.1 (3-in-1-Modul) | m5stack-cardputer |
Plug-and-Play auf den v1.1-Headern; Bruce flashen, CC1101/nRF24 im RF-Menü auswählen. |
| StickS3 (RF Pack S3) | m5stack-sticks3 |
Verwende den m5stack-sticks3-Bruce-Build (native Pin-Zuordnung) und die (Legacy)-Treiber. Die StickS3-Unterstützung wurde in Bruce-Builds von Ende 2025 bis Anfang 2026 stabilisiert (Issue #2148) — ein aktueller Build ist hier also besonders wichtig. |
| StickC Plus / Plus 2 (Stick RF 424) |
m5stack-cplus / cplus2
|
Verwende den passenden m5stack-cplus / cplus2-Build. |
FAQ
Warum zeigt Bruce "CC1101 not found" / "nRF24 not detected" an?
Wie flashe ich Bruce ohne Desktop-Toolchain?
Was ist die aktuelle Bruce-Version?
Soll ich im Menü "CC1101" oder "CC1101 (Legacy)" wählen?
Bearbeite ich BrucePins.conf auf der SD-Karte oder im internen Speicher?
Welche Pin-Werte verwendet der Cardputer ADV?
Warum funktioniert mein CC1101 erst, nachdem ich zuerst das nRF24 öffne?
Mein Modul zeigt gleich nach dem Kauf "not found" — ist es defekt?
Funktioniert ein 433-MHz-Modul auch auf 868/915 MHz?
Auf der Suche nach einem Board, das von Haus aus Bruce-ready ist?
Jedes PINGEQUA M5Stack RF-Modul wird mit dokumentierter Pin-Zuordnung und Menüpfad ausgeliefert, damit dich "not found" keinen ganzen Abend kostet.
RF Pack S3 (StickS3) → Cardputer ADV — Hydra RF → Cardputer v1.1 — 3-in-1 →Quellen & weiterführende Informationen: Bruce-Firmware — BruceDevices/firmware, Releases; CC1101-Einrichtung — Bruce-Wiki; "not found"-Meldungen — #2035, #1909, #2148. Versionsstand geprüft im Juni 2026 — aktuelle Angaben siehe Releases-Seite.
Nur für autorisierte Sicherheitstests und Bildungszwecke. Verwende RF-Hardware ausschließlich auf Geräten und Frequenzen, für die du eine Betriebserlaubnis hast. Du bist selbst für die Einhaltung aller geltenden Gesetze und Funkvorschriften verantwortlich (z. B. FCC Part 15 in den USA, CE/RED in der EU). "M5Stack", "Bruce" und "Flipper Zero" werden zur Kompatibilitätsangabe genannt; PINGEQUA ist unabhängig und steht in keiner Verbindung zu bzw. wird nicht unterstützt von deren Rechteinhabern.