FreeBSD Manual Pages
WSP(4) Kernel Interfaces Manual WSP(4) NAME wsp -- Wellspring touchpad driver SYNOPSIS To compile this driver into the kernel, place the following lines into your kernel configuration file: device wsp device hid device usb Alternatively, to load the driver as a module at boot time, place the following line in loader.conf(5): wsp_load="YES" DESCRIPTION The wsp driver provides support for the Apple Internal Trackpad device found in many Apple laptops. The driver simulates a three-button mouse using multi-finger press/tap detection. A single-finger press generates a left button click. A two-finger press maps to the right button; whereas a three-finger press gets treated as a middle button click. The trackpad functions with presses and taps. A press is a full-forced press which causes a physical lowering of the trackpad. A tap is a touch of the trackpad which does not depress the physical trackpad. The wsp driver supports receiving evdev input device data if enabled. This data is used for extended usage of the touchpad like multi-finger support, pressure detection, tap support, and gestures. At least the second bit of the sysctl(8) tunable kern.evdev.rcpt_mask must be set. This can be enabled with kern.evdev.rcpt_mask=3. Vertical scrolling (z-axis) is enabled by default with a two-finger tap and the movement of a finger up and down. Horizontal scrolling (t- axis) is not natively supported by the sysmouse protocol, therefore must be enabled with evdev data. This can be enabled with the sysctl(8) tunable kern.evdev.sysmouse_t_axis=3. Horizontal scrolling can be used with a two-finger tap and the movement of a finger from side to side. The sysctl(8) tunable hw.usb.wsp.t_factor must be greater than 0 for horizontal scrolling to be enabled, too. Horizontal swiping with a three-finger tap is registered as mouse but- tons 8 and 9, depending on the direction. These buttons default to backwards and forwards keyboard events. SYSCTL VARIABLES The following variables are available as sysctl(8) tunables: hw.usb.wsp.scale_factor Controls the pointer sensitivity. Default is 12. hw.usb.wsp.enable_single_tap_clicks Enables single-tap to register as a left-click. Default is 1 (enabled). hw.usb.wsp.enable_single_tap_movement Enables movement on the trackpad follow a partially-released left-click. Default is 1 (enabled). hw.usb.wsp.max_finger_diameter Specifies the maximum finger diameter on the trackpad that is registered as a finger (a lower value is used for palm detec- tion). Default is 1900. max_scroll_finger_distance Specifies the maximum distance between two fingers where z-axis and t-axis movements are registered. Z-axis and T-axis move- ments are vertical and horizontal movements with more than one finger tapped (not clicked), respectively. Default is 8192. hw.usb.wsp.max_double_tap_distance Specifies the maximum distance between two fingers that a two- finger click will be registered as a right-click. Default is 2500. hw.usb.wsp.scr_threshold Specifies the minimum horizontal or vertical distance required to register as a scrolling gesture. Default is 20. hw.usb.wsp.z_factor Z-axis sensitivity. Default is 5. hw.usb.wsp.z_invert Z-axis inversion. Default is 0 (disabled). hw.usb.wsp.t_factor T-axis sensitivity. Default is 0 (disabled). hw.usb.wsp.t_invert T-axis inversion. Default is 0 (disabled). hw.usb.wsp.scroll_finger_count Specifies the number of tapped fingers which registers as a scrolling movement. Default is 2. hw.usb.wsp.horizontal_swipe_finger_count Speifies the number of tapped fingers which registers as a swipe gesture. Default is 3. hw.usb.wsp.pressure_touch_threshold Specifies the threshold for a finger to be registered as a click. Default is 50. hw.usb.wsp.pressure_untouch_threshold Specifies the threshold for a finger to be registered as an unclick. Default is 10. hw.usb.wsp.pressure_tap_threshold Specifies the threadhold for a finger to be registered as a tap. Default is 120. hw.usb.wsp.debug Specifies the wsp driver debugging level (0-3). Default is 1. FILES wsp creates a blocking pseudo-device file, /dev/wsp0, which presents the mouse as a sysmouse or mousesystems type device--see moused(8) for an explanation of these mouse types. SEE ALSO sysmouse(4), usb(4), loader.conf(5), xorg.conf(5) (ports/x11/xorg), moused(8), sysctl(8) AUTHORS The wsp driver was written by Huang Wen Hui <huanghwh@gmail.com>. FreeBSD 15.0 February 9, 2021 WSP(4)
NAME | SYNOPSIS | DESCRIPTION | SYSCTL VARIABLES | FILES | SEE ALSO | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=wsp&manpath=FreeBSD+15.0-RELEASE+and+Ports>