/[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.15 Revision 1.16
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bluetooth-guide.xml,v 1.15 2007/10/22 05:28:14 nightmorph Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bluetooth-guide.xml,v 1.16 2009/07/16 23:02:01 nightmorph Exp $ -->
4 4
5<guide link="/doc/en/bluetooth-guide.xml"> 5<guide link="/doc/en/bluetooth-guide.xml">
6<title>Gentoo Linux Bluetooth Guide</title> 6<title>Gentoo Linux Bluetooth Guide</title>
7 7
8<author title="Author"> 8<author title="Author">
18 <mail link="fox2mike@gentoo.org">Shyam Mani</mail> 18 <mail link="fox2mike@gentoo.org">Shyam Mani</mail>
19</author> 19</author>
20<author title="Editor"> 20<author title="Editor">
21 <mail link="rane@gentoo.org">Łukasz Damentko</mail> 21 <mail link="rane@gentoo.org">Łukasz Damentko</mail>
22</author> 22</author>
23<author title="Editor">
24 <mail link="nightmorph"/>
25</author>
23 26
24<abstract> 27<abstract>
25This guide will explain how to successfully install a host Bluetooth device, 28This guide will explain how to successfully install a host Bluetooth device,
26configure the kernel properly, explain all the possibilities that the Bluetooth 29configure the kernel properly, explain all the possibilities that the Bluetooth
27interconnection offers and how to have some fun with Bluetooth. 30interconnection offers and how to have some fun with Bluetooth.
29 32
30<!-- The content of this document is licensed under the CC-BY-SA license --> 33<!-- The content of this document is licensed under the CC-BY-SA license -->
31<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 34<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
32<license/> 35<license/>
33 36
34<version>1.10</version> 37<version>1.11</version>
35<date>2007-10-21</date> 38<date>2009-07-16</date>
36 39
37<chapter id="introduction"> 40<chapter id="introduction">
38<title>Introduction</title> 41<title>Introduction</title>
39<section> 42<section>
40<title>What is Bluetooth?</title> 43<title>What is Bluetooth?</title>
53<section> 56<section>
54<title>About the content of this guide</title> 57<title>About the content of this guide</title>
55<body> 58<body>
56 59
57<p> 60<p>
58The first part of this guide is to identify qualified and non-qualified devices 61The first part of this guide explains how to configure the system kernel,
59that support the Bluetooth technology. This way, users can purchase Bluetooth
60devices that are known to work. After that, the guide explains how to configure
61the system kernel, identify the Bluetooth devices installed on the system and 62identify the Bluetooth devices installed on the system and detected by the
62detected by the kernel and install the necessary basic Bluetooth tools. 63kernel and install the necessary basic Bluetooth tools.
63</p> 64</p>
64 65
65<p> 66<p>
66The second part covers how to detect remote devices and how to establish a 67The second part covers how to detect remote devices and how to establish a
67connection from or to them by either setting up radio frequency communication 68connection from or to them by either setting up radio frequency communication
68(RFCOMM) or by setting up a personal area network (PAN). 69(RFCOMM)<!-- or by setting up a personal area network (PAN)-->.
69</p> 70</p>
70 71
71<p> 72<p>
72The last part of the guide lists in detail applications that can take 73The last part of the guide lists in detail applications that can take
73advantage of all the possibilities offered by the Bluetooth technology. 74advantage of all the possibilities offered by the Bluetooth technology.
74</p>
75
76</body>
77</section>
78</chapter>
79
80<chapter id="devices">
81<title>Supported Devices</title>
82<section>
83<title>Qualified and non-qualified devices that support Bluetooth</title>
84<body>
85
86<impo>
87These products might work even though some are not qualified Bluetooth
88products. Gentoo does not support them in any way, they might just work.
89</impo>
90
91<p>
92A list of the currently supported devices can be found at: <uri
93link="http://www.holtmann.org/linux/bluetooth/features.html">Bluetooth device
94features and revision information by Marcel Holtmann</uri>.
95</p> 75</p>
96 76
97</body> 77</body>
98</section> 78</section>
99</chapter> 79</chapter>
106 86
107<p> 87<p>
108As the latest Linux stable kernel is 2.6, the configuration will be done for 88As the latest Linux stable kernel is 2.6, the configuration will be done for
109these series of the kernel. Most Bluetooth devices are connected to a USB port, 89these series of the kernel. Most Bluetooth devices are connected to a USB port,
110so USB will be enabled too. Please refer to the <uri 90so USB will be enabled too. Please refer to the <uri
111link="/doc/en/usb-guide.xml"> Gentoo Linux USB Guide</uri>. 91link="/doc/en/usb-guide.xml">Gentoo Linux USB Guide</uri>.
112</p> 92</p>
113 93
114<pre caption="Configuration for 2.6 kernels"> 94<pre caption="Configuration for 2.6 kernels">
115Networking ---&gt; 95Networking ---&gt;
116 96
310with knowledge of this number can essentially establish connections with your 290with knowledge of this number can essentially establish connections with your
311devices. 291devices.
312</impo> 292</impo>
313 293
314<note> 294<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 295Beginning 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 296have 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 297passkey 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 298<c>kdebluetooth</c>. You can also use <c>passkey-agent</c> (found in
327<c>bluez-utils</c>) from the command line. 299<c>bluez-utils</c>) from the command line.
521<comment>(To use a determined device when connecting to another one)</comment> 493<comment>(To use a determined device when connecting to another one)</comment>
522</pre> 494</pre>
523 495
524</body> 496</body>
525</section> 497</section>
526<section> 498<!-- Deleting pan chapter, bug 266690, until we know how the hell to do this -->
527<title>Setting up a Personal Area Network (PAN)</title>
528<body>
529
530<note>
531Please note that setting up a Personal Area Network is optional. This section
532describes how to set up and connect to a Network Access Point, though setting
533up a Group Ad-Hoc Network follows a similar way.
534</note>
535
536<p>
537First of all, we need the <c>bnep</c> module loaded. And probably we want it
538loaded each time the computer starts.
539</p>
540
541<pre caption="Loading the bnep module">
542# <i>modprobe bnep</i>
543# <i>echo "bnep" &gt;&gt; /etc/modules.autoload.d/kernel-2.6</i>
544</pre>
545
546<p>
547We have to start the <c>pand</c> daemon in the host that will provide the NAP.
548We'll have to specify that we want to provide a NAP service and that this host
549will be the master, thus the other hosts that connect to it, the slaves.
550Another possible service is GN (Group ad-hoc Network).
551</p>
552
553<pre caption="Running the pand daemon">
554# <i>pand --listen --role NAP --master --autozap</i>
555</pre>
556
557<p>
558After doing that, we have a host listening, so the rest of hosts just have to
559connect to that one.
560</p>
561
562<pre caption="Connecting to the Network Access Point">
563# <i>pand --connect 00:0A:0B:0C:0D:0E --service NAP --autozap</i>
564</pre>
565
566<p>
567If everything went fine, we can now configure the IP addresses of our hosts.
568</p>
569
570<pre caption="bnep IP address configuration">
571host0 #<i> ifconfig bnep0 192.168.2.1</i>
572host1 #<i> ifconfig bnep0 192.168.2.2</i>
573
574host0 #<i> ifconfig bnep0</i>
575bnep0 Link encap:Ethernet HWaddr 00:0A:0B:0C:0D:0E
576 inet addr:192.168.2.1 Bcast:192.168.2.255 Mask:255.255.255.0
577 inet6 addr: fe80::210:60ff:fea3:cb41/64 Scope:Link
578 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
579 RX packets:0 errors:0 dropped:0 overruns:0 frame:0
580 TX packets:5 errors:0 dropped:0 overruns:0 carrier:0
581 collisions:0 txqueuelen:1000
582 RX bytes:208 (208.0 b) TX bytes:188 (188.0 b)
583
584host1 #<i> ifconfig bnep0</i>
585bnep0 Link encap:Ethernet HWaddr 00:01:02:03:04:05
586 inet addr:192.168.2.2 Bcast:192.168.2.255 Mask:255.255.255.0
587 inet6 addr: fe80::210:60ff:fea2:dd2a/64 Scope:Link
588 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
589 RX packets:0 errors:0 dropped:0 overruns:0 frame:0
590 TX packets:5 errors:0 dropped:0 overruns:0 carrier:0
591 collisions:0 txqueuelen:1000
592 RX bytes:208 (208.0 b) TX bytes:188 (188.0 b)
593</pre>
594
595<p>
596Finally, we can do a simple test to see that the network is working fine.
597</p>
598
599<pre caption="IP ping between bnep interfaces">
600host1 #<i> ping 192.168.2.1</i>
601PING 192.168.2.1 (192.168.2.1) 56(84) bytes of data.
60264 bytes from 192.168.2.1: icmp_seq=1 ttl=64 time=34.0 ms
60364 bytes from 192.168.2.1: icmp_seq=2 ttl=64 time=37.3 ms
604
605--- 192.168.2.1 ping statistics ---
6062 packets transmitted, 2 received, 0% packet loss, time 1000ms
607rtt min/avg/max/mdev = 34.045/35.690/37.336/1.656 ms
608</pre>
609
610</body>
611</section>
612</chapter> 499</chapter>
613 500
614<chapter id="apps"> 501<chapter id="apps">
615<title>Desktop Applications for Bluetooth</title> 502<title>Desktop Applications for Bluetooth</title>
616<section> 503<section>

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

  ViewVC Help
Powered by ViewVC 1.1.20