00 Terminal

Terminal Selection

The ESP32 Bus Pirate firmware supports three main modes of interaction:

• 🖥️ Serial CLI – Connect over USB to send commands via a terminal.
• 🌐 Web CLI – Connect via Wi-Fi and access a browser-based interface (no USB required).
• 📟 Standalone - On device screen and keyboard, only for the Cardputer.

All modes offer the same commands and features, but their setup differs depending on your device.

---

Getting Started with Stick

Since the M5Stick has no built-in keyboard, you must:

1. Connect to the device via Serial using USB (see Serial).
2. Select WiFi mode and use the connect command to join your Wi-Fi.
3. Restart the device and select WiFi Web mode to use the browser-based CLI.

Instant Setup with Cardputer

The M5Stack Cardputer includes a built-in keyboard and a screen, so:

• Choose Standalone mode to use on its own, no connection or serial needed.
• For the Standalone mode, use arrows up/down to scroll and esc to scroll down line by line.
• For the Standalone mode, use tab to retype automatically previous commands.
• You can type your Wi-Fi credentials directly on the device to connect to the Web CLI.
• You can also use it with the normal serial connection.

---

Getting Started with M5StampS3, AtomS3, S3 DevKit, Xiao S3

These devices have no built-in screen or keyboard, so initial setup must be done via Serial.

First-Time Setup

Before using the Web CLI, you must connect over USB Serial:

1. Open a terminal (see Serial) on your computer.
2. Type:

   mode wifi
   connect
   

3. Select the network, password, and wait for connection confirmation, ssid and password are now saved to NVS (non-volatile memory).
4. Reboot the device normally.

Boot Procedure and LED Feedback

On each boot if the board button is pressed within 3 seconds, the device enters in Wi-Fi connection process to be able to use the WEBUI instead of Serial.

• ⚪ A white LED will turn on indicating the start of the WiFi connection.
• 🔵 If the LED flashes blue, no saved Wi-Fi credentials were found on the device.
• 🟢 If the LED flashes green, the device successfully connected to Wi-Fi, you can now acces the WEBUI
• 🔴 If it flashes red, the connection failed.

⚠️ Important:
Do not hold the BOOT button when powering the device, or it will enter USB boot mode, which is not used for normal operation.

Fallback to Serial

If the Wi-Fi connection fails (invalid credentials or no network), you can always:

• Connect via Serial, go to the Wi-Fi mode and use connect to select and connect to you WiFi.

Instant WiFi Setup with the T-Embeds

1. Power the device and choose WiFi Web terminal mode.
2. Select your WiFi and type your password with the encoder.
3. If the connection is successful, the WEB UI IP will show on the screen.

Instant WiFi Setup with the T-Dispay

1. Power the device and choose WiFi Web terminal mode.
2. Select your WiFi and type your password with the buttons.
3. If the connection is successful, the WEB UI IP will show on the screen.

Fallback to Serial

If the Wi-Fi connection fails (invalid credentials or no network), you can always:

• Connect via Serial, go to the Wi-Fi mode and use connect to select and connect to you WiFi.

---

Serial Connection

See the dedicated page about Serial

Note

⚠️ Some commands can interrupt the current terminal session depending on your connection type.

For example, if you're connected via WiFi and use the disconnect command, the browser terminal will close. Similarly using USB commands will end the USB Serial connection.

💡 Tip: For features that generate a large amount of output — such as 1Wire or I2C sniffers — it's recommended to use the Serial CLI over USB to avoid missing data in the Web terminal.