Subversion Repositories svn LFS-FR

Rev

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

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
 <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
  <!ENTITY bluez-download-http "http://www.kernel.org/pub/linux/bluetooth/bluez-&bluez-version;.tar.xz">
  <!ENTITY bluez-download-ftp  "ftp://ftp.kernel.org/pub/linux/bluetooth/bluez-&bluez-version;.tar.xz">
  <!ENTITY bluez-md5sum        "33177e5743e24b2b3738f72be64e3ffb">
  <!ENTITY bluez-size          "1.6 Mo">
  <!ENTITY bluez-buildsize     "87 Mo (avec les tests)">
  <!ENTITY bluez-time          "0.7 SBU (avec les tests)">
]>
<sect1 id="bluez" xreflabel="bluez-&bluez-version;">
  <?dbhtml filename="bluez.html"?>
  <sect1info>
    <othername>$LastChangedBy&nbsp;: randy $</othername>
    <date>$Date&nbsp;: 2013-02-11 19:51:17 +0100 (Mon, 11 Feb 2013) $</date>
  </sect1info>
  <title>BlueZ-&bluez-version;</title>
  <indexterm zone="bluez">
    <primary sortas="a-BlueZ">BlueZ</primary>
  </indexterm>
  <sect2 role="package">
    <title>Introduction à BlueZ</title>
    <para>
      Le paquet <application>BlueZ</application> contient la pile de protocole
      Bluetooth pour Linux.
    </para>
    &lfs78_checked;
    <bridgehead renderas="sect3">Information sur le paquet </bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Téléchargement (HTTP)&nbsp;: <ulink url="&bluez-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Téléchargement (FTP)&nbsp;: <ulink url="&bluez-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Somme de contrôle MD5 du téléchargement&nbsp;: &bluez-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Taille du téléchargement&nbsp;: &bluez-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimation de l'espace disque requis&nbsp;: &bluez-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimation du temps de construction&nbsp;: &bluez-time;
        </para>
      </listitem>
    </itemizedlist>
      <bridgehead renderas="sect3">Téléchargements supplémentaires</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
             Correctif facultatif (requis pour faie fonctionner correctement gnome-bluetooth
             et/ou kde bluedevil):
            <ulink url="&patch-root;/bluez-&bluez-version;-obexd_without_systemd-1.patch"/>
          </para>
        </listitem>
      </itemizedlist>
    <bridgehead renderas="sect3">Dépendances de BlueZ</bridgehead>
    <bridgehead renderas="sect4">Requises</bridgehead>
    <para role="required">
      <xref linkend="dbus"/>,
      <xref linkend="glib2"/> et
      <xref linkend="libical"/>
    </para>
    <para condition="html" role="usernotes">
      Notes utilisateur&nbsp;: <ulink url="&blfs-wiki;/bluez"/>
    </para>
  </sect2>
  <sect2 role="kernel" id="bluez-kernel">
    <title>Configuration du noyau</title>
    <para>
      Actives les options suivantes dans la configuration du noyau et recompilez le noyau si nécessaire:
    </para>
<screen>
<literal>[*] Networking support ---&gt;                [CONFIG_NET]
  &lt;/M&gt; Bluetooth subsystem support ---&gt;    [CONFIG_BT]
    &lt;*/M&gt; RFCOMM protocol support          [CONFIG_BT_RFCOMM]
    [*]   RFCOMM TTY support               [CONFIG_BT_RFCOMM_TTY]
    &lt;*/M&gt; BNEP protocol support            [CONFIG_BT_BNEP]
    [*]   Multicast filter support         [CONFIG_BT_BNEP_MC_FILTER]
    [*]   Protocol filter support          [CONFIG_BT_BNEP_PROTO_FILTER]
    &lt;*/M&gt; HIDP protocol support            [CONFIG_BT_HIDP]
        Bluetooth device drivers ---&gt;
          (Select the appropriate drivers for your Bluetooth hardware)
  &lt;*/M&gt; RF switch subsystem support ---&gt;   [CONFIG_RFKILL]</literal>
</screen>
    <indexterm zone="bluez bluez-kernel">
      <primary sortas="d-bluez">bluez</primary>
    </indexterm>
  </sect2>
  <sect2 role="installation">
    <title>Installation de BlueZ</title>
     <para>
      si vous voulez utiliser <application>BlueZ</application> avec
      gnome-bluetooth et/ou kde bluedevil, appliquez le correctif suivant:
    </para>
<screen>
<userinput>patch -Np1 -i ../bluez-&bluez-version;-obexd_without_systemd-1.patch</userinput>
</screen>
    <para>
      Installez <application>BlueZ</application> en lançant les commandes suivantes&nbsp;:
      commands:
    </para>
<screen>
<userinput>./configure --prefix=/usr                     --sysconfdir=/etc                 --localstatedir=/var              --enable-library                  --disable-systemd     &amp;&amp;
make</userinput>
</screen>
    <para>
      Pour tester les résultats, tapez : <userinput>make check</userinput>.
    </para>
    <para>
      Maintenant, en tant qu'utilisateur <systemitem class="username">root</systemitem>&nbsp;:
    </para>
<screen role="root">
<userinput>make install &amp;&amp;
ln -svf ../libexec/bluetooth/bluetoothd /usr/sbin</userinput>
</screen>
    <para>
      Installez le fichier principal de configuration  en tant qu'utilisateur
      <systemitem class="username">root</systemitem>&nbsp;:
    </para>
<screen role="root">
<userinput>install -v -dm755 /etc/bluetooth &amp;&amp;
install -v -m644 src/main.conf /etc/bluetooth/main.conf</userinput>
</screen>
    <para>
      Si vous le souhaitez, installez la documentation de l'API en tant qu'utilisateur
      <systemitem class="username">root</systemitem>&nbsp;:
    </para>
<screen role="root">
<userinput>install -v -dm755 /usr/share/doc/bluez-&bluez-version; &amp;&amp;
install -v -m644 doc/*.txt /usr/share/doc/bluez-&bluez-version;</userinput>
</screen>
  </sect2>
  <sect2 role="commands">
    <title>Explications des commandes</title>
    <para>
      <parameter>--enable-library</parameter>: Ce paramètre active la construction de bibliothèques de
      compatibilité
      <application>BlueZ</application> 4 qui sont requises par certaines applications.
    </para>
    <para>
      <parameter>--disable-systemd</parameter>: Ce paramètre est nécéssaire car
      <application>systemd</application>  ne fait pas partie de LFS/BLFS. si vous utilisez
      systemd, enlevez ce paramètre.</para>
    <para>
      <command>ln -svf ../libexec/bluetooth/bluetoothd /usr/sbin</command>:
      Cette commande donne accès au démon bluetooth de façon plus cohérente.
    </para>
  </sect2>
  <sect2 role="configuration">
    <title>Configuration de BlueZ</title>
    <sect3 id="bluez-config">
      <title>Fichiers de configuration</title>
      <para>
        <filename>/etc/bluetooth/main.conf</filename>
        est installé automatiquement pendant l'installation.
        En supplément, il y a trois fichiers de configuration en plus.
         /etc/sysconfig/bluetooth est installé comme une partie des scripts de démarrage.
        De plus, vous pouvez facultativement installer la suite en tant qu'utilisateur
        <systemitem class="username">root</systemitem>:
      </para>
<screen role="root">
<userinput>cat > /etc/bluetooth/rfcomm.conf &lt;&lt; "EOF"</userinput>
<literal># rfcomm.conf
# Set up the RFCOMM configuration of the Bluetooth subsystem in the Linux kernel.
# Use one line per command
# See the rfcomm man page for options
# End of rfcomm.conf</literal>
EOF
</screen>
<screen role="root">
<userinput>cat > /etc/bluetooth/uart.conf &lt;&lt; "EOF"</userinput>
<literal>#uart.conf
# Attach serial devices via UART HCI to BlueZ stack
# Use one line per device
# See the hciattach man page for options
# End of uart.conf</literal>
EOF
</screen>
      <indexterm zone="bluez bluez-config">
        <primary
       sortas="e-etc-bluetooth-main.conf">/etc/bluetooth/main.conf</primary>
      </indexterm>
    </sect3>
    <sect3  id="bluez-init">
      <title>Script de démarrage</title>
      <para>
        Pour démarrer automatiquement le démon <command>bluetoothd</command> quand le système est redémarré,
        installez le script de démarrage <filename>/etc/rc.d/init.d/bluetooth</filename> depuis le paquet
        <xref linkend="bootscripts"/>.
      </para>
      <indexterm zone="bluez bluez-init">
        <primary sortas="f-bluetooth">bluetooth</primary>
      </indexterm>
<screen role="root">
<userinput>make install-bluetooth</userinput>
</screen>
    </sect3>
  </sect2>
  <sect2 role="content">
    <title>Contenu</title>
    <segmentedlist>
      <segtitle>Programmes installés</segtitle>
      <segtitle>Bibliothèque installée</segtitle>
      <segtitle>Répertoires installés</segtitle>
      <seglistitem>
        <seg>
          bccmd, bluemoon, bluetoothctl, bluetoothd (lien symbolique), btmon, ciptool,
          hciattach, hciconfig, hcidump, hcitool, hex2hcd, l2ping,
          l2test, mpris-proxy, rctest, et sdptool
        </seg>
        <seg>
          libbluetooth.so
        </seg>
        <seg>
          /etc/bluetooth, /usr/{include,libexec}/bluetooth, et
          /usr/share/doc/bluez-&bluez-version;
        </seg>
      </seglistitem>
    </segmentedlist>
    <variablelist>
      <bridgehead renderas="sect3">Description courte</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>
      <varlistentry id="bccmd">
        <term><command>bccmd</command></term>
        <listitem>
          <para>
            est utilisé pour taper des commandes BlueCore sur les périphériques Cambridge Silicon
            Radio.
          </para>
          <indexterm zone="bluez bccmd">
            <primary sortas="b-bccmd">bccmd</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="bluemoon">
        <term><command>bluemoon</command></term>
        <listitem>
          <para>
            est un utilitaire de configuration de Bluemoon.
          </para>
          <indexterm zone="bluez bluemoon">
            <primary sortas="b-bluemoon">bluemoon</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="bluetoothctl">
        <term><command>bluetoothctl</command></term>
        <listitem>
          <para>
            est le programme de contrôle interactif de Bluetooth.
          </para>
          <indexterm zone="bluez bluetoothctl">
            <primary sortas="b-bluetoothctl">bluetoothctl</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="bluetoothd">
        <term><command>bluetoothd</command></term>
        <listitem>
          <para>
            est le démon Bluetooth.
          </para>
          <indexterm zone="bluez bluetoothd">
            <primary sortas="b-bluetoothd">bluetoothd</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="btmon">
        <term><command>btmon</command></term>
        <listitem>
          <para>
            fournit l'accès à l'infrastructure de surveillance de Bluetooth pour lire
            les traces HCI.
          </para>
          <indexterm zone="bluez btmon">
            <primary sortas="b-btmon">btmon</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="ciptool">
        <term><command>ciptool</command></term>
        <listitem>
          <para>
            est utilisé pour initialiser, maintenir et inspecter la configuration de CIP des sous-système
            Bluetooth dans le noyau Linux.
          </para>
          <indexterm zone="bluez ciptool">
            <primary sortas="b-ciptool">ciptool</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="hciattach">
        <term><command>hciattach</command></term>
        <listitem>
          <para>
            est utilisé pour attacher un port série UART à la pile Bluetooth comme étant une interface
            de transport HCI.
          </para>
          <indexterm zone="bluez hciattach">
            <primary sortas="b-hciattach">hciattach</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="hciconfig">
        <term><command>hciconfig</command></term>
        <listitem>
          <para>
            est utilisé pour configurer les périphériques Bluetooth.
          </para>
          <indexterm zone="bluez hciconfig">
            <primary sortas="b-hciconfig">hciconfig</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="hcidump">
        <term><command>hcidump</command></term>
        <listitem>
          <para>
            lit des données brutes HCI venant et allant à un périphérique Bluetooth
            et affiche à l'écran les commandes, les événements et les données dans
            un format lisible.
          </para>
          <indexterm zone="bluez hcidump">
            <primary sortas="b-hcidump">hcidump</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="hcitool">
        <term><command>hcitool</command></term>
        <listitem>
          <para>
            est utilisé pour configurer les connexions Bluetooth et envoyer quelques commandes spéciales aux périphériques
            Bluetooth.
          </para>
          <indexterm zone="bluez hcitool">
            <primary sortas="b-hcitool">hcitool</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="hex2hcd">
        <term><command>hex2hcd</command></term>
        <listitem>
          <para>
            est utilisé pour convertir un fichier utilisé par les périphériques Broadcom
            au format hcd (Broadcom bluetooth firmware.
          </para>
          <indexterm zone="bluez hex2hcd">
            <primary sortas="b-hex2hcd">hex2hcd</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="l2ping">
        <term><command>l2ping</command></term>
        <listitem>
          <para>
            est utilisé pour envoyer des demandes d'écho L2CAP à l'adresse MAC Bluetooth donné en notation hexadécimale.
          </para>
          <indexterm zone="bluez l2ping">
            <primary sortas="b-l2ping">l2ping</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="l2test">
        <term><command>l2test</command></term>
        <listitem>
          <para>
            est le programme de tests de L2CAP.
         </para>
          <indexterm zone="bluez l2test">
            <primary sortas="b-l2test">l2test</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="rctest">
        <term><command>rctest</command></term>
        <listitem>
          <para>
            est utilisé pour tester les communications RFCOMM de la pile Bluetooth.
          </para>
          <indexterm zone="bluez rctest">
            <primary sortas="b-pand">rctest</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="rfcomm">
        <term><command>rfcomm</command></term>
        <listitem>
          <para>
            est utilisé pour initialiser, maintenir et inspecter la configuration RFCOMM
            des sous-sytèmes Bluetooth dans le noyau Linux.
          </para>
          <indexterm zone="bluez rfcomm">
            <primary sortas="b-rfcomm">rfcomm</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="sdptool">
        <term><command>sdptool</command></term>
        <listitem>
          <para>
            est utilisé pour effectuer des demandes SDP sur les périphériques Bluetooth.
          </para>
          <indexterm zone="bluez sdptool">
            <primary sortas="b-sdptool">sdptool</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="libbluetooth">
        <term><filename class="libraryfile">libbluetooth.so</filename></term>
        <listitem>
          <para>
            contient les fonctions de l'API de <application>BlueZ</application> 4.
          </para>
          <indexterm zone="bluez libbluetooth">
            <primary sortas="c-libbluetooth">libbluetooth.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect2>
</sect1>