Difference between pages "Bluetooth made easy" and "Kernel Seeds"

(Difference between pages)
m (updated codeblock for clarity)
 
(Created page with "This page is intended to house the new Kernel Seeds page. Here's what Duncan and I think is a good idea: * kernel-seeds.org redirects to this page. * This page has some nice...")
 
Line 1: Line 1:
== Kernel Support ==
+
This page is intended to house the new Kernel Seeds page.
You must have bluetooth support in your kernel if you are going to use bluetooth.  Enable the following in your kernel config:
+
<console>
+
##i##Networking support →
+
  ##i##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
+
</console>
+
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:
+
Here's what Duncan and I think is a good idea:
<console>
+
##i##Networking support →
+
##i##  Bluetooth subsystem support →
+
##i##    Bluetooth device drivers →
+
        <m> HCI USB driver
+
</console>
+
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:
+
<console>
+
echo “>bluez-4.(whatever version you choose)”>>/etc/portage/package.mask
+
echo “>pulseaudio-4.(whatever version you choose)”>>/etc/portage/package.mask
+
</console>
+
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
+
* kernel-seeds.org redirects to this page.
 +
* This page has some nice, special graphics on it to differentiate it from the other Funtoo Wiki pages.
 +
* This page begins with a short history of Kernel Seeds, giving credit to Pappy and talking about its role in the Gentoo community.
 +
* Following this, a short introduction to the concepts behind kernel seeds will be written from scratch.
 +
* Existing content will be converted and edited and stored as subpages (ie. Kernel_Seeds/Working_With_Kernel_Seeds)
 +
* The latest .config files (3.9.9 era) will be moved to a git repository to allow community maintenance. The older versions will be archived.
  
And then: emerge -aND @world
+
This will allow the pages to be maintained by interested users, and allow good integration with the rest of the Funtoo wiki, while maintaining its distinctiveness with its own look.
 
+
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:
+
<console>
+
# rc-update add bluetooth default
+
</console>
+
== 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:
+
<console>
+
##i###/etc/udev/rules.d/10-local.rules
+
##i### Set bluetooth power up
+
##i##ACTION=="add", KERNEL=="hci0", RUN+="/usr/bin/hciconfig hci0 up"
+
</console>
+
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:
+
<console>
+
##i###/etc/local.d/*.start
+
##i##rfkill block bluetooth
+
</console>
+
Bluez-4.x will start with the device powered off.
+
 
+
Or, you bluez-5.x users that want your device powered on start:
+
<console>
+
##i###/etc/local.d/*.start
+
##i##rfkill unblock bluetooth  #UNTESTED!
+
</console>
+
/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.
+
<console>
+
##i###/home/<username>/bin/bluetooth
+
##i###keyboard shortcut set to <your choice>, toggles bluetooth on & off
+
##i###this file must be added to sudoers ;)
+
 
+
##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
+
 
+
##i##for file in /sys/class/rfkill/*
+
##i##do
+
##i## if [ "$(cat ${file}/name)" = "hp-bluetooth" ]; then  ### you'll have to snoop around in there, rename to what your device is called
+
##i## BT_STATE=$(cat ${file}/state)
+
##i## fi
+
##i##done
+
##i##if [[ ${BT_STATE} -eq 1 ]]; then
+
##i## rfkill block bluetooth
+
##i## BLUETOOTH_STRING="  Bluetooth powered off"
+
##i## DISPLAY_COLOR="red"
+
##i##else
+
##i##        rfkill unblock bluetooth
+
##i## BLUETOOTH_STRING="  Bluetooth powered on"
+
##i## DISPLAY_COLOR="blue"
+
##i##fi
+
##i### Clean up any running aosd_cat processes
+
##i##killall aosd_cat &> /dev/null
+
##i### Display the desired text
+
##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
+
</console>
+
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:
+
<console>
+
##i##<username> ALL = NOPASSWD: /home/<username>/bin/bluetooth
+
</console>
+
Now just add the following command to your hotkey assignment, and you can toggle bluetooth on & off to your heart's content:
+
<console>
+
##i##sudo /home/<username>/bin/bluetooth
+
</console>
+
== 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.
+
 
+
{{fancynote|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:
+
<console>
+
##i###/home/<username>/bin/bluetooth (partial)
+
##i##  …  else
+
##i##      rfkill unblock bluetooth
+
##i### add these 4 lines
+
##i##        sleep 2
+
##i##        /usr/bin/bdaddr -i hci0 AA:AA:AA:AA:AA:AA  2&>1>/dev/null #of course, you must change this to "Master Record's" receiver address
+
##i##        /usr/sbin/hciconfig hci0 reset
+
##i##        /etc/init.d/bluetooth restart
+
##i### end of addition
+
##i## BLUETOOTH_STRING="  Bluetooth powered on"
+
##i## DISPLAY_COLOR="blue"  ...
+
                  …
+
</console>
+
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.
+

Revision as of 00:06, 10 April 2014

This page is intended to house the new Kernel Seeds page.

Here's what Duncan and I think is a good idea:

  • kernel-seeds.org redirects to this page.
  • This page has some nice, special graphics on it to differentiate it from the other Funtoo Wiki pages.
  • This page begins with a short history of Kernel Seeds, giving credit to Pappy and talking about its role in the Gentoo community.
  • Following this, a short introduction to the concepts behind kernel seeds will be written from scratch.
  • Existing content will be converted and edited and stored as subpages (ie. Kernel_Seeds/Working_With_Kernel_Seeds)
  • The latest .config files (3.9.9 era) will be moved to a git repository to allow community maintenance. The older versions will be archived.

This will allow the pages to be maintained by interested users, and allow good integration with the rest of the Funtoo wiki, while maintaining its distinctiveness with its own look.