The most recent version of this page is a draft.DiffThis version is outdated by a newer approved version.DiffThis version (2020/02/04 22:36) is a draft.
Approvals: 0/1

This is an old revision of the document!


You need to establish a SSH connection or a terminal windows with keyboard to accomblish this further. You can connect your bluetooth controller manually by doing some commands step by step.

Get started by typing bluetoothctl

Now you are in the Bluetooth control unit. Type following commands and confirm every single one with Enter

  agent on
  default-agent
  power on
  scan on

Important: Now set the controller in Pairing mode! This strongly depends from your controller type and we can't write an instruction set for every single controller, how to do this.

So you are in Pairing Mode and you likely see text messages like this.

[bluetooth]# scan on
Discovery started
[CHG] Controller 43:45:C0:00:1F:AC Discovering: yes
[NEW] Device E4:17:D8:C2:0B:0E 8BitDo M30 Modkit

Now we want to connect to our controller. So we type following commands to connect to discovered controller with MAC adress E4:17:D8:C2:0B:0E properly. We need to wait a few seconds after entering each command to setup the controller correctly

  pair E4:17:D8:C2:0B:0E
  connect E4:17:D8:C2:0B:0E
  trust E4:17:D8:C2:0B:0E

So we see for a example a process text like this

[bluetooth]# pair E4:17:D8:C2:0B:0E
Attempting to pair with E4:17:D8:C2:0B:0E
[CHG] Device E4:17:D8:C2:0B:0E Connected: yes
[CHG] Device E4:17:D8:C2:0B:0E Modalias: usb:v2DC8p5101d0100
[CHG] Device E4:17:D8:C2:0B:0E UUIDs: 00001124-0000-1000-8000-00805f9b34fb
[CHG] Device E4:17:D8:C2:0B:0E UUIDs: 00001200-0000-1000-8000-00805f9b34fb
[CHG] Device E4:17:D8:C2:0B:0E ServicesResolved: yes
[CHG] Device E4:17:D8:C2:0B:0E Paired: yes
Pairing successful
[bluetooth]# connect E4:17:D8:C2:0B:0E
Attempting to connect to E4:17:D8:C2:0B:0E
Failed to connect: org.bluez.Error.Failed
[CHG] Device E4:17:D8:C2:0B:0E Connected: yes
Authorize service
o): yes Authorize service 00001124-0000-1000-8000-00805f9b34fb (yes/no
[8BitDo M30 Modkit]# trust E4:17:D8:C2:0B:0E
[CHG] Device E4:17:D8:C2:0B:0E Trusted: yes
Changing E4:17:D8:C2:0B:0E trust succeeded

Type devices to see a list of devices configurated in your BT setup.
Type remove MAC-ADRESS to remove single devices
Type yes if you are asked for authorization progress or enter PIN

  • bluetooth_controllers_-_manual_setup.1580852188.txt.gz
  • Last modified: 4 years ago
  • by lala