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

Warum nRF24-Scanner-Apps auf Dual-Chip-PINGEQUA-2-in-1-Flipper-Platinen einen Schwarzbildschirm zeigen — und wie wir das behoben haben

Ein generischer nRF24-Channel-Scanner kann den Bildschirm eines Flipper Zero auf 2-in-1-Dual-Chip-Platinen mitten im Scan schwarz werden lassen — hier ist die Ursache in der SPI-Bus-Arbitrierung und die Lösung, die wir in RF Lab ausgeliefert haben.

KurzantwortDer schwarze Bildschirm entsteht, weil Single-Chip-nRF24-Scanner-Apps den zweiten Chip auf einem gemeinsam genutzten SPI-Bus nie deselektieren und dadurch den Display-Refresh-Task des Flipper aushungern. PINGEQUA hat das in RF Lab (jetzt v0.5.4, 2026-06-12) behoben, indem jede Transaktion über ein einziges furi_hal_spi_bus_handle_external läuft und die CSN des inaktiven Chips vor jedem Zugriff stets auf High gezogen wird. Es ist ein kostenloses Open-Source-.fap für das PINGEQUA 2-in-1 nRF24 + CC1101 RF Devboard.
PINGEQUA 2-in-1 nRF24 + CC1101 Platine mit zwei Antennen auf dem Flipper Zero, Channel Scanner läuft

Das Symptom

Startet man auf einer Dual-Chip-Platine einen Channel-Scanner eines Drittanbieters für nRF24 und beginnt einen Signal-Scan, kann das Flipper-Display mittendrin schwarz werden.

Flipper-Bildschirm, der sich während eines nRF24-Scans auf einer Dual-Chip-Platine von unten her schwarz füllt
Ein nRF24-Channel-Scanner eines Drittanbieters auf einer 2-in-1-Platine — das Display füllt sich mitten im Scan von unten her schwarz.

Das betrifft nicht nur unsere Hardware. Die am häufigsten geforkte Community-nRF24-App verzeichnet einen offenen Bugreport, der dieselbe Fehlerklasse beschreibt:

„der Bildschirm wird beim Scannen manchmal für etwa 5 Sekunden komplett schwarz. Wird die Scan-Zeit verkürzt, tritt das Schwarzwerden häufiger auf.“
flipperzero-nrf24 issue #15, offen seit 2022

Warum es Dual-Chip-Platinen stärker trifft

Eine 2-in-1-Platine verdrahtet nRF24 und CC1101 parallel auf einem SPI-Bus, softwareseitig ausgewählt über die jeweils eigene CSN-Leitung jedes Chips. Ein Scanner, der für einen einzelnen nRF24 geschrieben wurde, steuert nur seine eigene CSN — er deselektiert den zweiten Chip nie. Dann können beide Chips gleichzeitig auf dem gemeinsamen Bus antworten, und ein Scanner, der den SPI-Bus durchgehend belegt, kann den Display-Refresh-Task aushungern. Das Ergebnis ist ein schwarzer Bildschirm.

Wir sind nicht die Einzigen, die auf diese Lücke bei Legacy-Apps hinweisen — selbst unsere eigenen Produkthinweise warnen, dass Legacy-Anwendungen fest codierte Pin-Definitionen haben können, und empfehlen Apps mit sauberer GPIO-/SPI-Behandlung.

Diese Ursachenbeschreibung ist unsere technische Analyse des beobachteten Verhaltens, kein vom Hersteller bestätigter Defekt.

Warum wir neu geschrieben statt gepatcht haben

Die Eigenheiten eines einzelnen Forks zu patchen behebt nicht das zugrunde liegende Bus-Arbitrierungsproblem und übersteht das nächste Firmware-Update nicht. Deshalb haben wir Anfang 2026 das Toolkit gegen das offizielle Furi SDK neu aufgebaut — keine fork-privaten Symbole, ein sauberer SPI-Arbiter.

Was sich geändert hat

  • Single-Handle-SPI-Arbiter — jede Transaktion läuft über ein einziges Bus-Handle (furi_hal_spi_bus_handle_external), das in jeder Firmware enthalten ist.
  • Der inaktive Chip wird immer deselektiert — vor jedem Zugriff wird die CSN des anderen Chips auf High gezogen. Der Bus bleibt nie mehrdeutig, sodass das Display nie aushungert.
  • Ein .fap, jede Firmware — läuft auf der offiziellen Flipper-Firmware (OFW), Momentum, Unleashed, RogueMaster und Xtreme. Kein Neukompilieren.
PINGEQUA RF Lab Channel Scanner läuft sauber — Live-2,4-GHz-Spektrum, kein schwarzer Bildschirm
Dieselbe Hardware mit RF Lab — volles 126-Kanal-Spektrum, kein Aushungern des Displays.

Versionshistorie und Firmware-Kompatibilität

Was sich über die Releases hinweg geändert hat

Release Was es gebracht hat
Furi-SDK-Neuaufbau (Anfang 2026) Gegen das offizielle Furi SDK neu aufgebaut; einziges SPI-Bus-Handle (furi_hal_spi_bus_handle_external); CSN des inaktiven Chips vor jedem Zugriff immer auf High gezogen.
v0.5.2 Menschenlesbare Export-Dateinamen (z. B. scan_2026-05-15_143022_ch42.csv); On-Device-About-Bildschirm mit scannbaren QR-Codes für Shop und Quell-Repo.
RF Lab v0.5.4 (2026-06-12) Fügt einen 2,4-GHz-Signalgenerator ausschließlich für autorisierte Tests hinzu; Sendeleistung bewusst begrenzt, um FCC §15 / ETSI EN 300 328 einzuhalten.
RF Lab wird aktiv weiterentwickelt — lade dir immer den neuesten Build von GitHub Releases herunter statt einer älteren zwischengespeicherten Version.
RF Lab About-Bildschirm mit scannbarem QR-Code zum Shop
Der On-Device-About-Bildschirm — scanne den QR-Code, um den Shop oder das Quell-Repo zu öffnen.

Firmware-Kompatibilität

Firmware Hinweise
Offizielle Flipper-Firmware (OFW) Mindest-API ≥ 87.1
Momentum Unterstützt, kein Neukompilieren
Unleashed Unterstützt, kein Neukompilieren
RogueMaster Unterstützt, kein Neukompilieren
Xtreme Unterstützt, kein Neukompilieren

Wird als einzelnes ~44-KB-.fap ausgeliefert, das alle fünf Firmware-Ziele von Haus aus abdeckt.

In Aktion sehen

RF Lab Hauptmenü-Navigation auf dem Flipper Zero
Hauptmenü — Scanner, Signalgenerator, About
RF Lab Hauptmenü auf einem Flipper Zero mit der 2-in-1-Platine
Auf der Hardware
RF Lab 2,4-GHz-Signalgenerator-Modus, nur für autorisierte Tests
2,4-GHz-Signalgenerator (nur für autorisierte Tests)

Auf deinem Setup ausprobieren

  1. Lade pingequa_rf_toolkit.fap von GitHub Releases herunter
  2. Ziehe es in qFlipper nach /ext/apps/GPIO/
  3. Starte es über Apps → GPIO → PINGEQUA RF Lab

Kein GPIO-Remapping, kein firmwarespezifisches Setup.

Was als Nächstes kommt, liegt bei dir

Die v0.6-Roadmap ist offen. Wünschst du dir eine Sub-GHz-Spektrumansicht, einen Dualband-Sweep oder eigene Scan-Presets? Öffne ein Issue — die nächste Version entsteht aus dem, was die Leute tatsächlich anfragen.

Offene Hardware. Offener Quellcode.

nRF24L01+PA & CC1101 auf einem einzigen SPI-Bus — für den Flipper Zero.

FAP herunterladen (kostenlos) Hardware kaufen

FAQ

Warum verursachen generische nRF24-Scanner-Apps einen schwarzen Bildschirm auf Dual-Chip-2-in-1-Platinen?
Eine 2-in-1-Platine verdrahtet nRF24 und CC1101 parallel auf einem SPI-Bus, softwareseitig ausgewählt über die jeweils eigene CSN-Leitung jedes Chips. Ein Scanner, der für einen einzelnen nRF24 geschrieben wurde, steuert nur seine eigene CSN — er deselektiert den zweiten Chip nie. Dann können beide Chips gleichzeitig auf dem gemeinsamen Bus antworten, und ein Scanner, der den SPI-Bus durchgehend belegt, kann den Display-Refresh-Task des Flipper aushungern. Sichtbar wird das als Bildschirm, der mitten im Scan schwarz wird. Das ist unsere technische Analyse des beobachteten Verhaltens, kein vom Hersteller bestätigter Defekt.
Mein Bildschirm wird während eines Scans schwarz — ist mein nRF24-Modul defekt?
Nein. Das betrifft nicht nur unsere Hardware, und es ist kein Zeichen für ein defektes Modul. Die am häufigsten geforkte Community-nRF24-App verzeichnet einen offenen Bugreport (Issue #15, offen seit 2022), der dieselbe Fehlerklasse beschreibt — der Bildschirm wird beim Scannen für einige Sekunden schwarz, häufiger bei verkürzter Scan-Zeit. Es ist ein Bus-Arbitrierungsproblem in Software aus der Single-Chip-Ära, kein Hardwarefehler.
Welche App-Version behebt das Problem mit dem schwarzen Bildschirm, und wie wurde es behoben?
RF Lab behebt es — das aktuelle Release ist v0.5.4 (2026-06-12), aufbauend auf dem Neuaufbau von Anfang 2026. Statt die Eigenheiten eines einzelnen Forks zu patchen (was das nächste Firmware-Update nicht überstehen würde), wurde das Toolkit gegen das offizielle Furi SDK mit einem sauberen SPI-Arbiter neu aufgebaut. Jede Transaktion läuft über ein einziges Bus-Handle (furi_hal_spi_bus_handle_external), das in jeder Firmware enthalten ist, und die CSN des inaktiven Chips wird vor jedem Zugriff immer auf High gezogen — sodass der Bus nie mehrdeutig bleibt und das Display nie aushungert. Es wird als ein einzelnes .fap ausgeliefert, das auf der offiziellen Firmware (OFW, API ≥ 87.1), Momentum, Unleashed, RogueMaster und Xtreme läuft, ohne Neukompilieren.
Kann RF Lab senden, oder ist es nur zum Empfang?
Beides. Der 2,4-GHz-Spektrumanalysator (126 Kanäle, Max-Hold, CSV-Export) empfängt, und v0.5.4 enthält zusätzlich einen 2,4-GHz-Signalgenerator ausschließlich für autorisierte HF-Tests. Seine Sendeleistung ist bewusst begrenzt, um FCC §15 / ETSI EN 300 328 einzuhalten. Verwende den Signalgenerator nur auf Frequenzen und in Umgebungen, für die du eine Testerlaubnis hast.
Funktioniert das auf meiner Firmware ohne Neukompilieren?
Ja. RF Lab wird als einzelnes ~44-KB-.fap ausgeliefert, das auf der offiziellen Firmware (OFW, API ≥ 87.1), Momentum, Unleashed, RogueMaster und Xtreme von Haus aus läuft — kein GPIO-Remapping und kein firmwarespezifisches Setup. Lade es von GitHub Releases herunter, ziehe es in qFlipper nach /ext/apps/GPIO/ und starte es über Apps → GPIO → PINGEQUA RF Lab.

Quellen & weiterführende Lektüre: flipperzero-nrf24 #15 · Flipper Furi SDK Dokumentation

Zurück zum Blog