1) Prerequisites

• VS Code installed

• PlatformIO IDE extension (install from the VS Code Marketplace)

• Git (optional, for cloning the repo)

• Drivers:

  • Windows: CP210x or CH34x if your board uses those USB-UART chips

  • Linux: add udev rules (see below)

  • macOS: usually no extra driver needed

Linux udev (USB permissions)

sudo usermod -a -G dialout $USER
# Add rules for CP210x/CH34x if needed, then:
sudo udevadm control --reload-rules
sudo udevadm trigger
# Reboot or re-login to apply group changes

2) Get the source

# Clone (or download ZIP)
git clone https://github.com/geo-tp/ESP32-Bus-Pirate.git

3) Open in PlatformIO

• Open VS Code → PlatformIO Home → Open Project → select the repo folder.

Tip: The project supports multiple boards, choose the one you want.