• USB
  • Intermediate
  • 5 min
  • Serial CLI

Recipe · Intermediate · USB

How to choose a dedicated USB adapter mode

Use the USB adapters menu to reboot ESP32 Bit Pirate into flashrom, AVRDUDE, SUMP, OpenOCD, IR Toy or SubGHz tool modes.

Browser tools connected to hardware.
A practical ESP32 Bit Pirate recipe based on documented firmware commands.
Step 1

Commands

Run this sequence from the CLI. Adjust pins, addresses or filenames to match your own setup.

Result

What it means

The adapters menu is the bridge between the interactive firmware and external tools like flashrom, avrdude, PulseView, OpenOCD, LIRC or raw SubGHz tooling.

Troubleshooting

  • Re-enter the selected mode setup if pins changed.
  • Confirm the target shares ground with the ESP32 Bit Pirate.
  • Start with short commands before using longer capture or bridge sessions.

Next steps

  • Use the SPI flash programmer for serprog/flashrom.
  • Use the logic analyzer for SUMP captures.
  • Use OpenOCD adapter mode for JTAG/SWD experiments.

USB adapter mode FAQ

What changes when I select a USB adapter mode?

The firmware saves a one-shot adapter configuration, reboots, and exposes a dedicated USB CDC interface for a host tool such as flashrom, avrdude, PulseView, OpenOCD, LIRC or a serial script.

How do I return to normal Bit Pirate CLI?

Reset or reboot the board after using the host tool. Adapter mode is meant to be temporary and dedicated to one protocol, not a normal interactive multi-protocol CLI session.

Should I choose Web Tools or desktop tools?

Use Web Tools when the matching browser workflow exists and you want a simple setup. Use desktop tools when you need mature command-line options, automation, or formats such as sigrok, OpenOCD or LIRC workflows.

Go deeper