Beyond Linux® From Scratch - Version 7.4

Chapter 12. System Utilities

BlueZ-4.101

Introduction to BlueZ

The BlueZ package contains the Bluetooth protocol stack for Linux.

This package is known to build and work properly using an LFS-7.4 platform.

Package Information

BlueZ Dependencies

Required

D-Bus-1.6.14 and GLib-2.36.4

Optional

alsa-lib-1.0.27.2, Check-0.9.10, gst-plugins-base-0.10.36, libsndfile-1.0.25, and libusb-compat-0.1.5

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/bluez

Kernel Configuration

Enable the following options in the kernel configuration and recompile the kernel if necessary: 

[*] Networking support --->
  <*> or <M> Bluetooth subsystem support --->
    <*> or <M> RFCOMM protocol support
    [*] RFCOMM TTY support
    <*> or <M> BNEP protocol support
    [*] Multicast filter support
    [*] Protocol filter support
    <*> or <M> HIDP protocol support

    Bluetooth device drivers --->

Select the appropriate drivers for your Bluetooth hardware.

Installation of BlueZ

Install BlueZ by running the following commands: 


./configure --prefix=/usr        \
            --sysconfdir=/etc    \
            --localstatedir=/var \
            --libexecdir=/lib    \
            --enable-bccmd       \
            --enable-dfutool     \
            --enable-dund        \
            --enable-hid2hci     \
            --enable-hidd        \
            --enable-pand        \
            --enable-tools       \
            --enable-wiimote     \
            --disable-test       \
            --without-systemdunitdir &&
make

This package does not come with a test suite.

Now, as the root user: 

make install

Install required configuration files as the root user: 

for CONFFILE in audio input network serial ; do
    install -v -m644 ${CONFFILE}/${CONFFILE}.conf /etc/bluetooth/${CONFFILE}.conf
done
unset CONFFILE

If desired, install the API documentation as the root user: 

install -v -m755 -d /usr/share/doc/bluez-4.101 &&
install -v -m644 doc/*.txt /usr/share/doc/bluez-4.101

Command Explanations

--enable-bccmd: This switch enables building of the BCCMD interface utility.

--enable-dfutool: This switch enables building of the DFU firmware upgrade utility.

--enable-dund: This switch enables building of the DUN daemon.

--enable-hid2hci: This switch enables building of the HID mode switching utility.

--enable-hidd: This switch enables building of the HID daemon.

--enable-pand: This switch enables building of the PAN daemon.

--enable-tools: This switch enables building of the Bluetooth utilities.

--enable-wiimote: This switch enables building of the Wii Remote plugin.

--disable-test: This switch disables installation of the test programs.

--without-systemdunitdir: This switch disables installation of the systemd units.

--enable-cups: This switch enables CUPS backend support. Note that CUPS does not need to be installed for this support.

Configuring BlueZ

Config Files

/etc/bluetooth/audio.conf, /etc/bluetooth/input.conf, /etc/bluetooth/main.conf, /etc/bluetooth/network.conf, /etc/bluetooth/rfcomm.conf and /etc/bluetooth/serial.conf

Boot Script

To automatically start the bluetoothd daemon when the system is rebooted, install the /etc/rc.d/init.d/bluetooth bootscript from the blfs-bootscripts-20130908 package. 

make install-bluetooth

Contents

Installed Programs: bccmd, bluetoothd, ciptool, dfutool, dund, gatttool, hciattach, hciconfig, hcitool, hid2hci, hidd, l2ping, pand, rfcomm, and sdptool
Installed Library: libbluetooth.so
Installed Directories: /etc/bluetooth, /usr/include/bluetooth, /usr/lib/bluetooth, /usr/share/doc/bluez-4.101, and /var/lib/bluetooth

Short Descriptions

bccmd

is used to issue BlueCore commands to Cambridge Silicon Radio devices.

bluetoothd

is the Bluetooth daemon.

ciptool

is used to set up, maintain, and inspect the CIP configuration of the Bluetooth subsystem in the Linux kernel.

dfutool

is used to verify, archive and upgrade firmware files.

dund

is the Bluetooth dial-up networking daemon.

hciattach

is used to attach a serial UART to the Bluetooth stack as HCI transport interface.

hciconfig

is used to configure Bluetooth devices.

hcitool

is used to configure Bluetooth connections and send some special command to Bluetooth devices.

hid2hci

is used to set up switch supported Bluetooth devices into the HCI mode and back.

hidd

is the Bluetooth HID daemon.

l2ping

is used to send a L2CAP echo request to the Bluetooth MAC address given in dotted hex notation.

pand

is the Bluetooth daemon that allows you to connect to ethernet networks using Bluetooth.

rfcomm

is used to set up, maintain, and inspect the RFCOMM configuration of the Bluetooth subsystem in the Linux kernel.

sdptool

is used to perform SDP queries on Bluetooth devices.

libbluetooth.so

contains the BlueZ API functions.

Last updated on 2013-09-05 09:23:52 -0700