How to configure the TrackPoint

2005-10-10T20:55:23Z

24.164.41.39: Added slight config help for pre-2.6.9 kernels.

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |The [[Patch to enable advanced trackpoint configuration|kernel trackpoint driver]] is controlled by echoing values to special files. Common configuration options are outlined below.
{{NOTE|
From 2.6.11 on, config files for this driver are in <tt>/sys/devices/platform/i8042/serio0</tt>.

Prior to kernel 2.6.11, these files were located in <tt>/proc/trackpoint</tt>. (This document uses the new locations.)

Prior to kernel 2.6.9, these files were not files at all, but were command-line options to the psmouse module. (Note this means you must compile psmouse as a module!) See http://stephen.evanchik.com/node/16.
}}
|}

==General Configuration==
The configuration options are reflected by the files you can find in {{path|/sys/devices/platform/i8042/serio0}}. See the [[Patch to enable advanced trackpoint configuration|TrackPoint driver page]] for a complete list.
Configuration is done by echoing the appropriate values into these special files.
{{HINT|If <tt>echo XX > file</tt> isn't working for you, try <tt>echo -n XX > file</tt> instead}}

==Most common Features==
The most common settings are '''Press to Select''', '''sensitivity''', '''speed''' and '''scrolling'''.

===Press to Select===
Press to Select allows you to tap the control stick which will simulate a left click. You can enable this feature by typing the following in to a terminal (you may need to be root):

:{{cmdroot|echo 1 > /sys/devices/platform/i8042/serio0/press_to_select}}

Press to Select should now be enabled. You can disable it in a similar manner:

:{{cmdroot|echo 0 > /sys/devices/platform/i8042/serio0/press_to_select}}

===Sensitivity & Speed===
Adjusting the speed and sensitivity of the TrackPoint requires echoing a value between 0 and 255 into the appropriate file. For example, for a speed of 120 and a sensitivity of 250, type the following into a terminal:

:{{cmdroot|echo 120 > /sys/devices/platform/i8042/serio0/speed}}
:{{cmdroot|echo 250 > /sys/devices/platform/i8042/serio0/sensitivity}}

Feel free to experiment with your settings until you find a combination that is comfortable.

===Scrolling===
====Using a kernel prior to 2.6.11====
The scrolling action is essentially the same as is used in the TrackPoint Windows drivers. To enable this feature, type the following in to a terminal (you may need to be root):

:{{cmdroot|echo 1 > /proc/trackpoint/scroll}}

Then press the middle button and push the stick up and down to scroll. Similarly, to disable scrolling:

:{{cmdroot|echo 0 > /proc/trackpoint/scroll}}

====Using the X server (kernel 2.6.11+)====
The scroll setting has been removed from the trackpoint driver in kernel versions 2.6.11 and above. Scroll emulation should now be handled in the X server. First do:

:{{cmd|echo -n 0 > /sys/devices/platform/i8042/serio0/middle_btn_disable}}

(Note for kernel 2.6.13: There's no more such file /sys/devices/platform/i8042/serio0/middle_btn_disable)

Then, for versions of Xorg since ~Oct '04, add these lines to your TrackPoint configuration section in {{path|/etc/X11/xorg.conf}}:

Option "EmulateWheel" "on"
Option "EmulateWheelButton" "2"

Now restart X and hold down button 2 and move the mouse to scroll, or just press and release button 2 for a middle click.
Please note that the patch allowing to use button 2 for a middle click is currently (27/09/05) NOT included in Debian and Ubuntu packages of Xorg. You can find an updated version of the package in the Experimental branch of debian.

For older versions of Xorg or for Xfree86 ({{path|/etc/X11/XF86Config}}) try this:

Option "Emulate3Buttons" "true"
Option "EmulateWheel" "true"
Option "EmulateWheelButton" "2"

Now restart X and hold down button two and move the mouse for scrolling. To get a middle click, press buttons 1 and 3 simultaneously.

==Soft Transparent Mode==
If you wish to connect a special device to the external PS/2 port, you should consider using "Soft Transparent Mode" so that the TrackPoint controller does not interpret any commands sent to the external PS/2 port. You can enable soft transparent mode by typing the following in to a terminal:

:{{cmdroot|echo 1 > /proc/trackpoint/transparent}}

Disabling soft transparent mode is similar:

:{{cmdroot|echo 0 > /proc/trackpoint/transparent}}

ThinkWiki - User contributions [en]

How to configure the TrackPoint