ESP32 Bit Pirate는 전설적인 Bus Pirate에서 영감을 받아, 사용자의 장치를 다중 프로토콜 개발 및 분석 도구로 변환해 주는 오픈 소스 펌웨어 (firmware)입니다.

이 도구는 시리얼 터미널 (serial terminal) 또는 웹 기반 CLI (Command Line Interface)를 통해 다양한 디지털 프로토콜 (I2C, UART, 1-Wire, SPI 등)을 스니핑 (sniffing), 전송, 스크립팅 및 상호작용하는 것을 지원합니다. 또한 Bluetooth, Wi-Fi, Sub-GHz 및 RFID와 같은 무선 프로토콜 (radio protocols)과도 통신합니다.

공식 프로젝트 웹사이트에서 모든 것을 확인할 수 있습니다: ESP32 Bit Pirate Website.

해당 사이트에서 펌웨어를 설치하고, 웹 도구를 열고, 하드웨어 가이드를 따르며, 레시피 (recipes)를 탐색하고, 문서 (documentation)에 접근할 수 있습니다.

USB Serial 또는 WiFi Web을 통한 대화형 명령줄 인터페이스 (CLI).

지원 모드:

• HiZ (기본값)

• I2C (scan, glitch, slave mode, dump, eeprom)

• SPI (eeprom, flash, sdcard, slave mode)

• UART / Half-Duplex UART (bridge, read, write)

• 1WIRE (ibutton, eeprom)

• 2WIRE (sniff, smartcard) / 3WIRE (eeprom)

• DIO (Digital I/O, read, pullup, set, pwm)

• Infrared (send, record, universal remote)

• USB (HID, flashrom, storage, usb-uart)

• Bluetooth (BLE HID, scan, spoofing, sniffing)

• Wi-Fi / Ethernet (sniff, deauth, nmap, netcat)

• JTAG (scan, SWD, openOCD)

• LED (animations, set LEDs)

• I2S (test speakers, mic, play sound)

• CAN (sniff, send and receive frames)

• SUBGHZ (analyze, record, replay)

• RFID (read, write, clone)

• RF24 (scan, send, receive)

• FM (analyze, broadcast)

• CELL (dump sim card, sms, call)

I2C, UART, SPI, 1Wire, 2wire, CAN, Wi-Fi, Bluetooth, SubGhz를 지원하는 프로토콜 스니퍼 (Protocol sniffers).

보드레이트 (Baudrate) 자동 감지 (auto-detection), AT 커맨드 (AT commands) 및 UART를 위한 다양한 도구.

레지스터 조작 (Registers manipulation), I2C 장치 식별 및 EEPROM 덤프 (EEPROM dump) 도구.

모든 종류의 EEPROM, Flash 읽기 및 SPI를 위한 다양한 기타 도구.

Bus Pirate 스타일의 바이트코드 (bytecode) 명령 또는 Python을 사용한 스크립팅 (Scripting).

80개 이상의 적외선 (INFRARED) 프로토콜을 지원하는 Device-B-Gone 명령.

직접적인 I/O 관리, PWM, 서보 (servo), GPIO 상태 제어.

무선 신호 및 주파수 분석.

모든 대역 (on every bands). -
더 가까이 (Near than)

50개의 주소 지정 가능 LED (addressable LEDs) 프로토콜 지원. -
네트워크 접속을 위해 Ethernet 및 WiFi 지원. -
다음 기능을 통해 데이터를 가져오거나 내보낼 수 있습니다:

HTTP를 통한 LittleFS. -
펌웨어 작업을 도와주는 Pirate assistant. -
USB-Uart 동글 (dongle), SPI 프로그래머 (programmer), 로직 분석기 (logic analyzer) 및 기타 도구. -
웹 브라우저에서 USB 시리얼을 사용할 수 있는 Web Serial 도구.

기타 ESP32-S3 기반 보드-
최소 8 MB의 플래시 (flash) 메모리를 보유하고 있다면, 모든 ESP32-S3 기반 보드를 지원할 수 있습니다. -
어떠한 ESP32-S3 보드에도 s3 dev-kit 펌웨어를 플래싱 (flash) 할 수 있습니다. -
펌웨어의 기본 핀 매핑 (pin mapping)이 사용자의 특정 보드와 일치하지 않을 수 있음을 유의하십시오.

🔧 펌웨어 플래싱 (Flash)

• ESP32 Bit Pirate Web Flasher를 사용하여 웹 브라우저에서 직접 펌웨어를 구울 (burn) 수 있습니다.

• M5Burner의 StickS3, AtomS3, M5StampS3 또는 Cardputer 카테고리에서도 구울 수 있습니다.

🔌 시리얼 (Serial) 또는 웹을 통해 연결

• Serial (시리얼): 모든 터미널 앱 또는 무료 브라우저 기반 Web Serial (웹 시리얼) 터미널 (Connect via Serial 참조)

• Web (웹): Wi-Fi를 설정하고 브라우저를 통해 CLI (명령줄 인터페이스)에 접속 (Wi-Fi Connection 참조)

🧪 다음과 같은 명령어를 사용하세요:

mode help scan sniff ...

📚 모든 모드와 명령어에 대한 자세한 문서는 Wiki (위키)를 방문하세요.

포함 내용:

• Terminal mode (터미널 모드) - 시리얼 및 웹 터미널에 관한 내용.
• Mode overviews (모드 개요) - 지원되는 모드 탐색.
• Serial setup (시리얼 설정) - USB를 통한 시리얼 접속.

위키는 모든 작동 원리를 배우기에 가장 좋은 곳입니다.

🛠️ Python 스크립트를 시리얼로 사용하여 ESP32 Bit Pirate와의 상호작용을 자동화하세요.

ESP32 Bit Pirate Python Lab을 사용하면 브라우저에서 직접 스크립트를 작성하고 테스트할 수 있습니다.

포함 기능: 파일에 데이터 로깅, EEPROM 및 Flash 덤프, GPIO 상호작용, LED 애니메이션 등...

🔌 추가 하드웨어 모듈을 사용하여 ESP32 Bit Pirate의 기능을 확장하세요.
Expander (익스팬더)를 추가하면 WiFi 5 GHz 또는 기타 무선 프로토콜 지원이 가능해집니다.

🔧 오리지널 Bus Pirate 어댑터와 함께 작동하도록 설계된 ESP32 S3 DevKit용 도킹 스테이션입니다.
이를 통해 오리지널 Bus Pirate 어댑터 및 액세서리 생태계를 그대로 연결하여 사용할 수 있습니다.

(출시 예정)

ESP32 Bit Pirate 펌웨어는 세 가지 명령줄 인터페이스 (CLI) 모드를 제공합니다:

모든 인터페이스는 동일한 명령어 구조를 공유하며 상호 교체하여 사용할 수 있습니다 (자세한 내용 참조).

ESP32 Bit Pirate Web Serial Tools를 사용하면 PuTTY, minicom 또는 다른 터미널 애플리케이션을 설치할 필요 없이 호환되는 브라우저에서 Serial CLI에 직접 접속할 수 있습니다.

어떤 모드에서도 새로운 명령어를 추가하는 간단한 방법을 설명하는 'How To Contribute' 섹션을 참조하세요.

이미지, 로고, 프레젠테이션, 사진, 비디오, 일러스트레이션을 확인해 보세요. 이러한 시각 자료들은 펌웨어(firmware)를 설명하고 홍보하기 위해 블로그 포스트, 문서, 비디오 또는 기사에서 자유롭게 사용할 수 있습니다.

⚠️ 전압 경고: 장치는 3.3V 또는 5V에서만 작동해야 합니다.

• 다른 전압 레벨을 사용하여 주변 기기를 연결하지 마십시오. 그렇게 하면 ESP32가 손상될 수 있습니다.

⚠️ 사용 경고: 이 펌웨어는 교육, 진단 및 상호 운용성 테스트 목적으로만 제공됩니다.

• 적절한 권한 없이 장치를 방해, 조사 또는 조작하는 데 사용하지 마십시오.
• 지역 규정을 위반하거나 네트워크 및 통신을 방해할 수 있는 승인되지 않은 RF 송신(예: sub-GHz)을 피하십시오.
• 저자들은 무단 액세스 또는 신호 방출로 인한 법적 결과를 포함하여, 이 소프트웨어 또는 하드웨어의 오용에 대해 책임을 지지 않습니다.
• 항상 귀하의 국가 법률 및 책임 있는 공개 정책(responsible disclosure policies)의 범위를 준수하십시오.