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

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

  ViewVC Help
Powered by ViewVC 1.1.20