Attachment 241795 Details for Bug 286826 – suggested changes to the guide

[patch] suggested changes to the guide

bluetooth-guide.patch (text/plain), 6.09 KB, created by Nuno Silva on 2010-08-07 18:45:40 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Nuno Silva

Created: 2010-08-07 18:45:40 UTC

Size: 6.09 KB

patch

obsolete

>--- bluetooth-guide.xml?revision=1.17.orig	2010-08-03 22:31:10.000000000 +0100
>+++ bluetooth-guide.xml?revision=1.17	2010-08-07 15:41:38.000000000 +0100
>@@ -172,32 +172,103 @@
> <chapter id="bluez">
> <title>BlueZ - The Bluetooth Stack</title>
> <section>
>-<title>Installing BlueZ</title>
>+<title>What is BlueZ?</title>
> <body>
> 
> <p>
> Now that the device is detected by the kernel, we need a layer that lets
> applications communicate with the Bluetooth device. BlueZ provides the official
>-Linux Bluetooth stack. The ebuilds that provide what we need are
>-<c>bluez-libs</c> and <c>bluez-utils</c>. Devices that need Broadcom firmware
>+Linux Bluetooth stack. The ebuild that provides what we need is
>+<c>bluez</c>. Devices that need Broadcom firmware 
> files or the like may need <c>bluez-firmware</c>.
> </p>
>+</body>
>+</section>
> 
>-<pre caption="Installing bluez-libs and bluez-utils">
>-# <i>emerge net-wireless/bluez-libs net-wireless/bluez-utils</i>
>+<section>
>+<title>BlueZ permission control</title>
>+
>+<body>
>+<p>
>+Before installing, it is a good idea to choose how to control users' ability to
>+use bluetooth.
>+</p>
>+
>+<p>
>+There are two methods:
>+<ul>
>+
>+  <li>"consolekit": identifies users who are sat in front of the computer,
>+  and grants them access;</li>
>+  <li>"plugdev": allows members of the plugdev group to use bluetooth</li>
>+</ul>
>+</p>
>+
>+<p>
>+Although the permission policy can be tuned by editing the dbus permission rules
>+for <c>bluez</c>, the <c>consolekit</c> USE flag must be set accordingly
>+<ul>
>+  <li><c>consolekit</c> &mdash; means the consolekit method is used and requires
>+  it to be enabled in some dependencies</li>
>+  <li><c>-consolekit</c> &mdash; selects the plugdev method, and does not
>+  require any consolekit support in dependencies.</li>
>+</ul>
>+</p>
>+</body>
>+</section>
>+
>+<section>
>+<title>Installing bluez</title>
>+
>+<body>
>+<p>
>+Now we can install the package, using the following command.
>+</p>
>+<pre caption="Installing bluez">
>+# <i>emerge net-wireless/bluez</i>
> </pre>
> 
>+
>+<p>
>+This ebuild might require certain USE flags to be enabled for other ebuilds:
>+<ul>
>+  <li><c>sys-fs/udev</c> must have the <c>extras</c> flag enabled</li>
>+  <li>When <c>bluez</c> is built with <c>consolekit</c> enabled (see above),
>+  <c>sys-auth/pambase</c> must have it enabled too.</li>
>+</ul>
>+</p>
>+
>+<p>
>+Now the bluetooth stack is completely installed, but you need other tools to do
>+anything useful with it.
>+</p>
>+
>+<p>
>+You can get some tools enabling the <c>test-programs</c> USE flag
>+for <c>bluez</c>, which will install some testing utilities. But this is a
>+limited set of tools, mainly intended for testing &mdash; you probably want to
>+install an external bluetooth utilities package.
>+</p>
> </body>
> </section>
>+
> <section>
>-<title>BlueZ configuration and PIN pairing</title>
>+<title>BlueZ configuration</title>
> <body>
> 
> <p>
> Now it's time to see if the Bluetooth device is being picked up correctly by the
>-system. We start up the required Bluetooth services first.
>+system. We start up the required Bluetooth services first. (It may have been
>+started when you plugged the device, if it uses some hotpluggable interface
>+(like USB).)
> </p>
> 
>+
>+
> <pre caption="Running hciconfig">
> <comment>(Start up Bluetooth)</comment>
> # <i>/etc/init.d/bluetooth start</i>
>@@ -273,9 +344,14 @@
>         #encrypt enable;
> }
> </pre>
>+</body>
>+</section>
> 
>+<section>
>+<title>PIN pairing (<c>&lt;bluez-4</c>)</title>
>+<body>
> <p>
>-After that, we have to configure the Bluetooth device PIN. That will help in
>+After configuration, we have to configure the Bluetooth device PIN. That will help in
> pairing this device with another one.
> </p>
> 
>@@ -298,9 +374,65 @@
> <c>kdebluetooth</c>. You can also use <c>passkey-agent</c> (found in
> <c>bluez-utils</c>) from the command line.
> </note>
>+</body>
>+</section>
>+
>+<section> 
>+<title>PIN Pairing (<c>=bluez-4</c>, with <c>simple-agent</c>)</title>
>+<body>
>+<p>
>+In <c>=bluez-4</c>, there is no global PIN &mdash; when a device is paired you
>+need some bluetooth utility to input a PIN. One such utility
>+is <c>simple-agent</c>, part of bluez testing utilities (when built
>+with <c>USE="test-programs"</c>).
>+</p>
>+
>+<p>
>+Before pairing, you must know the bluetooth adapter id
>+(run <c>/usr/sbin/hciconfig</c>, if you have several adapters, you need to
>+choose which one you want to pair.
>+</p>
>+
>+<p>
>+
>+You also need the MAC address of the device you want to pair with the
>+adapter. Some devices have this written in some label, others don't. To find it
>+out, make the device visible and run <c>hcitool scan</c> &mdash; the result is a
>+list of devices, with their friendly names and MAC addresses.
>+</p>
>+
>+<pre caption="pairing with simple-agent">
>+  <comment>Find the MAC address:</comment>
>+$ hcitool scan
>+Scanning ...
>+	05:04:03:02:01:00	friendly-name
>+
>+  <comment>Find the adapter ID:</comment>
>+$ /usr/sbin/hciconfig
>+hci0:   Type: USB
>+        BD Address: 00:01:02:03:04:05 ACL MTU: 192:8  SCO MTU: 64:8
>+        UP RUNNING PSCAN
>+        RX bytes:131 acl:0 sco:0 events:18 errors:0
>+        TX bytes:565 acl:0 sco:0 commands:17 errors:0
>+
>+  <comment>And then pair the device</comment>
>+$ simple-agent hci0 05:04:03:02:01:00
>+RequestPinCode (/org/bluez/..../hci0/dev_05_04_03_02_01_00)
>+Enter PIN Code: 1234
>+  <comment>(Now the remote device will ask you for this same PIN.)</comment>
>+Release
>+New device (/org/bluez/..../hci0/dev_05_04_03_02_01_00)
>+</pre>
> 
>+<p>
>+Other bluetooth packages might be able to handle pairing. This involves a tool
>+which initiates pairing or a tool which listens for pairing requests, or both.
>+
>+</p>
> </body>
> </section>
>+
> <section>
> <title>Services configuration</title>
> <body>

Actions: View | Diff

Attachments on bug 286826: 241795 | 243633 | 251849 | 252969 | 254259