/[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.13
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.13 2007/05/16 09:10:33 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.9</version>
36<date>2006-11-02</date> 36<date>2007-05-16</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
211 210
212<warn> 211<warn>
213Do not emerge <c>bluez-sdp</c> as it will break <c>bluez-utils</c>! 212Do not emerge <c>bluez-sdp</c> as it will break <c>bluez-utils</c>!
214</warn> 213</warn>
215 214
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> 215</body>
229</section> 216</section>
230<section> 217<section>
231<title>BlueZ configuration and PIN pairing</title> 218<title>BlueZ configuration and PIN pairing</title>
232<body> 219<body>
277 security auto; 264 security auto;
278 265
279 # Pairing mode 266 # Pairing mode
280 pairing multi; 267 pairing multi;
281 268
269<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> 270(Change pin_helper to use /etc/bluetooth/pin-helper)</comment>
283 # PIN helper 271 # PIN helper
284 pin_helper /etc/bluetooth/pin-helper; 272 pin_helper /etc/bluetooth/pin-helper;
285} 273}
286 274
287# Default settings for HCI devices 275# Default settings for HCI devices
314<p> 302<p>
315After that, we have to configure the Bluetooth device PIN. That will help in 303After that, we have to configure the Bluetooth device PIN. That will help in
316pairing this device with another one. 304pairing this device with another one.
317</p> 305</p>
318 306
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"> 307<pre caption="Editing /etc/bluetooth/pin">
327<comment>(Change 123456 with your desired pin number.)</comment> 308<comment>(Replace 123456 with your desired pin number.)</comment>
328123456 309123456
329</pre> 310</pre>
330 311
331<impo> 312<impo>
332This number (of your choice) must be the same in all your hosts with Bluetooth 313This 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 314devices 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 315with knowledge of this number can essentially establish connections with your
335devices. 316devices.
336</impo> 317</impo>
318
319<note>
320If you are using <c>&lt;=bluez-libs-2.x</c> and <c>&lt;=bluez-utils-2.x</c> you
321can choose from different pin helpers, depending on what you want to use.
322Available pin helpers are: <c>/usr/lib/kdebluetooth/kbluepin</c>
323(net-wireless/kdebluetooth), <c>/usr/bin/bluepin</c> or
324<c>/etc/bluetooth/pin-helper</c> among others.
325</note>
326
327<note>
328Beginning with <c>>=bluez-libs-3.x</c> and <c>>=bluez-utils-3.x</c>, pin helpers
329have been replaced by passkey agents. There are a few different graphical
330passkey agents available to help manage your PIN, such as <c>bluez-gnome</c> and
331<c>kdebluetooth</c>. You can also use <c>passkey-agent</c> (found in
332<c>bluez-utils</c>) from the command line.
333</note>
337 334
338</body> 335</body>
339</section> 336</section>
340<section> 337<section>
341<title>Services configuration</title> 338<title>Services configuration</title>
741 Bluetooth connection (amongst other things). It includes such features as 738 Bluetooth connection (amongst other things). It includes such features as
742 backing up this information and restoring it later, and syncing with the 739 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 740 Evolution e-mail client. You will need the <c>irmc</c> USE flag set to
744 ensure that <c>multisync</c> has Bluetooth support. 741 ensure that <c>multisync</c> has Bluetooth support.
745 </li> 742 </li>
743 <li>
744 <c>net-wireless/opd</c> and <c>net-wireless/ussp-push</c> are command line
745 tools (server and client) that can be used to send files to your mobile
746 phone.
747 </li>
746</ul> 748</ul>
747 749
748</body> 750</body>
749</section> 751</section>
750</chapter> 752</chapter>

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

  ViewVC Help
Powered by ViewVC 1.1.20