M5Stack Cardputer RF module with CC1101 and nRF24 for Bruce firmware

Bruce-Firmware auf dem M5Stack: So flasht man sie und behebt „CC1101 / nRF24 Not Found" (2026)

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.

Kurzantwort Wenn dein M5Stack-RF-Modul in Bruce "CC1101 not found" oder "nRF24 not detected" anzeigt, ist das Funkmodul fast nie defekt. Die zwei häufigsten Ursachen: (1) Du hast noch keine Bruce-Firmware geflasht — oder du nutzt einen alten Build mit einem bekannten SPI-/Power-Bug — und (2) die Pin-Zuordnung in BrucePins.conf passt nicht zu deinem Board. Die Lösung: Flashe die aktuelle Bruce-Version (1.15, Mai 2026) über bruce.computer/flasher, setze die richtigen Pins, gehe dann in der App zu RF → Config → RF Module, wähle CC1101 (on SPI / Legacy) und starte neu.

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.

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:

  1. 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.
  2. 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.
  3. Modul im Menü nicht ausgewählt — Bruce zeigt standardmäßig eventuell nicht auf dein externes CC1101/nRF24, bis du es auswählst.
  4. 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.
  5. 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.
  6. 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.

Das RF Pack S3 für StickS3 wird mit einer Schnellstart-Karte geliefert, die den genauen Bruce-Menüpfad und die Pin-Referenz enthält — dieser Schritt entfällt damit.

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.

Eigenheit, die man kennen sollte — "CC1101 funktioniert erst, nachdem ich zuerst das nRF24 öffne." Bei Dual-Radio-Boards, die sich einen SPI-Bus teilen, kann das CC1101 scheitern, wenn du direkt hineinbootest, weil sein Init-Code davon ausgeht, dass der SPI-Bus bereits konfiguriert ist — öffnet man zuerst das nRF24, wird der Bus dabei konfiguriert, und danach funktioniert auch das CC1101 (Bruce Issue #1909). Die hardwareseitige Lösung ist ein gepuffertes/isoliertes SPI, bei dem die Reihenfolge keine Rolle mehr spielt — genau das leistet der SN74-Puffer im RF Pack S3.

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?
Meist ist die Firmware nicht geflasht (oder es handelt sich um einen alten Build mit einem bekannten SPI-/Power-Bug), oder die Pin-Zuordnung in BrucePins.conf passt nicht zu deinem Board. Flashe die aktuelle Bruce-Version, korrigiere die Pins, wähle das Modul unter RF → Config → RF Module aus und starte neu. Das Modul ist nur selten tatsächlich defekt.
Wie flashe ich Bruce ohne Desktop-Toolchain?
Nutze den offiziellen Web-Flasher unter bruce.computer/flasher in Chrome oder Edge — per USB anschließen, dein Board wählen, auf Flash klicken. Kein esptool, kein COM-Port-Setup nötig.
Was ist die aktuelle Bruce-Version?
1.15, veröffentlicht am 2026-05-25. Halte sie aktuell — mehrere "not found"-Meldungen gehen auf veraltete Builds zurück.
Soll ich im Menü "CC1101" oder "CC1101 (Legacy)" wählen?
Versuche zuerst CC1101 (on SPI); wird das Funkmodul weiterhin nicht erkannt, wechsle zu CC1101 (Legacy) (und nRF24 (Legacy)), das den älteren, breiter kompatiblen SPI-Treiberpfad nutzt.
Bearbeite ich BrucePins.conf auf der SD-Karte oder im internen Speicher?
Beides kann zutreffen. Falls das Bearbeiten nur einer Version nicht wirkt, bearbeite BrucePins.conf sowohl auf der SD-Karte als auch in LittleFS und starte dann neu. Der einfachste Editor ist die geräteinterne WebUI (Files → WebUI, die IP im Browser öffnen, Login admin / bruce).
Welche Pin-Werte verwendet der Cardputer ADV?
Für die PINGEQUA Cardputer ADV CC1101 + nRF24 Aufsätze: CC1101_Pins → CS 13, IO0 5; NRF24_Pins → CS 6, IO0 4. Setze diese Werte in BrucePins.conf (beide Kopien) und starte neu.
Warum funktioniert mein CC1101 erst, nachdem ich zuerst das nRF24 öffne?
Bei Dual-Radio-Boards, die sich einen SPI-Bus teilen, geht die Init-Routine des CC1101 davon aus, dass der Bus bereits konfiguriert ist; öffnet man zuerst das nRF24, wird SPI dabei eingerichtet, sodass das CC1101 danach funktioniert (Bruce Issue #1909). Ein Board mit gepuffertem/isoliertem SPI (z. B. das SN74 im RF Pack S3) vermeidet dieses Reihenfolge-Problem komplett.
Mein Modul zeigt gleich nach dem Kauf "not found" — ist es defekt?
Mit ziemlicher Sicherheit nicht. Prüfe, ob du Bruce geflasht, die richtige Pin-Zuordnung gesetzt hast und ob der Aufsatz zu deinem genauen Gerätemodell passt (ADV vs. v1.1). Ein Hardwaredefekt ist das Letzte, was infrage kommt.
Funktioniert ein 433-MHz-Modul auch auf 868/915 MHz?
Der CC1101-Chip deckt diese Frequenzbänder ab, aber ein auf 433 abgestimmtes Board und eine entsprechende Antenne performen außerhalb davon schlecht. Verwende ein zum Frequenzband passendes Modul und eine passende Antenne.

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.

Zurück zum Blog