ESP32 Bit Pirate

ESP32 Bit Pirate é um firmware de código aberto que transforma o seu dispositivo numa ferramenta de desenvolvimento e análise multiprotocolo, inspirada no lendário Bus Pirate.

Suporta sniffing, envio, scripting e interação com vários protocolos digitais (I2C, UART, 1-Wire, SPI, etc.) através de um terminal serial ou CLI baseada na web. Também comunica com protocolos de rádio como Bluetooth, Wi-Fi, Sub-GHz e RFID.

O site oficial do projeto centraliza tudo: Website do ESP32 Bit Pirate.

A partir daí pode instalar o firmware, abrir as ferramentas web, seguir os guias de hardware, explorar as receitas e aceder à documentação.

Funcionalidades

• Interface de linha de comandos (CLI) interativa via USB Serial ou WiFi Web.

• Modos para:

  • HiZ (padrão)
  • I2C (scan, glitch, modo escravo, dump, eeprom)
  • SPI (eeprom, flash, sdcard, modo escravo)
  • UART / Half-Duplex UART (bridge, read, write)
  • 1WIRE (ibutton, eeprom)
  • 2WIRE (sniff, smartcard) / 3WIRE (eeprom)
  • DIO (Digital I/O, read, pullup, set, pwm)
  • Infrared (enviar, gravar, controlo remoto universal)
  • USB (HID, flashrom, storage, usb-uart)
  • Bluetooth (BLE HID, scan, spoofing, sniffing)
  • Wi-Fi / Ethernet (sniff, deauth, nmap, netcat)
  • JTAG (scan, SWD, openOCD)
  • LED (animações, definir LEDs)
  • I2S (testar altifalantes, microfone, reproduzir som)
  • CAN (sniff, enviar e receber tramas)
  • SUBGHZ (analisar, gravar, reproduzir)
  • RFID (ler, escrever, clonar)
  • RF24 (scan, enviar, receber)
  • FM (analisar, transmitir)
  • CELL (dump do cartão SIM, SMS, chamada)
  • LORA (sniff, payload, meshtatic)

• Sniffers de protocolo I2C, UART, SPI, 1Wire, 2wire, CAN, Wi-Fi, Bluetooth, SubGhz.

• Deteção automática de baudrate, comandos AT e várias ferramentas para UART.

• Manipulação de registos, ferramentas de dump de EEPROM, identificação de dispositivos para I2C.

• Leitura de todos os tipos de EEPROM, Flash e várias outras ferramentas para SPI.

• Scripting usando instruções de bytecode estilo Bus Pirate ou Python.

• Comando Device-B-Gone com mais de 80 protocolos INFRARED suportados.

• Gestão direta de I/O, estado de PWM, servo, GPIOs.

• Análise de sinais de rádio e frequências em todas as bandas.

• Cerca de 50 protocolos de LEDs endereçáveis suportados.

• Ethernet e WiFi são suportados para aceder a redes.

• Importação e exportação de dados com o LittleFS sobre HTTP.

• Assistente Pirata para o ajudar com o firmware.

• Dongle USB-Uart, programador SPI, analisador lógico e mais.

• Ferramentas Web Serial para usar USB Serial através de um navegador web.

Dispositivos Suportados

• Outras placas baseadas em ESP32-S3

  • Todas as placas baseadas em ESP32-S3 podem ser suportadas, desde que tenham pelo menos 8 MB de flash.

  • Pode gravar o firmware do s3 dev-kit em qualquer placa ESP32-S3.

  • Tenha em mente que o mapeamento de pinos padrão no firmware pode não corresponder à sua placa específica.

Como Começar

1. 🔧 Grave o firmware

   • Use o Web Flasher do ESP32 Bit Pirate para gravar o firmware diretamente a partir de um navegador web.
   • Também pode gravá-lo no M5Burner, na categoria StickS3, AtomS3, M5StampS3 ou Cardputer.

2. 🔌 Ligue via Serial ou Web

   • Serial: qualquer aplicação de terminal, ou o terminal Web Serial gratuito baseado em navegador (veja Ligar via Serial)
   • Web: configure o Wi-Fi e aceda à CLI através do navegador (veja Ligação Wi-Fi)

3. 🧪 Use comandos como:

   root@kitploit:~

   mode
   help
   scan
   sniff
   ...
   

Wiki

📚 Visite a Wiki para documentação detalhada sobre todos os modos e comandos.

Inclui:

• Modo Terminal - Sobre o terminal serial e web.
• Visão geral dos modos - Explore os modos suportados.
• Configuração serial - Acesso serial via USB.

A wiki é o melhor lugar para aprender como tudo funciona.

Scripting

🛠️ Automatize interações com o ESP32 Bit Pirate usando scripts Python sobre serial.

Pode escrever e testar scripts diretamente no navegador com o Python Lab do ESP32 Bit Pirate.

Incluindo: Registo de dados num ficheiro, dump de eeprom e flash, interação com GPIOs, animação de LEDs...

Expander

🔌 Expanda as capacidades do ESP32 Bit Pirate com módulos de hardware adicionais. O Expander adiciona suporte para WiFi 5 GHz ou outros protocolos de rádio.

Dock

🔧 Uma estação de ancoragem para o ESP32 S3 DevKit projetada para funcionar com adaptadores Bus Pirate originais.

Permite-lhe ligar e usar o ecossistema original de adaptadores e acessórios do Bus Pirate.

Obtenha o ESP32 Bit Pirate Dock na PCBWay.

Interfaces de Linha de Comandos

O firmware ESP32 Bit Pirate fornece três modos de interface de linha de comandos (CLI):

Todas as interfaces partilham a mesma estrutura de comandos e podem ser usadas de forma intercambiável (mais detalhes).

Interface Web Móvel via WiFi

Modo Autónomo para o Cardputer

Ferramentas Web Serial Baseadas em Navegador

As Ferramentas Web Serial do ESP32 Bit Pirate fornecem acesso direto à CLI Serial a partir de um navegador compatível, sem instalar PuTTY, minicom ou outra aplicação de terminal.

Contribuir

Consulte a secção Como Contribuir, que descreve uma forma simples de adicionar um novo comando a qualquer modo.

Recursos Visuais

Veja imagens, logótipo, apresentações, fotos, vídeos, ilustrações. Estes recursos visuais podem ser usados livremente em publicações de blogue, documentação, vídeos ou artigos para ajudar a explicar e promover o firmware.

Aviso

⚠️ Aviso de Tensão: Os dispositivos devem operar apenas a 3.3V ou 5V.

• Não ligue periféricos que utilizem outros níveis de tensão — fazê-lo pode danificar o seu ESP32.

⚠️ Aviso de Utilização: Este firmware é fornecido apenas para fins educacionais, de diagnóstico e de teste de interoperabilidade.

• Não o utilize para interferir, sondar ou manipular dispositivos sem a devida autorização.
• Evite quaisquer transmissões de RF não autorizadas (por exemplo, sub-GHz) que possam violar regulamentações locais ou perturbar redes e comunicações.
• Os autores não são responsáveis por qualquer uso indevido deste software ou hardware, incluindo consequências legais resultantes de acesso não autorizado ou emissão de sinais.
• Mantenha-se sempre dentro dos limites das leis do seu país e das políticas de divulgação responsável.