d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document the Synaptics tunable. While I'm here, also mention the

Browse Source 
synapticshw_t structure and the MOUSE_SYN_GETHWINFO ioctl() which
reads it.

MT5 candidate

Approved by:	njl
This commit is contained in:
Philip Paeps 2004-09-30 06:18:29 +00:00
parent fbcd15008a
commit 7327755fe8
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=135955
1 changed files with 49 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
share/man/man4/psm.4
View File

@ -26,7 +26,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd April 1, 2000
.Dd September 29, 2004
.Dt PSM 4
.Os
.Sh NAME
@ -348,6 +348,15 @@ It has no effect unless the
.Em HOOKRESUME
flag is set as well.
.El
.Sh TUNABLES
Extended support for Synaptics touchpads can be enabled by setting
.Va hw.psm.synaptics_support
to
.Em 1
at boot-time.
This will enable
.Nm
to handle packets from guest devices (sticks) and extra buttons.
.Sh IOCTLS
There are a few
.Xr ioctl 2
@ -438,6 +447,36 @@ Microsoft Ballpoint mouse
Microsoft IntelliMouse
.El
.Pp
.It Dv MOUSE_SYN_GETHWINFO Ar synapticshw_t *synhw
Retrieves extra information associated with Synaptics Touchpads.
Only available when
.Va hw.psm.synaptics_support
has been enabled.
.Bd -literal
typedef struct synapticshw {
int infoMajor; /* major hardware revision */
int infoMinor; /* minor hardware revision */
int infoRot180; /* touchpad is rotated */
int infoPortrait; /* touchpad is a portrait */
int infoSensor; /* sensor model */
int infoHardware; /* hardware model */
int infoNewAbs; /* supports the newabs format */
int capPen; /* can detect a pen */
int infoSimpleC; /* supports simple commands */
int infoGeometry; /* touchpad dimensions */
int capExtended; /* supports extended packets */
int capSleep; /* can be suspended/resumed */
int capFourButtons; /* has four buttons */
int capMultiFinger; /* can detect multiple fingers */
int capPalmDetect; /* can detect a palm */
int capPassthrough; /* can passthrough guest packets */
} synapticshw_t;
.Ed
.Pp
See the
.Em Synaptics TouchPad Interfacing Guide
for more information about the fields in this structure.
.Pp
.It Dv MOUSE_GETMODE Ar mousemode_t *mode
The command gets the current operation parameters of the mouse
driver.
@ -799,6 +838,10 @@ The ioctl command
.Dv MOUSEIOCREAD
has been removed.
It was never functional anyway.
.Pp
Enabling the extended support for Synaptics touchpads has been reported to
cause problems with responsivity on some (newer) models of Synaptics
hardware, particularly those with guest devices.
.Sh SEE ALSO
.Xr ioctl 2 ,
.Xr syslog 3 ,
@ -808,6 +851,11 @@ It was never functional anyway.
.Xr sysmouse 4 ,
.Xr moused 8 ,
.Xr syslogd 8
.Pp
.Rs
.%T Synaptics TouchPad Interfacing Guide
.%O http://www.synaptics.com/
.Re
.\".Sh HISTORY
.Sh AUTHORS
.An -nosplit