ESP32 Bit Pirate

ESP32 Bit Pirate est un firmware open-source qui transforme votre appareil en un outil multi-protocole de développement et d'analyse, inspiré de la légendaire Bus Pirate.

Il prend en charge l'écoute (sniffing), l'envoi, l'exécution de scripts et l'interaction avec divers protocoles numériques (I2C, UART, 1-Wire, SPI, etc.) via un terminal série ou une CLI web. Il communique également avec des protocoles radio comme Bluetooth, Wi-Fi, Sub-GHz et RFID.

Le site web officiel du projet centralise tout : ESP32 Bit Pirate Website.

À partir de là, vous pouvez installer le firmware, ouvrir les outils web, suivre les guides matériels, explorer les recettes et accéder à la documentation.

Fonctionnalités

• Interface en ligne de commande (CLI) interactive via USB Serial ou WiFi Web.

• Modes disponibles :

  • HiZ (par défaut)
  • I2C (scan, glitch, mode esclave, dump, eeprom)
  • SPI (eeprom, flash, sdcard, mode esclave)
  • UART / Half-Duplex UART (bridge, lecture, écriture)
  • 1WIRE (ibutton, eeprom)
  • 2WIRE (sniff, smartcard) / 3WIRE (eeprom)
  • DIO (I/O numériques, lecture, pullup, set, pwm)
  • Infrared (envoi, enregistrement, télécommande universelle)
  • USB (HID, flashrom, stockage, usb-uart)
  • Bluetooth (BLE HID, scan, spoofing, sniffing)
  • Wi-Fi / Ethernet (sniff, deauth, nmap, netcat)
  • JTAG (scan, SWD, openOCD)
  • LED (animations, réglage des LED)
  • I2S (test des haut-parleurs, micro, lecture de son)
  • CAN (sniff, envoi et réception de trames)

Appareils pris en charge

• Autres cartes basées sur ESP32-S3

  • Toutes les cartes basées sur l'ESP32-S3 peuvent être prises en charge, à condition d'avoir au moins 8 Mo de flash.

  • Vous pouvez flasher le firmware du s3 dev-kit sur n'importe quelle carte ESP32-S3.

  • Gardez à l'esprit que le mappage des broches par défaut dans le firmware peut ne pas correspondre à votre carte spécifique.

Pour commencer

1. 🔧 Flasher le firmware

   • Utilisez le ESP32 Bit Pirate Web Flasher pour graver le firmware directement depuis un navigateur web.
   • Vous pouvez également le graver via M5Burner, dans la catégorie StickS3, AtomS3, M5StampS3 ou Cardputer.

2. 🔌 Se connecter via Serial ou Web

   • Serial : n'importe quelle application de terminal, ou le terminal Web Serial gratuit basé sur navigateur (voir Se connecter via Serial)
   • Web : configurez le Wi-Fi et accédez à la CLI via le navigateur (voir Connexion Wi-Fi)

3. 🧪 Utilisez des commandes comme :

   root@kitploit:~

   mode
   help
   scan
   sniff
   ...
   

Wiki

📚 Visitez le Wiki pour une documentation détaillée sur chaque mode et commande.

Comprend :

• Mode terminal - À propos du terminal série et web.
• Aperçu des modes - Parcourez les modes pris en charge.
• Configuration série - Accès série via USB.

Le wiki est le meilleur endroit pour apprendre comment tout fonctionne.

Scripting

🛠️ Automatisez les interactions avec l'ESP32 Bit Pirate à l'aide de scripts Python via le port série.

Vous pouvez écrire et tester des scripts directement dans le navigateur avec le ESP32 Bit Pirate Python Lab.

Notamment : Journalisation de données dans un fichier, dump d'eeprom et de flash, interaction avec les GPIO, animation de LED...

Expander

🔌 Étendez les capacités de l'ESP32 Bit Pirate avec des modules matériels supplémentaires. L'Expander ajoute la prise en charge du WiFi 5 GHz ou d'autres protocoles radio.

Dock

🔧 Une station d'accueil pour l'ESP32 S3 DevKit conçue pour fonctionner avec les adaptateurs Bus Pirate d'origine. Elle vous permet de brancher et d'utiliser l'écosystème d'origine d'adaptateurs et d'accessoires Bus Pirate.

Obtenez l'ESP32 Bit Pirate Dock sur PCBWay.

Interfaces en ligne de commande

Le firmware ESP32 Bit Pirate propose trois modes d'interface en ligne de commande (CLI) :

Toutes les interfaces partagent la même structure de commandes et peuvent être utilisées de manière interchangeable (plus de détails).

Interface Web mobile via WiFi

Mode autonome pour la Cardputer

Outils Web Serial basés sur navigateur

Les ESP32 Bit Pirate Web Serial Tools offrent un accès direct à la CLI série depuis un navigateur compatible, sans installer PuTTY, minicom ou une autre application de terminal.

Contribuer

Consultez la section Comment contribuer, qui décrit un moyen simple d'ajouter une nouvelle commande à n'importe quel mode.

Ressources visuelles

Consultez images, logo, présentations, photos, vidéos, illustrations. Ces visuels peuvent être librement utilisés dans des articles de blog, documentations, vidéos ou articles pour aider à expliquer et promouvoir le firmware.

Avertissement

⚠️ Avertissement de tension : Les appareils doivent fonctionner uniquement à 3,3 V ou 5 V.

• Ne pas connecter de périphériques utilisant d'autres niveaux de tension — cela pourrait endommager votre ESP32.

⚠️ Avertissement d'utilisation : Ce firmware est fourni uniquement à des fins éducatives, de diagnostic et de test d'interopérabilité.

• Ne l'utilisez pas pour interférer avec, sonder ou manipuler des appareils sans autorisation appropriée.
• Évitez toute transmission RF non autorisée (par exemple sub-GHz) qui pourrait violer les réglementations locales ou perturber les réseaux et communications.
• Les auteurs ne sont pas responsables de toute mauvaise utilisation de ce logiciel ou matériel, y compris des conséquences légales résultant d'un accès non autorisé ou d'une émission de signaux.
• Restez toujours dans les limites des lois de votre pays et des politiques de divulgation responsable.