Quick Setup
Connect Bus Pirate 5
Connect the Bus Pirate to your computer with a USB C cable.
Bus Pirate 5 currently appears as two USB devices:
- USB CDC class device: an emulated serial port for accessing the user terminal
- USB Mass Storage Device: a disk drive interface for accessing a TF flash card inserted in the Bus Pirate
These are common device classes and recent operating systems will not request or require a driver. We're living in the future, woohoo!
Find the serial port
Your terminal emulation software will probably detect and list all the available serial ports connected to your computer. If there's more than one serial port, you can connect to each and press enter
until you find the Bus Pirate terminal. You can probably skip this step, but if you need to find the port manually follow the instructions below.
- Windows
- Linux
- macOS
- Android
- Press the Windows key or open the start menu
- Type
Device Manager
- Click on the Device Manager to open it
- In the Device Manager look for
Ports (COM & LPT)
, expand it - In the example Bus Pirate 5 is connected as COM3
Fire up a terminal emulator
A terminal emulator is software that connects to the Bus Pirate serial interface and displays the command line. Bus Pirate 5 supports VT100 for a colorful interface with a live view statusbar. A fallback monochrome ASCII mode is also available. Most terminal emulators support VT100, it's been around since the 1970s.
- Windows
- Linux
- macOS
- Android
- We're huge fans of Tera Term on Windows. Download and install the latest version.
- Open Tera Term and select
Setup
thenSerial port
. - Choose the Bus Pirate port, and configure it for 115200 (speed), 8 bit (data), None (parity), and 1 bit (stop bits). Click
New setting
orNew Open
to open the port.
- Now select
Setup
thenTerminal
. - Configure as shown above. Terminal size 80x24, New-line both set to CR, Terminal ID set to VT100. Click
OK
. - To save the settings for next time, choose
Setup
thenSave Settings
.
Seeing duplicate characters when you type? Check that local echo
is unchecked in this menu.
- Press
Enter
in the terminal. - The Bus Pirate will prompt you to choose VT100 color mode or the fallback ASCII monochrome mode.
- We recommend you type
y
followed by theenter
key.
You should see something like this. Congratulations, you're talking to the Bus Pirate!
If you see lots of extra garbage characters in the terminal that is probably the VT100 code that updates the live view statusbar. Verify that your terminal supports VT100 mode and that VT100 mode is enabled.