/[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.3 Revision 1.8
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.3 2005/08/31 15:03:32 neysx Exp $ --> 4<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bluetooth-guide.xml,v 1.8 2006/11/02 18:37: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.1</version> 35<version>1.5</version>
36<date>2005-08-31</date> 36<date>2006-11-02</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>
112want to use modules instead of compiling support built into the kernel. Please, 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>. 113refer to the <uri link="/doc/en/usb-guide.xml"> Gentoo Linux USB Guide</uri>.
114</p> 114</p>
115 115
116<pre caption="Configuration for 2.6 kernels"> 116<pre caption="Configuration for 2.6 kernels">
117Device Drivers ---&gt;
118 Networking Support ---&gt; 117Networking ---&gt;
119 118
120&lt;*&gt; Bluetooth subsystem support ---&gt; 119&lt;*&gt; Bluetooth subsystem support ---&gt;
121 120
122--- Bluetooth subsystem support 121--- Bluetooth subsystem support
123&lt;M&gt; L2CAP protocol support 122&lt;M&gt; L2CAP protocol support
209<pre caption="Installing bluez-libs and bluez-utils"> 208<pre caption="Installing bluez-libs and bluez-utils">
210# <i>emerge net-wireless/bluez-libs net-wireless/bluez-utils</i> 209# <i>emerge net-wireless/bluez-libs net-wireless/bluez-utils</i>
211</pre> 210</pre>
212 211
213<warn> 212<warn>
214Do not emerge <c>bluez-kernel</c> or <c>bluez-sdp</c> as they will break 213Do not emerge <c>bluez-sdp</c> as it will break <c>bluez-utils</c>!
215<c>bluez-utils</c>!
216</warn> 214</warn>
217 215
218<p> 216<p>
219Additionally, as we have compiled the Bluetooth subsystem as modules, we will 217Additionally, as we have compiled the Bluetooth subsystem as modules, we will
220need hotplug and coldplug, which are explained in the <uri 218need hotplug and coldplug, which are explained in the <uri
263</p> 261</p>
264 262
265<pre caption="Editing /etc/bluetooth/hcid.conf"> 263<pre caption="Editing /etc/bluetooth/hcid.conf">
266<comment>(Recommended changes to be made to the file are shown)</comment> 264<comment>(Recommended changes to be made to the file are shown)</comment>
267 265
266# HCId options
267options {
268 # Automatically initialize new devices
269 autoinit yes;
270
268<comment>(Change security to "auto")</comment> 271<comment>(Change security to "auto")</comment>
269 # Security Manager mode 272 # Security Manager mode
270 # none - Security manager disabled 273 # none - Security manager disabled
271 # auto - Use local PIN for incoming connections 274 # auto - Use local PIN for incoming connections
272 # user - Always ask user for a PIN 275 # user - Always ask user for a PIN
273 # 276 #
274 security auto; 277 security auto;
275 278
279 # Pairing mode
280 pairing multi;
281
276<comment>(Change pin_helper to use /etc/bluetooth/pin-helper)</comment> 282<comment>(Change pin_helper to use /etc/bluetooth/pin-helper)</comment>
277 # PIN helper 283 # PIN helper
278 pin_helper /etc/bluetooth/pin-helper; 284 pin_helper /etc/bluetooth/pin-helper;
285}
279 286
287# Default settings for HCI devices
288device {
280<comment>(Set your device name here, you can call it anything you want)</comment> 289<comment>(Set your device name here, you can call it anything you want)</comment>
281 # Local device name 290 # Local device name
282 # %d - device id 291 # %d - device id
283 # %h - host name 292 # %h - host name
284 name "BlueZ at %h (%d)"; 293 name "BlueZ at %h (%d)";
294
295 # Local device class
296 class 0x3e0100;
297
298 # Inquiry and Page scan
299 iscan enable; pscan enable;
300
301 # Default link mode
302 lm accept;
303
304 # Default link policy
305 lp rswitch,hold,sniff,park;
285 306
286<comment>(Leave as is, if you don't know what exactly these do)</comment> 307<comment>(Leave as is, if you don't know what exactly these do)</comment>
287 # Authentication and Encryption (Security Mode 3) 308 # Authentication and Encryption (Security Mode 3)
288 #auth enable; 309 #auth enable;
289 #encrypt enable; 310 #encrypt enable;
334</pre> 355</pre>
335 356
336<p> 357<p>
337Let's be sure that the Bluetooth daemons started correctly. If we can see that 358Let's be sure that the Bluetooth daemons started correctly. If we can see that
338both <c>hcid</c> and <c>sdpd</c> are running, then we configured Bluetooth the 359both <c>hcid</c> and <c>sdpd</c> are running, then we configured Bluetooth the
339right way. After that, we can see if the decices are now up and running with 360right way. After that, we can see if the devices are now up and running with
340the configured options. 361the configured options.
341</p> 362</p>
342 363
343<pre caption="Checking whether Bluetooth daemons started correctly"> 364<pre caption="Checking whether Bluetooth daemons started correctly">
344<comment>(Check to see if the services are running)</comment> 365<comment>(Check to see if the services are running)</comment>
34826054 ? 00:00:00 sdpd 36926054 ? 00:00:00 sdpd
349 370
350# <i>hciconfig -a</i> 371# <i>hciconfig -a</i>
351hci0: Type: USB 372hci0: Type: USB
352 BD Address: 00:0A:0B:0C:0D:0E ACL MTU: 192:8 SCO MTU: 64:8 373 BD Address: 00:0A:0B:0C:0D:0E ACL MTU: 192:8 SCO MTU: 64:8
353 UP RUNNING PSCAN ISCAN AUTH ENCRYPT 374 UP RUNNING PSCAN ISCAN
354 RX bytes:125 acl:0 sco:0 events:17 errors:0 375 RX bytes:125 acl:0 sco:0 events:17 errors:0
355 TX bytes:565 acl:0 sco:0 commands:17 errors:0 376 TX bytes:565 acl:0 sco:0 commands:17 errors:0
356 Features: 0xff 0xff 0x0f 0x00 0x00 0x00 0x00 0x00 377 Features: 0xff 0xff 0x0f 0x00 0x00 0x00 0x00 0x00
357 Packet type: DM1 DM3 DM5 DH1 DH3 DH5 HV1 HV2 HV3 378 Packet type: DM1 DM3 DM5 DH1 DH3 DH5 HV1 HV2 HV3
358 Link policy: RSWITCH HOLD SNIFF PARK 379 Link policy: RSWITCH HOLD SNIFF PARK
399Inquiring ... 420Inquiring ...
400 00:0A:0B:0C:0D:0E clock offset: 0x5579 class: 0x72010c 421 00:0A:0B:0C:0D:0E clock offset: 0x5579 class: 0x72010c
401</pre> 422</pre>
402 423
403<p> 424<p>
404Now that we now the MAC address of the remote Bluetooth devices, we can check 425Now that we know the MAC address of the remote Bluetooth devices, we can check
405if we paired them correctly. 426if we paired them correctly.
406</p> 427</p>
407 428
408<pre caption="Running l2ping"> 429<pre caption="Running l2ping">
409# <i>l2ping 00:0A:0B:0C:0D:0E</i> 430# <i>l2ping 00:0A:0B:0C:0D:0E</i>
720 Bluetooth connection (amongst other things). It includes such features as 741 Bluetooth connection (amongst other things). It includes such features as
721 backing up this information and restoring it later, and syncing with the 742 backing up this information and restoring it later, and syncing with the
722 Evolution e-mail client. You will need the <c>irmc</c> USE flag set to 743 Evolution e-mail client. You will need the <c>irmc</c> USE flag set to
723 ensure that <c>multisync</c> has Bluetooth support. 744 ensure that <c>multisync</c> has Bluetooth support.
724 </li> 745 </li>
725 <li>
726 <c>media-plugins/xmms-btexmms</c>: Btexmms is an XMMS plugin that allows
727 you to use your Bluetooth-enabled (Sony) Ericsson mobile phone as a remote
728 control for XMMS.
729 </li>
730</ul> 746</ul>
731 747
732</body> 748</body>
733</section> 749</section>
734</chapter> 750</chapter>

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

  ViewVC Help
Powered by ViewVC 1.1.20