| 1 |
fox2mike 05/07/25 11:12:45 |
| 2 |
|
| 3 |
Added: xml/htdocs/doc/en/draft bluetooth-guide.xml |
| 4 |
Log: |
| 5 |
Draft version to play around with before going final. Still needs a bit of grammer/english corrections + some content to be added. |
| 6 |
|
| 7 |
Revision Changes Path |
| 8 |
1.1 xml/htdocs/doc/en/draft/bluetooth-guide.xml |
| 9 |
|
| 10 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/draft/bluetooth-guide.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
| 11 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/draft/bluetooth-guide.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo |
| 12 |
|
| 13 |
Index: bluetooth-guide.xml |
| 14 |
=================================================================== |
| 15 |
<?xml version='1.0' encoding="UTF-8"?> |
| 16 |
|
| 17 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 18 |
|
| 19 |
<guide link="/doc/en/bluetooth-guide.xml"> |
| 20 |
<title>Gentoo Linux Bluetooth Guide</title> |
| 21 |
|
| 22 |
<author title="Author"> |
| 23 |
<mail link="deathwing00@g.o">Ioannis Aslanidis</mail> |
| 24 |
</author> |
| 25 |
<author title="Contributor"> |
| 26 |
<mail link="puggy@g.o">Douglas Russell</mail> |
| 27 |
</author> |
| 28 |
<author title="Contributor"> |
| 29 |
<mail link="marcel@××××××××.org">Marcel Holtmann</mail> |
| 30 |
</author> |
| 31 |
<author title="Contributor/Editor"> |
| 32 |
<mail link="fox2mike@g.o">Shyam Mani</mail> |
| 33 |
</author> |
| 34 |
<author title="Editor"> |
| 35 |
<mail link="rane@××××××.pl">Łukasz Damentko</mail> |
| 36 |
</author> |
| 37 |
|
| 38 |
<abstract> |
| 39 |
This guide will explain how to successfully install a host Bluetooth device, |
| 40 |
configure the kernel properly, explain all the possibilities that the Bluetooth |
| 41 |
interconnection offers and how to have some fun with Bluetooth. |
| 42 |
</abstract> |
| 43 |
|
| 44 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
| 45 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 46 |
<license/> |
| 47 |
|
| 48 |
<version>1.0</version> |
| 49 |
<date>2005-07-25</date> |
| 50 |
|
| 51 |
<chapter id="introduction"> |
| 52 |
<title>Introduction</title> |
| 53 |
<section> |
| 54 |
<title>What is Bluetooth?</title> |
| 55 |
<body> |
| 56 |
|
| 57 |
<p> |
| 58 |
Bluetooth is an industrial specification that provides users a way to connect |
| 59 |
and exchange information between devices like personal computers, PDAs or |
| 60 |
mobile phones. Using the Bluetooth technology, users can achieve wireless voice |
| 61 |
and data transmission between devices at a low cost. Bluetooth also offers the |
| 62 |
possibility to create small wireless LANs and to synchronize devices. |
| 63 |
</p> |
| 64 |
|
| 65 |
</body> |
| 66 |
</section> |
| 67 |
<section> |
| 68 |
<title>About the content of this guide</title> |
| 69 |
<body> |
| 70 |
|
| 71 |
<p> |
| 72 |
The first part of this guide is to identify qualified and non-qualified devices |
| 73 |
that support the Bluetooth technology. This way, users can purchase Bluetooth |
| 74 |
devices that are known to work. After that, the guide explains how to configure |
| 75 |
the system kernel, identify the Bluetooth devices installed on the system and |
| 76 |
detected by the kernel and install the necessary basic Bluetooth tools. |
| 77 |
</p> |
| 78 |
|
| 79 |
<p> |
| 80 |
The second part covers how to detect remote devices and how to establish a |
| 81 |
connection from or to them by either setting up radio frequency communication |
| 82 |
(RFCOMM) or by setting up a personal area network (PAN). |
| 83 |
</p> |
| 84 |
|
| 85 |
<p> |
| 86 |
The last part of the guide lists in detail applications that can take |
| 87 |
advantage of all the possibilities offered by the Bluetooth technology. |
| 88 |
</p> |
| 89 |
|
| 90 |
</body> |
| 91 |
</section> |
| 92 |
</chapter> |
| 93 |
|
| 94 |
<chapter id="devices"> |
| 95 |
<title>Supported Devices</title> |
| 96 |
<section> |
| 97 |
<title>Qualified and non-qualified devices that support Bluetooth</title> |
| 98 |
<body> |
| 99 |
|
| 100 |
<impo> |
| 101 |
These products might work even though some are not qualified Bluetooth |
| 102 |
products. Gentoo does not support them in any way, they might just work. |
| 103 |
</impo> |
| 104 |
|
| 105 |
<p> |
| 106 |
A list of the currently supported devices can be found at: <uri |
| 107 |
link="http://www.holtmann.org/linux/bluetooth/features.html">Bluetooth device |
| 108 |
features and revision information by Marcel Holtmann</uri>. |
| 109 |
</p> |
| 110 |
|
| 111 |
</body> |
| 112 |
</section> |
| 113 |
</chapter> |
| 114 |
|
| 115 |
<chapter id="kernel"> |
| 116 |
<title>Configuring the system</title> |
| 117 |
<section> |
| 118 |
<title>Kernel Configuration</title> |
| 119 |
<body> |
| 120 |
|
| 121 |
<p> |
| 122 |
As the latest linux stable kernel is 2.6, the configuration will be done for |
| 123 |
these series of the kernel. Most Bluetooth devices are connected to a USB port, |
| 124 |
so USB will be enabled too. If you want, you can use hotplugging in case you |
| 125 |
want to use modules instead of compiling support built into the kernel. Please, |
| 126 |
refer to the <uri link="/doc/en/usb-guide.xml"> Gentoo |
| 127 |
Linux USB Guide</uri>. |
| 128 |
</p> |
| 129 |
|
| 130 |
<pre caption="Configuration for 2.6 kernels"> |
| 131 |
Device Drivers ---> |
| 132 |
Networking Support ---> |
| 133 |
|
| 134 |
<*> Bluetooth subsystem support ---> |
| 135 |
|
| 136 |
--- Bluetooth subsystem support |
| 137 |
<M> L2CAP protocol support |
| 138 |
<M> SCO links support |
| 139 |
<M> RFCOMM protocol support |
| 140 |
[*] RFCOMM TTY support |
| 141 |
<M> BNEP protocol support |
| 142 |
[*] Multicast filter support |
| 143 |
[*] Protocol filter support |
| 144 |
<M> HIDP protocol support |
| 145 |
|
| 146 |
Bluetooth device drivers ---> |
| 147 |
<M> HCI USB driver |
| 148 |
[*] SCO (voice) support |
| 149 |
<M> HCI UART driver |
| 150 |
[*] UART (H4) protocol support |
| 151 |
[*] BCSP protocol support |
| 152 |
[*] Transmit CRC with every BCSP packet |
| 153 |
<M> HCI BCM203x USB driver |
| 154 |
<M> HCI BPA10x USB driver |
| 155 |
<M> HCI BlueFRITZ! USB driver |
| 156 |
<comment>(The four drivers below are for PCMCIA Bluetooth devices and will only |
| 157 |
show up if you have also selected PCMCIA support in your kernel.)</comment> |
| 158 |
<M> HCI DTL1 (PC Card) driver |
| 159 |
<M> HCI BT3C (PC Card) driver |
| 160 |
<M> HCI BlueCard (PC Card) driver |
| 161 |
<M> HCI UART (PC Card) device driver |
| 162 |
<comment>(The driver below is intended for HCI Emulation software.)</comment> |
| 163 |
<M> HCI VHCI (Virtual HCI device) driver |
| 164 |
|
| 165 |
<comment>(Move back three levels to Device Drives and then check if USB is |
| 166 |
enabled. This is required if you use a Bluetooth dongle, which are mostly USB |
| 167 |
based.)</comment> |
| 168 |
USB support ---> |
| 169 |
|
| 170 |
<*> Support for Host-side USB |
| 171 |
--- USB Host Controller Drivers |
| 172 |
<M> EHCI HCD (USB 2.0) support |
| 173 |
[ ] Full speed ISO transactions (EXPERIMENTAL) |
| 174 |
[ ] Root Hub Transaction Translators (EXPERIMENTAL) |
| 175 |
<*> OHCI HCD support |
| 176 |
<*> UHCI HCD (most Intel and VIA) support |
| 177 |
< > SL811HS HCD support |
| 178 |
</pre> |
| 179 |
|
| 180 |
<p> |
| 181 |
Now we'll reboot with our new kernel. If everything went fine, we will have a |
| 182 |
system that is Bluetooth ready. |
| 183 |
</p> |
| 184 |
|
| 185 |
<impo> |
| 186 |
Your USB device may have two modes the default of which may not be HCI, but HID. |
| 187 |
If this is your case, use <c>hid2hci</c> to switch to HCI mode. Your system |
| 188 |
will not remember this change when you next reboot. |
| 189 |
</impo> |
| 190 |
|
| 191 |
<pre caption="Checking the Bluetooth devices"> |
| 192 |
<comment>(One way to check for the device)</comment> |
| 193 |
# <i>cat /proc/bus/usb/devices | grep -e^[TPD] | grep -e Cls=e0 -B1 -A1</i> |
| 194 |
<comment>(The Cls=e0(unk. ) identifies the Bluetooth adapter.)</comment> |
| 195 |
T: Bus=02 Lev=02 Prnt=03 Port=00 Cnt=01 Dev#= 4 Spd=12 MxCh= 0 |
| 196 |
D: Ver= 1.10 Cls=e0(unk. ) Sub=01 Prot=01 MxPS=64 #Cfgs= 1 |
| 197 |
P: Vendor=0a12 ProdID=0001 Rev= 5.25 |
| 198 |
<comment>(Some might show up on lsusb from sys-apps/usbutils)</comment> |
| 199 |
# <i>lsusb</i> |
| 200 |
Bus 003 Device 002: ID 046d:c00e Logitech, Inc. Optical Mouse |
| 201 |
Bus 003 Device 001: ID 0000:0000 |
| 202 |
Bus 002 Device 002: ID 0db0:1967 Micro Star International Bluetooth Dongle |
| 203 |
</pre> |
| 204 |
|
| 205 |
</body> |
| 206 |
</section> |
| 207 |
</chapter> |
| 208 |
|
| 209 |
<chapter id="bluez"> |
| 210 |
<title>BlueZ installation, configuration and PIN pairing</title> |
| 211 |
<section> |
| 212 |
<title>Installing BlueZ</title> |
| 213 |
<body> |
| 214 |
|
| 215 |
|
| 216 |
|
| 217 |
-- |
| 218 |
gentoo-doc-cvs@g.o mailing list |
Archives