Provided by: xserver-xorg-input-evdev_2.6.0-1ubuntu13_i386 bug

NAME

       evdev - Generic Linux input driver

SYNOPSIS

       Section "InputDevice"
         Identifier "devname"
         Driver "evdev"
         Option "Device"   "devpath"
         Option "Emulate3Buttons"     "True"
         Option "Emulate3Timeout"     "50"
         Option "GrabDevice"     "False"
         ...
       EndSection

DESCRIPTION

       evdev  is  an  Xorg input driver for Linux's generic event devices.  It
       therefore supports all input  devices  that  the  kernel  knows  about,
       including most mice, keyboards, tablets and touchscreens.  evdev is the
       default driver on the major Linux distributions.

       The evdev driver can serve as both  a  pointer  and  a  keyboard  input
       device.  Multiple  input devices are supported by multiple instances of
       this driver, with one InputDevice section of your  xorg.conf  for  each
       input device that will use this driver.

       It  is  recommended  that  evdev  devices  are  configured  through the
       InputClass directive (refer to xorg.conf(5))  instead  of  manual  per-
       device  configuration.  Devices  configured in the xorg.conf(5) are not
       hot-plug capable.

SUPPORTED HARDWARE

       In general, any input device that the kernel has a driver  for  can  be
       accessed  through the evdev driver.  See the Linux kernel documentation
       for a complete list.

CONFIGURATION DETAILS

       Please refer to xorg.conf(5) for general configuration details and  for
       options  that  can  be  used with all input drivers.  This section only
       covers configuration details specific to this driver.

       The following driver Options are supported:

       Option "ButtonMapping" "string"
              Sets the button mapping for this device. The mapping is a space-
              separated  list  of  button mappings that correspond in order to
              the physical buttons on the device (i.e. the first number is the
              mapping  for  button 1, etc.). The default mapping is "1 2 3 ...
              32". A mapping of 0 deactivates the button. Multiple buttons can
              have  the  same  mapping.  For example, a left-handed mouse with
              deactivated scroll-wheel would use a mapping of "3  2  1  0  0".
              Invalid  mappings  are  ignored and the default mapping is used.
              Buttons not specified in the  user's  mapping  use  the  default
              mapping.

       Option "Device" "string"
              Specifies  the  device through which the device can be accessed.
              This will generally be of the form "/dev/input/eventX", where  X
              is  some  integer.   The mapping from device node to hardware is
              system-dependent.

       Option "DragLockButtons" "L1 B2 L3 B4"
              Sets "drag lock buttons" that simulate holding a button down, so
              that  low  dexterity people do not have to hold a button down at
              the same time they move a mouse cursor. Button numbers occur  in
              pairs,  with the lock button number occurring first, followed by
              the button number  that  is  the  target  of  the  lock  button.
              Property: "Evdev Drag Lock Buttons".

       Option "DragLockButtons" "M1"
              Sets  a  "master  drag  lock  button"  that acts as a "Meta Key"
              indicating that the next button pressed is to be "drag  locked".
              Property: "Evdev Drag Lock Buttons".

       Option "Emulate3Buttons" "boolean"
              Enable/disable  the emulation of the third (middle) mouse
              button for mice which only  have  two  physical  buttons.
              The  third  button  is  emulated by pressing both buttons
              simultaneously.  Default: off.  Property:  "Evdev  Middle
              Button Emulation".

       Option "Emulate3Timeout" "integer"
              Sets  the timeout (in milliseconds) that the driver waits
              before   deciding   if   two   buttons   where    pressed
              "simultaneously"  when  3  button  emulation  is enabled.
              Default: 50. Property: "Evdev Middle Button Timeout".

       Option "EmulateWheel" "boolean"
              Enable/disable "wheel" emulation.  Wheel emulation  means
              emulating  button  press/release events when the mouse is
              moved while a specific real  button  is  pressed.   Wheel
              button  events  (typically  buttons  4 and 5) are usually
              used  for  scrolling.   Wheel  emulation  is  useful  for
              getting  wheel-like  behaviour  with  trackballs.  It can
              also be useful for mice with 4 or  more  buttons  but  no
              wheel.   See  the  description of the EmulateWheelButton,
              EmulateWheelInertia,  EmulateWheelTimeout,  XAxisMapping,
              and  YAxisMapping options.  Default: off. Property "Evdev
              Wheel Emulation".

       Option "EmulateWheelButton" "integer"
              Specifies which button must be held down to enable  wheel
              emulation  mode.   While  this button is down, X and/or Y
              pointer  movement  will  generate  button   press/release
              events as specified for the XAxisMapping and YAxisMapping
              settings. If the button is 0 and EmulateWheel is on,  any
              motion  of  the  device  is  converted into wheel events.
              Default: 4.  Property: "Evdev Wheel Emulation Button".

       Option "EmulateWheelInertia" "integer"
              Specifies how far (in pixels) the pointer  must  move  to
              generate  button  press/release events in wheel emulation
              mode.  Default:  10.  Property:  "Evdev  Wheel  Emulation
              Inertia".

       Option "EmulateWheelTimeout" "integer"
              Specifies the time in milliseconds the EmulateWheelButton
              must be pressed before wheel emulation is started. If the
              EmulateWheelButton  is  released before this timeout, the
              original button press/release event  is  sent.   Default:
              200. Property: "Evdev Wheel Emulation Timeout".

       Option "GrabDevice" "boolean"
              Force  a  grab  on the event device. Doing so will ensure
              that no other driver can initialise the same  device  and
              it  will  also  stop  the  device  from sending events to
              /dev/kbd or /dev/input/mice. Events from this device will
              not  be  sent  to  virtual  devices  (e.g.  rfkill or the
              Macintosh mouse button emulation).  Default: disabled.

       Option "InvertX" "Bool"

       Option "InvertY" "Bool"
              Invert the given axis.  Default:  off.  Property:  "Evdev
              Axis Inversion".

       Option "IgnoreRelativeAxes" "Bool"

       Option "IgnoreAbsoluteAxes" "Bool"
              Ignore  the specified type of axis. Default: unset. The X
              server cannot deal with devices that have  both  relative
              and  absolute  axes.  Evdev  tries  to guess wich axes to
              ignore given the device type and disables  absolute  axes
              for  mice and relative axes for tablets, touchscreens and
              touchpad. These options allow to forcibly disable an axis
              type.  Mouse  wheel axes are exempt and will work even if
              relative   axes   are   ignored.   No   property,    this
              configuration must be set in the configuration.
              If  either  option  is  set to False, the driver will not
              ignore the specified axes regardless of the  presence  of
              other  axes.  This  may trigger buggy behavior and events
              from  this  axis  are   always   forwarded.   Users   are
              discouraged from setting this option.

       Option "Calibration" "min-x max-x min-y max-y"
              Calibrates  the  X  and  Y  axes for devices that need to
              scale to a different coordinate system than  reported  to
              the  X  server. This feature is required for devices that
              need to scale  to  a  different  coordinate  system  than
              originally  reported  by  the kernel (e.g. touchscreens).
              The scaling to the custom coordinate system is  done  in-
              driver and the X server is unaware of the transformation.
              Property: "Evdev Axis Calibration".

       Option "Mode" "Relative"|"Absolute"
              Sets the mode of the device if device has absolute  axes.
              The  default  value  for touchpads is relative, for other
              absolute.  This option has no effect on  devices  without
              absolute axes.

       Option "SwapAxes" "Bool"
              Swap x/y axes. Default: off. Property: "Evdev Axes Swap".

       Option "XAxisMapping" "N1 N2"
              Specifies  which  buttons  are  mapped to motion in the X
              direction in wheel emulation mode.  Button number  N1  is
              mapped to the negative X axis motion and button number N2
              is mapped to the positive X  axis  motion.   Default:  no
              mapping. Property: "Evdev Wheel Emulation Axes".

       Option "YAxisMapping" "N1 N2"
              Specifies  which  buttons  are  mapped to motion in the Y
              direction in wheel emulation mode.  Button number  N1  is
              mapped to the negative Y axis motion and button number N2
              is mapped to the positive Y axis motion.  Default: "4 5".
              Property: "Evdev Wheel Emulation Axes".

SUPPORTED PROPERTIES

       The following properties are provided by the evdev driver.

       Evdev Axis Calibration
              4  32-bit  values,  order min-x, max-x, min-y, max-y or 0
              values to disable in-driver axis calibration.

       Evdev Axis Inversion
              2 boolean values (8 bit, 0 or 1), order X, Y.  1  inverts
              the axis.

       Evdev Axes Swap
              1 boolean value (8 bit, 0 or 1). 1 swaps x/y axes.

       Evdev Drag Lock Buttons
              8-bit.  Either  1  value  or pairs of values. Value range
              0-32, 0 disables a value.

       Evdev Middle Button Emulation
              1 boolean value (8 bit, 0 or 1).

       Evdev Middle Button Timeout
              1 16-bit positive value.

       Evdev Wheel Emulation
              1 boolean value (8 bit, 0 or 1).

       Evdev Wheel Emulation Axes
              4 8-bit values, order X up, X  down,  Y  up,  Y  down.  0
              disables a value.

       Evdev Wheel Emulation Button
              1 8-bit value, allowed range 0-32, 0 disables the button.

       Evdev Wheel Emulation Inertia
              1 16-bit positive value.

       Evdev Wheel Emulation Timeout
              1 16-bit positive value.

AUTHORS

       Kristian Hogsberg, Peter Hutterer

SEE ALSO

       Xorg(1), xorg.conf(5), Xserver(1), X(7)