ESP32 Bit Pirate home
  • Bluetooth
  • Beginner
  • 5 min
  • Serial CLI

Recipe · Beginner · Bluetooth

How to scan nearby Bluetooth devices

Before pairing with or testing a BLE device, it helps to know what is actually advertising nearby. This recipe keeps Bluetooth work passive at first.

Bluetooth connection between two devices.
Scan first, then decide whether pairing or HID testing makes sense.
Step 1

Commands

Run the commands below after selecting the right Bit Pirate mode and confirming the wiring.

Result

What success looks like

The target appears during the scan with a plausible RSSI. If it does not appear, check power, distance and whether the target is in advertising mode.

Troubleshooting

  • Target is not advertising.
  • Randomized BLE addresses make the same device appear differently.
  • Too many nearby devices; move closer to the target.
  • Bluetooth was already in a stale state; run reset before another test.

Next steps

  • Use pair <mac> only with your own target.
  • Use sniff to log passive traffic if needed.
  • Use reset before switching Bluetooth workflows.

Bluetooth scan FAQ

What does Bluetooth scan discover?

It lists nearby advertising Bluetooth devices for a short scan window. It does not pair, connect or prove that every service is usable.

What metadata should I compare during BLE scans?

Compare device name, RSSI trend, advertised services, manufacturer data and timing. Those clues are often more useful than a single MAC-style address during BLE discovery.

What should I do after finding my target?

For your own device, pair with its MAC when needed, start a BLE HID server for keyboard or mouse tests, or reset Bluetooth before switching workflows.

Go deeper