/[gentoo]/xml/htdocs/doc/en/bluetooth-guide.xml
Gentoo

Diff of /xml/htdocs/doc/en/bluetooth-guide.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.8 Revision 1.14
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2 2
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bluetooth-guide.xml,v 1.8 2006/11/02 18:37:33 nightmorph Exp $ --> 4<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bluetooth-guide.xml,v 1.14 2007/10/22 05:27:37 nightmorph Exp $ -->
5 5
6<guide link="/doc/en/bluetooth-guide.xml"> 6<guide link="/doc/en/bluetooth-guide.xml">
7<title>Gentoo Linux Bluetooth Guide</title> 7<title>Gentoo Linux Bluetooth Guide</title>
8 8
9<author title="Author"> 9<author title="Author">
30 30
31<!-- The content of this document is licensed under the CC-BY-SA license --> 31<!-- The content of this document is licensed under the CC-BY-SA license -->
32<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 32<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
33<license/> 33<license/>
34 34
35<version>1.5</version> 35<version>1.10</version>
36<date>2006-11-02</date> 36<date>2007-10-21</date>
37 37
38<chapter id="introduction"> 38<chapter id="introduction">
39<title>Introduction</title> 39<title>Introduction</title>
40<section> 40<section>
41<title>What is Bluetooth?</title> 41<title>What is Bluetooth?</title>
106<body> 106<body>
107 107
108<p> 108<p>
109As the latest Linux stable kernel is 2.6, the configuration will be done for 109As the latest Linux stable kernel is 2.6, the configuration will be done for
110these series of the kernel. Most Bluetooth devices are connected to a USB port, 110these series of the kernel. Most Bluetooth devices are connected to a USB port,
111so USB will be enabled too. If you want, you can use hotplugging in case you 111so USB will be enabled too. Please refer to the <uri
112want to use modules instead of compiling support built into the kernel. Please,
113refer to the <uri link="/doc/en/usb-guide.xml"> Gentoo Linux USB Guide</uri>. 112link="/doc/en/usb-guide.xml"> Gentoo Linux USB Guide</uri>.
114</p> 113</p>
115 114
116<pre caption="Configuration for 2.6 kernels"> 115<pre caption="Configuration for 2.6 kernels">
117Networking ---&gt; 116Networking ---&gt;
118 117
207 206
208<pre caption="Installing bluez-libs and bluez-utils"> 207<pre caption="Installing bluez-libs and bluez-utils">
209# <i>emerge net-wireless/bluez-libs net-wireless/bluez-utils</i> 208# <i>emerge net-wireless/bluez-libs net-wireless/bluez-utils</i>
210</pre> 209</pre>
211 210
212<warn>
213Do not emerge <c>bluez-sdp</c> as it will break <c>bluez-utils</c>!
214</warn>
215
216<p>
217Additionally, as we have compiled the Bluetooth subsystem as modules, we will
218need hotplug and coldplug, which are explained in the <uri
219link="http://www.gentoo.org/doc/en/usb-guide.xml#doc_chap4_sect2">Gentoo Linux
220USB Guide</uri>.
221</p>
222
223<pre caption="Emerging hotplug and coldplug">
224# <i>emerge hotplug coldplug</i>
225# <i>rc-update add coldplug boot</i>
226</pre>
227
228</body> 211</body>
229</section> 212</section>
230<section> 213<section>
231<title>BlueZ configuration and PIN pairing</title> 214<title>BlueZ configuration and PIN pairing</title>
232<body> 215<body>
277 security auto; 260 security auto;
278 261
279 # Pairing mode 262 # Pairing mode
280 pairing multi; 263 pairing multi;
281 264
265<comment>(You only need a pin helper if you are using &lt;=bluez-libs-2.x and &lt;=bluez-utils-2.x)
282<comment>(Change pin_helper to use /etc/bluetooth/pin-helper)</comment> 266(Change pin_helper to use /etc/bluetooth/pin-helper)</comment>
283 # PIN helper 267 # PIN helper
284 pin_helper /etc/bluetooth/pin-helper; 268 pin_helper /etc/bluetooth/pin-helper;
285} 269}
286 270
287# Default settings for HCI devices 271# Default settings for HCI devices
314<p> 298<p>
315After that, we have to configure the Bluetooth device PIN. That will help in 299After that, we have to configure the Bluetooth device PIN. That will help in
316pairing this device with another one. 300pairing this device with another one.
317</p> 301</p>
318 302
319<note>
320You can choose from different pin helpers, depending on what you want to use.
321Available pin helpers are: <c>/usr/lib/kdebluetooth/kbluepin</c>
322(net-wireless/kdebluetooth), <c>/usr/bin/bluepin</c> or
323<c>/etc/bluetooth/pin-helper</c> among others.
324</note>
325
326<pre caption="Editing /etc/bluetooth/pin"> 303<pre caption="Editing /etc/bluetooth/pin">
327<comment>(Change 123456 with your desired pin number.)</comment> 304<comment>(Replace 123456 with your desired pin number.)</comment>
328123456 305123456
329</pre> 306</pre>
330 307
331<impo> 308<impo>
332This number (of your choice) must be the same in all your hosts with Bluetooth 309This number (of your choice) must be the same in all your hosts with Bluetooth
333devices so they can be paired. This number must also be kept secret since anyone 310devices so they can be paired. This number must also be kept secret since anyone
334with knowledge of this number can essentially establish connections with your 311with knowledge of this number can essentially establish connections with your
335devices. 312devices.
336</impo> 313</impo>
314
315<note>
316If you are using <c>&lt;=bluez-libs-2.x</c> and <c>&lt;=bluez-utils-2.x</c> you
317can choose from different pin helpers, depending on what you want to use.
318Available pin helpers are: <c>/usr/lib/kdebluetooth/kbluepin</c>
319(net-wireless/kdebluetooth), <c>/usr/bin/bluepin</c> or
320<c>/etc/bluetooth/pin-helper</c> among others.
321</note>
322
323<note>
324Beginning with <c>>=bluez-libs-3.x</c> and <c>>=bluez-utils-3.x</c>, pin helpers
325have been replaced by passkey agents. There are a few different graphical
326passkey agents available to help manage your PIN, such as <c>bluez-gnome</c> and
327<c>kdebluetooth</c>. You can also use <c>passkey-agent</c> (found in
328<c>bluez-utils</c>) from the command line.
329</note>
337 330
338</body> 331</body>
339</section> 332</section>
340<section> 333<section>
341<title>Services configuration</title> 334<title>Services configuration</title>
741 Bluetooth connection (amongst other things). It includes such features as 734 Bluetooth connection (amongst other things). It includes such features as
742 backing up this information and restoring it later, and syncing with the 735 backing up this information and restoring it later, and syncing with the
743 Evolution e-mail client. You will need the <c>irmc</c> USE flag set to 736 Evolution e-mail client. You will need the <c>irmc</c> USE flag set to
744 ensure that <c>multisync</c> has Bluetooth support. 737 ensure that <c>multisync</c> has Bluetooth support.
745 </li> 738 </li>
739 <li>
740 <c>net-wireless/opd</c> and <c>net-wireless/ussp-push</c> are command line
741 tools (server and client) that can be used to send files to your mobile
742 phone.
743 </li>
746</ul> 744</ul>
747 745
748</body> 746</body>
749</section> 747</section>
750</chapter> 748</chapter>

Legend:
Removed from v.1.8  
changed lines
  Added in v.1.14

  ViewVC Help
Powered by ViewVC 1.1.20