M5Stack Cardputer RF module with CC1101 and nRF24 for Bruce firmware

Прошивка Bruce на M5Stack: как её прошить и исправить «CC1101 / nRF24 Not Found» (2026)

PINGEQUA Lab · прошивка Bruce · 7 мин чтения · Обновлено 2026-06-25

Новый RF-модуль, который сообщает «not found», кажется мёртвым железом — но на платах M5Stack это почти никогда не так. Вот реальная причина, а также точные настройки Bruce и значения пинов, которые всё исправляют.

Короткий ответ Если ваш RF-модуль M5Stack показывает в Bruce «CC1101 not found» или «nRF24 not detected», радиомодуль почти никогда не сломан. Две самые частые причины: (1) вы ещё не прошили прошивку Bruce — или используете старую сборку с известным багом SPI/питания — и (2) распиновка в BrucePins.conf не соответствует вашей плате. Решение: прошейте актуальный релиз Bruce (1.15, май 2026) на bruce.computer/flasher, задайте правильные пины, затем в приложении зайдите в RF → Config → RF Module, выберите CC1101 (on SPI / Legacy) и перезагрузите устройство.

Что такое Bruce и какие устройства он поддерживает?

Bruce — это прошивка с открытым исходным кодом для наступательной кибербезопасности на устройствах ESP32, которую поддерживает pr3y в репозитории BruceDevices/firmware. Она работает на M5Stack Cardputer, StickC Plus 1.1 / Plus 2, StickS3, M5Core / Core2, а также на платах Lilygo T-Deck / T-Embed. Именно эта прошивка превращает эти карманные устройства в RF-инструменты Sub-GHz (CC1101) и 2.4 ГГц (nRF24L01+) — поэтому RF-модуль PINGEQUA требует прошитого Bruce, прежде чем радиомодули появятся в системе.

Шаг 1 — Прошивка Bruce (три способа, от самого простого)

Вам не понадобится десктопный toolchain или возня с COM-портами.

Способ Как Подходит для
Web-флешер Откройте bruce.computer/flasher в Chrome или Edge, подключитесь через USB, выберите плату, нажмите flash Всем — установка не нужна
M5Launcher OTA Установите M5Launcher, обновите Bruce по воздуху (OTA) Быстрые обновления на уже прошитом устройстве
m5burner Прошивка через десктопное приложение M5Stack m5burner Если вы уже используете M5Burner

Выбирайте сборку, которая точно соответствует вашей плате (например, m5stack-cardputer, m5stack-cplus2, m5stack-sticks3). Неверный board target сам по себе — одна из причин «not found». PINGEQUA также размещает браузерный флешер на flash.pingequa.com для своих плат.

Шаг 2 — Почему возникает «not found» (реальные причины по порядку)

Судя по официальной wiki Bruce и повторяющимся issue на GitHub, причина ошибки сводится к следующему:

  1. Bruce не прошит, либо сборка старая/с багами — безусловная причина №1. Некоторые ранние сборки (например, 1.12 / 1.13) содержали регрессии в тайминге SPI и управлении питанием, из-за которых на исправном железе появлялась ложная «not found»; обновление это устраняет.
  2. Распиновка в BrucePins.conf не подходит вашей плате — радиомодули подключены к пинам chip-select/IRQ, которые нужно объявить правильно.
  3. Модуль не выбран в меню — по умолчанию Bruce может не указывать на ваш внешний CC1101/nRF24, пока вы не выберете его вручную.
  4. Не та модель модуля или плохая посадка — модуль ADV на плате v1.1 (или неплотная посадка) никогда не определяется. См. совместимость Cardputer ADV и v1.1.
  5. Конфигурация не применена в нужном хранилище — на некоторых устройствах BrucePins.conf нужно отредактировать и на SD-карте, и в LittleFS, а затем перезагрузить устройство.
  6. Действительно неисправный модуль — редкий случай, который стоит подозревать в последнюю очередь.

Шаг 3 — Чек-лист исправления

1. Прошейте / обновите Bruce до последней сборки

Используйте bruce.computer/flasher и правильный board target. Уже одно это устраняет баги 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

Две вещи, которые часто упускают: отредактируйте ОБЕ копии — BrucePins.conf существует в корне SD-карты и во внутреннем LittleFS устройства; в зависимости от сборки Bruce читает то одну, то другую, поэтому задайте одинаковые значения в обеих и перезагрузите устройство. А самый простой способ редактирования — WebUI: на устройстве откройте Files → WebUI, подключитесь к своей Wi-Fi-сети, откройте в браузере IP-адрес, показанный на экране (логин по умолчанию admin / bruce), отредактируйте там brucepins.conf и принудительно перезагрузите устройство.

В комплекте с RF Pack S3 для StickS3 идёт карточка быстрого старта с точным путём в меню Bruce и справкой по пинам, так что этот шаг можно пропустить.

3. Выберите модуль в Bruce

Перейдите в RF → Config → RF Module и выберите CC1101 (on SPI). На платах/сборках, где это необходимо, выберите драйвер (Legacy) — CC1101 (Legacy) и nRF24 (Legacy) — который использует более старый, широко совместимый путь SPI.

Особенность, о которой стоит знать — «CC1101 работает только после того, как я сначала открою nRF24». На платах с двумя радиомодулями, использующих одну общую шину SPI, CC1101 может не запуститься, если зайти сразу в него, — потому что его код инициализации предполагает, что шина SPI уже настроена. Если сначала открыть nRF24, это настраивает шину, и после этого CC1101 начинает работать (Bruce issue #1909). Аппаратное решение — буферизованный/изолированный SPI, при котором порядок не важен, — именно это делает буфер SN74 в RF Pack S3.

4. Переустановите модуль и проверьте диапазон

Выключите питание, плотно переустановите модуль на правильный разъём, включите питание и снова откройте меню RF. Убедитесь, что антенна и диапазон соответствуют модулю (плата на 433 МГц настроена именно на 433, а не на 868/915).

5. Всё ещё «not found»?

Теперь имеет смысл обратиться в поддержку. Укажите модель устройства, версию Bruce, board target и содержимое BrucePins.conf, чтобы причину (почти всегда это конфигурация) можно было быстро найти.

Особенности по устройствам

Устройство Bruce build target Примечания
Cardputer ADV (модули Hydra RF) m5stack-cardputer Прошейте последнюю версию Bruce, обновите brucepins.conf через WebUI, затем принудительно перезагрузите. ADV использует для SPI задний разъём 2×7.
Cardputer v1.1 (модуль 3-в-1) m5stack-cardputer Plug-and-play на разъёмах v1.1; прошейте Bruce, выберите CC1101/nRF24 в меню RF.
StickS3 (RF Pack S3) m5stack-sticks3 Используйте сборку Bruce m5stack-sticks3 (нативная распиновка) и драйверы (Legacy). Поддержка StickS3 стабилизировалась в сборках Bruce конца 2025 — начала 2026 года (issue #2148) — поэтому актуальная сборка здесь особенно важна.
StickC Plus / Plus 2 (Stick RF 424) m5stack-cplus / cplus2 Используйте соответствующую сборку m5stack-cplus / cplus2.

FAQ

Почему Bruce показывает «CC1101 not found» / «nRF24 not detected»?
Чаще всего прошивка не установлена (либо это старая сборка с известным багом SPI/питания), либо распиновка в BrucePins.conf не соответствует вашей плате. Прошейте актуальный Bruce, исправьте пины, выберите модуль в RF → Config → RF Module и перезагрузите устройство. Модуль редко бывает реально неисправен.
Как прошить Bruce без десктопного toolchain?
Используйте официальный веб-флешер на bruce.computer/flasher в Chrome или Edge — подключитесь по USB, выберите плату, нажмите flash. Никакого esptool, никакой настройки COM-порта.
Какая сейчас актуальная версия Bruce?
1.15, выпущена 2026-05-25. Держите прошивку актуальной — многие обращения по «not found» связаны именно с устаревшими сборками.
Что выбрать в меню — «CC1101» или «CC1101 (Legacy)»?
Сначала попробуйте CC1101 (on SPI); если радиомодуль всё ещё не определяется, переключитесь на CC1101 (Legacy) (и nRF24 (Legacy)) — этот драйвер использует более старый, но широко совместимый путь SPI.
Где редактировать BrucePins.conf — на SD-карте или во внутренней памяти?
Может действовать и то, и другое. Если редактирование только одной копии не срабатывает, отредактируйте BrucePins.conf и на SD-карте, и в LittleFS, затем перезагрузите устройство. Проще всего это сделать через встроенный WebUI (Files → WebUI, откройте IP-адрес в браузере, логин admin / bruce).
Какие значения пинов использует Cardputer ADV?
Для модулей PINGEQUA Cardputer ADV CC1101 + nRF24: CC1101_Pins → CS 13, IO0 5; NRF24_Pins → CS 6, IO0 4. Задайте эти значения в BrucePins.conf (в обеих копиях) и перезагрузите устройство.
Почему мой CC1101 работает только после того, как я сначала открою nRF24?
На платах с двумя радиомодулями на одной шине SPI инициализация CC1101 предполагает, что шина уже настроена; если сначала открыть nRF24, SPI настраивается, и после этого CC1101 работает (Bruce issue #1909). Плата с буферизованным/изолированным SPI (например, SN74 в RF Pack S3) полностью избегает этой проблемы очерёдности.
Модуль показывает not found сразу после покупки — он бракованный?
Почти наверняка нет. Убедитесь, что вы прошили Bruce, задали правильную распиновку и что модуль соответствует точной модели вашего устройства (ADV или v1.1). Аппаратная неисправность — последнее, что стоит подозревать.
Работает ли модуль на 433 МГц на частотах 868/915 МГц?
Чип CC1101 покрывает эти диапазоны, но плата и антенна, настроенные на 433 МГц, плохо работают вне этого диапазона. Используйте модуль и антенну, соответствующие нужному диапазону.

Нужна плата, готовая к работе с Bruce из коробки?

Каждый RF-модуль PINGEQUA для M5Stack поставляется с задокументированной распиновкой и путём в меню, так что «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 года — актуальную информацию смотрите на странице releases.

Только для авторизованного тестирования безопасности и образовательных целей. Используйте RF-оборудование только на устройствах и частотах, на которые у вас есть разрешение. Вы несёте ответственность за соблюдение всех применимых законов и радиочастотных регламентов (например, FCC Part 15 в США, CE/RED в ЕС). «M5Stack», «Bruce» и «Flipper Zero» упоминаются для указания совместимости; PINGEQUA — независимая компания, не аффилированная с правообладателями и не одобренная ими.

Вернуться к блогу