ESP32 Bit Pirate: hackovací nástroj Bus Pirate na ESP32

Stručně: ESP32 Bit Pirate je open-source firmware (licence MIT) od vývojáře geo-tp, který promění běžnou desku s čipem ESP32-S3 v multiprotokolový nástroj pro hardware hacking inspirovaný legendárním Bus Pirate. Komunikuje s drátovými sběrnicemi (I2C, SPI, UART, 1-Wire, 2-Wire, 3-Wire, JTAG, CAN) i s bezdrátovými protokoly (Wi-Fi, Bluetooth, Sub-GHz, RFID, NRF24, FM, infračervené ovládání). Ovládá se přes sériový terminál, přes webové CLI v prohlížeči, nebo u M5 Cardputeru přímo na zařízení. Firmware nainstalujete jedním kliknutím přes webový flasher a běží na řadě hotových desek (ESP32-S3 DevKit, M5 Cardputer, LILYGO T-Embed CC1101 a dalších). Na projekt upozornil Martin Hubáček na síti X.

Co je Bus Pirate a proč dává ESP32 verze smysl

Bus Pirate je dlouholetá klasika mezi nástroji pro práci s digitálními sběrnicemi. Jde o malou destičku, kterou připojíte k neznámému čipu nebo zařízení a přes jednoduché textové rozhraní s ním „mluvíte“ – přečtete obsah paměti, oskenujete I2C adresy, sniffujete komunikaci na SPI nebo odešlete vlastní data na UART. Místo toho, abyste pro každý protokol psali vlastní Arduino sketch, máte jeden univerzální překladač mezi vaším počítačem a hardwarem.

ESP32 Bit Pirate přebírá tuto filozofii a přenáší ji na čip ESP32-S3, který máme, my makeři, dávno doma. A přidává něco, co původní Bus Pirate nemá: bezdrátovou komunikaci. Díky integrovanému Wi-Fi a Bluetooth v ESP32 a díky externím modulům (CC1101 pro Sub-GHz, PN532 pro RFID, NRF24) zvládá nejen drátové sběrnice, ale i rádiové protokoly. Tím se z laciné vývojové desky stává nástroj, který se funkčně blíží zařízením typu Flipper Zero – jen za zlomek ceny a s plně otevřeným zdrojovým kódem.

Jak to funguje: tři způsoby ovládání

Hlavní devíza tohoto firmwaru je rozhraní příkazové řádky (CLI), které je u všech režimů stejné. Liší se jen způsob, jakým se k němu připojíte:

  • Webové rozhraní – ESP32 vytvoří webové CLI dostupné přes Wi-Fi z jakéhokoli prohlížeče. Funguje z počítače, tabletu i mobilu a nepotřebujete žádný kabel. Ideální pro rychlé testy, ukázky a „headless“ nasazení.
  • Sériové rozhraní – klasické připojení přes USB do libovolného terminálu. Je nejrychlejší, nejodezvovější a zvládá hladce velké objemy dat, takže se hodí na intenzivnější práci.
  • Standalone režim – pouze pro M5 Cardputer, který má vlastní klávesnici a displej. Celý nástroj tak nosíte v kapse jako samostatné zařízení bez nutnosti počítače.

Po nahrání firmwaru jej ovládáte jednoduchými příkazy jako mode (přepnutí protokolu), help (nápověda), scan (oskenování sběrnice) nebo sniff (odposlech komunikace). Syntaxe je u sériové i webové verze identická, takže se nemusíte nic přeučovat.

Které protokoly a režimy zvládá

Seznam podporovaných režimů je překvapivě rozsáhlý. Z drátových sběrnic firmware umí I2C (sken, dump, EEPROM, slave režim, glitch), SPI (EEPROM, flash, SD karty, slave režim), UART a half-duplex UART (most, čtení, zápis, automatická detekce baudrate, AT příkazy), dále 1-Wire (iButton, EEPROM), 2-Wire (sniff, smartcard), 3-WireJTAG/SWD (sken pinoutu), CAN (sniff i odesílání rámců) a přímé digitální I/O včetně PWM a ovládání serva.

Z bezdrátové oblasti firmware nabízí Wi-Fi a Ethernet (sniff, deauth, nmap, netcat), Bluetooth (BLE HID, sken, spoofing, sniffing), Sub-GHz (analýza, záznam, replay), RFID (čtení, zápis, klonování), NRF24FM (analýza i vysílání) a dokonce experimentální práci se SIM kartou. Samostatnou kapitolou je infračervený režim s podporou více než 80 protokolů a funkcí univerzálního dálkového ovladače typu „Device-B-Gone“. Pro adresovatelné LED pásky firmware podporuje téměř 50 protokolů.

Skriptovat lze dvěma způsoby: pomocí bajtkódu ve stylu původního Bus Pirate, nebo přímo v Pythonu přes sériovou linku – například pro automatický dump EEPROM, logování dat do souboru nebo ovládání GPIO. Data se importují a exportují přes souborový systém LittleFS po HTTP.

Na jakém hardwaru to běží

Firmware cílí na desky postavené na čipu ESP32-S3. Oficiálně podporovaný je obyčejný ESP32-S3 DevKit (přes 20 volných GPIO), dále celá rodina zařízení od M5Stack – M5 Cardputer a Cardputer ADV, M5 StickC S3, StampS3 a AtomS3 Lite – a několik desek LILYGO, z nichž nejzajímavější je T-Embed CC1101 Plus s integrovaným CC1101, NRF24, PN532, infraportem i baterií. Podporovaná je také Seeed Studio Xiao ESP32-S3.

Důležitá poznámka: obecně lze firmware nahrát na jakoukoli desku s ESP32-S3, pokud má alespoň 8 MB flash paměti. Stačí použít firmware pro DevKit. Počítejte ale s tím, že výchozí mapování pinů nemusí vaší konkrétní desce přesně odpovídat, takže si je budete muset dohledat nebo upravit.

Instalace jedním kliknutím

Asi nejpříjemnější věc na celém projektu je instalace. Není potřeba PlatformIO, kompilování ani boj s ovladači. Stačí v prohlížeči (typicky Chrome nebo Edge s podporou Web Serial) otevřít webový flasher (odkaz) projektu, připojit desku přes USB a kliknout. Firmware se nahraje přímo z webu. Alternativně lze pro zařízení M5Stack použít aplikaci M5Burner, kde najdete Bit Pirate v kategoriích pro Cardputer, AtomS3, StampS3 a M5Stick.

Po nahrání se buď připojíte sériovým terminálem přes USB, nebo nakonfigurujete Wi-Fi a otevřete webové CLI v prohlížeči. Podrobné návody ke každému režimu a příkazu najdete na rozsáhlé Wiki projektu.

Praktické využití pro makery/bastlíře

Kde se takový nástroj hodí v praxi? Pár konkrétních scénářů z dílny:

  • Reverse engineering neznámé desky/modulu – oskenujete I2C sběrnici a zjistíte, jaké čipy na ní visí, případně přečtete obsah jejich registrů.
  • Záchrana a klonování EEPROM/flash pamětí – vyčtete konfigurační paměť ze starého zařízení nebo si zazálohujete obsah SPI flash čipu před experimentem.
  • Ladění sériové komunikace – automatická detekce baudrate ušetří spoustu hádání, když nevíte, jakou rychlostí zařízení komunikuje na UART.
  • Univerzální dálkový ovladač – díky infračervenému režimu s desítkami protokolů nahradíte ztracené ovladače nebo otestujete IR přijímače.
  • Analýza Sub-GHz a RFID – s deskou typu T-Embed CC1101 můžete analyzovat rádiové signály nebo číst a klonovat RFID karty (samozřejmě jen ty vlastní).

Důležité varování: jen pro legální použití

Autor projektu na to upozorňuje a já taky. Firmware je určen výhradně pro vzdělávací, diagnostické a testovací účely u zařízení, ke kterým máte oprávnění. Neoprávněné odposlechy, útoky na cizí Wi-Fi sítě nebo vysílání na Sub-GHz pásmech mohou porušovat zákon i radiokomunikační předpisy. Vždy zůstaňte v mezích platné legislativy a zásad zodpovědného zveřejňování zranitelností.

Kde projekt najdete

Na tento projekt nás upozornil Martin Hubáček ve svém příspěvku na síti X (odkaz na příspěvek) – díky za tip. Zdrojový kód, webový flasher i kompletní dokumentaci najdete na GitHubu projektu geo-tp/ESP32-Bit-Pirate. V době psaní článku má repozitář přes 3 200 hvězdiček a aktivní vývoj, poslední verze v1.5 vyšla v březnu 2026.

Pro hobby elektronika, který už ESP32-S3 doma má, jde o jeden z nejlevnějších způsobů, jak si pořídit plnohodnotný multiprotokolový nástroj pro práci s hardwarem. A pokud vlastníte M5 Cardputer, dostáváte do kapsy kompletní hardwarový „švýcarák“ za pár stovek korun.

Ptáte se

Potřebuju k ESP32 Bit Pirate Flipper Zero nebo speciální hardware?

Ne. Základní funkce běží na běžné desce s čipem ESP32-S3 (s alespoň 8 MB flash), jako je ESP32-S3 DevKit. Pro rádiové protokoly typu Sub-GHz nebo RFID potřebujete desku s příslušnými moduly (např. LILYGO T-Embed CC1101 s čipem CC1101 a PN532), ale samotné drátové sběrnice i Wi-Fi/Bluetooth zvládne i levný DevKit.

Jak firmware nainstaluji bez instalace vývojového prostředí?

Nejjednodušší cesta je webový flasher projektu, který běží přímo v prohlížeči s podporou Web Serial (Chrome, Edge). Připojíte desku přes USB a firmware nahrajete jedním kliknutím. U zařízení M5Stack lze alternativně použít aplikaci M5Burner.

Je ESP32 Bit Pirate legální?

Samotný firmware ano – je to open-source software pod licencí MIT. Záleží ale na tom, jak ho použijete. Je určen pro vzdělávací, diagnostické a testovací účely u zařízení, ke kterým máte oprávnění. Neoprávněné odposlechy cizí komunikace, deauth útoky nebo vysílání na Sub-GHz pásmech mohou být v rozporu se zákonem a radiokomunikačními předpisy.

Jaký je rozdíl mezi webovým, sériovým a standalone režimem?

Všechny tři používají stejné příkazy. Webové rozhraní funguje bezdrátově přes Wi-Fi z prohlížeče a nepotřebuje kabel, hodí se na rychlé testy a headless nasazení. Sériové rozhraní přes USB je nejrychlejší a nejodezvovější, vhodné pro náročnější práci a velké objemy dat. Standalone režim je dostupný jen pro M5 Cardputer, který má vlastní displej a klávesnici, takže funguje jako samostatné přenosné zařízení.

Mohu firmware ovládat skriptem a automatizovat opakované úkoly?

Ano. Skriptovat lze pomocí bajtkódu ve stylu původního Bus Pirate, nebo přímo v Pythonu přes sériovou linku. To se hodí například pro automatický dump EEPROM a flash pamětí, logování dat do souboru, ovládání GPIO nebo animace LED. Hotové ukázkové skripty jsou k dispozici v samostatném repozitáři projektu.
Sdílejte článek:
Komentáře:
1 komentářů na sociálních sítích
Bus Pirate na ESP32. ESP32 Bit Pirate, umí sniffovat řadu sběrnic a nechybí Bluetooth a Wi-Fi. https://t.co/448J3kEppi Tip od @hubmartin https://t.co/aQLQXNbVqF ...více
Číst komentáře
- a -
Přidat svůj názor
Ukaž světu,
že jsi Maker!
Koupit tričko
Kafe pro Chiptrona
Dodej energii dalšímu článku

Související články

Různé vývojové desky s čipy ESP32 – srovnání variant

ESP32, S2, S3, C3, C6, H2, C5, P4 i chystaný S31 – který čip vybrat pro váš projekt? Srovnávací tabulka periferií, rozhodovací strom podle use-case, přehled softwarových platforem a tipy, kde koupit vývojové desky v Česku.

Používání AI při bastlení už není sci-fi. Stává se z něj běžný nástroj – podobně jako datasheet, osciloskop nebo Google. Rozdíl je ale v tom, že kvalita výsledku extrémně závisí na tom, jak AI zadáte úkol. Dobře napsaný prompt vám…

Plánujete vylepšit zařízení novějším Wi-Fi modulem s ESP32-C3 namísto staršího a slabšího modulu s ESP8266? Ač je ESP32-C3F (s ESP32-C3) rozměrově kompatibilní s ESP12F (s ESP8266), záměna není tak jednoduchá – prostá výměna modulů.

Přišel mi engineering sample vývojového kitu ESP32-C3-DevKitM-1.

Nastavení sériového připojení k ESP32 v Putty — konfigurace pro MicroPython REPL

Dva způsoby, jak nahrát MicroPython na ESP32 — jednoduše přes Thonny IDE nebo ručně přes esptool. První blikající LEDka do pěti minut.

EasyEDA je volně použitelný webový nástroj určený pro návrh elektronických schémat, návrh DPS a obvodovou simulaci. Celý nástroj běží ve webovém prohlížeči – není nutné nic instalovat a odpadá přenášení projektů mezi počítači. Stačí internetový prohlížeč a jste připraveni kreslit…

Trendy