This is an old revision of the document!
Synaptics
xorg.conf
### Start synaptics configuration section ### # Documentation at: # /usr/share/doc/xfree86-driver-synaptics/README.Debian # Section "InputDevice" # Start section. # Identifier "TouchPad" # Name doesn't matter - needs to be the same as in # Section "ServerLayout" below. # Driver "synaptics" # Name of driver to load (synaptics or alps or ...). # Option "CorePointer" # 'AlwaysCore' or 'CorePointer' (see docs). # Option "Device" "/dev/psaux" # Mouse device (see docs). # Option "Protocol" "auto-dev" # Mouse protocol (see docs). # # Option "Repeater" "/dev/ps2mouse" # Device to repeat mouse events to. # ################################################# Shared memory configuration (SHMConfig ) allows configuration of the # touchpad from user space. This has possible security implications - # see documentation. # # IMPORTANT! You may find that certain GUIs (KDE) will call the # synaptics driver after XF86Config-4 has been parsed and cause all of # the values you have programmed via XF86Config-4 to be reset to the # default driver values or to different values. If you find that your # XF86Config-4 configuration values seem to have no effect, set # SHMConfig to 0 (off) until you can create a script to load your # values via the 'synclient' program or until you can disable the # offending applet or program. # # Example: For KDE you can run (as the root user) the command # 'apt-get --purge remove ksynaptics' to remove the synaptics # control center module and then your XF86Config-4 settings will be # preserved (provided that you have no other modules or programs that # configure the driver upon loading the KDE GUI). # Option "SHMConfig" "1" # Leave off (0) until the touchpad is working correctly in X, # then turn on (1)to enable configuration from X applets or Xterm. # This eliminates X apps from interfering with XF86Config-4 tweaks. # Or leave on (1) if you prefer to use 'synclient' from within X to # configure the touchpad. # If you leave it on you may need to create a script that runs # after the X Server and session manager have finished loading # to restore your preferred settings, since some GUI environments # configure these settings automatically (i.e. after the X windows # system has loaded the driver and parsed the XF86Config-4 file). # ################################################# The LeftEdge, RightEdge, TopEdge, and BottomEdge parameters define # the edges of a rectangle within which all touches, taps, and gestures # will be interpreted normally. This rectangle is defined in units # which are derived from the way that the touchpad is manufactured. # To understand the units used, the coordinate system could be # viewed as a grid of wires embedded in the surface of the touchpad # (6143 wires in the horizontal [X] direction and 6143 wires in the # vertical [Y] direction), with each wire capable of reporting the # proximity of a finger to it and / or finger pressure [Z]. # The standard touchpad is measured in units starting from the left # edge in the 'X' direction (0-6143 units), and from the bottom edge # in the 'Y' direction (0-6143 units). The edges are the actual edges # of the touchpad before it is mounted in the computer - the bezel # that the touchpad is mounted in limits the actual finger contact area # to an area that is usually less than the maximum on all sides. This # means that the left edge of the bezel may be 1000 units from the # actual edge of the touchpad. Therefore, it is necessary to define a # rectangle that tells the synaptics driver that your finger is # approaching the edge of the bezel and will be unable to continue # motion in the current direction. This will allow the driver to # initiate special features such as Edge Motion(tm) or scrolling. # # The LeftEdge, RightEdge, TopEdge, and BottomEdge parameters define a # rectangle where finger motion will emulate normal mouse motion - any # motion outside of this rectangle will cause different behavior (such # as scrolling, or continuation of current motion at a certain rate # [Edge Motion(tm)]). Set these values to a value that accommodates # the width of your finger between the edge of the defined rectangle # and the bezel to start with, and then adjust as desired. # # NOTE: The Range figures given below are how much adjustment is # allowed for by the 'synclient' program, although there may be no # effect when these values are set beyond a certain limit. # Option "LeftEdge" "1500" # Range 0-10000 Units (pad coordinates) Standard value 1700 # Distance from the left edge of the touchpad to the left edge of the # defined rectangle. # Option "RightEdge" "5350" # Range 0-10000 Units (pad coordinates) Standard value 5300 # Distance from the left edge of the touchpad to the right edge of the # defined rectangle. # Option "TopEdge" "1500" # Range 0-10000 Units (pad coordinates) Standard value 1700 # Distance from the top edge of the touchpad to the top edge of the # defined rectangle. # Option "BottomEdge" "4450" # Range 0-10000 Units (pad coordinates) Standard value 4200 # Distance from the top edge of the touchpad to the bottom edge of the # defined rectangle. # ################################################# The next two values work together - lower values make the touchpad # more sensitive to touching and tapping, but some difference is # needed between them. # # Low threshold of pressure for finger detection - values below this # threshold will cause the finger contact to be considered ended. Option "FingerLow" "15" # Range 0-255 Units (pressure) Standard value 25 # This value must be approximately 10-20 units lower than the value of # 'FingerHigh' - otherwise instability and / or spurious generation of # tap events will be generated. # # High threshold of pressure for finger detection - values above this # threshold will cause the finger contact to be considered valid. Option "FingerHigh" "25" # Range 0-255 Units (pressure) Standard value 40 # Lower values increase the touchpad's sensitivity to touch (provided # that 'FingerLow' is set at a value that is less than 'FingerHigh'). # ################################################# The next three values work together to determine whether a tap event # will be generated or not. # # Maximum finger contact time for the contact to be considered a tap. # Lower values make the touchpad less 'sensitive' to taps - higher # values may cause tap events to be generated for normal finger touch # and release gestures. Option "MaxTapTime" "180" # Range 0-1000 Units (ms) Standard value 180 # '0' = no tap-to-click # # Maximum amount of finger movement allowed for the tap to be # considered valid - if the finger moves more then this amount from # the time of contact to time contact ends, the tap event will not be # generated. Option "MaxTapMove" "220" # Range 0-2000 Units (relative) Standard value 220 # '0' = eliminate single finger tap-to-click but allow two # and three finger tap-to-click # # Maximum time allowed between successive taps for the taps to be # interpreted as a double-click, triple-click, etc. Option "MaxDoubleTapTime" "150" # Range 0-1000 Units (ms) Standard value 150 # ################################################# The amount of time between the button-up and button-down events # that the X windows system generates in response to a tap event. Option "ClickTime" "60" # Range 0-1000 Units (ms) Standard value 60 # ################################################# Speed up tapping for single clicks. Option "FastTaps" "1" # Range 0-1 Units Boolean Standard value 1 # Use fast taps - 0 = false, 1 = true # ################################################# Time within which the left and right mouse buttons must be pressed # for a middle-button event to be generated - i.e. allowable time # between when one of the buttons is pressed and the other is pressed. Option "EmulateMidButtonTime" "75" # Range 0-1000 Units (ms) Standard value 75 # ################################################# Vertical and Horizontal sensitivity. # Distance the finger must move to generate a scroll event. Lower values # will result in faster scrolling. # Option "VertScrollDelta" "100" # Range 0-1000 Units (relative) Standard value 100 # Amount of change in vertical position since last packet was sent # to driver. # Option "HorizScrollDelta" "110" # Range 0-1000 Units (relative) Standard value 110 # Amount of change in horizontal position since last packet was sent # to driver. # ################################################# Factors to translate finger motion to cursor motion. # # This factor is used when the finger is moving slowly. Option "MinSpeed" "0.01" # Range 0-1.0 Units (relative) Standard value 0.01 # Decrease this value to increase the ability to precisely position # the mouse cursor. # # This factor is used when the finger is moving rapidly. Option "MaxSpeed" "0.10" # Range 0-1.0 Units (relative) Standard value 0.10 # Increase this value to increase the distance traveled by the mouse # cursor when the finger is moved rapidly across the touchpad. # # Factor by which MinSpeed or MaxSpeed is multiplied. Option "AccelFactor" "0.0075"# Range 0-0.2 Units (relative) Standard value 0.0075 # Increase this value to increase the speed of cursor movement at both # MinSpeed and MaxSpeed speeds. # ################################################# Edge Motion(tm) - Continuation of the motion that was occurring when # the finger reached the edge of the touchpad (i.e. the bezel). # Option "EdgeMotionMinZ" "30" # Range 1-255 Units (relative) Standard value 30 # Edge Motion(tm) minimum pressure - pressure at which the minimum # scroll speed is set. # Option "EdgeMotionMaxZ" "160" # Range 1-255 Units (relative) Standard value 160 # Edge Motion(tm) maximum pressure - pressure at which the maximum # scrolling speed is set. # Option "EdgeMotionMinSpeed" "100" # Range 0-1000 Units (relative) Standard value 1 # Edge Motion(tm) minimum speed. # Option "EdgeMotionMaxSpeed" "150" # Range 0-1000 Units (relative) Standard value 150 # Edge Motion(tm) maximum speed. # # If false, Edge Motion(tm) is only used for dragging and scrolling - # if true, Edge Motion(tm) is also used for normal mouse movements. Option "EdgeMotionUseAlways" "0" # Range 0-1 Units Boolean Standard value 0 # Always use Edge Motion(tm) - 0 = false, 1 = true # ################################################# Whether to use the Up / Down scrolling buttons as scroll buttons or # special buttons. Option "UpDownScrolling" "1" # Range 0-1 Units Boolean Standard value 1 # If 1, the Up / Down buttons generate button 4 and button 5 events, # respectively. If 0, the Up / Down buttons generate a double-click # and a button 2 event, respectively. # ################################################# Turn touchpad on or off. Option "TouchpadOff" "0" # Range 0-3 Units N/A Standard value 0 # If 1, the touchpad is off - if 0, the touchpad is on, if 3, the # touchpad has tapping disabled. # ################################################# Turn auxiliary mouse / joystick on or off. Option "GuestMouseOff" "1" # Range 0-1 Units Boolean Standard value 1 # If 1, auxiliary mouse is off - if 0, auxiliary mouse is on. # ################################################# Use locked drags to extend drag gestures beyond the edges of the # touchpad. Option "LockedDrags" "0" # Range 0-1 Units Boolean Standard value 0 # If 1, a drag gesture does not end until the pad is tapped again - # if 0, a drag gesture ends when the finger is lifted from the # touchpad. # ################################################# Description of values for the various 'Button' tap actions. # 0 = No action, 1 = Left Button, 2 = Middle Button, 3 = Right Button # There may be other values defined but these are the standard ones. # # It may be necessary to increase the value of MaxTapMove to a greater # value to obtain the '??CornerButton' events reliably. # # Button event that is generated when the right-top corner of the # touchpad is single-tapped. Option "RTCornerButton" "3" # Range 0-12 Units N/A Standard value 3 # # Button event that is generated when the right-bottom corner of the # touchpad is single-tapped. Option "RBCornerButton" "3" # Range 0-12 Units N/A Standard value 3 # # Button event that is generated when the left-top corner of the # touchpad is single-tapped. Option "LTCornerButton" "0" # Range 0-12 Units N/A Standard value 0 # # Button event that is generated when the left-bottom corner of the # touchpad is single-tapped. Option "LBCornerButton" "0" # Range 0-12 Units N/A Standard value 0 # # Button event to report for single-finger tap detected outside # of a corner or specially defined area. Option "TapButton1" "0" # Range 0-12 Units N/A Standard value 1 # # Button event to report for two-finger tap detected outside # of a corner or specially defined area. Option "TapButton2" "1" # Range 0-12 Units N/A Standard value 2 # # Button event to report for a three-finger tap detected outside # of a corner or specially defined area. Option "TapButton3" "0" # Range 0-12 Units N/A Standard value 3 # ################################################# Use circular dragging gestures to emulate a scroll-wheel. Option "CircularScrolling" "0" # Range 0-1 Units Boolean Standard value 0 # If on, circular scrolling is on - if off, circular scrolling is off. # # Angle of finger movement required to generate a scroll event. Option "CircScrollDelta" "0.05" # Range .01-3.0 Units (radians) Standard value 0.05 # # Defines the area(s) of the touchpad which will initiate a circular # scroll if CircScrollDelta radians of angular movement is detected. Option "CircScrollTrigger" "0" # Range 0-8 Units (relative) Standard value (User pref) # 0=All Edges, 1=Top Edge, 2=Top Right Corner, 3=Right Edge, # 4=Bottom Right Corner, 5=Bottom Edge, 6=Bottom Left Corner, # 7=Left Edge, 8=Top Left Corner # ################################################# Whether the touchpad is circular - if so, the LeftEdge, RightEdge, # TopEdge, and BottomEdge parameters define an ellipse instead of a # rectangle. Option "CircularPad" "0" # Range 0-1 Units Boolean Standard value 0 (or User pref) # If 0, the touchpad is rectangular - if 1 the touchpad is 'circular'. # ################################################# Palm contact detection. Option "PalmDetect" "1" # Range 0-1 Units Boolean Standard value 1 (or User pref) # Detect palm contact - 0 = off, 1 = on # Option "PalmMinWidth" "10" # Range 0-15 Units (pad coordinates) Standard value (10) # Minimum width of contact area to trigger palm detection. # Option "PalmMinZ" "200" # Range 0-255 Units (relative) Standard value (200) # Minimum contact pressure to trigger palm detection. # ################################################# Locked scrolling speed. Option "CoastingSpeed" "20" # Range 0-20 Units (relative) Standard value 10 # Speed that the window scrolls if you start the scroll by dragging # your finger on the edge of the touchpad and then 'throw' the scroll # with your finger. EndSection
Last modified: le 2008/12/17 12:42