ESP32 Bit Pirate

ESP32 Bit Pirate — это открытая прошивка, которая превращает ваше устройство в многофункциональный инструмент разработки и анализа множества протоколов, вдохновлённый легендарным Bus Pirate.

Поддерживает перехват, отправку, скриптинг и взаимодействие с различными цифровыми протоколами (I2C, UART, 1-Wire, SPI и др.) через последовательный терминал или веб-интерфейс CLI. Также работает с радиопротоколами вроде Bluetooth, Wi-Fi, Sub-GHz и RFID.

Официальный сайт проекта объединяет всё в одном месте: Сайт ESP32 Bit Pirate.

Оттуда можно установить прошивку, открыть веб-инструменты, изучить гайды по железу, посмотреть рецепты и открыть документацию.

Возможности

• Интерактивный интерфейс командной строки (CLI) через USB Serial или WiFi Web.
• Режимы для:
  • HiZ (по умолчанию)
  • I2C (сканирование, глитч, режим slave, дамп, eeprom)
  • SPI (eeprom, flash, sdcard, режим slave)
  • UART / Half-Duplex UART (бридж, чтение, запись)
  • 1WIRE (ibutton, eeprom)
  • 2WIRE (перехват, смарт-карта) / 3WIRE (eeprom)
  • DIO (цифровой I/O, чтение, подтяжка, установка, PWM)
  • Инфракрасный (отправка, запись, универсальный пульт)
  • USB (HID, flashrom, хранилище, usb-uart)
  • Bluetooth (BLE HID, сканирование, спуфинг, сниффинг)
  • Wi-Fi / Ethernet (сниффинг, деаут, nmap, netcat)
  • JTAG (сканирование, SWD, openOCD)
  • LED (анимации, установка LED)
  • I2S (тест динамиков, микрофон, воспроизведение звука)
  • CAN (сниффинг, отправка и приём кадров)
  • SUBGHZ (анализ, запись, повтор)
  • RFID (чтение, запись, клонирование)
  • RF24 (сканирование, отправка, приём)
  • FM (анализ, вещание)
  • CELL (дамп SIM-карты, SMS, звонки)
  • LORA (сниффинг, полезная нагрузка, meshtatic)

• Снифферы протоколов I2C, UART, SPI, 1Wire, 2wire, CAN, Wi-Fi, Bluetooth, SubGhz.
• Автоопределение бодрейта, AT-команды и различные инструменты для UART.
• Манипуляция регистрами, инструменты дампа EEPROM, идентификация устройств для I2C.
• Чтение всех видов EEPROM, Flash и различных других инструментов для SPI.
• Скриптинг с использованием байт-кода в стиле Bus Pirate или Python.
• Команда Device-B-Gone с поддержкой более 80 инфракрасных протоколов.
• Прямое управление I/O, PWM, сервоприводы, состояние GPIO.
• Анализ радиосигналов и частот во всех диапазонах.
• Поддержка почти 50 протоколов адресуемых LED.
• Поддержка Ethernet и WiFi для доступа к сетям.
• Импорт и экспорт данных через LittleFS по HTTP.
• Пиратский ассистент для помощи в работе с прошивкой.
• USB-UART адаптер, SPI-программатор, логический анализатор и многое другое.
• Веб-инструменты Web Serial для использования USB Serial через веб-браузер.

Поддерживаемые устройства

Устройство		Описание
ESP32 S3 Dev Kit		Более 20 доступных GPIO, 1 кнопка
M5 AtomS3 Lite		8 GPIO (Grove, Header), IR TX, 1 кнопка
M5 Cardputer		2 GPIO (Grove), экран, клавиатура, микрофон, динамик, IR TX, SD-карта, батарея, автономный режим
M5 Cardputer ADV		12 GPIO (Grove, Header), экран, клавиатура, микрофон, динамик, IR TX, SD-карта, IMU, батарея, автономный режим
M5 StampS3		9 GPIO (распинованные выводы), 1 кнопка
M5 Stick S3		13 GPIO (Grove, Header), экран, микрофон, динамик, IR TX, IR RX, IMU, 3 кнопки, батарея
LILYGO T-Display		13 GPIO (1 Qwicc), экран, 2 кнопки
LILYGO T-Embed		9 GPIO (Grove, Header), экран, энкодер, динамик, микрофон, SD-карта
LILYGO T-Embed CC1101		4 GPIO (2x Qwiic), экран, энкодер, динамик, микрофон, SD Card, CC1101, PN532, IR TX, IR RX , батарея
LILYGO T-Embed CC1101 Plus		4 GPIO (2x Qwiic), экран, энкодер, динамик, микрофон, SD Card, CC1101, NRF24, PN532, IR TX, IR RX , батарея
Heltec WiFi LoRa 32 V4		15 GPIO (Header), SX1262 LoRa, 2 кнопки, экран не поддерживается
Heltec Vision Master T190		15 GPIO (Header, Qwiiic), экран, 2 кнопки, SX1262 LoRa
Seeed Studio Xiao S3		9 GPIO (распинованные выводы), 1 кнопка
Waveshare ESP32-S3-GEEK		7 GPIO (Dupont header), экран, 1 кнопка, SD-карта
- Другие платы на базе ESP32-S3

- Все платы на базе ESP32-S3 могут быть поддерживаемы, если у них есть минимум 8 МБ флеш-памяти.

- Вы можете прошить прошивку s3 dev-kit на любую плату ESP32-S3.

- Имейте в виду, что стандартное назначение пинов в прошивке может не совпадать с вашей конкретной платой.

Начало работы

1. 🔧 Прошейте прошивку

   • Используйте ESP32 Bit Pirate Web Flasher, чтобы записать прошивку прямо из веб-браузера.
   • Также можно прошить через M5Burner, в категории StickS3, AtomS3, M5StampS3 или Cardputer.

2. 🔌 Подключитесь через Serial или Web

   • Serial: любое терминальное приложение или бесплатный браузерный Web Serial терминал (см. Подключение через Serial)
   • Web: настройте Wi-Fi и получите доступ к CLI через браузер (см. Wi-Fi подключение)

3. 🧪 Используйте команды вроде: mode help scan sniff ...

Wiki

📚 Посетите Wiki для подробной документации по каждому режиму и команде.

Включает: - Режим терминала — о последовательном и веб-терминале. - Обзоры режимов — список поддерживаемых режимов. - Настройка Serial — доступ через USB.

Wiki — лучшее место, чтобы узнать, как всё работает.

Скриптинг

🛠️ Автоматизируйте взаимодействие с ESP32 Bit Pirate с помощью Python-скриптов через Serial.

Вы можете писать и тестировать скрипты прямо в браузере с ESP32 Bit Pirate Python Lab.

Включая: логирование данных в файл, дамп EEPROM и флеш, взаимодействие с GPIO, анимация LED...

Экспандер

🔌 Расширьте возможности ESP32 Bit Pirate с дополнительными аппаратными модулями. Экспандер добавляет поддержку WiFi 5 ГГц или других радиопротоколов.

Док

🔧 Док-станция для ESP32 S3 DevKit, разработанная для работы с оригинальными адаптерами Bus Pirate. Она позволяет подключать и использовать оригинальную экосистему адаптеров и аксессуаров Bus Pirate.

Получите ESP32 Bit Pirate Dock на PCBWay.

Интерфейсы командной строки

Прошивка ESP32 Bit Pirate предоставляет три режима интерфейса командной строки (CLI):

Все интерфейсы используют одну и ту же структуру команд и взаимозаменяемы (подробнее).

Мобильный веб-интерфейс через WiFi

Автономный режим для Cardputer

Браузерные инструменты Web Serial

Веб-инструменты ESP32 Bit Pirate для Web Serial обеспечивают прямой доступ к последовательному CLI из совместимого браузера без установки PuTTY, minicom или другого терминального приложения.

Участие в разработке

См. раздел Как участвовать, в котором описан простой способ добавить новую команду в любой режим.

Визуальные материалы

См. изображения, логотип, презентации, фото, видео, иллюстрации. Эти визуальные материалы могут свободно использоваться в блогах, документации, видео или статьях для объяснения и продвижения прошивки.

Предупреждение

⚠️ Предупреждение о напряжении: Устройства должны работать только при 3.3 В или 5 В. - Не подключайте периферию с другими уровнями напряжения — это может повредить ваш ESP32.

⚠️ Предупреждение об использовании: Эта прошивка предоставляется только для образовательных, диагностических целей и тестирования совместимости. - Не используйте её для вмешательства, сканирования или манипулирования устройствами без надлежащего разрешения. - Избегайте несанкционированных RF-передач (например, sub-GHz), которые могут нарушать местные законы или сбивать сети и связи. - Авторы не несут ответственности за любое неправильное использование этого программного обеспечения или оборудования, включая правовые последствия, возникающие из несанкционированного доступа или излучения сигналов. - Всегда действуйте в рамках законов вашей страны и политик ответственного раскрытия информации.