Subversion Repositories svn LFS-FR

Rev

Rev 7031 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
5853 myou72 1
<?xml version="1.0" encoding="UTF-8"?>
2201 myou72 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
  <!ENTITY bluez-download-http "http://www.kernel.org/pub/linux/bluetooth/bluez-&bluez-version;.tar.xz">
7
  <!ENTITY bluez-download-ftp  "ftp://ftp.kernel.org/pub/linux/bluetooth/bluez-&bluez-version;.tar.xz">
7031 myou72 8
  <!ENTITY bluez-md5sum        "33177e5743e24b2b3738f72be64e3ffb">
6890 myou72 9
  <!ENTITY bluez-size          "1.6 Mo">
7031 myou72 10
  <!ENTITY bluez-buildsize     "87 Mo (avec les tests)">
11
  <!ENTITY bluez-time          "0.7 SBU (avec les tests)">
2201 myou72 12
]>
13
<sect1 id="bluez" xreflabel="bluez-&bluez-version;">
14
  <?dbhtml filename="bluez.html"?>
15
  <sect1info>
3531 myou72 16
    <othername>$LastChangedBy&nbsp;: randy $</othername>
17
    <date>$Date&nbsp;: 2013-02-11 19:51:17 +0100 (Mon, 11 Feb 2013) $</date>
2201 myou72 18
  </sect1info>
19
  <title>BlueZ-&bluez-version;</title>
20
  <indexterm zone="bluez">
21
    <primary sortas="a-BlueZ">BlueZ</primary>
22
  </indexterm>
23
  <sect2 role="package">
5853 myou72 24
    <title>Introduction à BlueZ</title>
2201 myou72 25
    <para>
2204 myou72 26
      Le paquet <application>BlueZ</application> contient la pile de protocole
27
      Bluetooth pour Linux.
2201 myou72 28
    </para>
6976 myou72 29
    &lfs78_checked;
2201 myou72 30
    <bridgehead renderas="sect3">Information sur le paquet </bridgehead>
31
    <itemizedlist spacing="compact">
32
      <listitem>
33
        <para>
5853 myou72 34
          Téléchargement (HTTP)&nbsp;: <ulink url="&bluez-download-http;"/>
2201 myou72 35
        </para>
36
      </listitem>
37
      <listitem>
38
        <para>
5853 myou72 39
          Téléchargement (FTP)&nbsp;: <ulink url="&bluez-download-ftp;"/>
2201 myou72 40
        </para>
41
      </listitem>
42
      <listitem>
43
        <para>
5853 myou72 44
          Somme de contrôle MD5 du téléchargement&nbsp;: &bluez-md5sum;
2201 myou72 45
        </para>
46
      </listitem>
47
      <listitem>
48
        <para>
5853 myou72 49
          Taille du téléchargement&nbsp;: &bluez-size;
2201 myou72 50
        </para>
51
      </listitem>
52
      <listitem>
53
        <para>
2214 myou72 54
          Estimation de l'espace disque requis&nbsp;: &bluez-buildsize;
2201 myou72 55
        </para>
56
      </listitem>
57
      <listitem>
58
        <para>
2214 myou72 59
          Estimation du temps de construction&nbsp;: &bluez-time;
2201 myou72 60
        </para>
61
      </listitem>
62
    </itemizedlist>
5975 myou72 63
      <bridgehead renderas="sect3">Téléchargements supplémentaires</bridgehead>
64
      <itemizedlist spacing="compact">
65
        <listitem>
66
          <para>
7054 myou72 67
             Correctif facultatif (requis pour faie fonctionner correctement gnome-bluetooth
5975 myou72 68
             et/ou kde bluedevil):
69
            <ulink url="&patch-root;/bluez-&bluez-version;-obexd_without_systemd-1.patch"/>
70
          </para>
71
        </listitem>
72
      </itemizedlist>
5853 myou72 73
    <bridgehead renderas="sect3">Dépendances de BlueZ</bridgehead>
2201 myou72 74
    <bridgehead renderas="sect4">Requises</bridgehead>
75
    <para role="required">
5975 myou72 76
      <xref linkend="dbus"/>,
77
      <xref linkend="glib2"/> et
78
      <xref linkend="libical"/>
2201 myou72 79
    </para>
80
    <para condition="html" role="usernotes">
2214 myou72 81
      Notes utilisateur&nbsp;: <ulink url="&blfs-wiki;/bluez"/>
2201 myou72 82
    </para>
83
  </sect2>
84
  <sect2 role="kernel" id="bluez-kernel">
2204 myou72 85
    <title>Configuration du noyau</title>
2201 myou72 86
    <para>
5853 myou72 87
      Actives les options suivantes dans la configuration du noyau et recompilez le noyau si nécessaire:
2201 myou72 88
    </para>
3532 myou72 89
<screen>
6699 myou72 90
<literal>[*] Networking support ---&gt;                [CONFIG_NET]
91
  &lt;/M&gt; Bluetooth subsystem support ---&gt;    [CONFIG_BT]
92
    &lt;*/M&gt; RFCOMM protocol support          [CONFIG_BT_RFCOMM]
93
    [*]   RFCOMM TTY support               [CONFIG_BT_RFCOMM_TTY]
94
    &lt;*/M&gt; BNEP protocol support            [CONFIG_BT_BNEP]
95
    [*]   Multicast filter support         [CONFIG_BT_BNEP_MC_FILTER]
96
    [*]   Protocol filter support          [CONFIG_BT_BNEP_PROTO_FILTER]
97
    &lt;*/M&gt; HIDP protocol support            [CONFIG_BT_HIDP]
98
        Bluetooth device drivers ---&gt;
99
          (Select the appropriate drivers for your Bluetooth hardware)
100
  &lt;*/M&gt; RF switch subsystem support ---&gt;   [CONFIG_RFKILL]</literal>
3532 myou72 101
</screen>
2201 myou72 102
    <indexterm zone="bluez bluez-kernel">
103
      <primary sortas="d-bluez">bluez</primary>
104
    </indexterm>
105
  </sect2>
106
  <sect2 role="installation">
107
    <title>Installation de BlueZ</title>
5975 myou72 108
     <para>
109
      si vous voulez utiliser <application>BlueZ</application> avec
110
      gnome-bluetooth et/ou kde bluedevil, appliquez le correctif suivant:
111
    </para>
6207 myou72 112
<screen>
113
<userinput>patch -Np1 -i ../bluez-&bluez-version;-obexd_without_systemd-1.patch</userinput>
114
</screen>
2201 myou72 115
    <para>
5853 myou72 116
      Installez <application>BlueZ</application> en lançant les commandes suivantes&nbsp;:
2201 myou72 117
      commands:
118
    </para>
3532 myou72 119
<screen>
7031 myou72 120
<userinput>./configure --prefix=/usr                     --sysconfdir=/etc                 --localstatedir=/var              --enable-library                  --disable-systemd     &amp;&amp;
3532 myou72 121
make</userinput>
122
</screen>
2201 myou72 123
    <para>
6312 myou72 124
      Pour tester les résultats, tapez : <userinput>make check</userinput>.
2201 myou72 125
    </para>
126
    <para>
2214 myou72 127
      Maintenant, en tant qu'utilisateur <systemitem class="username">root</systemitem>&nbsp;:
2201 myou72 128
    </para>
3532 myou72 129
<screen role="root">
6379 myou72 130
<userinput>make install &amp;&amp;
131
ln -svf ../libexec/bluetooth/bluetoothd /usr/sbin</userinput>
3532 myou72 132
</screen>
2201 myou72 133
    <para>
7011 myou72 134
      Installez le fichier principal de configuration  en tant qu'utilisateur
3531 myou72 135
      <systemitem class="username">root</systemitem>&nbsp;:
2201 myou72 136
    </para>
3532 myou72 137
<screen role="root">
6207 myou72 138
<userinput>install -v -dm755 /etc/bluetooth &amp;&amp;
139
install -v -m644 src/main.conf /etc/bluetooth/main.conf</userinput>
3532 myou72 140
</screen>
2201 myou72 141
    <para>
2204 myou72 142
      Si vous le souhaitez, installez la documentation de l'API en tant qu'utilisateur
3531 myou72 143
      <systemitem class="username">root</systemitem>&nbsp;:
2201 myou72 144
    </para>
3532 myou72 145
<screen role="root">
6207 myou72 146
<userinput>install -v -dm755 /usr/share/doc/bluez-&bluez-version; &amp;&amp;
3532 myou72 147
install -v -m644 doc/*.txt /usr/share/doc/bluez-&bluez-version;</userinput>
148
</screen>
2201 myou72 149
  </sect2>
150
  <sect2 role="commands">
151
    <title>Explications des commandes</title>
152
    <para>
5975 myou72 153
      <parameter>--enable-library</parameter>: Ce paramètre active la construction de bibliothèques de
7011 myou72 154
      compatibilité
5975 myou72 155
      <application>BlueZ</application> 4 qui sont requises par certaines applications.
2201 myou72 156
    </para>
157
    <para>
5976 myou72 158
      <parameter>--disable-systemd</parameter>: Ce paramètre est nécéssaire car
7011 myou72 159
      <application>systemd</application>  ne fait pas partie de LFS/BLFS. si vous utilisez
5977 myou72 160
      systemd, enlevez ce paramètre.</para>
6312 myou72 161
    <para>
162
      <command>ln -svf ../libexec/bluetooth/bluetoothd /usr/sbin</command>:
163
      Cette commande donne accès au démon bluetooth de façon plus cohérente.
164
    </para>
2201 myou72 165
  </sect2>
166
  <sect2 role="configuration">
2204 myou72 167
    <title>Configuration de BlueZ</title>
2201 myou72 168
    <sect3 id="bluez-config">
2204 myou72 169
      <title>Fichiers de configuration</title>
2201 myou72 170
      <para>
5975 myou72 171
        <filename>/etc/bluetooth/main.conf</filename>
6312 myou72 172
        est installé automatiquement pendant l'installation.
173
        En supplément, il y a trois fichiers de configuration en plus.
6524 myou72 174
         /etc/sysconfig/bluetooth est installé comme une partie des scripts de démarrage.
6312 myou72 175
        De plus, vous pouvez facultativement installer la suite en tant qu'utilisateur
176
        <systemitem class="username">root</systemitem>:
2201 myou72 177
      </para>
6379 myou72 178
<screen role="root">
179
<userinput>cat > /etc/bluetooth/rfcomm.conf &lt;&lt; "EOF"</userinput>
6312 myou72 180
<literal># rfcomm.conf
181
# Set up the RFCOMM configuration of the Bluetooth subsystem in the Linux kernel.
182
# Use one line per command
183
# See the rfcomm man page for options
6379 myou72 184
# End of rfcomm.conf</literal>
6565 myou72 185
EOF
6379 myou72 186
</screen>
187
<screen role="root">
188
<userinput>cat > /etc/bluetooth/uart.conf &lt;&lt; "EOF"</userinput>
6312 myou72 189
<literal>#uart.conf
190
# Attach serial devices via UART HCI to BlueZ stack
191
# Use one line per device
192
# See the hciattach man page for options
6379 myou72 193
# End of uart.conf</literal>
6565 myou72 194
EOF
6379 myou72 195
</screen>
2201 myou72 196
      <indexterm zone="bluez bluez-config">
197
        <primary
198
        sortas="e-etc-bluetooth-main.conf">/etc/bluetooth/main.conf</primary>
199
      </indexterm>
200
    </sect3>
201
    <sect3  id="bluez-init">
5853 myou72 202
      <title>Script de démarrage</title>
2201 myou72 203
      <para>
5853 myou72 204
        Pour démarrer automatiquement le démon <command>bluetoothd</command> quand le système est redémarré,
205
        installez le script de démarrage <filename>/etc/rc.d/init.d/bluetooth</filename> depuis le paquet
2204 myou72 206
        <xref linkend="bootscripts"/>.
2201 myou72 207
      </para>
208
      <indexterm zone="bluez bluez-init">
209
        <primary sortas="f-bluetooth">bluetooth</primary>
210
      </indexterm>
3532 myou72 211
<screen role="root">
212
<userinput>make install-bluetooth</userinput>
213
</screen>
2201 myou72 214
    </sect3>
215
  </sect2>
216
  <sect2 role="content">
217
    <title>Contenu</title>
218
    <segmentedlist>
5853 myou72 219
      <segtitle>Programmes installés</segtitle>
220
      <segtitle>Bibliothèque installée</segtitle>
221
      <segtitle>Répertoires installés</segtitle>
2201 myou72 222
      <seglistitem>
223
        <seg>
6923 myou72 224
          bccmd, bluemoon, bluetoothctl, bluetoothd (lien symbolique), btmon, ciptool,
225
          hciattach, hciconfig, hcidump, hcitool, hex2hcd, l2ping,
226
          l2test, mpris-proxy, rctest, et sdptool
2201 myou72 227
        </seg>
228
        <seg>
229
          libbluetooth.so
230
        </seg>
231
        <seg>
7003 myou72 232
          /etc/bluetooth, /usr/{include,libexec}/bluetooth, et
5975 myou72 233
          /usr/share/doc/bluez-&bluez-version;
2201 myou72 234
        </seg>
235
      </seglistitem>
236
    </segmentedlist>
237
    <variablelist>
238
      <bridgehead renderas="sect3">Description courte</bridgehead>
239
      <?dbfo list-presentation="list"?>
240
      <?dbhtml list-presentation="table"?>
241
      <varlistentry id="bccmd">
242
        <term><command>bccmd</command></term>
243
        <listitem>
244
          <para>
5853 myou72 245
            est utilisé pour taper des commandes BlueCore sur les périphériques Cambridge Silicon
2204 myou72 246
            Radio.
2201 myou72 247
          </para>
248
          <indexterm zone="bluez bccmd">
249
            <primary sortas="b-bccmd">bccmd</primary>
250
          </indexterm>
251
        </listitem>
252
      </varlistentry>
6891 myou72 253
      <varlistentry id="bluemoon">
254
        <term><command>bluemoon</command></term>
255
        <listitem>
256
          <para>
257
            est un utilitaire de configuration de Bluemoon.
258
          </para>
259
          <indexterm zone="bluez bluemoon">
260
            <primary sortas="b-bluemoon">bluemoon</primary>
261
          </indexterm>
262
        </listitem>
263
      </varlistentry>
6763 myou72 264
      <varlistentry id="bluetoothctl">
265
        <term><command>bluetoothctl</command></term>
266
        <listitem>
267
          <para>
268
            est le programme de contrôle interactif de Bluetooth.
269
          </para>
270
          <indexterm zone="bluez bluetoothctl">
271
            <primary sortas="b-bluetoothctl">bluetoothctl</primary>
272
          </indexterm>
273
        </listitem>
274
      </varlistentry>
2201 myou72 275
      <varlistentry id="bluetoothd">
276
        <term><command>bluetoothd</command></term>
277
        <listitem>
278
          <para>
5853 myou72 279
            est le démon Bluetooth.
2201 myou72 280
          </para>
281
          <indexterm zone="bluez bluetoothd">
282
            <primary sortas="b-bluetoothd">bluetoothd</primary>
283
          </indexterm>
284
        </listitem>
285
      </varlistentry>
6891 myou72 286
      <varlistentry id="btmon">
287
        <term><command>btmon</command></term>
288
        <listitem>
289
          <para>
290
            fournit l'accès à l'infrastructure de surveillance de Bluetooth pour lire
291
            les traces HCI.
292
          </para>
293
          <indexterm zone="bluez btmon">
294
            <primary sortas="b-btmon">btmon</primary>
295
          </indexterm>
296
        </listitem>
297
      </varlistentry>
2201 myou72 298
      <varlistentry id="ciptool">
299
        <term><command>ciptool</command></term>
300
        <listitem>
301
          <para>
5853 myou72 302
            est utilisé pour initialiser, maintenir et inspecter la configuration de CIP des sous-système
2204 myou72 303
            Bluetooth dans le noyau Linux.
2201 myou72 304
          </para>
305
          <indexterm zone="bluez ciptool">
306
            <primary sortas="b-ciptool">ciptool</primary>
307
          </indexterm>
308
        </listitem>
309
      </varlistentry>
310
      <varlistentry id="hciattach">
311
        <term><command>hciattach</command></term>
312
        <listitem>
313
          <para>
5853 myou72 314
            est utilisé pour attacher un port série UART à la pile Bluetooth comme étant une interface
2204 myou72 315
            de transport HCI.
2201 myou72 316
          </para>
317
          <indexterm zone="bluez hciattach">
318
            <primary sortas="b-hciattach">hciattach</primary>
319
          </indexterm>
320
        </listitem>
321
      </varlistentry>
322
      <varlistentry id="hciconfig">
323
        <term><command>hciconfig</command></term>
324
        <listitem>
325
          <para>
5853 myou72 326
            est utilisé pour configurer les périphériques Bluetooth.
2201 myou72 327
          </para>
328
          <indexterm zone="bluez hciconfig">
329
            <primary sortas="b-hciconfig">hciconfig</primary>
330
          </indexterm>
331
        </listitem>
332
      </varlistentry>
6891 myou72 333
      <varlistentry id="hcidump">
334
        <term><command>hcidump</command></term>
335
        <listitem>
336
          <para>
337
            lit des données brutes HCI venant et allant à un périphérique Bluetooth
338
            et affiche à l'écran les commandes, les événements et les données dans
339
            un format lisible.
340
          </para>
341
          <indexterm zone="bluez hcidump">
342
            <primary sortas="b-hcidump">hcidump</primary>
343
          </indexterm>
344
        </listitem>
345
      </varlistentry>
2201 myou72 346
      <varlistentry id="hcitool">
347
        <term><command>hcitool</command></term>
348
        <listitem>
349
          <para>
5853 myou72 350
            est utilisé pour configurer les connexions Bluetooth et envoyer quelques commandes spéciales aux périphériques
2204 myou72 351
            Bluetooth.
2201 myou72 352
          </para>
353
          <indexterm zone="bluez hcitool">
354
            <primary sortas="b-hcitool">hcitool</primary>
355
          </indexterm>
356
        </listitem>
357
      </varlistentry>
6892 myou72 358
      <varlistentry id="hex2hcd">
359
        <term><command>hex2hcd</command></term>
360
        <listitem>
361
          <para>
362
            est utilisé pour convertir un fichier utilisé par les périphériques Broadcom
363
            au format hcd (Broadcom bluetooth firmware.
364
          </para>
365
          <indexterm zone="bluez hex2hcd">
366
            <primary sortas="b-hex2hcd">hex2hcd</primary>
367
          </indexterm>
368
        </listitem>
369
      </varlistentry>
2201 myou72 370
      <varlistentry id="l2ping">
371
        <term><command>l2ping</command></term>
372
        <listitem>
373
          <para>
5853 myou72 374
            est utilisé pour envoyer des demandes d'écho L2CAP à l'adresse MAC Bluetooth donné en notation hexadécimale.
2201 myou72 375
          </para>
376
          <indexterm zone="bluez l2ping">
377
            <primary sortas="b-l2ping">l2ping</primary>
378
          </indexterm>
379
        </listitem>
380
      </varlistentry>
6891 myou72 381
      <varlistentry id="l2test">
382
        <term><command>l2test</command></term>
383
        <listitem>
384
          <para>
385
            est le programme de tests de L2CAP.
386
         </para>
387
          <indexterm zone="bluez l2test">
388
            <primary sortas="b-l2test">l2test</primary>
389
          </indexterm>
390
        </listitem>
391
      </varlistentry>
5975 myou72 392
      <varlistentry id="rctest">
393
        <term><command>rctest</command></term>
2201 myou72 394
        <listitem>
395
          <para>
5975 myou72 396
            est utilisé pour tester les communications RFCOMM de la pile Bluetooth.
2201 myou72 397
          </para>
5975 myou72 398
          <indexterm zone="bluez rctest">
399
            <primary sortas="b-pand">rctest</primary>
2201 myou72 400
          </indexterm>
401
        </listitem>
402
      </varlistentry>
403
      <varlistentry id="rfcomm">
404
        <term><command>rfcomm</command></term>
405
        <listitem>
406
          <para>
5853 myou72 407
            est utilisé pour initialiser, maintenir et inspecter la configuration RFCOMM
408
            des sous-sytèmes Bluetooth dans le noyau Linux.
2201 myou72 409
          </para>
410
          <indexterm zone="bluez rfcomm">
411
            <primary sortas="b-rfcomm">rfcomm</primary>
412
          </indexterm>
413
        </listitem>
414
      </varlistentry>
415
      <varlistentry id="sdptool">
416
        <term><command>sdptool</command></term>
417
        <listitem>
418
          <para>
5853 myou72 419
            est utilisé pour effectuer des demandes SDP sur les périphériques Bluetooth.
2201 myou72 420
          </para>
421
          <indexterm zone="bluez sdptool">
422
            <primary sortas="b-sdptool">sdptool</primary>
423
          </indexterm>
424
        </listitem>
425
      </varlistentry>
426
      <varlistentry id="libbluetooth">
427
        <term><filename class="libraryfile">libbluetooth.so</filename></term>
428
        <listitem>
429
          <para>
5975 myou72 430
            contient les fonctions de l'API de <application>BlueZ</application> 4.
2201 myou72 431
          </para>
432
          <indexterm zone="bluez libbluetooth">
433
            <primary sortas="c-libbluetooth">libbluetooth.so</primary>
434
          </indexterm>
435
        </listitem>
436
      </varlistentry>
437
    </variablelist>
438
  </sect2>
439
</sect1>