M5Stack向けBruceファームウェア:書き込み方法と「CC1101 / nRF24 Not Found」の直し方(2026年)
Share
PINGEQUA Lab · Bruceファームウェア · 読了目安7分 · 更新日 2026-06-25
買ったばかりのRFモジュールが"not found"と表示されると、ハードウェアが死んでいるように感じます — しかしM5Stack系のボードでは、そのケースはほぼありません。ここでは本当の原因と、それを解決する正確なBruceの設定・ピン値を解説します。
Bruceとは何か、対応デバイスは?
BruceはESP32デバイス向けのオープンソース攻撃的セキュリティファームウェアで、pr3y氏がBruceDevices/firmwareで開発・保守しています。M5Stack Cardputer、StickC Plus 1.1 / Plus 2、StickS3、M5Core / Core2のほか、Lilygo T-Deck / T-Embed系のボードでも動作します。これらのハンドヘルド機をSub-GHz(CC1101)・2.4GHz(nRF24L01+)対応のRFツールに変えるファームウェアであり、だからこそPINGEQUAのRFモジュールは無線モジュールが認識される前にBruceの書き込みが必要になります。
- 最新版:Bruce 1.15(2026-05-25 リリース)。
- プロジェクト / ドキュメント:bruce.computer および wiki.bruce.computer。
ステップ1 — Bruceを書き込む(3つの方法、簡単な順)
デスクトップのツールチェーンも、COMポートの設定も一切不要です。
| 方法 | 手順 | 向いているケース |
|---|---|---|
| Webフラッシャー | ChromeまたはEdgeでbruce.computer/flasherを開き、USBで接続してボードを選び、flashをクリック | 誰にでもおすすめ — インストール不要 |
| M5Launcher OTA | M5Launcherをインストールし、Bruceを無線(OTA)で更新 | 書き込み済みデバイスの素早い更新向け |
| m5burner | M5Stackのデスクトップアプリm5burnerから書き込み | すでにM5Burnerを使っている場合 |
自分のボードに正確に一致するビルドを選んでください(例:m5stack-cardputer、m5stack-cplus2、m5stack-sticks3)。ボードターゲットを間違えること自体が"not found"の原因になります。PINGEQUAも自社ボード向けにブラウザ内蔵のフラッシャーをflash.pingequa.comで提供しています。
ステップ2 — なぜ"not found"が起きるのか(実際の原因を順番に)
Bruce公式wikiや繰り返し報告されているGitHub issueによると、原因は次のいずれかに集約されます。
- Bruce未書き込み、または古い/不具合のあるビルド — 圧倒的に最多の原因。初期の一部ビルド(例:1.12 / 1.13)にはSPIタイミングや電源管理のリグレッションがあり、正常なハードウェアでも誤って"not found"になっていました。更新すれば解決します。
- BrucePins.confのピン設定がボードと合っていない — 無線モジュールはchip-select/IRQピンに配線されており、これらを正しく宣言する必要があります。
- メニューでモジュールが選択されていない — 選択するまでBruceの初期設定が外付けのCC1101/nRF24を指していない場合があります。
- モジュールの型が違う、または装着不良 — ADVモジュールをv1.1に挿しても(あるいは接触が緩い場合も)絶対に認識されません。詳しくはCardputer ADVとv1.1の互換性を参照してください。
- 設定が正しい保存先に反映されていない — 機種によってはBrucePins.confをSDカードとLittleFSの両方で編集し、デバイスを再起動する必要があります。
- 本当にモジュールが故障している — 稀なケースで、最後に疑うべき原因です。
ステップ3 — 解決チェックリスト
1. Bruceを最新ビルドに書き込み/更新する
bruce.computer/flasherを使い、正しいボードターゲットを選びます。これだけで旧ビルドのSPI/電源バグは解消されます。
2. ピン設定(BrucePins.conf)を行う
Bruceは無線モジュールのピン割り当てをBrucePins.confから読み込みます。chip-select(CS)とIO0のピンがボードの配線と一致するまで、無線モジュールは認識されません。
Cardputer ADVのピン値(PINGEQUA Cardputer ADV CC1101 + nRF24モジュール向け):
| セクション | CSピン | IO0ピン |
|---|---|---|
CC1101_Pins |
13 | 5 |
NRF24_Pins |
6 | 4 |
見落とされがちな点が2つあります。まず両方のコピーを編集すること — BrucePins.confはSDカードのルートとデバイス内のLittleFSの両方に存在し、ビルドによってBruceがどちらを読むか変わるため、両方に同じ値を設定して再起動してください。もう一つ、最も簡単な編集方法はWebUIです。デバイス上でFiles → WebUIを開き、Wi-Fiに接続し、画面に表示されたIPをブラウザで開いて(デフォルトのログインはadmin / bruce)、そこでbrucepins.confを編集し、強制的に再起動してください。
3. Bruce側でモジュールを選択する
RF → Config → RF Moduleに進み、CC1101 (on SPI)を選択します。必要なボード/ビルドでは、より古く互換性の広いSPI経路を使う(Legacy)ドライバー — CC1101 (Legacy)とnRF24 (Legacy) — を選んでください。
4. 挿し直してバンドを確認する
電源を切り、正しいヘッダーにモジュールをしっかり挿し直してから電源を入れ、RFメニューを開き直してください。アンテナとバンドがモジュールと一致しているかも確認しましょう(433MHz用ボードは433MHz用に調整されており、868/915MHzには対応していません)。
5. それでも"not found"のままなら
ここまで来たらサポートに問い合わせる価値があります。デバイスの機種、Bruceのバージョン、ボードターゲット、BrucePins.confの内容を伝えれば、原因(ほぼ常に設定まわり)を素早く特定できます。
機種別の注意点
| 機種 | Bruceビルドターゲット | 備考 |
|---|---|---|
| Cardputer ADV(Hydra RFモジュール) | m5stack-cardputer |
最新のBruceを書き込み、WebUI経由でbrucepins.confを更新後、強制的に再起動してください。ADVは背面の2×7ヘッダーをSPIに使用します。 |
| Cardputer v1.1(3-in-1モジュール) | m5stack-cardputer |
v1.1のヘッダーにそのまま挿すだけ。Bruceを書き込み、RFメニューでCC1101/nRF24を選択してください。 |
| StickS3(RF Pack S3) | m5stack-sticks3 |
m5stack-sticks3向けのBruceビルド(ネイティブのピン設定)と(Legacy)ドライバーを使用してください。StickS3のサポートは2025年末〜2026年初頭のBruceビルドで安定しました(issue #2148)。そのため特に最新ビルドの使用が重要です。 |
| StickC Plus / Plus 2(Stick RF 424) |
m5stack-cplus / cplus2
|
対応するm5stack-cplus / cplus2ビルドを使用してください。 |
よくある質問
なぜBruceで"CC1101 not found" / "nRF24 not detected"と表示されるのですか?
デスクトップのツールチェーンなしでBruceを書き込むには?
現在のBruceの最新バージョンは?
メニューでは"CC1101"と"CC1101 (Legacy)"のどちらを選ぶべきですか?
BrucePins.confはSDカードと内部ストレージのどちらを編集すればよいですか?
Cardputer ADVのピン値はいくつですか?
なぜnRF24を先に開かないとCC1101が動作しないのですか?
買ってすぐモジュールが not foundと表示されます — 不良品でしょうか?
433MHzモジュールは868/915MHzでも使えますか?
最初からBruce対応済みのボードが欲しいですか?
PINGEQUAのM5Stack向けRFモジュールにはすべてピン設定とメニューパスが明記されているので、"not found"に一晩を費やす必要はありません。
RF Pack S3 (StickS3) → Cardputer ADV — Hydra RF → Cardputer v1.1 — 3-in-1 →出典・参考情報:Bruceファームウェア — BruceDevices/firmware、releases;CC1101のセットアップ — Bruce wiki;"not found"の報告 — #2035、#1909、#2148。バージョン情報は2026年6月時点で確認済み — 最新情報はreleasesページを確認してください。
許可を得たセキュリティテストおよび教育目的に限り使用してください。RFハードウェアは、運用が許可されたデバイス・周波数でのみ使用してください。適用されるすべての法令・電波関連規制(例:米国のFCC Part 15、EUのCE/RED)を遵守する責任はご自身にあります。"M5Stack"、"Bruce"、"Flipper Zero"は互換性を示すために言及しているものであり、PINGEQUAはこれらの権利者とは独立した存在であり、提携・承認を受けたものではありません。