fox2mike 05/07/25 11:12:45 Added: xml/htdocs/doc/en/draft bluetooth-guide.xml Log: Draft version to play around with before going final. Still needs a bit of grammer/english corrections + some content to be added.
Revision Changes Path 1.1 xml/htdocs/doc/en/draft/bluetooth-guide.xml 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 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 Index: bluetooth-guide.xml =================================================================== <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="/doc/en/bluetooth-guide.xml"> <title>Gentoo Linux Bluetooth Guide</title> <author title="Author"> <mail link="[EMAIL PROTECTED]">Ioannis Aslanidis</mail> </author> <author title="Contributor"> <mail link="[EMAIL PROTECTED]">Douglas Russell</mail> </author> <author title="Contributor"> <mail link="[EMAIL PROTECTED]">Marcel Holtmann</mail> </author> <author title="Contributor/Editor"> <mail link="[EMAIL PROTECTED]">Shyam Mani</mail> </author> <author title="Editor"> <mail link="[EMAIL PROTECTED]">Åukasz Damentko</mail> </author> <abstract> This guide will explain how to successfully install a host Bluetooth device, configure the kernel properly, explain all the possibilities that the Bluetooth interconnection offers and how to have some fun with Bluetooth. </abstract> <!-- The content of this document is licensed under the CC-BY-SA license --> <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> <license/> <version>1.0</version> <date>2005-07-25</date> <chapter id="introduction"> <title>Introduction</title> <section> <title>What is Bluetooth?</title> <body> <p> Bluetooth is an industrial specification that provides users a way to connect and exchange information between devices like personal computers, PDAs or mobile phones. Using the Bluetooth technology, users can achieve wireless voice and data transmission between devices at a low cost. Bluetooth also offers the possibility to create small wireless LANs and to synchronize devices. </p> </body> </section> <section> <title>About the content of this guide</title> <body> <p> The first part of this guide is to identify qualified and non-qualified devices that support the Bluetooth technology. This way, users can purchase Bluetooth devices that are known to work. After that, the guide explains how to configure the system kernel, identify the Bluetooth devices installed on the system and detected by the kernel and install the necessary basic Bluetooth tools. </p> <p> The second part covers how to detect remote devices and how to establish a connection from or to them by either setting up radio frequency communication (RFCOMM) or by setting up a personal area network (PAN). </p> <p> The last part of the guide lists in detail applications that can take advantage of all the possibilities offered by the Bluetooth technology. </p> </body> </section> </chapter> <chapter id="devices"> <title>Supported Devices</title> <section> <title>Qualified and non-qualified devices that support Bluetooth</title> <body> <impo> These products might work even though some are not qualified Bluetooth products. Gentoo does not support them in any way, they might just work. </impo> <p> A list of the currently supported devices can be found at: <uri link="http://www.holtmann.org/linux/bluetooth/features.html";>Bluetooth device features and revision information by Marcel Holtmann</uri>. </p> </body> </section> </chapter> <chapter id="kernel"> <title>Configuring the system</title> <section> <title>Kernel Configuration</title> <body> <p> As the latest linux stable kernel is 2.6, the configuration will be done for these series of the kernel. Most Bluetooth devices are connected to a USB port, so USB will be enabled too. If you want, you can use hotplugging in case you want to use modules instead of compiling support built into the kernel. Please, refer to the <uri link="/doc/en/usb-guide.xml"> Gentoo Linux USB Guide</uri>. </p> <pre caption="Configuration for 2.6 kernels"> Device Drivers ---> Networking Support ---> <*> Bluetooth subsystem support ---> --- Bluetooth subsystem support <M> L2CAP protocol support <M> SCO links support <M> RFCOMM protocol support [*] RFCOMM TTY support <M> BNEP protocol support [*] Multicast filter support [*] Protocol filter support <M> HIDP protocol support Bluetooth device drivers ---> <M> HCI USB driver [*] SCO (voice) support <M> HCI UART driver [*] UART (H4) protocol support [*] BCSP protocol support [*] Transmit CRC with every BCSP packet <M> HCI BCM203x USB driver <M> HCI BPA10x USB driver <M> HCI BlueFRITZ! USB driver <comment>(The four drivers below are for PCMCIA Bluetooth devices and will only show up if you have also selected PCMCIA support in your kernel.)</comment> <M> HCI DTL1 (PC Card) driver <M> HCI BT3C (PC Card) driver <M> HCI BlueCard (PC Card) driver <M> HCI UART (PC Card) device driver <comment>(The driver below is intended for HCI Emulation software.)</comment> <M> HCI VHCI (Virtual HCI device) driver <comment>(Move back three levels to Device Drives and then check if USB is enabled. This is required if you use a Bluetooth dongle, which are mostly USB based.)</comment> USB support ---> <*> Support for Host-side USB --- USB Host Controller Drivers <M> EHCI HCD (USB 2.0) support [ ] Full speed ISO transactions (EXPERIMENTAL) [ ] Root Hub Transaction Translators (EXPERIMENTAL) <*> OHCI HCD support <*> UHCI HCD (most Intel and VIA) support < > SL811HS HCD support </pre> <p> Now we'll reboot with our new kernel. If everything went fine, we will have a system that is Bluetooth ready. </p> <impo> Your USB device may have two modes the default of which may not be HCI, but HID. If this is your case, use <c>hid2hci</c> to switch to HCI mode. Your system will not remember this change when you next reboot. </impo> <pre caption="Checking the Bluetooth devices"> <comment>(One way to check for the device)</comment> # <i>cat /proc/bus/usb/devices | grep -e^[TPD] | grep -e Cls=e0 -B1 -A1</i> <comment>(The Cls=e0(unk. ) identifies the Bluetooth adapter.)</comment> T: Bus=02 Lev=02 Prnt=03 Port=00 Cnt=01 Dev#= 4 Spd=12 MxCh= 0 D: Ver= 1.10 Cls=e0(unk. ) Sub=01 Prot=01 MxPS=64 #Cfgs= 1 P: Vendor=0a12 ProdID=0001 Rev= 5.25 <comment>(Some might show up on lsusb from sys-apps/usbutils)</comment> # <i>lsusb</i> Bus 003 Device 002: ID 046d:c00e Logitech, Inc. Optical Mouse Bus 003 Device 001: ID 0000:0000 Bus 002 Device 002: ID 0db0:1967 Micro Star International Bluetooth Dongle </pre> </body> </section> </chapter> <chapter id="bluez"> <title>BlueZ installation, configuration and PIN pairing</title> <section> <title>Installing BlueZ</title> <body> -- [email protected] mailing list
