| 1 |
fox2mike 05/07/26 11:44:34 |
| 2 |
|
| 3 |
Modified: xml/htdocs/doc/en/draft bluetooth-guide.xml |
| 4 |
Log: |
| 5 |
Mixed bag of changes... |
| 6 |
|
| 7 |
Revision Changes Path |
| 8 |
1.2 +58 -102 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.2&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.2&content-type=text/plain&cvsroot=gentoo |
| 12 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/draft/bluetooth-guide.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo |
| 13 |
|
| 14 |
Index: bluetooth-guide.xml |
| 15 |
=================================================================== |
| 16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/bluetooth-guide.xml,v |
| 17 |
retrieving revision 1.1 |
| 18 |
retrieving revision 1.2 |
| 19 |
diff -u -r1.1 -r1.2 |
| 20 |
--- bluetooth-guide.xml 25 Jul 2005 11:12:45 -0000 1.1 |
| 21 |
+++ bluetooth-guide.xml 26 Jul 2005 11:44:34 -0000 1.2 |
| 22 |
@@ -123,19 +123,19 @@ |
| 23 |
<M> L2CAP protocol support |
| 24 |
<M> SCO links support |
| 25 |
<M> RFCOMM protocol support |
| 26 |
- [*] RFCOMM TTY support |
| 27 |
+[*] RFCOMM TTY support |
| 28 |
<M> BNEP protocol support |
| 29 |
- [*] Multicast filter support |
| 30 |
- [*] Protocol filter support |
| 31 |
+[*] Multicast filter support |
| 32 |
+[*] Protocol filter support |
| 33 |
<M> HIDP protocol support |
| 34 |
|
| 35 |
Bluetooth device drivers ---> |
| 36 |
<M> HCI USB driver |
| 37 |
- [*] SCO (voice) support |
| 38 |
+[*] SCO (voice) support |
| 39 |
<M> HCI UART driver |
| 40 |
- [*] UART (H4) protocol support |
| 41 |
- [*] BCSP protocol support |
| 42 |
- [*] Transmit CRC with every BCSP packet |
| 43 |
+[*] UART (H4) protocol support |
| 44 |
+[*] BCSP protocol support |
| 45 |
+[*] Transmit CRC with every BCSP packet |
| 46 |
<M> HCI BCM203x USB driver |
| 47 |
<M> HCI BPA10x USB driver |
| 48 |
<M> HCI BlueFRITZ! USB driver |
| 49 |
@@ -156,8 +156,8 @@ |
| 50 |
<*> Support for Host-side USB |
| 51 |
--- USB Host Controller Drivers |
| 52 |
<M> EHCI HCD (USB 2.0) support |
| 53 |
- [ ] Full speed ISO transactions (EXPERIMENTAL) |
| 54 |
- [ ] Root Hub Transaction Translators (EXPERIMENTAL) |
| 55 |
+[ ] Full speed ISO transactions (EXPERIMENTAL) |
| 56 |
+[ ] Root Hub Transaction Translators (EXPERIMENTAL) |
| 57 |
<*> OHCI HCD support |
| 58 |
<*> UHCI HCD (most Intel and VIA) support |
| 59 |
< > SL811HS HCD support |
| 60 |
@@ -193,7 +193,7 @@ |
| 61 |
</chapter> |
| 62 |
|
| 63 |
<chapter id="bluez"> |
| 64 |
-<title>BlueZ installation, configuration and PIN pairing</title> |
| 65 |
+<title>BlueZ Installation</title> |
| 66 |
<section> |
| 67 |
<title>Installing BlueZ</title> |
| 68 |
<body> |
| 69 |
@@ -202,18 +202,14 @@ |
| 70 |
Now that the device is detected by the kernel, we need a layer that lets |
| 71 |
applications communicate with the Bluetooth device. BlueZ provides the official |
| 72 |
Linux Bluetooth stack. The ebuilds that provide what we need are |
| 73 |
-<c>bluez-libs</c> and <c>bluez-utils</c>. |
| 74 |
+<c>bluez-libs</c> and <c>bluez-utils</c>. Devices that need Broadcom firmware |
| 75 |
+files or the like may need <c>bluez-firmware</c>. |
| 76 |
</p> |
| 77 |
|
| 78 |
<pre caption="Installing bluez-libs and bluez-utils"> |
| 79 |
# <i>emerge net-wireless/bluez-libs net-wireless/bluez-utils</i> |
| 80 |
</pre> |
| 81 |
|
| 82 |
-<impo> |
| 83 |
-Some devices might also need <c>bluez-firmware</c> to get the Broadcom firmware |
| 84 |
-files. |
| 85 |
-</impo> |
| 86 |
- |
| 87 |
<warn> |
| 88 |
Do not emerge <c>bluez-kernel</c> or <c>bluez-sdp</c> as they will break |
| 89 |
<c>bluez-utils</c>! |
| 90 |
@@ -239,16 +235,16 @@ |
| 91 |
|
| 92 |
<p> |
| 93 |
Now it's time to see if the Bluetooth device is being picked up correctly by the |
| 94 |
-system. |
| 95 |
+system. We start up the required Bluetooth services first. |
| 96 |
</p> |
| 97 |
|
| 98 |
<pre caption="Running hciconfig"> |
| 99 |
<comment>(Start up Bluetooth)</comment> |
| 100 |
# <i>/etc/init.d/bluetooth start</i> |
| 101 |
* Starting Bluetooth ... |
| 102 |
-* Starting hcid ... [ ok ] |
| 103 |
-* Starting sdpd ... [ ok ] |
| 104 |
-* Starting rfcomm ... [ ok ] |
| 105 |
+* Starting hcid ... [ ok ] |
| 106 |
+* Starting sdpd ... [ ok ] |
| 107 |
+* Starting rfcomm ... [ ok ] |
| 108 |
|
| 109 |
# <i>hciconfig</i> |
| 110 |
hci0: Type: USB |
| 111 |
@@ -261,85 +257,45 @@ |
| 112 |
<p> |
| 113 |
This shows that the Bluetooth device has been recognised. As you might have |
| 114 |
noticed the device is <e>DOWN</e>. Let's configure it so that we can bring it |
| 115 |
-up. A sample file with an already configured device is below. For additional |
| 116 |
-details: <c>man hcid.conf</c>. |
| 117 |
+up. The configuration file is at <path>/etc/bluetooth/hcid.conf</path>. The |
| 118 |
+required changes to the config file are shown below. For additional details |
| 119 |
+please refer to <c>man hcid.conf</c>. |
| 120 |
</p> |
| 121 |
|
| 122 |
-<pre caption="/etc/bluetooth/hcid.conf"> |
| 123 |
-<comment>#</comment> |
| 124 |
-<comment># HCI daemon configuration file.</comment> |
| 125 |
-<comment>#</comment> |
| 126 |
- |
| 127 |
-<comment># HCId options</comment> |
| 128 |
-options { |
| 129 |
- <comment># Automatically initialize new devices</comment> |
| 130 |
- autoinit yes; |
| 131 |
- |
| 132 |
- <comment># Security Manager mode</comment> |
| 133 |
- <comment># none - Security manager disabled</comment> |
| 134 |
- <comment># auto - Use local PIN for incoming connections</comment> |
| 135 |
- <comment># user - Always ask user for a PIN</comment> |
| 136 |
- <comment>#</comment> |
| 137 |
+<pre caption="Editing /etc/bluetooth/hcid.conf"> |
| 138 |
+<comment>(Recommended changes to be made to the file are shown)</comment> |
| 139 |
+ |
| 140 |
+<comment>(Change security to "auto")</comment> |
| 141 |
+ # Security Manager mode |
| 142 |
+ # none - Security manager disabled |
| 143 |
+ # auto - Use local PIN for incoming connections |
| 144 |
+ # user - Always ask user for a PIN |
| 145 |
+ # |
| 146 |
security auto; |
| 147 |
- |
| 148 |
- <comment># Pairing mode</comment> |
| 149 |
- <comment># none - Pairing disabled</comment> |
| 150 |
- <comment># multi - Allow pairing with already paired devices |
| 151 |
- </comment> |
| 152 |
- <comment># once - Pair once and deny successive attempts</comment> |
| 153 |
- pairing multi; |
| 154 |
- |
| 155 |
- <comment># PIN helper</comment> |
| 156 |
- <comment># pin_helper /usr/bin/bluepin;</comment> |
| 157 |
+ |
| 158 |
+<comment>(Change pin_helper to use /etc/bluetooth/pin-helper)</comment> |
| 159 |
+ # PIN helper |
| 160 |
pin_helper /etc/bluetooth/pin-helper; |
| 161 |
|
| 162 |
- <comment># D-Bus PIN helper</comment> |
| 163 |
- <comment>#dbus_pin_helper;</comment> |
| 164 |
-} |
| 165 |
- |
| 166 |
-<comment># Default settings for HCI devices</comment> |
| 167 |
-device { |
| 168 |
- <comment># Local device name</comment> |
| 169 |
- <comment> # %d - device id</comment> |
| 170 |
- <comment> # %h - host name</comment> |
| 171 |
+<comment>(Set your device name here, you can call it anything you |
| 172 |
+want)</comment> |
| 173 |
+ # Local device name |
| 174 |
+ # %d - device id |
| 175 |
+ # %h - host name |
| 176 |
name "BlueZ at %h (%d)"; |
| 177 |
|
| 178 |
- <comment> # Local device class</comment> |
| 179 |
- class 0x3e0100; |
| 180 |
- |
| 181 |
- <comment> # Default packet type</comment> |
| 182 |
- <comment> #pkt_type DH1,DM1,HV1;</comment> |
| 183 |
- |
| 184 |
- <comment> # Inquiry and Page scan</comment> |
| 185 |
- iscan enable; pscan enable; |
| 186 |
- |
| 187 |
- <comment># Default link mode</comment> |
| 188 |
- <comment># none - no specific policy</comment> |
| 189 |
- <comment># accept - always accept incoming connections</comment> |
| 190 |
- <comment># master - become master on incoming connections,</comment> |
| 191 |
- <comment># deny role switch on outgoing connections |
| 192 |
- </comment> |
| 193 |
- lm accept; |
| 194 |
- |
| 195 |
- <comment># Default link policy</comment> |
| 196 |
- <comment># none - no specific policy</comment> |
| 197 |
- <comment># rswitch - allow role switch</comment> |
| 198 |
- <comment># hold - allow hold mode</comment> |
| 199 |
- <comment># sniff - allow sniff mode</comment> |
| 200 |
- <comment># park - allow park mode</comment> |
| 201 |
- lp rswitch,hold,sniff,park; |
| 202 |
- |
| 203 |
- <comment># Authentication and Encryption (Security Mode 3)</comment> |
| 204 |
- <comment>#auth enable;</comment> |
| 205 |
- <comment>#encrypt enable;</comment> |
| 206 |
+<comment>(Leave as is, if you don't know what exactly these do)</comment> |
| 207 |
+ # Authentication and Encryption (Security Mode 3) |
| 208 |
+ #auth enable; |
| 209 |
+ #encrypt enable; |
| 210 |
} |
| 211 |
</pre> |
| 212 |
|
| 213 |
|
| 214 |
|
| 215 |
|
| 216 |
-- |
| 217 |
gentoo-doc-cvs@g.o mailing list |
Archives