1152 lines
43 KiB
HTML
1152 lines
43 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of SYNAPTICS</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>SYNAPTICS</H1>
|
|
Section: Devices and Network Interfaces (4)<BR>Updated: xf86-input-synaptics 1.9.1<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
synaptics - touchpad input driver
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<PRE>
|
|
<B>Section "InputDevice"</B>
|
|
<B> Identifier "</B><I>devname</I><B>"</B>
|
|
<B> Driver "synaptics"</B>
|
|
<B> Option "Device" "</B><I>devpath</I><B>"</B>
|
|
<B> Option "Path" "</B><I>path</I><B>"</B>
|
|
...
|
|
<B>EndSection</B>
|
|
</PRE>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>synaptics</B>
|
|
|
|
is an Xorg input driver for touchpads.
|
|
Even though touchpads can be handled by the normal evdev or mouse drivers,
|
|
this driver allows more advanced features of the
|
|
touchpad to become available. Some benefits would be:
|
|
<DL COMPACT>
|
|
<DT id="1">•<DD>
|
|
Movement with adjustable, non-linear acceleration and speed.
|
|
<DT id="2">•<DD>
|
|
Button events through short touching of the touchpad.
|
|
<DT id="3">•<DD>
|
|
Double-Button events through double short touching of the touchpad.
|
|
<DT id="4">•<DD>
|
|
Dragging through short touching and holding down the finger on the
|
|
touchpad (tap-and-drag gesture).
|
|
<DT id="5">•<DD>
|
|
Middle and right button events on the upper and lower corner of the
|
|
touchpad.
|
|
<DT id="6">•<DD>
|
|
Vertical scrolling (button four and five events) through moving the
|
|
finger on the right side of the touchpad.
|
|
<DT id="7">•<DD>
|
|
The up/down button sends button four/five events.
|
|
<DT id="8">•<DD>
|
|
Horizontal scrolling (button six and seven events) through moving the
|
|
finger on the lower side of the touchpad.
|
|
<DT id="9">•<DD>
|
|
The multi-buttons send button four/five events for vertical scrolling
|
|
and button six/seven events for horizontal scrolling.
|
|
<DT id="10">•<DD>
|
|
Adjustable finger detection.
|
|
<DT id="11">•<DD>
|
|
Multifinger taps: two finger for right button and three finger for
|
|
middle button events.
|
|
(Needs hardware support.
|
|
Not all models implement this feature.)
|
|
<DT id="12">•<DD>
|
|
Pressure-dependent motion speed.
|
|
</DL>
|
|
<P>
|
|
|
|
Note that depending on the touchpad firmware, some of these features
|
|
might be available even without using the synaptics driver. Note also
|
|
that some functions are not available on all touchpad models, because
|
|
they need support from the touchpad hardware/firmware. (Multifinger
|
|
taps for example.)
|
|
<P>
|
|
|
|
The name "synaptics" is historical and the driver still provides the
|
|
synaptics protocol parsing code. Under Linux however, the hardware-specifics
|
|
are handled by the kernel and this driver will work for any touchpad that
|
|
has a working kernel driver. If your device is recognized as "PS/2
|
|
Mouse" or similar, the kernel driver does not support your device and this
|
|
driver will only provide limited functionality.
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CONFIGURATION OPTIONS</H2>
|
|
|
|
Please refer to <A HREF="/cgi-bin/man/man2html?5+xorg.conf">xorg.conf</A>(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.
|
|
<P>
|
|
|
|
The following driver
|
|
<B>Options</B>
|
|
|
|
are supported:
|
|
<DL COMPACT>
|
|
<DT id="13"><B>Option "Device" "</B><I>string</I><B>"</B>
|
|
|
|
<DD>
|
|
This option specifies the device file in your "/dev" directory which will
|
|
be used to access the physical device. Normally you should use something like
|
|
"/dev/input/eventX", where X is some integer.
|
|
<DT id="14"><B>Option "Protocol" "</B><I>string</I><B>"</B>
|
|
|
|
<DD>
|
|
Specifies which kernel driver will be used by this driver. This is the list of
|
|
supported drivers and their default use scenarios.
|
|
<TABLE>
|
|
<TR VALIGN=top><TD>auto-dev</TD><TD>automatic, default (recommend)<BR></TD></TR>
|
|
<TR VALIGN=top><TD>event</TD><TD>Linux 2.6 kernel events<BR></TD></TR>
|
|
<TR VALIGN=top><TD>psaux</TD><TD>raw device access (Linux 2.4)<BR></TD></TR>
|
|
<TR VALIGN=top><TD>psm</TD><TD>FreeBSD psm driver<BR></TD></TR>
|
|
</TABLE>
|
|
|
|
<DT id="15"><B>Option "LeftEdge" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
X coordinate for left edge. Property: "Synaptics Edges"
|
|
<DT id="16"><B>Option "RightEdge" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
X coordinate for right edge. Property: "Synaptics Edges"
|
|
<DT id="17"><B>Option "TopEdge" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Y coordinate for top edge. Property: "Synaptics Edges"
|
|
<DT id="18"><B>Option "BottomEdge" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Y coordinate for bottom edge. Property: "Synaptics Edges"
|
|
<DT id="19"><B>Option "FingerLow" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
When finger pressure drops below this value, the driver counts it as a
|
|
release. Property: "Synaptics Finger"
|
|
<DT id="20"><B>Option "FingerHigh" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
When finger pressure goes above this value, the driver counts it as a
|
|
touch. Property: "Synaptics Finger"
|
|
<DT id="21"><B>Option "MaxTapTime" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Maximum time (in milliseconds) for detecting a tap. Property: "Synaptics Tap
|
|
Durations"
|
|
<DT id="22"><B>Option "MaxTapMove" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Maximum movement of the finger for detecting a tap. Property: "Synaptics Tap
|
|
Move"
|
|
<DT id="23"><B>Option "MaxDoubleTapTime" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Maximum time (in milliseconds) for detecting a double tap. Property:
|
|
"Synaptics Tap Durations"
|
|
<DT id="24"><B>Option "ClickTime" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
The duration of the mouse click generated by tapping. Property: "Synaptics Tap
|
|
Durations"
|
|
<DT id="25"><B>Option "ClickPad" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
Whether the device is a click pad. See
|
|
<B>ClickPad support</B>
|
|
|
|
for more details. Property: "Synaptics ClickPad"
|
|
<DT id="26"><B>Option "VertEdgeScroll" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
Enable vertical scrolling when dragging along the right edge. Property:
|
|
"Synaptics Edge Scrolling"
|
|
<DT id="27"><B>Option "HorizEdgeScroll" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
Enable horizontal scrolling when dragging along the bottom edge. Property:
|
|
"Synaptics Edge Scrolling"
|
|
<DT id="28"><B>Option "CornerCoasting" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
Enable edge scrolling to continue while the finger stays in an edge corner.
|
|
Property: "Synaptics Edge Scrolling"
|
|
<DT id="29"><B>Option "VertTwoFingerScroll" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
Enable vertical scrolling when dragging with two fingers anywhere on
|
|
the touchpad. Property: "Synaptics Two-Finger Scrolling"
|
|
<DT id="30"><B>Option "HorizTwoFingerScroll" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
Enable horizontal scrolling when dragging with two fingers anywhere on
|
|
the touchpad. Property: "Synaptics Two-Finger Scrolling"
|
|
<DT id="31"><B>Option "VertScrollDelta" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Move distance of the finger for a scroll event. Property: "Synaptics Scrolling
|
|
Distance"
|
|
<DT id="32"><B>Option "HorizScrollDelta" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Move distance of the finger for a scroll event. Property: "Synaptics Scrolling
|
|
Distance"
|
|
<DT id="33"><B>Option "MinSpeed" "</B><I>float</I><B>"</B>
|
|
|
|
<DD>
|
|
Minimum speed factor. Property: "Synaptics Move Speed"
|
|
<DT id="34"><B>Option "MaxSpeed" "</B><I>float</I><B>"</B>
|
|
|
|
<DD>
|
|
Maximum speed factor. Property: "Synaptics Move Speed"
|
|
<DT id="35"><B>Option "AccelFactor" "</B><I>float</I><B>"</B>
|
|
|
|
<DD>
|
|
Acceleration factor for normal pointer movements. Property: "Synaptics Move
|
|
Speed"
|
|
<DT id="36"><B>Option "PressureMotionMinZ" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Finger pressure at which minimum pressure motion factor is applied. Property:
|
|
"Synaptics Pressure Motion"
|
|
<DT id="37"><B>Option "PressureMotionMaxZ" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Finger pressure at which maximum pressure motion factor is applied. Property:
|
|
"Synaptics Pressure Motion"
|
|
<DT id="38"><B>Option "PressureMotionMinFactor" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Lowest setting for pressure motion factor. Property: "Synaptics Pressure
|
|
Motion Factor"
|
|
<DT id="39"><B>Option "PressureMotionMaxFactor" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Greatest setting for pressure motion factor. Property: "Synaptics Pressure
|
|
Motion Factor"
|
|
<DT id="40"><B>Option "HorizHysteresis" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
The minimum horizontal HW distance required to generate motion events. Can be
|
|
specified as a percentage. Increase if noise motion is a problem for you. Zero
|
|
is disabled.
|
|
Default: 0.5 percent of the diagonal or (in case of evdev) the appropriate
|
|
"fuzz" as advertised by the device.
|
|
<DT id="41"><B>Option "VertHysteresis" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
The minimum vertical HW distance required to generate motion events. See
|
|
<B>HorizHysteresis</B>.
|
|
<DT id="42"><B>Option "UpDownScrolling" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
If on, the up/down buttons generate button 4/5 events.
|
|
If off, the up button generates a double click and the down button
|
|
generates a button 2 event. This option is only available for touchpads with
|
|
physical scroll buttons.
|
|
Property: "Synaptics Button Scrolling"
|
|
<DT id="43"><B>Option "LeftRightScrolling" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
If on, the left/right buttons generate button 6/7 events.
|
|
If off, the left/right buttons both generate button 2 events.
|
|
This option is only available for touchpads with physical scroll buttons.
|
|
Property: "Synaptics Button Scrolling"
|
|
<DT id="44"><B>Option "UpDownScrollRepeat" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
If on, and the up/down buttons are used for scrolling
|
|
(<B>UpDownScrolling</B>), these buttons will send auto-repeating 4/5 events,
|
|
with the delay between repeats determined by <B>ScrollButtonRepeat</B>.
|
|
This option is only available for touchpads with physical scroll buttons.
|
|
Property: "Synaptics Button Scrolling Repeat"
|
|
<DT id="45"><B>Option "LeftRightScrollRepeat" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
If on, and the left/right buttons are used for scrolling
|
|
(<B>LeftRightScrolling</B>), these buttons will send auto-repeating 6/7 events,
|
|
with the delay between repeats determined by <B>ScrollButtonRepeat</B>.
|
|
This option is only available for touchpads with physical scroll buttons.
|
|
Property: "Synaptics Button Scrolling Repeat"
|
|
<DT id="46"><B>Option "ScrollButtonRepeat" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
The number of milliseconds between repeats of button events 4-7 from the
|
|
up/down/left/right scroll buttons.
|
|
This option is only available for touchpads with physical scroll buttons.
|
|
Property: "Synaptics Button Scrolling Time"
|
|
<DT id="47"><B>Option "EmulateMidButtonTime" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Maximum time (in milliseconds) for middle button emulation. Property:
|
|
"Synaptics Middle Button Timeout"
|
|
<DT id="48"><B>Option "EmulateTwoFingerMinZ" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
For touchpads not capable of detecting multiple fingers but are capable
|
|
of detecting finger pressure and width, this sets the
|
|
Z pressure threshold. When both Z pressure and W width thresholds
|
|
are crossed, a two finger press will be emulated. This defaults
|
|
to a value that disables emulation on touchpads with real two-finger detection
|
|
and defaults to a value that enables emulation on remaining touchpads that
|
|
support pressure and width support.
|
|
Property: "Synaptics Two-Finger Pressure"
|
|
<DT id="49"><B>Option "EmulateTwoFingerMinW" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
For touchpads not capable of detecting multiple fingers but are
|
|
capable of detecting finger width and pressure, this sets the
|
|
W width threshold. When both W width and Z pressure thresholds
|
|
are crossed, a two finger press will be emulated. This feature works best
|
|
with (<B>PalmDetect</B>) off. Property: "Synaptics Two-Finger Width"
|
|
<DT id="50"><B>Option "TouchpadOff" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Switch off the touchpad.
|
|
Valid values are:
|
|
<TABLE>
|
|
<TR VALIGN=top><TD>0</TD><TD>Touchpad is enabled<BR></TD></TR>
|
|
<TR VALIGN=top><TD>1</TD><TD>Touchpad is switched off (physical clicks still work)<BR></TD></TR>
|
|
<TR VALIGN=top><TD>2</TD><TD>Only tapping and scrolling is switched off<BR></TD></TR>
|
|
</TABLE>
|
|
|
|
When the touchpad is switched off, button events caused by a physical
|
|
button press are still interpreted. On a ClickPad, this includes
|
|
software-emulated middle and right buttons as defined by
|
|
the SoftButtonAreas setting.
|
|
<DT id="51">Property: "Synaptics Off"<DD>
|
|
<DT id="52"><B>Option "LockedDrags" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
If off, a tap-and-drag gesture ends when you release the finger.
|
|
If on, the gesture is active until you tap a second time, or until
|
|
LockedDragTimeout expires. Property: "Synaptics Locked Drags"
|
|
<DT id="53"><B>Option "LockedDragTimeout" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
This parameter specifies how long it takes (in milliseconds) for the
|
|
LockedDrags mode to be automatically turned off after the finger is
|
|
released from the touchpad. Property: "Synaptics Locked Drags Timeout"
|
|
<DT id="54"><B>Option "RTCornerButton" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Which mouse button is reported on a right top corner tap.
|
|
Set to 0 to disable. Property: "Synaptics Tap Action"
|
|
<DT id="55"><B>Option "RBCornerButton" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Which mouse button is reported on a right bottom corner tap.
|
|
Set to 0 to disable. Property: "Synaptics Tap Action"
|
|
<DT id="56"><B>Option "LTCornerButton" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Which mouse button is reported on a left top corner tap.
|
|
Set to 0 to disable. Property: "Synaptics Tap Action"
|
|
<DT id="57"><B>Option "LBCornerButton" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Which mouse button is reported on a left bottom corner tap.
|
|
Set to 0 to disable. Property: "Synaptics Tap Action"
|
|
<DT id="58"><B>Option "TapButton1" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Which mouse button is reported on a non-corner one-finger tap.
|
|
Set to 0 to disable. Property: "Synaptics Tap Action"
|
|
<DT id="59"><B>Option "TapButton2" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Which mouse button is reported on a non-corner two-finger tap.
|
|
Set to 0 to disable. Property: "Synaptics Tap Action"
|
|
<DT id="60"><B>Option "TapButton3" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Which mouse button is reported on a non-corner three-finger tap.
|
|
Set to 0 to disable. Property: "Synaptics Tap Action"
|
|
<DT id="61"><B>Option "ClickFinger1" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Which mouse button is reported when left-clicking with one finger.
|
|
Set to 0 to disable. Property: "Synaptics Click Action"
|
|
<DT id="62"><B>Option "ClickFinger2" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Which mouse button is reported when left-clicking with two fingers.
|
|
Set to 0 to disable. Property: "Synaptics Click Action"
|
|
<DT id="63"><B>Option "ClickFinger3" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Which mouse button is reported when left-clicking with three fingers.
|
|
Set to 0 to disable. Property: "Synaptics Click Action"
|
|
<DT id="64"><B>Option "CircularScrolling" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
If on, circular scrolling is used. Property: "Synaptics Circular Scrolling"
|
|
<DT id="65"><B>Option "CircScrollDelta" "</B><I>float</I><B>"</B>
|
|
|
|
<DD>
|
|
Move angle (radians) of finger to generate a scroll event. Property: "Synaptics
|
|
Circular Scrolling Distance"
|
|
<DT id="66"><B>Option "CircScrollTrigger" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Trigger region on the touchpad to start circular scrolling
|
|
<TABLE>
|
|
<TR VALIGN=top><TD>0</TD><TD>All Edges<BR></TD></TR>
|
|
<TR VALIGN=top><TD>1</TD><TD>Top Edge<BR></TD></TR>
|
|
<TR VALIGN=top><TD>2</TD><TD>Top Right Corner<BR></TD></TR>
|
|
<TR VALIGN=top><TD>3</TD><TD>Right Edge<BR></TD></TR>
|
|
<TR VALIGN=top><TD>4</TD><TD>Bottom Right Corner<BR></TD></TR>
|
|
<TR VALIGN=top><TD>5</TD><TD>Bottom Edge<BR></TD></TR>
|
|
<TR VALIGN=top><TD>6</TD><TD>Bottom Left Corner<BR></TD></TR>
|
|
<TR VALIGN=top><TD>7</TD><TD>Left Edge<BR></TD></TR>
|
|
<TR VALIGN=top><TD>8</TD><TD>Top Left Corner<BR></TD></TR>
|
|
</TABLE>
|
|
|
|
Property: "Synaptics Circular Scrolling Trigger"
|
|
<DT id="67"><B>Option "CircularPad" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
Instead of being a rectangle, the edge is the ellipse enclosed by the
|
|
Left/Right/Top/BottomEdge parameters.
|
|
For circular touchpads. Property: "Synaptics Circular Pad"
|
|
<DT id="68"><B>Option "PalmDetect" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
If palm detection should be enabled.
|
|
Note that this also requires hardware/firmware support from the
|
|
touchpad. Property: "Synaptics Palm Detection"
|
|
<DT id="69"><B>Option "PalmMinWidth" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Minimum finger width at which touch is considered a palm. Property: "Synaptics
|
|
Palm Dimensions"
|
|
<DT id="70"><B>Option "PalmMinZ" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Minimum finger pressure at which touch is considered a palm. Property:
|
|
"Synaptics Palm Dimensions"
|
|
<DT id="71"><B>Option "CoastingSpeed" "</B><I>float</I><B>"</B>
|
|
|
|
<DD>
|
|
Your finger needs to produce this many scrolls per second in order to start
|
|
coasting. The default is 20 which should prevent you from starting coasting
|
|
unintentionally.
|
|
0 disables coasting. Property: "Synaptics Coasting Speed"
|
|
<DT id="72"><B>Option "CoastingFriction" "</B><I>float</I><B>"</B>
|
|
|
|
<DD>
|
|
Number of scrolls/second² to decrease the coasting speed. Default
|
|
is 50.
|
|
Property: "Synaptics Coasting Speed"
|
|
<DT id="73"><B>Option "SingleTapTimeout" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Timeout after a tap to recognize it as a single tap. Property: "Synaptics Tap
|
|
Durations"
|
|
<DT id="74"><B>Option "GrabEventDevice" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
If GrabEventDevice is true, the driver will grab the event device for
|
|
exclusive use when using the linux 2.6 event protocol.
|
|
When using other protocols, this option has no effect.
|
|
Grabbing the event device means that no other user space or kernel
|
|
space program sees the touchpad events.
|
|
This is desirable if the X config file includes /dev/input/mice as an
|
|
input device, but is undesirable if you want to monitor the device
|
|
from user space.
|
|
When changing this parameter with the synclient program, the change
|
|
will not take effect until the synaptics driver is disabled and
|
|
reenabled.
|
|
This can be achieved by switching to a text console and then switching
|
|
back to X.
|
|
<DT id="75"><B>Option "TapAndDragGesture" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
Switch on/off the tap-and-drag gesture.
|
|
This gesture is an alternative way of dragging.
|
|
It is performed by tapping (touching and releasing the finger), then
|
|
touching again and moving the finger on the touchpad.
|
|
The gesture is enabled by default and can be disabled by setting the
|
|
TapAndDragGesture option to false. Property: "Synaptics Gestures"
|
|
<DT id="76"><B>Option ®esolutionDetect" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
Allow or prevent the synaptics driver from reporting the size of the
|
|
touchpad to the X server. The X server normally uses this information
|
|
to scale movements so that touchpad movement corresponds visually to
|
|
mouse cursor movements on the screen. However, in some rare cases where
|
|
the touchpad height/width ratio is significantly different from the
|
|
laptop, it can cause the mouse cursor to skip pixels in the X or Y axis.
|
|
This option allows disabling this scaling behavior, which can provide
|
|
smoother mouse movement in such cases.
|
|
Property: "Synaptics Resolution Detect"
|
|
<DT id="77"><B>Option "VertResolution" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Resolution of X coordinates in units/millimeter. The value is used
|
|
together with HorizResolution to compensate unequal vertical and
|
|
horizontal sensitivity. Setting VertResolution and HorizResolution
|
|
equal values means no compensation. Default value is read from
|
|
the touchpad or set to 1 if value could not be read.
|
|
Property: "Synaptics Pad Resolution"
|
|
<DT id="78"><B>Option "HorizResolution" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Resolution of Y coordinates in units/millimeter. The value is used
|
|
together with VertResolution to compensate unequal vertical and
|
|
horizontal sensitivity. Setting VertResolution and HorizResolution
|
|
equal values means no compensation. Default value is read from
|
|
the touchpad or set to 1 if value could not be read.
|
|
Property: "Synaptics Pad Resolution"
|
|
<DT id="79"><B>Option "AreaLeftEdge" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Ignore movements, scrolling and tapping which start left of this edge.
|
|
The option is disabled by default and can be enabled by setting the
|
|
AreaLeftEdge option to any integer value other than zero. If supported by the
|
|
server (version 1.9 and later), the edge may be specified in percent of
|
|
the total width of the touchpad. Property: "Synaptics Area"
|
|
<DT id="80"><B>Option "AreaRightEdge" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Ignore movements, scrolling and tapping which start right of this edge.
|
|
The option is disabled by default and can be enabled by setting the
|
|
AreaRightEdge option to any integer value other than zero. If supported by the
|
|
server (version 1.9 and later), the edge may be specified in percent of
|
|
the total width of the touchpad. Property: "Synaptics Area"
|
|
<DT id="81"><B>Option "AreaTopEdge" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Ignore movements, scrolling and tapping which start above this edge.
|
|
The option is disabled by default and can be enabled by setting the
|
|
AreaTopEdge option to any integer value other than zero. If supported by the
|
|
server (version 1.9 and later), the edge may be specified in percent of
|
|
the total height of the touchpad. Property: "Synaptics Area"
|
|
<DT id="82"><B>Option "AreaBottomEdge" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
Ignore movements, scrolling and tapping which start below this edge.
|
|
The option is disabled by default and can be enabled by setting the
|
|
AreaBottomEdge option to any integer value other than zero. If supported by the
|
|
server (version 1.9 and later), the edge may be specified in percent of
|
|
the total height of the touchpad. Property: "Synaptics Area"
|
|
<DT id="83"><B>Option "SoftButtonAreas" "</B><I>RBL RBR RBT RBB MBL MBR MBT MBB</I><B>"</B>
|
|
|
|
<DD>
|
|
This option is only available on ClickPad devices.
|
|
Enable soft button click area support on ClickPad devices.
|
|
The first four parameters are the left, right, top, bottom edge of the right
|
|
button, respectively, the second four parameters are the left, right, top,
|
|
bottom edge of the middle button, respectively. Any of the values may be
|
|
given as percentage of the touchpad width or height, whichever applies.
|
|
If any edge is set to 0 (not 0%), the button is assumed to extend to
|
|
infinity in the given direction. Setting all values to 0 (not 0%) disables
|
|
soft button areas. Button areas may not overlap, however it is permitted for two
|
|
buttons to share an edge value.
|
|
Property: "Synaptics Soft Button Areas"
|
|
<DT id="84"><B>Option "HasSecondarySoftButtons" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
This option is only available on ClickPad devices.
|
|
Enable the secondary software button area support. The exact area must be
|
|
set in option "SecondarySoftButtonAreas". See
|
|
<B>ClickPad support</B>
|
|
|
|
for more details.
|
|
<DT id="85"><B>Option "SecondarySoftButtonAreas" "</B><I>RBL RBR RBT RBB MBL MBR MBT MBB</I><B>"</B>
|
|
|
|
<DD>
|
|
This option is only available on ClickPad devices and only if
|
|
<B>Option "HasSecondarySoftButtons"</B>
|
|
|
|
is enabled.
|
|
Define the secondary soft button click areas on ClickPad devices (usually on
|
|
top of the device).
|
|
For the allowed values for this option, see
|
|
<B>Option "SoftButtonAreas".</B>
|
|
|
|
Primary and secondary soft button areas must not overlap each other. If they do,
|
|
the behavior of the driver is undefined.
|
|
Property: "Synaptics Secondary Soft Button Areas". This property is only
|
|
initialized if
|
|
<B>Option "HasSecondarySoftButtons" </B>
|
|
|
|
is enabled and this option is set in the <A HREF="/cgi-bin/man/man2html?5+xorg.conf">xorg.conf</A>(5).
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>CONFIGURATION DETAILS</H2>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H3>Area handling</H3>
|
|
|
|
The LeftEdge, RightEdge, TopEdge and BottomEdge parameters are used to
|
|
define the edge and corner areas of the touchpad.
|
|
The parameters split the touchpad area in 9 pieces, like this:
|
|
<P>
|
|
|
|
<TABLE>
|
|
<TR VALIGN=top><TD></TD><TD>LeftEdge</TD><TD COLSPAN=2>RightEdge</TD><TD></TD></TR>
|
|
<TR VALIGN=top><TD></TD></TR>
|
|
<TR VALIGN=top><TD ALIGN=center>1</TD><TD ALIGN=center>2</TD><TD ALIGN=center>3</TD><TD></TD></TR>
|
|
<TR VALIGN=top><TD></TD></TR>
|
|
<TR VALIGN=top><TD ALIGN=center></TD><TD ALIGN=center></TD><TD ALIGN=center></TD><TD></TD></TR>
|
|
<TR VALIGN=top><TD ALIGN=center>4</TD><TD ALIGN=center>5</TD><TD ALIGN=center>6</TD><TD></TD></TR>
|
|
<TR VALIGN=top><TD ALIGN=center></TD><TD ALIGN=center></TD><TD ALIGN=center></TD><TD></TD></TR>
|
|
<TR VALIGN=top><TD></TD></TR>
|
|
<TR VALIGN=top><TD ALIGN=center>7</TD><TD ALIGN=center>8</TD><TD ALIGN=center>9</TD><TD></TD></TR>
|
|
<TR VALIGN=top><TD></TD></TR>
|
|
<TR VALIGN=top><TD COLSPAN=2>Physical left edge</TD><TD></TD><TD>Physical right edge</TD><TD></TD></TR>
|
|
</TABLE>
|
|
|
|
<P>
|
|
|
|
Coordinates to the left of LeftEdge are part of the left edge (areas
|
|
1, 4 and 7), coordinates to the left of LeftEdge and above TopEdge
|
|
(area 1) are part of the upper left corner, etc.
|
|
<P>
|
|
|
|
A good way to find appropriate edge parameters is to use <A HREF="/cgi-bin/man/man2html?1+evtest">evtest</A>(1) on the
|
|
device to see the x/y coordinates corresponding to different positions on
|
|
the touchpad.
|
|
<P>
|
|
|
|
The perceived physical edges may be adjusted with the AreaLeftEdge,
|
|
AreaRightEdge, AreaTopEdge, and AreaBottomEdge options. If these values are
|
|
set to something other than the physical edges, input that starts in the
|
|
space between the area edge and the respective physical edge is ignored.
|
|
Note that this reduces the available space on the touchpad to start motions
|
|
in.
|
|
<A NAME="lbAH"> </A>
|
|
<H3>Tapping</H3>
|
|
|
|
A tap event happens when the finger is touched and released in a time
|
|
interval shorter than MaxTapTime, and the touch and release
|
|
coordinates are less than MaxTapMove units apart.
|
|
A "touch" event happens when the Z value goes above FingerHigh, and an
|
|
"untouch" event happens when the Z value goes below FingerLow.
|
|
<P>
|
|
|
|
The MaxDoubleTapTime parameter has the same function as the MaxTapTime
|
|
parameter, but for the second, third, etc tap in a tap sequence.
|
|
If you can't perform double clicks fast enough (for example, xmms
|
|
depends on fast double clicks), try reducing this parameter.
|
|
If you can't get word selection to work in xterm (ie button down,
|
|
button up, button down, move mouse), try increasing this parameter.
|
|
<P>
|
|
|
|
The ClickTime parameter controls the delay between the button down and
|
|
button up X events generated in response to a tap event.
|
|
A too long value can cause undesirable autorepeat in scroll bars and a
|
|
too small value means that visual feedback from the gui application
|
|
you are interacting with is harder to see.
|
|
<A NAME="lbAI"> </A>
|
|
<H3>Acceleration</H3>
|
|
|
|
The MinSpeed, MaxSpeed and AccelFactor parameters control the pointer
|
|
motion speed.
|
|
The speed value defines the scaling between touchpad coordinates and
|
|
screen coordinates.
|
|
When moving the finger very slowly, the MinSpeed value is used, when
|
|
moving very fast the MaxSpeed value is used.
|
|
When moving the finger at moderate speed, you get a pointer motion
|
|
speed somewhere between MinSpeed and MaxSpeed.
|
|
If you don't want any acceleration, set MinSpeed and MaxSpeed to the
|
|
same value.
|
|
<P>
|
|
|
|
The MinSpeed, MaxSpeed and AccelFactor parameters don't have any
|
|
effect on scrolling speed.
|
|
Scrolling speed is determined solely from the VertScrollDelta and
|
|
HorizScrollDelta parameters.
|
|
To invert the direction of vertical or horizontal scrolling, set
|
|
VertScrollDelta or HorizScrollDelta to a negative value.
|
|
<P>
|
|
|
|
Acceleration is mostly handled outside the driver, thus the driver will
|
|
translate MinSpeed into constant deceleration and adapt MaxSpeed at
|
|
startup time. This ensures you can user the other acceleration profiles, albeit
|
|
without pressure motion. However the numbers at runtime will likely be different
|
|
from any options you may have set.
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H3>Pressure motion</H3>
|
|
|
|
When pressure motion is activated, the cursor motion speed depends
|
|
on the pressure exerted on the touchpad (the more pressure exerted on
|
|
the touchpad, the faster the pointer).
|
|
More precisely the speed is first calculated according to MinSpeed,
|
|
MaxSpeed and AccelFactor, and then is multiplied by a sensitivity
|
|
factor.
|
|
<P>
|
|
|
|
The sensitivity factor can be adjusted using the PressureMotion
|
|
parameters.
|
|
If the pressure is below PressureMotionMinZ, PressureMotionMinFactor
|
|
is used, and if the pressure is greater than PressureMotionMaxZ,
|
|
PressureMotionMaxFactor is used.
|
|
For a pressure value between PressureMotionMinZ and
|
|
PressureMotionMaxZ, the factor is increased linearly.
|
|
<A NAME="lbAK"> </A>
|
|
<H3>Middle button emulation</H3>
|
|
|
|
Since most synaptics touchpad models don't have a button that
|
|
corresponds to the middle button on a mouse, the driver can emulate
|
|
middle mouse button events.
|
|
If you press both the left and right mouse buttons at almost the same
|
|
time (no more than EmulateMidButtonTime milliseconds apart) the driver
|
|
generates a middle mouse button event.
|
|
<A NAME="lbAL"> </A>
|
|
<H3>Circular scrolling</H3>
|
|
|
|
Circular scrolling acts like a scrolling wheel on the touchpad.
|
|
Scrolling is engaged when a drag starts in the given CircScrollTrigger
|
|
region, which can be all edges, a particular side, or a particular
|
|
corner.
|
|
Once scrolling is engaged, moving your finger in clockwise circles
|
|
around the center of the touchpad will generate scroll down events and
|
|
counter clockwise motion will generate scroll up events.
|
|
Lifting your finger will disengage circular scrolling.
|
|
Use tight circles near the center of the pad for fast scrolling and
|
|
large circles for better control.
|
|
When used together with vertical scrolling, hitting the upper or lower
|
|
right corner will seamlessly switch over from vertical to circular
|
|
scrolling.
|
|
<P>
|
|
<A NAME="lbAM"> </A>
|
|
<H3>Coasting</H3>
|
|
|
|
Coasting is enabled by setting the CoastingSpeed parameter to a
|
|
non-zero value.
|
|
Coasting comes in two flavors: conventional (finger off) coasting, and
|
|
corner (finger on) coasting.
|
|
<P>
|
|
|
|
Conventional coasting is enabled when coasting is enabled,
|
|
and CornerCoasting is set to false.
|
|
When conventional coasting is enabled, horizontal/vertical scrolling
|
|
can continue after the finger is released from the lower/right edge of
|
|
the touchpad.
|
|
The driver computes the scrolling speed corresponding to the finger
|
|
speed immediately before the finger leaves the touchpad.
|
|
If this scrolling speed is larger than the CoastingSpeed parameter
|
|
(measured in scroll events per second), the scrolling will continue
|
|
with the same speed in the same direction until the finger touches the
|
|
touchpad again.
|
|
<P>
|
|
|
|
Corner coasting is enabled when coasting is enabled, and
|
|
CornerCoasting is set to true.
|
|
When corner coasting is enabled, edge scrolling can continue as long
|
|
as the finger stays in a corner.
|
|
Coasting begins when the finger enters the corner, and continues until
|
|
the finger leaves the corner.
|
|
CornerCoasting takes precedence over the seamless switch from edge
|
|
scrolling to circular scrolling. That is, if CornerCoasting is
|
|
active, scrolling will stop, and circular scrolling will not start,
|
|
when the finger leaves the corner.
|
|
<P>
|
|
<A NAME="lbAN"> </A>
|
|
<H3>Noise cancellation</H3>
|
|
|
|
The synaptics has a built-in noise cancellation based on hysteresis. This means
|
|
that incoming coordinates actually shift a box of predefined dimensions such
|
|
that it covers the incoming coordinate, and only the boxes own center is used
|
|
as input. Obviously, the smaller the box the better, but the likelyhood of
|
|
noise motion coming through also increases.
|
|
<P>
|
|
<A NAME="lbAO"> </A>
|
|
<H3>ClickPad support</H3>
|
|
|
|
A click pad device has button(s) integrated into the touchpad surface. The
|
|
user must press downward on the touchpad in order to generated a button
|
|
press. ClickPad support is enabled if the option
|
|
<B>ClickPad</B>
|
|
|
|
is set or the property is set at runtime. On some platforms, this option
|
|
will be set automatically if the kernel detects a matching device. On Linux,
|
|
the device must have the INPUT_PROP_BUTTONPAD property set.
|
|
<P>
|
|
|
|
ClickPads do not support middle mouse button emulation. If enabling ClickPad
|
|
support at runime, the user must also set the middle mouse button timeout to
|
|
0. If auto-detected, middle mouse button emulation is disabled by the
|
|
driver.
|
|
<P>
|
|
|
|
ClickPads provide software emulated buttons through
|
|
<B>Option "SoftButtonAreas".</B>
|
|
|
|
These buttons enable areas on the touchpad to perform as right or middle
|
|
mouse button. When the user performs a click within a defined soft button
|
|
area, a right or middle click is performed.
|
|
<P>
|
|
|
|
Some laptops, most notably the Lenovo T440, T540 and x240 series, provide a
|
|
pointing stick without physical buttons. On those laptops, the top of the
|
|
touchpad acts as software-emulated button area. This area can be enabled
|
|
with
|
|
<B>Option "HasSecondarySoftButtons"</B>
|
|
|
|
and configured
|
|
with
|
|
<B>Option "SecondarySoftButtonAreas".</B>
|
|
|
|
On some platforms, this option
|
|
will be set automatically if the kernel detects a matching device. On Linux,
|
|
the device must have the INPUT_PROP_TOPBUTTONPAD property set.
|
|
<P>
|
|
<A NAME="lbAP"> </A>
|
|
<H2>DEVICE PROPERTIES</H2>
|
|
|
|
Synaptics 1.0 and higher support input device properties if the driver is
|
|
running on X server 1.6 or higher. The synclient tool
|
|
shipped with synaptics version 1.1 uses input device properties by default.
|
|
Properties supported:
|
|
<DL COMPACT>
|
|
<DT id="86"><B>Synaptics Edges</B>
|
|
|
|
<DD>
|
|
32 bit, 4 values, left, right, top, bottom.
|
|
<P>
|
|
<DT id="87"><B>Synaptics Finger</B>
|
|
|
|
<DD>
|
|
32 bit, 3 values, low, high, press.
|
|
<P>
|
|
<DT id="88"><B>Synaptics Tap Time</B>
|
|
|
|
<DD>
|
|
32 bit.
|
|
<P>
|
|
<DT id="89"><B>Synaptics Tap Move</B>
|
|
|
|
<DD>
|
|
32 bit.
|
|
<P>
|
|
<DT id="90"><B>Synaptics Tap Durations</B>
|
|
|
|
<DD>
|
|
32 bit, 3 values, single touch timeout, max tapping time for double taps,
|
|
duration of a single click.
|
|
<P>
|
|
<DT id="91"><B>Synaptics ClickPad</B>
|
|
|
|
<DD>
|
|
8 bit (Bool).
|
|
<P>
|
|
<DT id="92"><B>Synaptics Middle Button Timeout</B>
|
|
|
|
<DD>
|
|
32 bit.
|
|
<P>
|
|
<DT id="93"><B>Synaptics Two-Finger Pressure</B>
|
|
|
|
<DD>
|
|
32 bit.
|
|
<P>
|
|
<DT id="94"><B>Synaptics Two-Finger Width</B>
|
|
|
|
<DD>
|
|
32 bit.
|
|
<P>
|
|
<DT id="95"><B>Synaptics Scrolling Distance</B>
|
|
|
|
<DD>
|
|
32 bit, 2 values, vert, horiz.
|
|
<P>
|
|
<DT id="96"><B>Synaptics Edge Scrolling</B>
|
|
|
|
<DD>
|
|
8 bit (BOOL), 3 values, vertical, horizontal, corner.
|
|
<P>
|
|
<DT id="97"><B>Synaptics Two-Finger Scrolling</B>
|
|
|
|
<DD>
|
|
8 bit (BOOL), 2 values, vertical, horizontal.
|
|
<P>
|
|
<DT id="98"><B>Synaptics Move Speed</B>
|
|
|
|
<DD>
|
|
FLOAT, 4 values, min, max, accel, <deprecated>
|
|
<P>
|
|
<DT id="99"><B>Synaptics Button Scrolling</B>
|
|
|
|
<DD>
|
|
8 bit (BOOL), 2 values, updown, leftright.
|
|
<P>
|
|
<DT id="100"><B>Synaptics Button Scrolling Repeat</B>
|
|
|
|
<DD>
|
|
8 bit (BOOL), 2 values, updown, leftright.
|
|
<P>
|
|
<DT id="101"><B>Synaptics Button Scrolling Time</B>
|
|
|
|
<DD>
|
|
32 bit.
|
|
<P>
|
|
<DT id="102"><B>Synaptics Off</B>
|
|
|
|
<DD>
|
|
8 bit, valid values (0, 1, 2).
|
|
<P>
|
|
<DT id="103"><B>Synaptics Locked Drags</B>
|
|
|
|
<DD>
|
|
8 bit (BOOL).
|
|
<P>
|
|
<DT id="104"><B>Synaptics Locked Drags Timeout</B>
|
|
|
|
<DD>
|
|
32 bit.
|
|
<P>
|
|
<DT id="105"><B>Synaptics Tap Action</B>
|
|
|
|
<DD>
|
|
8 bit, up to MAX_TAP values (see synaptics.h), 0 disables an element. order:
|
|
RT, RB, LT, LB, F1, F2, F3.
|
|
<P>
|
|
<DT id="106"><B>Synaptics Click Action</B>
|
|
|
|
<DD>
|
|
8 bit, up to MAX_CLICK values (see synaptics.h), 0 disables an element.
|
|
order: Finger 1, 2, 3.
|
|
<P>
|
|
<DT id="107"><B>Synaptics Circular Scrolling</B>
|
|
|
|
<DD>
|
|
8 bit (BOOL).
|
|
<P>
|
|
<DT id="108"><B>Synaptics Circular Scrolling Distance</B>
|
|
|
|
<DD>
|
|
FLOAT.
|
|
<P>
|
|
<DT id="109"><B>Synaptics Circular Scrolling Trigger</B>
|
|
|
|
<DD>
|
|
8 bit, valid values 0..8 (inclusive) order: any edge, top, top + right,
|
|
right, right + bottom, bottom, bottom + left, left, left + top.
|
|
<P>
|
|
<DT id="110"><B>Synaptics Circular Pad</B>
|
|
|
|
<DD>
|
|
8 bit (BOOL).
|
|
<P>
|
|
<DT id="111"><B>Synaptics Palm Detection</B>
|
|
|
|
<DD>
|
|
8 bit (BOOL).
|
|
<P>
|
|
<DT id="112"><B>Synaptics Palm Dimensions</B>
|
|
|
|
<DD>
|
|
32 bit, 2 values, width, z.
|
|
<P>
|
|
<DT id="113"><B>Synaptics Coasting Speed</B>
|
|
|
|
<DD>
|
|
FLOAT, 2 values, speed, friction.
|
|
<P>
|
|
<DT id="114"><B>Synaptics Pressure Motion</B>
|
|
|
|
<DD>
|
|
32 bit, 2 values, min, max.
|
|
<P>
|
|
<DT id="115"><B>Synaptics Pressure Motion Factor</B>
|
|
|
|
<DD>
|
|
FLOAT, 2 values, min, max.
|
|
<P>
|
|
<DT id="116"><B>Synaptics Resolution Detect</B>
|
|
|
|
<DD>
|
|
8 bit (BOOL).
|
|
<P>
|
|
<DT id="117"><B>Synaptics Grab Event Device</B>
|
|
|
|
<DD>
|
|
8 bit (BOOL).
|
|
<P>
|
|
<DT id="118"><B>Synaptics Gestures</B>
|
|
|
|
<DD>
|
|
8 bit (BOOL), 1 value, tap-and-drag.
|
|
<P>
|
|
<DT id="119"><B>Synaptics Area</B>
|
|
|
|
<DD>
|
|
The AreaLeftEdge, AreaRightEdge, AreaTopEdge and AreaBottomEdge parameters are used to
|
|
define the edges of the active area of the touchpad. All movements, scrolling and tapping
|
|
which take place outside of this area will be ignored. This property is disabled by
|
|
default.
|
|
<P>
|
|
32 bit, 4 values, left, right, top, bottom. 0 disables an element.
|
|
<P>
|
|
<DT id="120"><B>Synaptics Soft Button Areas</B>
|
|
|
|
<DD>
|
|
This property is only available on ClickPad devices.
|
|
The Right and middle soft button areas are used to support right and middle
|
|
click actions on a ClickPad device. Providing 0 for all values of a given button
|
|
disables the button area.
|
|
<P>
|
|
32 bit, 8 values, RBL, RBR, RBT, RBB, MBL, MBR, MBT, MBB.
|
|
<P>
|
|
<DT id="121"><B>Synaptics Capabilities</B>
|
|
|
|
<DD>
|
|
This read-only property expresses the physical capability of the touchpad,
|
|
most notably whether the touchpad hardware supports multi-finger tapping and
|
|
scrolling.
|
|
<P>
|
|
8 bit (BOOL), 7 values (read-only), has left button, has middle button, has
|
|
right button, two-finger detection, three-finger detection, pressure detection, and finger/palm width detection.
|
|
<P>
|
|
<DT id="122"><B>Synaptics Pad Resolution</B>
|
|
|
|
<DD>
|
|
32 bit unsigned, 2 values (read-only), vertical, horizontal in units/millimeter.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAQ"> </A>
|
|
<H2>NOTES</H2>
|
|
|
|
Configuration through
|
|
<I>InputClass</I>
|
|
|
|
sections is recommended in X servers 1.8 and later. See <A HREF="/cgi-bin/man/man2html?5+xorg.conf.d">xorg.conf.d</A>(5) for
|
|
more details. An example xorg.conf.d snippet is provided in
|
|
<I>${sourcecode}/conf/70-synaptics.conf</I>
|
|
|
|
<P>
|
|
|
|
Configuration through hal fdi files is recommended in X servers 1.5, 1.6 and
|
|
1.7. An example hal policy file is provided in
|
|
<I>${sourcecode}/conf/11-x11-synaptics.fdi</I>
|
|
|
|
<P>
|
|
|
|
If either of
|
|
<B>Protocol "</B><I>auto-dev</I><B>"</B>
|
|
|
|
(default) or
|
|
<B>Protocol "</B><I>event</I><B>"</B>
|
|
|
|
is used, the driver initializes defaults based on the capabilities reported by
|
|
the kernel driver. Acceleration, edges and resolution are based on the dimensions
|
|
reported by the kernel. If the kernel reports multi-finger detection, two-finger
|
|
vertical scrolling is enabled, horizontal two-finger scrolling is disabled and
|
|
edge scrolling is disabled. If no multi-finger capabilities are reported,
|
|
edge scrolling is enabled for both horizontal and vertical scrolling.
|
|
Tapping is disabled by default for touchpads with one or more physical buttons.
|
|
To enable it you need to map tap actions to buttons. See the "TapButton1",
|
|
"TapButton2" and "TapButton3" options.
|
|
<P>
|
|
|
|
Button mapping for physical buttons is handled in the server.
|
|
If the device is switched to left-handed (an in-server mapping of physical
|
|
buttons 1, 2, 3 to the logical buttons 3, 2, 1, respectively), both physical
|
|
and TapButtons are affected. To counteract this, the TapButtons need to be set
|
|
up in reverse order (TapButton1=3, TapButton2=1).
|
|
<P>
|
|
<A NAME="lbAR"> </A>
|
|
<H2>REMOVED OPTIONS</H2>
|
|
|
|
The following options are no longer part of the driver configuration:
|
|
<DL COMPACT>
|
|
<DT id="123"><B>Option "Repeater" "</B><I>string</I><B>"</B>
|
|
|
|
<DD>
|
|
<DT id="124"><B>Option "HistorySize" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
<DT id="125"><B>Option "SpecialScrollAreaRight" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
<DT id="126"><B>Option "GuestMouseOff" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
<DT id="127"><B>Option "SHMConfig" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
<DT id="128"><B>Option "FingerPress" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
<DT id="129"><B>Option "TrackstickSpeed" "</B><I>float</I><B>"</B>
|
|
|
|
<DD>
|
|
<DT id="130"><B>Option "EdgeMotionMinZ" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
<DT id="131"><B>Option "EdgeMotionMaxZ" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
<DT id="132"><B>Option "EdgeMotionMinSpeed" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
<DT id="133"><B>Option "EdgeMotionMaxSpeed" "</B><I>integer</I><B>"</B>
|
|
|
|
<DD>
|
|
<DT id="134"><B>Option "EdgeMotionUseAlways" "</B><I>boolean</I><B>"</B>
|
|
|
|
<DD>
|
|
<DT id="135"><DD>
|
|
</DL>
|
|
<A NAME="lbAS"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
<P>
|
|
|
|
Peter Osterlund <<A HREF="mailto:petero2@telia.com">petero2@telia.com</A>> and many others.
|
|
<A NAME="lbAT"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<P>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?1+Xorg">Xorg</A>(1), <A HREF="/cgi-bin/man/man2html?5+xorg.conf">xorg.conf</A>(5), <A HREF="/cgi-bin/man/man2html?1+Xserver">Xserver</A>(1), <A HREF="/cgi-bin/man/man2html?7+X">X</A>(7), <A HREF="/cgi-bin/man/man2html?1+synclient">synclient</A>(1), <A HREF="/cgi-bin/man/man2html?1+syndaemon">syndaemon</A>(1)
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="136"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="137"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="138"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="139"><A HREF="#lbAE">CONFIGURATION OPTIONS</A><DD>
|
|
<DT id="140"><A HREF="#lbAF">CONFIGURATION DETAILS</A><DD>
|
|
<DL>
|
|
<DT id="141"><A HREF="#lbAG">Area handling</A><DD>
|
|
<DT id="142"><A HREF="#lbAH">Tapping</A><DD>
|
|
<DT id="143"><A HREF="#lbAI">Acceleration</A><DD>
|
|
<DT id="144"><A HREF="#lbAJ">Pressure motion</A><DD>
|
|
<DT id="145"><A HREF="#lbAK">Middle button emulation</A><DD>
|
|
<DT id="146"><A HREF="#lbAL">Circular scrolling</A><DD>
|
|
<DT id="147"><A HREF="#lbAM">Coasting</A><DD>
|
|
<DT id="148"><A HREF="#lbAN">Noise cancellation</A><DD>
|
|
<DT id="149"><A HREF="#lbAO">ClickPad support</A><DD>
|
|
</DL>
|
|
<DT id="150"><A HREF="#lbAP">DEVICE PROPERTIES</A><DD>
|
|
<DT id="151"><A HREF="#lbAQ">NOTES</A><DD>
|
|
<DT id="152"><A HREF="#lbAR">REMOVED OPTIONS</A><DD>
|
|
<DT id="153"><A HREF="#lbAS">AUTHORS</A><DD>
|
|
<DT id="154"><A HREF="#lbAT">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:02 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|