ESP32 Bit Pirate

ESP32 Bit Pirate è un firmware open-source che trasforma il tuo dispositivo in uno strumento di sviluppo e analisi multi-protocollo, ispirato al leggendario Bus Pirate.

Supporta lo sniffing, l'invio, lo scripting e l'interazione con vari protocolli digitali (I2C, UART, 1-Wire, SPI, ecc.) tramite un terminale seriale o una CLI basata sul web. Comunica inoltre con protocolli radio come Bluetooth, Wi-Fi, Sub-GHz e RFID.

Il sito web ufficiale del progetto centralizza tutto: Sito Web ESP32 Bit Pirate.

Da lì puoi installare il firmware, aprire gli strumenti web, seguire le guide hardware, esplorare le ricette e accedere alla documentazione.

Caratteristiche

• Interfaccia a riga di comando (CLI) interattiva tramite USB Serial o WiFi Web.

• Modalità per:

  • HiZ (predefinita)
  • I2C (scan, glitch, modalità slave, dump, eeprom)
  • SPI (eeprom, flash, sdcard, modalità slave)
  • UART / Half-Duplex UART (bridge, lettura, scrittura)
  • 1WIRE (ibutton, eeprom)
  • 2WIRE (sniff, smartcard) / 3WIRE (eeprom)
  • DIO (I/O digitale, lettura, pullup, set, pwm)
  • Infrared (invio, registrazione, telecomando universale)
  • USB (HID, flashrom, storage, usb-uart)
  • Bluetooth (BLE HID, scan, spoofing, sniffing)
  • Wi-Fi / Ethernet (sniff, deauth, nmap, netcat)
  • JTAG (scan, SWD, openOCD)
  • LED (animazioni, impostazione LED)
  • I2S (test altoparlanti, microfono, riproduzione audio)
  • CAN (sniff, invio e ricezione frame)
  • SUBGHZ (analisi, registrazione, replay)
  • RFID (lettura, scrittura, clonazione)
  • RF24 (scansione, invio, ricezione)
  • FM (analisi, trasmissione)
  • CELL (dump scheda SIM, sms, chiamata)
  • LORA (sniff, payload, meshtatic)

• Sniffer di protocollo I2C, UART, SPI, 1Wire, 2wire, CAN, Wi-Fi, Bluetooth, SubGhz.

• Auto-rilevamento del baudrate, comandi AT e vari strumenti per UART.

• Manipolazione dei registri, strumenti di dump EEPROM, identificazione dei dispositivi per I2C.

• Leggi ogni tipo di EEPROM, Flash e vari altri strumenti per SPI.

• Scripting tramite istruzioni bytecode in stile Bus Pirate o Python.

• Comando Device-B-Gone con più di 80 protocolli a infrarossi supportati.

• Gestione diretta dell'I/O, PWM, servo, stato dei GPIO.

• Analizza segnali radio e frequenze su tutte le bande.

• Supporto per più di 50 protocolli di LED indirizzabili.

• Ethernet e WiFi supportati per l'accesso alle reti.

• Importa ed esporta dati con LittleFS via HTTP.

• Pirate assistant per aiutarti con il firmware.

• Dongle USB-Uart, programmatore SPI, logic analyzer e altro.

• Strumenti Web Serial per usare USB Serial tramite un browser web.

Dispositivi Supportati

• Altre schede basate su ESP32-S3

  • Tutte le schede basate su ESP32-S3 possono essere supportate, purché abbiano almeno 8 MB di flash.

  • Puoi flasare il firmware s3 dev-kit su qualsiasi scheda ESP32-S3.

  • Tieni presente che il mapping dei pin predefinito nel firmware potrebbe non corrispondere alla tua scheda specifica.

Per Iniziare

1. 🔧 Flasa il firmware

   • Usa l'ESP32 Bit Pirate Web Flasher per flasare il firmware direttamente da un browser web.
   • Puoi anche flasarlo con M5Burner, nella categoria StickS3, AtomS3, M5StampS3 o Cardputer.

2. 🔌 Connettiti via Seriale o Web

   • Seriale: qualsiasi applicazione terminale, oppure il terminale Web Serial gratuito basato su browser (vedi Connessione via Seriale)
   • Web: configura il Wi-Fi e accedi alla CLI tramite browser (vedi Connessione Wi-Fi)

3. 🧪 Usa comandi come:

   root@kitploit:~

   mode
   help
   scan
   sniff
   ...
   

Wiki

📚 Visita la Wiki per la documentazione dettagliata su ogni modalità e comando.

Include:

• Modalità terminale - Informazioni sul terminale seriale e web.
• Panoramica delle modalità - Sfoglia le modalità supportate.
• Configurazione seriale - Accesso seriale tramite USB.

La wiki è il posto migliore per imparare come funziona tutto.

Scripting

🛠️ Automatizza le interazioni con l'ESP32 Bit Pirate utilizzando script Python via seriale.

Puoi scrivere e testare script direttamente nel browser con l'ESP32 Bit Pirate Python Lab.

Incluso: registrazione dei dati su file, dump di eeprom e flash, interazione con i GPIO, animazioni LED...

Expander

🔌 Espandi le capacità dell'ESP32 Bit Pirate con moduli hardware aggiuntivi. L'Expander aggiunge il supporto per il WiFi 5 GHz o altri protocolli radio.

Dock

🔧 Una docking station per l'ESP32 S3 DevKit progettata per funzionare con gli adattatori Bus Pirate originali. Ti permette di collegare e utilizzare l'ecosistema originale di adattatori e accessori Bus Pirate.

Ottieni l'ESP32 Bit Pirate Dock su PCBWay.

Interfacce a riga di comando

Il firmware ESP32 Bit Pirate offre tre modalità di interfaccia a riga di comando (CLI):

Tutte le interfacce condividono la stessa struttura dei comandi e possono essere usate in modo intercambiabile (maggiori dettagli).

Interfaccia Web Mobile via WiFi

Modalità Standalone per il Cardputer

Strumenti Web Serial Basati su Browser

Gli ESP32 Bit Pirate Web Serial Tools forniscono accesso diretto alla CLI seriale da un browser compatibile, senza installare PuTTY, minicom o un'altra applicazione terminale.

Contribuisci

Consulta la sezione Come Contribuire, che illustra un modo semplice per aggiungere un nuovo comando a qualsiasi modalità.

Risorse Visive

Vedi immagini, logo, presentazioni, foto, video, illustrazioni. Queste risorse visive possono essere usate liberamente in post di blog, documentazione, video o articoli per spiegare e promuovere il firmware.

Avvertenza

⚠️ Avvertenza sulla Tensione: i dispositivi devono funzionare solo a 3.3V o 5V.

• Non collegare periferiche che utilizzano altri livelli di tensione — potresti danneggiare il tuo ESP32.

⚠️ Avvertenza sull'Utilizzo: questo firmware è fornito esclusivamente a scopo educativo, diagnostico e di test di interoperabilità.

• Non usarlo per interferire con, sondare o manipolare dispositivi senza la dovuta autorizzazione.
• Evita qualsiasi trasmissione RF non autorizzata (es. sub-GHz) che potrebbe violare le normative locali o disturbare reti e comunicazioni.
• Gli autori non sono responsabili di qualsiasi uso improprio di questo software o hardware, incluse le conseguenze legali derivanti da accesso non autorizzato o emissione di segnali.
• Rispetta sempre i limiti delle leggi del tuo paese e le politiche di divulgazione responsabile.