How to connect a Bluetooth controller to a Raspberry Pi?
Here’s the usual, reliable way to connect a Bluetooth controller to a Raspberry Pi (Raspberry Pi OS). I’ll give you both GUI and terminal methods, plus the pairing combos for common controllers.
1) Quick GUI method (Raspberry Pi OS Desktop)
-
Turn on Bluetooth on the Pi:
-
Click the Bluetooth icon in the top bar (or go to Preferences → Bluetooth).
-
-
Put your controller into pairing mode (see section 3).
-
In the Bluetooth window:
-
Search / Add Device
-
Select your controller
-
Click Pair
-
-
After pairing, choose Connect (some controllers auto-connect).
Tip: If you don’t see a Bluetooth UI, install it:
2) Terminal method (works on Desktop + Lite): bluetoothctl
-
Open a terminal and run:
-
Inside
bluetoothctl, type:
-
Put the controller in pairing mode. Wait until you see it appear, then copy its MAC address (looks like
AA:BB:CC:DD:EE:FF). -
Pair + trust + connect:
If it asks for a PIN, most game controllers pair without one—just accept/confirm if prompted.
3) Pairing mode for common controllers
-
PS4 DualShock 4: hold SHARE + PS until the light bar flashes rapidly.
-
PS5 DualSense: hold CREATE + PS until the lights flash.
-
Xbox Wireless (Bluetooth models): turn on → hold the pair button until Xbox logo flashes fast.
-
(Older Xbox One controllers may not support Bluetooth unless they’re the newer revision / updated.)
-
-
Nintendo Switch Pro Controller: press the sync button (small button near USB-C) until lights scan.
4) Check if it’s actually connected
See Bluetooth devices
Confirm Linux sees joystick/gamepad events
Optional tests:
5) Common fixes if it won’t pair/connect
-
Bluetooth blocked
-
Remove and re-pair
Then repeat the pairing steps.
-
Power issues / weak supply
Controllers + Bluetooth can get flaky if the Pi’s power is unstable—use a solid PSU. -
It pairs but won’t reconnect automatically
Make sure you ran:

评论
发表评论