Add tutorial: setting-up Bluetooth - PulseAudio #24
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,138 @@ | ||
| --- | ||
| title: Setting Up Bluetooth audio with PulseAudio - A2DP only | ||
| subject: Bluetooth | ||
| --- | ||
|
|
||
| ### Overview | ||
| Debian jessie is using BlueZ 5 and PluseAudio 5, which are fairly new. | ||
| There were major breaking changes in these versions. | ||
| Most stuff you find on the Internet will be for BlueZ 4 and PulseAudio 4, | ||
| so watch out, those configurations may not work. | ||
|
|
||
| [PulseAudio 5 only supports the A2DP profile](http://www.freedesktop.org/wiki/Software/PulseAudio/Notes/5.0/) and not Headset profile (HSP) or Hands-free profile (HFP), | ||
|
There was a problem hiding this comment. Put links at the end of the file. For example, this line should be something like... ...and at the end of the file... There was a problem hiding this comment. done |
||
| although it is [under development](http://cgit.freedesktop.org/pulseaudio/pulseaudio/commit/?id=1f0de01bfc85f92785fcd2f0e863e471af7e6ace). | ||
|
|
||
| The A2DP profile provides these two profiles: | ||
|
There was a problem hiding this comment. The profiles are not provided by A2DP, rather, they are provided by PulseAudio. (A2DP is just a specification). There was a problem hiding this comment. sharp :-) |
||
|
|
||
| UUID: Audio Source | ||
| UUID: Audio Sink | ||
|
|
||
| The remote device we are connecting to needs to have at least one of these profiles. | ||
|
|
||
| ### How to get PulseAudio working with Bluetooth | ||
|
There was a problem hiding this comment. Please put blank line after all heading lines. |
||
| **This should all be done as root** | ||
|
|
||
| 1. Install pulseaudio: | ||
|
|
||
| apt-get install --no-install-recommends pulseaudio pulseaudio-module-bluetooth | ||
|
|
||
| 2. Create a systemd service for running pulseaudio as the pulse user. | ||
| Save the following lines as `/etc/systemd/system/pulseaudio.service` | ||
|
|
||
| [Unit] | ||
| Description=Pulse Audio | ||
| [Service] | ||
| Type=simple | ||
| ExecStart=/usr/bin/pulseaudio --system --disallow-exit --disable-shm | ||
|
There was a problem hiding this comment. Need blank lines before and after the "code" There was a problem hiding this comment. That indeed helps a lot, thanks |
||
|
|
||
| and reload systemd with `systemctl daemon-reload` | ||
|
|
||
| 3. Give the `pulse` user permission to use Bluetooth. | ||
| Save the following lines to `/etc/dbus-1/system.d/pulseaudio-bluetooth.conf` | ||
|
|
||
| <busconfig> | ||
|
|
||
| <policy user="pulse"> | ||
| <allow send_destination="org.bluez"/> | ||
| </policy> | ||
|
|
||
| </busconfig> | ||
|
|
||
| 4. Paste the following lines to the **end** of `/etc/pulse/system.pa`: | ||
|
|
||
| ### Automatically load driver modules for Bluetooth hardware | ||
| .ifexists module-bluetooth-policy.so | ||
| load-module module-bluetooth-policy | ||
| .endif | ||
| .ifexists module-bluetooth-discover.so | ||
| load-module module-bluetooth-discover | ||
| .endif | ||
|
|
||
| 5. Start the systemd service: `systemctl start pulseaudio.service` | ||
|
|
||
| 6. Connect the device, example using brickman on the EV3 screen. | ||
| You only need to do the pairing stuff once. | ||
| Be sure to substitute the address of the actual device your are connecting to. | ||
|
There was a problem hiding this comment. In brickman, we see the name of the device, so we don't have to worry about the address. There was a problem hiding this comment. hihi :-) |
||
| Actions to do: | ||
|
|
||
| On the brickman main screen scroll to the `Bluetooth` option: | ||
|  | ||
|
There was a problem hiding this comment. Please use liquid template for images. Also, brickman screenshots should be given meaningful names and go in Example: There was a problem hiding this comment. learned. There was a problem hiding this comment. Found an answer for my second question, will change the brickman images to have a background of 0xadb578 and push into my repo. There was a problem hiding this comment. Q1: Yes, replacing the existing file would be good. However, see answer to Q2 for caveat. |
||
|
|
||
| Press the EV3 "ENTER" button (the center button) | ||
| Scroll with the up or down button to `Start Scan` and press "ENTER" | ||
|  | ||
|
There was a problem hiding this comment. Should be a blank line between all screenshots and surrounding text. |
||
|
|
||
| Did you set the target device "discoverable"? If not, better do that now. | ||
| Scroll down (or up if you like) to the device you want to use. | ||
| Press "ENTER" to select: | ||
|  | ||
|
|
||
| On the brickman device page: | ||
| Select `Pair` and press "ENTER" | ||
|  | ||
|
|
||
| On the remote device you also need to accept the pairing. | ||
| Select `Accept` and press "ENTER" | ||
|  | ||
|
|
||
| After successful pairing select `Connect` and press "ENTER": | ||
|  | ||
|
|
||
| 7. Now, you should be able to play sound from a remote device on your EV3 without any further configuration. | ||
|
|
||
| 8. To play sound from the EV3 on a remote device, there are a few more steps. | ||
| * add your own non-root user(s) to the `audio` and `pulse-access` groups: | ||
|
|
||
| usermod -a -G pulse-access,audio myuser | ||
|
There was a problem hiding this comment. Needs additional indenting so that it is displayed as code. |
||
|
|
||
| * Run `pactl list cards` | ||
|
There was a problem hiding this comment. This must be run as |
||
| The end of the output should look something like this: | ||
|
|
||
| Card #1 | ||
|
There was a problem hiding this comment. Same here - needs more indenting. There was a problem hiding this comment. helps, thanks |
||
| Name: bluez_card.00_17_E7_BD_1C_8E | ||
| Driver: module-bluez5-device.c | ||
| Owner Module: 14 | ||
| Properties: | ||
| device.description = "BlueZ 5.23" | ||
| device.string = "00:17:E7:BD:1C:8E" | ||
| device.api = "bluez" | ||
| device.class = "sound" | ||
| device.bus = "bluetooth" | ||
| bluez.path = "/org/bluez/hci0/dev_00_17_E7_BD_1C_8E" | ||
| bluez.class = "0x0c0000" | ||
| bluez.alias = "BlueZ 5.23" | ||
| device.icon_name = "audio-card-bluetooth" | ||
| Profiles: | ||
| a2dp_source: High Fidelity Capture (A2DP Source) (sinks: 0, sources: 1, priority: 10, available: yes) | ||
| a2dp: High Fidelity Playback (A2DP Sink) (sinks: 1, sources: 0, priority: 10, available: yes) | ||
| off: Off (sinks: 0, sources: 0, priority: 0, available: yes) | ||
| Active Profile: a2dp | ||
| Ports: | ||
| unknown-output: Bluetooth Output (priority: 0, latency offset: 0 usec) | ||
| Part of profile(s): a2dp | ||
| unknown-input: Bluetooth Input (priority: 0, latency offset: 0 usec) | ||
| Part of profile(s): a2dp_source | ||
|
|
||
| The active profile probably doesn't say `a2dp`, although in the output above it already has been set. | ||
| So set it by running: `pactl set-card-profile 1 a2dp` | ||
| The "1" in this command is the number of the BT card from the output above. | ||
|
|
||
| 9. Now you can play sound using paplay. | ||
| Example: `paplay -d bluez_sink.00_17_E7_BD_1C_8E /usr/share/sounds/alsa/Front_Center.wav` | ||
|
There was a problem hiding this comment. Put the command on its own line and indented so that it displays as a larger code block. There was a problem hiding this comment. and blanks lines before and after. |
||
| Possibly error messages like `xcb_connection_has_error() returned true` have been seen and not explained. | ||
| There seems to be no ill effect on BT audio. | ||
| Using my simple non-root user I get: | ||
|
|
||
| Failed to create secure directory (/run/user/0/pulse): Permission denied | ||
|
|
||
| but playback **does** work. | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,6 @@ | ||
| --- | ||
| title: Setting Up Bluetooth keyboard | ||
| subject: Bluetooth | ||
| --- | ||
|
|
||
| ### Needs to be created |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Get rid of trailing spaces to prevent line breaks. This applies to the whole file.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
On some places it's a matter of taste, but you are right. will do.