• Bluetooth
  • Intermediate
  • 5 min
  • Serial CLI

Recipe · Intermediate · Bluetooth

How to use BLE mouse movement

Use Bluetooth HID mouse commands to send a small relative movement or click to a paired BLE host.

Bluetooth connection between two devices.
A practical ESP32 Bit Pirate workflow based on the documented firmware commands.
Step 1

Commands

Run the workflow from the CLI after selecting the matching mode.

Result

What it means

The output confirms that the protocol path is working and gives you a baseline for deeper experiments.

Troubleshooting

  • Mouse commands require server mode and a connected host.
  • Use small relative movements first.
  • Run reset before re-pairing.

Next steps

  • Try keyboard text after mouse works.
  • Use mouse jiggle only in a controlled environment.
  • Check Bluetooth status after connection changes.

BLE mouse movement FAQ

How does BLE mouse movement work?

The firmware sends relative HID mouse reports to the paired host, so small movement values nudge the cursor from its current position.

Why should I start with small movements?

Relative HID movement can be disruptive if values are too large. Use small deltas and a safe desktop area before testing clicks or jiggle actions.

Can BLE mouse movement send absolute screen coordinates?

Most HID mouse actions here are relative movements and button reports. They move from the current pointer position rather than targeting an exact screen coordinate.

Go deeper