99 Serial

Serial Connection Guide

This guide explains how to connect to the ESP32 Bus Pirate using a serial terminal on your computer.
Whether you're using Windows, macOS, or Linux, several tools are available to open a serial port and interact with the CLI.

---

🪟 Windows

🔁 Find the COM port

Open Device Manager and look under Ports (COM & LPT). You’ll see something like:

USB Serial Device (COM3)

If you're using M5Burner, plug in the device while M5Burner is open — the COM port will appear automatically when the board is connected.

✅ Recommended: PuTTY

• Free, open-source, lightweight.
• Supports serial (COMx) mode easily.
• Simple raw text display for command-line interaction.

🔄 Alternatives:

• CoolTerm — Visual, easy to configure.
• RealTerm — Advanced features, older UI.
• YAT (Yet Another Terminal) — Clean and MCU-friendly.

---

🍎 macOS

🔁 Find the COM port

In a terminal, run:

ls /dev/tty.usb*

You may see something like:

/dev/tty.usbserial-0001

If you're using M5Burner, plug in the device while M5Burner is open — the USB interface will appear automatically when the board is connected.

✅ Recommended: CoolTerm

• Auto-detects USB serial ports (CH340, CP210x, FTDI, etc.).
• Friendly interface and customizable.

🔄 Alternatives:

• screen in terminal:

  screen /dev/tty.usbserial-XXXX 115200

---

🐧 Linux

🔁 Find the COM port

In a terminal, run:

ls /dev/ttyUSB*
ls /dev/ttyACM*

You may see something like:

/dev/ttyUSB0

If you're using M5Burner, plug in the device while M5Burner is open — the USB interface will appear automatically when the board is connected.

✅ Recommended: screen or minicom

📦 screen

• Pre-installed on most distros.
• Simple to use:

  screen /dev/ttyUSB0 115200

🧩 minicom

• Configurable with menus.
• First time setup: run sudo minicom -s

🔄 Alternatives:

• picocom
• gtkterm
• CuteCom
• PuTTY for Linux

---

ℹ️ Tips

• Make sure to select the correct serial port (e.g. COM3, /dev/ttyUSB0 /dev/ttyACMO, or /dev/tty.usbserial-*).
• Use 115200 baud rate, 8 data bits, no parity, 1 stop bit.
• If you don’t see the welcome message, send any key to “wake” the Bus Pirate and trigger the banner.