source: general/sysutils/bluez.xml@ ef84ea0

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since ef84ea0 was ef84ea0, checked in by Fernando de Oliveira <fernando@…>, 10 years ago

Update to BlueZ-5.17. Thanks Armin K.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@12913 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 11.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY bluez-download-http "http://www.kernel.org/pub/linux/bluetooth/bluez-&bluez-version;.tar.xz">
8 <!ENTITY bluez-download-ftp "ftp://ftp.kernel.org/pub/linux/bluetooth/bluez-&bluez-version;.tar.xz">
9 <!ENTITY bluez-md5sum "5e6e41f0a275092ace303e813cd6f33b">
10 <!ENTITY bluez-size "1.3 MB">
11 <!ENTITY bluez-buildsize "51 MB">
12 <!ENTITY bluez-time "0.6 SBU">
13]>
14
15<sect1 id="bluez" xreflabel="BlueZ-&bluez-version;">
16 <?dbhtml filename="bluez.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>BlueZ-&bluez-version;</title>
24
25 <indexterm zone="bluez">
26 <primary sortas="a-BlueZ">BlueZ</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to BlueZ</title>
31
32 <para>
33 The <application>BlueZ</application> package contains the
34 Bluetooth protocol stack for Linux.
35 </para>
36
37 &lfs75_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&bluez-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&bluez-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &bluez-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &bluez-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &bluez-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &bluez-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">BlueZ Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Required</bridgehead>
76 <para role="required">
77 <xref linkend="dbus"/>,
78 <xref linkend="glib2"/>,
79 <xref linkend="libical"/>
80 </para>
81
82 <para condition="html" role="usernotes">
83 User Notes: <ulink url="&blfs-wiki;/bluez"/>
84 </para>
85 </sect2>
86
87
88 <sect2 role="kernel" id="bluez-kernel">
89 <title>Kernel Configuration</title>
90
91 <para>
92 Enable the following options in the kernel configuration and recompile the
93 kernel if necessary:
94 </para>
95
96<screen><literal>[*] Networking support --->
97 &lt;*&gt; or &lt;M&gt; Bluetooth subsystem support --->
98 &lt;*&gt; or &lt;M&gt; RFCOMM protocol support
99 [*] RFCOMM TTY support
100 &lt;*&gt; or &lt;M&gt; BNEP protocol support
101 [*] Multicast filter support
102 [*] Protocol filter support
103 &lt;*&gt; or &lt;M&gt; HIDP protocol support
104
105 Bluetooth device drivers ---></literal></screen>
106
107 <para>
108 Select the appropriate drivers for your Bluetooth hardware.
109 </para>
110
111 <indexterm zone="bluez bluez-kernel">
112 <primary sortas="d-bluez">bluez</primary>
113 </indexterm>
114 </sect2>
115
116 <sect2 role="installation">
117 <title>Installation of BlueZ</title>
118
119 <para>
120 Install <application>BlueZ</application> by running the following
121 commands:
122 </para>
123
124<screen><userinput>./configure --prefix=/usr \
125 --sysconfdir=/etc \
126 --localstatedir=/var \
127 --libexecdir=/usr/lib \
128 --enable-library \
129 --disable-systemd &amp;&amp;
130make</userinput></screen>
131
132 <para>
133 This package does not come with a test suite.
134 </para>
135
136 <para>
137 Now, as the <systemitem class="username">root</systemitem> user:
138 </para>
139
140<screen role="root"><userinput>make install</userinput></screen>
141
142 <para>
143 Install the main configuration file as the
144 <systemitem class="username">root</systemitem> user:
145 </para>
146
147<screen role="root"><userinput>install -v -dm755 /etc/bluetooth &amp;&amp;
148install -v -m644 src/main.conf /etc/bluetooth/main.conf</userinput></screen>
149
150 <para>
151 If desired, install the API documentation as the
152 <systemitem class="username">root</systemitem> user:
153 </para>
154
155<screen role="root"><userinput>install -v -dm755 /usr/share/doc/bluez-&bluez-version; &amp;&amp;
156install -v -m644 doc/*.txt /usr/share/doc/bluez-&bluez-version;</userinput></screen>
157
158 </sect2>
159
160
161 <sect2 role="commands">
162 <title>Command Explanations</title>
163
164 <para>
165 <parameter>--enable-library</parameter>: This switch enables building of the
166 <application>BlueZ</application> 4 compatibility library which is required by
167 some applications.
168 </para>
169
170 <para>
171 <parameter>--disable-systemd</parameter>: This switch is needed for
172 <application>systemd</application> is not part of LFS/BLFS. If you are
173 using systemd, remove this switch.
174 </para>
175
176 </sect2>
177
178 <sect2 role="configuration">
179 <title>Configuring BlueZ</title>
180
181 <sect3 id="bluez-config">
182 <title>Config Files</title>
183 <para>
184 <filename>/etc/bluetooth/main.conf</filename>
185 </para>
186
187 <indexterm zone="bluez bluez-config">
188 <primary
189 sortas="e-etc-bluetooth-main.conf">/etc/bluetooth/main.conf</primary>
190 </indexterm>
191
192 </sect3>
193
194 <sect3 id="bluez-init">
195 <title>Boot Script</title>
196
197 <para>
198 To automatically start the <command>bluetoothd</command> daemon when the
199 system is rebooted, install the
200 <filename>/etc/rc.d/init.d/bluetooth</filename> bootscript from the
201 <xref linkend="bootscripts"/> package.
202 </para>
203
204 <indexterm zone="bluez bluez-init">
205 <primary sortas="f-bluetooth">bluetooth</primary>
206 </indexterm>
207
208<screen role="root"><userinput>make install-bluetooth</userinput></screen>
209
210 </sect3>
211
212 </sect2>
213
214 <sect2 role="content">
215 <title>Contents</title>
216
217 <segmentedlist>
218 <segtitle>Installed Programs</segtitle>
219 <segtitle>Installed Library</segtitle>
220 <segtitle>Installed Directories</segtitle>
221
222 <seglistitem>
223 <seg>
224 bccmd, bluemoon, bluetoothctl, bluetoothd, btmon, ciptool,
225 hciattach, hciconfig, hcidump, hcitool, hid2hci, l2ping,
226 l2test, obexd, rctest, rfcomm, and sdptool
227 </seg>
228 <seg>
229 libbluetooth.so
230 </seg>
231 <seg>
232 /etc/bluetooth,
233 /usr/include/bluetooth,
234 /usr/libexec/bluetooth, and
235 /usr/share/doc/bluez-&bluez-version;
236 </seg>
237 </seglistitem>
238 </segmentedlist>
239
240 <variablelist>
241 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
242 <?dbfo list-presentation="list"?>
243 <?dbhtml list-presentation="table"?>
244
245 <varlistentry id="bccmd">
246 <term><command>bccmd</command></term>
247 <listitem>
248 <para>
249 is used to issue BlueCore commands to Cambridge Silicon
250 Radio devices.
251 </para>
252 <indexterm zone="bluez bccmd">
253 <primary sortas="b-bccmd">bccmd</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 <varlistentry id="bluetoothd">
259 <term><command>bluetoothd</command></term>
260 <listitem>
261 <para>
262 is the Bluetooth daemon.
263 </para>
264 <indexterm zone="bluez bluetoothd">
265 <primary sortas="b-bluetoothd">bluetoothd</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="ciptool">
271 <term><command>ciptool</command></term>
272 <listitem>
273 <para>
274 is used to set up, maintain, and inspect the CIP configuration
275 of the Bluetooth subsystem in the Linux kernel.
276 </para>
277 <indexterm zone="bluez ciptool">
278 <primary sortas="b-ciptool">ciptool</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="hciattach">
284 <term><command>hciattach</command></term>
285 <listitem>
286 <para>
287 is used to attach a serial UART to the Bluetooth stack
288 as HCI transport interface.
289 </para>
290 <indexterm zone="bluez hciattach">
291 <primary sortas="b-hciattach">hciattach</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
296 <varlistentry id="hciconfig">
297 <term><command>hciconfig</command></term>
298 <listitem>
299 <para>
300 is used to configure Bluetooth devices.
301 </para>
302 <indexterm zone="bluez hciconfig">
303 <primary sortas="b-hciconfig">hciconfig</primary>
304 </indexterm>
305 </listitem>
306 </varlistentry>
307
308 <varlistentry id="hcitool">
309 <term><command>hcitool</command></term>
310 <listitem>
311 <para>
312 is used to configure Bluetooth connections and send some
313 special command to Bluetooth devices.
314 </para>
315 <indexterm zone="bluez hcitool">
316 <primary sortas="b-hcitool">hcitool</primary>
317 </indexterm>
318 </listitem>
319 </varlistentry>
320
321 <varlistentry id="hid2hci">
322 <term><command>hid2hci</command></term>
323 <listitem>
324 <para>
325 is used to set up switch supported Bluetooth devices into
326 the HCI mode and back.
327 </para>
328 <indexterm zone="bluez hid2hci">
329 <primary sortas="b-hid2hci">hid2hci</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 <varlistentry id="l2ping">
335 <term><command>l2ping</command></term>
336 <listitem>
337 <para>
338 is used to send a L2CAP echo request to the Bluetooth MAC
339 address given in dotted hex notation.
340 </para>
341 <indexterm zone="bluez l2ping">
342 <primary sortas="b-l2ping">l2ping</primary>
343 </indexterm>
344 </listitem>
345 </varlistentry>
346
347 <varlistentry id="rctest">
348 <term><command>rctest</command></term>
349 <listitem>
350 <para>
351 is used to test RFCOMM communications on the
352 Bluetooth stack.
353 </para>
354 <indexterm zone="bluez rctest">
355 <primary sortas="b-rctest">rctest</primary>
356 </indexterm>
357 </listitem>
358 </varlistentry>
359
360 <varlistentry id="rfcomm">
361 <term><command>rfcomm</command></term>
362 <listitem>
363 <para>
364 is used to set up, maintain, and inspect the RFCOMM
365 configuration of the Bluetooth subsystem in the
366 Linux kernel.
367 </para>
368 <indexterm zone="bluez rfcomm">
369 <primary sortas="b-rfcomm">rfcomm</primary>
370 </indexterm>
371 </listitem>
372 </varlistentry>
373
374 <varlistentry id="sdptool">
375 <term><command>sdptool</command></term>
376 <listitem>
377 <para>
378 is used to perform SDP queries on Bluetooth devices.
379 </para>
380 <indexterm zone="bluez sdptool">
381 <primary sortas="b-sdptool">sdptool</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 <varlistentry id="libbluetooth">
387 <term><filename class="libraryfile">libbluetooth.so</filename></term>
388 <listitem>
389 <para>
390 contains the <application>BlueZ</application> 4 API functions.
391 </para>
392 <indexterm zone="bluez libbluetooth">
393 <primary sortas="c-libbluetooth">libbluetooth.so</primary>
394 </indexterm>
395 </listitem>
396 </varlistentry>
397 </variablelist>
398
399 </sect2>
400
401</sect1>
Note: See TracBrowser for help on using the repository browser.