source: x/installing/x7driver-wacom.xml@ 1f355410

<?xml version="1.0" encoding="ISO-8859-1"?>
<!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 xorg-wacom-driver-version "0.40.0">

  <!ENTITY xorg-wacom-driver-download-http "https://github.com/linuxwacom/xf86-input-wacom/releases/download/xf86-input-wacom-&xorg-wacom-driver-version;/xf86-input-wacom-&xorg-wacom-driver-version;.tar.bz2">
  <!ENTITY xorg-wacom-driver-download-ftp  " ">
  <!ENTITY xorg-wacom-driver-md5sum        "e97a5230d1875d288010b3df1b332ed5">
  <!ENTITY xorg-wacom-driver-size          "616 KB">
  <!ENTITY xorg-wacom-driver-buildsize     "12 MB (with tests)">
  <!ENTITY xorg-wacom-driver-time          "0.1 SBU (with tests)">
]>

  <!-- Begin Xorg Wacom Driver -->
  <sect2 id="xorg-wacom-driver" xreflabel="Xorg Wacom Driver-&xorg-wacom-driver-version;">

  <sect2info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect2info>

    <title>Xorg Wacom Driver-&xorg-wacom-driver-version;</title>

    <indexterm zone="xorg-wacom-driver">
      <primary sortas="a-xorg-wacom-driver">xorg-wacom-driver</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Xorg Wacom Driver</title>

      <para>
        The <application>Xorg Wacom Driver</application> package contains the
        X.Org X11 driver and SDK for Wacom and Wacom-like tablets. It is not
        required to use a Wacom tablet, the
        <application>xf86-input-evdev</application> driver can handle these
        devices without problems.
      </para>

      &lfs10_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&xorg-wacom-driver-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&xorg-wacom-driver-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &xorg-wacom-driver-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &xorg-wacom-driver-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &xorg-wacom-driver-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &xorg-wacom-driver-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">Xorg Wacom Drivers Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="xorg-server"/>
      </para>

      <bridgehead renderas="sect5">Optional</bridgehead>
      <para role="optional">
        <xref linkend="doxygen"/> and
        <xref linkend="graphviz"/>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/xorg-wacom-driver"/>
      </para>
    </sect3>

    <sect3 role="kernel" id="xorg-wacom-driver-kernel">
      <title>Kernel Configuration</title>

      <para>
        To use a Wacom tablet with USB interface, enable the following
        options in your kernel configuration and recompile. Note that
        other configuration options could be required for tablet with a
        serial or bluetooth interface:
      </para>

<screen><literal>Device Drivers  ---&gt;
  HID support  ---&gt;
    -*- HID bus support                                      [CONFIG_HID]
         Special HID drivers ---&gt;
              &lt;*/M&gt; Wacom Intuos/Graphire tablet support (USB) [CONFIG_HID_WACOM]</literal></screen>

      <indexterm zone="xorg-wacom-driver xorg-wacom-driver-kernel">
        <primary sortas="d-xorg-wacom-driver">xorg-wacom-driver</primary>
      </indexterm>
    </sect3>

    <sect3 role="installation">
      <title>Installation of Xorg Wacom Driver</title>

<!-- Fixed in 0.40.0
      <para>
        First, adapt the <application>Xorg Wacom Driver</application> to
        changes in udev:
      </para>

<screen><userinput remap="pre">sed -i 's/ACTION!="add|change"/ACTION=="remove"/' conf/wacom.rules</userinput></screen>
-->
      <para>
        Install <application>Xorg Wacom Driver</application> by running the following
        commands:
      </para>

<screen revision="sysv"><userinput>./configure $XORG_CONFIG --with-systemd-unit-dir=no \
            --with-udev-rules-dir=/lib/udev/rules.d &amp;&amp;
make</userinput></screen>

<screen revision="systemd"><userinput>./configure $XORG_CONFIG \
            --with-udev-rules-dir=/lib/udev/rules.d \
            --with-systemd-unit-dir=/lib/systemd/system &amp;&amp;
make</userinput></screen>

      <para>
        To test the results, issue: <command>make check</command>.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>make install</userinput></screen>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Programs</segtitle>
        <segtitle>Installed Xorg Driver</segtitle>

        <seglistitem>
          <seg>
            isdv4-serial-debugger, isdv4-serial-inputattach, and xsetwacom
          </seg>
          <seg>
            wacom_drv.so
          </seg>
        </seglistitem>
      </segmentedlist>

      <variablelist>
        <bridgehead renderas="sect4">Short Descriptions</bridgehead>
        <?dbfo list-presentation="list"?>
        <?dbhtml list-presentation="table"?>

        <varlistentry id="xsetwacom">
          <term><command>xsetwacom</command></term>
          <listitem>
            <para>
              is a commandline utility used to query
              and modify wacom driver settings.
            </para>
            <indexterm zone="xorg-wacom-driver xsetwacom">
              <primary sortas="b-xsetwacom">xsetwacom</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="wacom_drv">
          <term><filename class="libraryfile">wacom_drv.so</filename></term>
          <listitem>
            <para>
              is an Xorg input driver for Wacom devices.
            </para>
            <indexterm zone="xorg-wacom-driver wacom_drv">
              <primary sortas="c-wacom_drv">wacom_drv.so</primary>
            </indexterm>
          </listitem>
        </varlistentry>

      </variablelist>

    </sect3>

  </sect2>
  <!-- End Xorg Wacom Driver -->