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 (сканирование, глитчинг, режим ведомого, дамп, eeprom)
  • SPI (eeprom, flash, sdcard, режим ведомого)
  • UART / Half-Duplex UART (мост, чтение, запись)
  • 1WIRE (ibutton, eeprom)
  • 2WIRE (сниффинг, смарт-карты) / 3WIRE (eeprom)
  • DIO (цифровой ввод/вывод, чтение, подтяжка, установка, ШИМ)
  • Infrared (отправка, запись, универсальный пульт)
  • USB (HID, flashrom, хранилище, usb-uart)
  • Bluetooth (BLE HID, сканирование, спуфинг, сниффинг)
  • Wi-Fi / Ethernet (сниффинг, deauth, nmap, netcat)
  • JTAG (сканирование, SWD, openOCD)
  • LED (анимации, настройка светодиодов)
  • I2S (тестирование динамиков, микрофона, воспроизведение звука)
  • CAN (сниффинг, отправка и приём кадров)
  • SUBGHZ (анализ, запись, воспроизведение)
  • RFID (чтение, запись, клонирование)
  • RF24 (сканирование, отправка, приём)
  • FM (анализ, вещание)
  • CELL (дамп SIM-карты, SMS, звонки)
  • LORA (сниффинг, полезная нагрузка, meshtatic)

• Снифферы протоколов I2C, UART, SPI, 1Wire, 2wire, CAN, Wi-Fi, Bluetooth, SubGhz.

• Автоопределение скорости (baudrate), AT-команды и различные инструменты для UART.

• Работа с регистрами, инструменты дампа EEPROM, определение устройств для I2C.

• Чтение всевозможных EEPROM, Flash и множество других инструментов для SPI.

• Написание скриптов с использованием байткода в стиле Bus Pirate или Python.

• Команда Device-B-Gone с поддержкой более 80 протоколов INFRARED.

• Прямое управление вводом/выводом, ШИМ, сервоприводы, состояние GPIO.

• Анализ радиосигналов и частот во всех диапазонах.

• Поддержка почти 50 протоколов адресуемых светодиодов.

• Ethernet и WiFi поддерживаются для доступа к сетям.

• Импорт и экспорт данных с помощью LittleFS через HTTP.

• Pirate assistant для помощи в работе с прошивкой.

• Переходник USB-UART, программатор SPI, логический анализатор и многое другое.

• Веб-инструменты Web Serial для использования USB Serial через веб-браузер.

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

• Другие платы на базе ESP32-S3

  • Могут поддерживаться все платы на базе ESP32-S3 при условии, что они имеют не менее 8 МБ flash-памяти.

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

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

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

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

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

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

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

3. 🧪 Используйте команды, например:

   root@kitploit:~

   mode
   help
   scan
   sniff
   ...
   

Wiki

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

Содержит:

• Терминальный режим — О последовательном и веб-терминале.
• Обзор режимов — Просмотр поддерживаемых режимов.
• Настройка Serial — Доступ через последовательный порт USB.

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

Написание скриптов

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

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

Включая: запись данных в файл, дамп eeprom и flash, взаимодействие с GPIO, анимацию светодиодов...

Expander

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

Dock

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

Закажите ESP32 Bit Pirate Dock на PCBWay.

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

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

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

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

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

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

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

Внести вклад

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

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

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

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

⚠️ Предупреждение о напряжении: Устройства должны работать только при напряжении 3.3V или 5V.

• Не подключайте периферийные устройства с другими уровнями напряжения — это может повредить ваш ESP32.

⚠️ Предупреждение об использовании: Эта прошивка предоставляется только для образовательных целей, диагностики и проверки совместимости.

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