The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.
Bluetooth made easy
Kernel Support
You must have bluetooth support in your kernel if you are going to use bluetooth. Enable the following in your kernel config:
root ##i##Networking support → Bluetooth subsystem support → <m> RFCOMM protocol support <y> RFCOMM tty support <m> BNEP protocol support <y> Multicast filter support <y> Protocol filter support <m> HIDP protocol support
I find no difference in choosing built-in modules vs. loading modules with the exception that someday you may wish to use out-of-tree drivers directly from wireless.kernel.org. Just adding all the modules guarantees you can do anything bluetooth in the future, not worth worrying about saving a tiny bit of space.
Also be sure and select your bluetooth device driver:
root ##i##Networking support → root ##i## Bluetooth subsystem support → root ##i## Bluetooth device drivers → <m> HCI USB driver
Make sure you choose at least the HCI USB driver. Others may be applicable to your setup too, for example, if you have a Broadcom BCM203x device you'll want the driver for that which loads the appropriate firmware.
Userspace Programs
As of this writing there have been big changes in bluez. If you intend to use headsets, they (currently) will NOT work with bluez-5.x. The HSP/HFP protocol that these headsets use were set up by bluez (in the past), but that now will be handled by pulseaudio (in the future). For headset owners (in the present) you must choose bluez-4.x and pulseaudio-4.x if you intend to use them. So mask the newer versions in /etc/portage/package.mask:
echo “>bluez-4.(whatever version you choose)”>>/etc/portage/package.mask echo “>pulseaudio-4.(whatever version you choose)”>>/etc/portage/package.mask
A2DP and other protocols still work fine in bluez-5, so if you don't intend to use headsets the above doesn't apply.
Add “bluetooth” to your USE flags in /etc/portage/make.conf
And then: emerge -aND @world
If you need firmware for your bluetooth receiver be sure and get that too. Sys-kernel/linux-firmware is always a safe bet to have on hand.
You'll want to add bluetooth to your startup:
root # rc-update add bluetooth default
Usage
While it's rumored that some high-profile Funtoo users refuse to even run X server, for the rest of us a handy GUI can be nice. However, be aware that all operations can be done from the command line as well. If you intend to do that, bluez-4.x needs to be installed with the “test-programs” USE flag. I don't believe it's necessary with bluez-5 and above.
For bluez-4.x/pulseaudio-4.x users wanting a GUI you can use gnome-bluetooth (I recommend <=3.6) or blueman. The blueman project has been abandoned, but still works fine until we all move on past version 4 bluez.
For bluez-5.x users the choice is more limited. Blueman will not work. A newer version of gnome-bluetooth probably does, not tested here. I did test bluedevil and it seemed to work, but I suspect initial pairing must still be done at the command line.
Pair up your devices, you're ready to go! For bluez-4.x with GUI this is pretty trivial, if you have issues, there is plenty on the web. Bluez-5.x is a little different, as far as I have seen it is all done at the command line, once again I refer you to the web where it is covered in detail.
Custom Tips
With bluez-5.x, things are bit strange. It starts with your bluetooth device (receiver) powered off. For those that would like their bluetooth active on machine start, the following code passing around the web added to /etc/udev/rules.d/10-local.rules is purported to work:
root ##i###/etc/udev/rules.d/10-local.rules root ##i### Set bluetooth power up root ##i##ACTION=="add", KERNEL=="hci0", RUN+="/usr/bin/hciconfig hci0 up"
However, I suspect the same technique the author has been using for years will work just as well. At any rate, while bluez-4.x powers your device on at startup, by the same token you can start it powered down and then use a hotkey to toggle it. By adding the following to your /etc/local.d/*.start file:
root ##i###/etc/local.d/*.start root ##i##rfkill block bluetooth
Bluez-4.x will start with the device powered off.
Or, you bluez-5.x users that want your device powered on start:
root ##i###/etc/local.d/*.start root ##i##rfkill unblock bluetooth #UNTESTED!
/etc/local.d/*.start operates as the root user. This is convenient, as rfkill requires root to execute.
Your bluetooth device will be physically powered down (no electricity even) when rfkill blocks it. Most desktop environments, Gnome, KDE, etc. have some way to assign a hotkey to a command. However, these commands are limited to the unprivileged user. Since rfkill must be run by root I use the following method.
First, we need toggle action, so the key can turn bluetooth either off or on. This accomplishes that. I have a /home/<username>/bin directory with many “helper” programs. In there, create a file owned by root, with chmod 744 permissions called bluetooth.
root ##i###/home/<username>/bin/bluetooth root ##i###keyboard shortcut set to <your choice>, toggles bluetooth on & off root ##i###this file must be added to sudoers ;) root ##i### we need to find which rfkill applies to bluetooth, there can be one for wifi, one for bluetooth, I have a 3rd , don't even know what it is root ##i##for file in /sys/class/rfkill/* root ##i##do root ##i## if [ "$(cat ${file}/name)" = "hp-bluetooth" ]; then ### you'll have to snoop around in there, rename to what your device is called root ##i## BT_STATE=$(cat ${file}/state) root ##i## fi root ##i##done root ##i##if [[ ${BT_STATE} -eq 1 ]]; then root ##i## rfkill block bluetooth root ##i## BLUETOOTH_STRING=" Bluetooth powered off" root ##i## DISPLAY_COLOR="red" root ##i##else root ##i## rfkill unblock bluetooth root ##i## BLUETOOTH_STRING=" Bluetooth powered on" root ##i## DISPLAY_COLOR="blue" root ##i##fi root ##i### Clean up any running aosd_cat processes root ##i##killall aosd_cat &> /dev/null root ##i### Display the desired text root ##i##echo "$BLUETOOTH_STRING" | aosd_cat -n "Georgia Italic 120" -u 1000 -o 200 -R $DISPLAY_COLOR -S black -f 0 -e 4 -p 3 -x 300
As you can see, I also have a display that prints huge colored letters across my screen telling bluetooth status for a few seconds as I enable/disable it. To have the display you must install x11-libs/libaosd. That's it, the code in the bluetooth program shows how to use this handy library.
Since this program is owned by root, and in fact, rfkill itself must be run as root, simply put the following line in your sudoers file:
root ##i##<username> ALL = NOPASSWD: /home/<username>/bin/bluetooth
Now just add the following command to your hotkey assignment, and you can toggle bluetooth on & off to your heart's content:
root ##i##sudo /home/<username>/bin/bluetooth
Yet Another Trick
Another handy thing that can be done. I have 2 computers at my desk, 1 is rarely used and somewhat underpowered. I sometimes use it though to talk on voip, leaving my main machine free to compile, restart, whatever.
The problem: I wish to use the same headsets on both computers. In practice, this is a bit of a hassle, because you must pair the headsets with only one machine, so as I switch back and forth, I have to change the pairing. Not the end of the world, but we can save that hassle.
Some newer headsets can be paired to as many as 3 different receivers, great if you have them
The first task is to acquire the bdaddr program. It's on the Backtrack Linux distros, you can probably find it out there in cyberspace somewhere, but it gets confusing on a search because bluez uses the bdaddr abbreviation a lot, creating a lot of noise in your search. I just put it in /usr/bin.
To accomplish this, one machine must be the “Master Record” and the other machine pretends to be that machine with pairing. Not as complicated as it sounds.
Now pair all of your devices on the “Master Record” machine. The secret link codes are stored at (shhhh!) /var/lib/bluetooth in a directory named with your receivers bluetooth address, let's say AA:AA:AA:AA:AA:AA. After this is done you are ready to start on the Pretender machine. It will fool bluez into thinking that it's bluetooth address is AA:AA:AA:AA:AA:AA, even though it has a different address. Copy the AA:AA:AA:AA:AA:AA directory from /var/lib/bluetooth on the “Master Record” machine to /var/lib/bluetooth on the “Pretender”. The Pretender will now have two directories in /var/lib/bluetooth, AA:AA:AA:AA:AA:AA and it's own receiver's address directory. (Unless you have more than 1 receiver, but let's keep it simple).
Then simply modify the code in /home/<username>/bin/bluetooth, only the “turn on” section is shown below, because that's all we are changing:
root ##i###/home/<username>/bin/bluetooth (partial) root ##i## … else root ##i## rfkill unblock bluetooth root ##i### add these 4 lines root ##i## sleep 2 root ##i## /usr/bin/bdaddr -i hci0 AA:AA:AA:AA:AA:AA 2&>1>/dev/null root ##i## /usr/sbin/hciconfig hci0 reset root ##i## /etc/init.d/bluetooth restart root ##i### end of addition root ##i## BLUETOOTH_STRING=" Bluetooth powered on" root ##i## DISPLAY_COLOR="blue" ... …
And that's it! Now both machines will use the same headsets and you won't constantly have to re-pair. When the Pretender bluetooth is toggled on it has the other machines bluetooth address for it's receiver. Note that I always start my bluetooth powered off, so it always starts in pretend mode, if you start with yours powered on it won't spoof the other address until you toggle it off & then on unless you add the above code to your /etc/local.d/*.start file.
The only caveat is I'm not sure what would ever happen if I had both bluetooth receivers on at the same time and turned on a headset. But far short of a nuclear meltdown I'm sure, I suspect one machine would grab the headset before the other? Anyhow, with hotkey controlled bluetooth it's never been an issue.