ESP32-S3 Bluetooth and BLE debugging

Scan BLE devices and test Bluetooth HID with ESP32

ESP32 Bit Pirate turns a compatible ESP32-S3 board into a Bluetooth and BLE scanning workbench. Use it to scan nearby devices, test BLE HID keyboard and mouse workflows, pair with your own host and troubleshoot BLE state from the serial CLI.

Start with Bluetooth scanning Flash ESP32 Bit Pirate

Bluetooth and BLE debugging visual with an ESP32 board, wireless signal and paired host

Quick Bluetooth workflow

Start passively with a scan, then move to BLE HID only with a host you own and can safely pair for small controlled tests.

01
Start Bluetooth mode from the serial CLI.
02
Scan nearby BLE advertisements to see which devices are visible.
03
Start the BLE HID server with a recognizable test name.
04
Pair from your own computer or phone before sending any keyboard or mouse command.
05
Use reset before changing server mode, pairing state or workflow.

mode bluetooth
scan
server My-BLE-Test
keyboard hello
mouse 10 0
reset

Example CLI flow. See the Bluetooth wiki for exact syntax, pairing behavior and firmware-specific options.

Bluetooth workflows covered by ESP32 Bit Pirate

Use this overview to choose the right BLE workflow before opening a detailed recipe.

Scan

BLE device discovery

List nearby advertising devices before pairing, HID testing or troubleshooting signal visibility.

Server

BLE HID server setup

Start a named BLE HID service so your own host can pair with the ESP32 Bit Pirate.

Keyboard

Controlled BLE keyboard tests

Send a short known text string to validate keyboard input without writing a BLE sketch.

Mouse

Small BLE mouse movement

Send tiny relative mouse movements or clicks only on a safe paired host.

Reset

Bluetooth state recovery

Clear stale mode or pairing state before repeating tests or switching HID behavior.

Compare

BLE versus USB HID

Use USB HID recipes when wired input is easier to debug than wireless pairing.

Detailed Bluetooth recipes

These pages are the task-level Bluetooth and BLE workflows. This overview keeps the protocol-level guidance here, while each recipe covers commands and troubleshooting in detail.

Useful Bluetooth references

This page is a protocol overview. Use the site index for the full web experience, or GitHub for source code, firmware documentation and the Bluetooth command reference.

Flash ESP32 Bit Pirate

Flash a supported ESP32-S3 board before testing Bluetooth mode from the browser.

Open Web Flasher

Bluetooth command reference

Open the maintained firmware wiki for Bluetooth scan, BLE HID server, keyboard, mouse and reset commands.

Open Bluetooth command reference

Supported ESP32-S3 boards

Check compatible boards before relying on Bluetooth or BLE HID workflows.

Compare supported ESP32-S3 boards

Web Serial Terminal

Open Web Serial for Bluetooth commands after the matching firmware is running.

Open Web Serial Terminal for ESP32 Bit Pirate

USB HID workflow

Compare BLE HID with wired USB HID when pairing adds too much uncertainty.

Open USB HID keyboard and mouse recipe

All hardware debugging recipes

Browse recipes that connect Bluetooth work to wiring, commands, captures and troubleshooting.

Browse all hardware debugging recipes

ESP32 Bit Pirate GitHub

Check firmware source, issues and releases that affect Bluetooth support.

Open GitHub repository

Bluetooth debugging FAQ

Short answers for common questions before moving into a detailed workflow.

Can ESP32 Bit Pirate scan nearby Bluetooth devices?

Yes. Bluetooth mode can scan nearby BLE advertisements so you can see which devices are visible before pairing or HID testing.

Can ESP32 Bit Pirate act as a BLE HID keyboard or mouse?

Yes. ESP32 Bit Pirate can start a BLE HID server and send controlled keyboard or mouse actions to your own paired test host.

Should I use BLE HID commands on someone else's device?

No. Use BLE HID workflows only with hosts you own or are explicitly allowed to test, and start with small controlled actions.