ESP32 Bit Pirate

ESP32 Bit Pirate は、伝説の Bus Pirate に触発された、あなたのデバイスをマルチプロトコル開発・解析ツールに変えるオープンソースファームウェアです。

シリアルターミナルまたはウェブベースの CLI を介して、さまざまなデジタルプロトコル (I2C、UART、1-Wire、SPI など) のスニッフィング、送信、スクリプティング、および対話操作をサポートします。また、Bluetooth、Wi-Fi、Sub-GHz、RFID などの無線プロトコルとも通信できます。

公式プロジェクトウェブサイトにすべてが集約されています: ESP32 Bit Pirate Website。

そこからファームウェアのインストール、ウェブツールの利用、ハードウェアガイドの参照、レシピの探索、ドキュメントへのアクセスが可能です。

特徴

• USB Serial または WiFi Web を介した対話型コマンドラインインターフェース (CLI)。

• 対応モード:

  • HiZ (デフォルト)
  • I2C (スキャン、グリッチ、スレーブモード、ダンプ、eeprom)
  • SPI (eeprom、フラッシュ、sdcard、スレーブモード)
  • UART / Half-Duplex UART (ブリッジ、読み取り、書き込み)
  • 1WIRE (ibutton、eeprom)
  • 2WIRE (スニッフィング、スマートカード) / 3WIRE (eeprom)
  • DIO (デジタル I/O、読み取り、プルアップ、設定、pwm)
  • Infrared (送信、記録、ユニバーサルリモコン)
  • USB (HID、flashrom、ストレージ、usb-uart)
  • Bluetooth (BLE HID、スキャン、スプーフィング、スニッフィング)
  • Wi-Fi / Ethernet (スニッフィング、deauth、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、フラッシュの読み取り、および SPI 用のその他のさまざまなツール。

• Bus Pirate スタイルのバイトコード命令または Python を使用したスクリプティング。

• 80 以上の INFRARED プロトコルをサポートする Device-B-Gone コマンド。

• 直接 I/O 管理、PWM、サーボ、GPIO 状態。

• すべての帯域で無線信号と周波数を解析。

• 50 近くのアドレス指定可能な LED プロトコルに対応。

• ネットワークにアクセスするための Ethernet と WiFi に対応。

• HTTP 経由の LittleFS を使用したデータのインポートとエクスポート。

• ファームウェアの操作を支援する Pirate assistant。

• USB-Uart ドングル、SPI プログラマー、ロジックアナライザーなど。

• Web ブラウザ上で USB Serial を使用するための Web Serial ツール。

対応デバイス

• その他の ESP32-S3 ベースのボード

  • ESP32-S3 ベースのすべてのボードは対応可能です。ただし、少なくとも 8 MB のフラッシュを備えている必要があります。

  • 任意の ESP32-S3 ボードに s3 dev-kit ファームウェアを書き込むことができます。

  • ファームウェアのデフォルトのピン割り当てがお使いのボードと一致しない場合があることに注意してください。

はじめに

1. 🔧 ファームウェアを書き込む

   • ESP32 Bit Pirate Web Flasher を使用して、Web ブラウザから直接ファームウェアを書き込みます。
   • M5Burner の StickS3、AtomS3、M5StampS3 または Cardputer カテゴリからも書き込めます。

2. 🔌 Serial または Web で接続する

   • Serial: 任意のターミナルアプリ、または無料のブラウザベース Web Serial ターミナル を使用します (Connect via Serial を参照)
   • Web: Wi-Fi を設定し、ブラウザ経由で CLI にアクセスします (Wi-Fi Connection を参照)

3. 🧪 次のようなコマンドを使用します:

   root@kitploit:~

   mode
   help
   scan
   sniff
   ...
   

Wiki

📚 すべてのモードとコマンドの詳細なドキュメントについては、Wiki を参照してください。

内容:

• Terminal mode - Serial と Web ターミナルについて。
• Mode overviews - 対応モードを閲覧。
• Serial setup - USB 経由の Serial アクセス。

Wiki は、すべての仕組みを学ぶのに最適な場所です。

スクリプティング

🛠️ Serial 経由の Python スクリプトを使用して、ESP32 Bit Pirate との対話操作を自動化します。

ESP32 Bit Pirate Python Lab を使用すると、ブラウザ上で直接スクリプトを作成してテストできます。

含まれるもの: ファイルへのデータ記録、eeprom とフラッシュのダンプ、GPIO との対話操作、LED アニメーション...

エキスパンダー

🔌 追加のハードウェアモジュールを使用して、**ESP32 Bit Pirate の機能を拡張**します。 エキスパンダーは、WiFi 5 GhZ またはその他の無線プロトコルのサポートを追加します。

ドック

🔧 オリジナルの Bus Pirate アダプターで動作するように設計された、ESP32 S3 DevKit 用ドッキングステーション。 オリジナルの Bus Pirate エコシステムのアダプターやアクセサリーを接続して使用できます。

PCBWay で ESP32 Bit Pirate Dock を入手する。

コマンドラインインターフェース

ESP32 Bit Pirate ファームウェアは、3 つのコマンドラインインターフェース (CLI) モードを提供します:

すべてのインターフェースは同じコマンド構造を共有しており、相互に置き換えて使用できます (詳細)。

WiFi 経由のモバイル Web インターフェース

Cardputer 用スタンドアロンモード

ブラウザベースの Web Serial ツール

ESP32 Bit Pirate Web Serial Tools は、PuTTY、minicom、その他のターミナルアプリケーションをインストールすることなく、互換性のあるブラウザから Serial CLI への直接アクセスを提供します。

コントリビュート

How To Contribute セクションを参照してください。任意のモードに新しいコマンドを追加する簡単な方法が説明されています。

ビジュアルアセット

画像、ロゴ、プレゼンテーション、写真、動画、イラスト を参照してください。これらのビジュアルは、ファームウェアの説明や宣伝に役立てるため、ブログ記事、ドキュメント、動画、記事で自由に使用できます。

警告

⚠️ 電圧に関する警告: デバイスは 3.3V または 5V でのみ動作させる必要があります。

• 他の電圧レベルのペリフェラルを接続しないでください — 接続すると ESP32 が損傷する可能性があります。

⚠️ 使用に関する警告: このファームウェアは教育、診断、および相互運用性テストの目的のみで提供されています。

• 適切な許可なく、デバイスへの妨害、プロービング、操作に使用しないでください。
• 現地の規制に違反したり、ネットワークや通信を妨害したりする可能性のある、無許可の RF 送信 (例: sub-GHz) を避けてください。
• 著者は、不正アクセスや信号の発射に起因する法的結果を含め、このソフトウェアまたはハードウェアの誤用について一切責任を負いません。
• 常に自国の法律と責任ある開示ポリシーの範囲内で行動してください。