NetBSD/sys/dev/pckbport/synapticsreg.h

117 lines
4.2 KiB
C
Raw Normal View History

/* $NetBSD: synapticsreg.h,v 1.9 2017/11/06 21:07:17 blymn Exp $ */
/*
Major re-write of the recently-committed Synaptics Touchpad driver, prompted by jittery and/or random movement during tap gestures, lack of edge motion, and a general desire to make use of the extra features available with the native protocol. - Ditch the kernel thread; it was overkill for the small amount of processing required to deal with touchpad events. - If we fail to probe a Synaptics touchpad, issue a RESET command to ensure that whatever device is out there is left in a sane state (thanks to Reinoud Zandijk for the hint). - Completely re-write gesture support. - Put the touchpad in 80 packets per second mode and count them so they can be used to time gesture durations (instead of using mono_time). - Enhance up/down button support with options to use them to emulate the middle button or Z-axis events (like a traditional wheel mouse). - Add 'edge motion'. If a drag gesture is in progress, and the reported finger position moves to the touchpad's border region, continue to report movement events at a fixed rate as if the finger carried on moving in the same direction. This restores some functionality usually provided by the touchpad's firmware in PS/2 mode. - Filter successive movement events to reduce jitter. When scaling movement events, fold the remainder into the next event to prevent loss of information during slow/small finger movements. Pointer movement is now much more refined. - Add support for touchpads which can report more than one finger on the pad simultaneously. Optionally use this feature for middle/right button emulation (i.e. tap two fingers to emulate middle button). This feature is disabled by default (for now) to avoid surprise pasting of clipboard text. ;-)
2005-01-03 01:37:12 +03:00
* Copyright (c) 2005, Steve C. Woodford
* Copyright (c) 2004, Ales Krenek
* Copyright (c) 2004, Kentaro A. Kurahone
* All rights reserved.
2005-02-27 03:26:58 +03:00
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above
* copyright notice, this list of conditions and the following
* disclaimer in the documentation and/or other materials provided
* with the distribution.
* * Neither the name of the Kentaro A. Kurahone nor the names of its
* contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
*/
#ifndef _DEV_PCKBCPORT_SYNAPTICSREG_H_
#define _DEV_PCKBCPORT_SYNAPTICSREG_H_
/* Synaptics information queries. */
#define SYNAPTICS_IDENTIFY_TOUCHPAD 0x0
#define SYNAPTICS_READ_MODE 0x1
#define SYNAPTICS_READ_CAPABILITIES 0x2
#define SYNAPTICS_READ_MODEL_ID 0x3
#define SYNAPTICS_EXTENDED_QUERY 0x9
#define SYNAPTICS_CONTINUED_CAPABILITIES 0x0c
/* Synaptics special commands */
#define SYNAPTICS_CMD_SET_MODE2 0x14
#define SYNAPTICS_CMD_CLIENT_CMD 0x28
/* Magic numbers. */
#define SYNAPTICS_MIN_VERSION 45 /* 4.5 */
#define SYNAPTICS_MAGIC_BYTE 0x47
/* Capability bits. */
#define SYNAPTICS_CAP_EXTENDED (1 << 15)
#define SYNAPTICS_CAP_EXTNUM (1 << 14 | 1 << 13 | 1 << 12)
#define SYNAPTICS_CAP_MBUTTON (1 << 10)
#define SYNAPTICS_CAP_PASSTHROUGH (1 << 7)
#define SYNAPTICS_CAP_MULTIFINGERREPORT (1 << 5)
#define SYNAPTICS_CAP_SLEEP (1 << 4)
#define SYNAPTICS_CAP_4BUTTON (1 << 3)
#define SYNAPTICS_CAP_MULTIDETECT (1 << 1)
#define SYNAPTICS_CAP_PALMDETECT (1 << 0)
/* Mode bits. */
#define SYNAPTICS_MODE_ABSOLUTE (1 << 7)
#define SYNAPTICS_MODE_RATE (1 << 6)
#define SYNAPTICS_MODE_SLEEP (1 << 3)
#define SYNAPTICS_MODE_EXTENDED_W (1 << 2) /* double meaning */
#define SYNAPTICS_MODE_GEST (1 << 2)
#define SYNAPTICS_MODE_4BYTE_CLIENT (1 << 1)
#define SYNAPTICS_MODE_W (1)
/* Extended mode button masks. */
#define SYN_1BUTMASK 0x1
#define SYN_2BUTMASK 0x1
Major re-write of the recently-committed Synaptics Touchpad driver, prompted by jittery and/or random movement during tap gestures, lack of edge motion, and a general desire to make use of the extra features available with the native protocol. - Ditch the kernel thread; it was overkill for the small amount of processing required to deal with touchpad events. - If we fail to probe a Synaptics touchpad, issue a RESET command to ensure that whatever device is out there is left in a sane state (thanks to Reinoud Zandijk for the hint). - Completely re-write gesture support. - Put the touchpad in 80 packets per second mode and count them so they can be used to time gesture durations (instead of using mono_time). - Enhance up/down button support with options to use them to emulate the middle button or Z-axis events (like a traditional wheel mouse). - Add 'edge motion'. If a drag gesture is in progress, and the reported finger position moves to the touchpad's border region, continue to report movement events at a fixed rate as if the finger carried on moving in the same direction. This restores some functionality usually provided by the touchpad's firmware in PS/2 mode. - Filter successive movement events to reduce jitter. When scaling movement events, fold the remainder into the next event to prevent loss of information during slow/small finger movements. Pointer movement is now much more refined. - Add support for touchpads which can report more than one finger on the pad simultaneously. Optionally use this feature for middle/right button emulation (i.e. tap two fingers to emulate middle button). This feature is disabled by default (for now) to avoid surprise pasting of clipboard text. ;-)
2005-01-03 01:37:12 +03:00
/* Touchpad edge boundaries (Recommended values from Synaptics documentation) */
#define SYNAPTICS_EDGE_LEFT 1632
#define SYNAPTICS_EDGE_RIGHT 5312
#define SYNAPTICS_EDGE_TOP 4288
#define SYNAPTICS_EDGE_BOTTOM 1568
#define SYNAPTICS_EDGE_MAX 6143
/* Finger pressures */
#define SYNAPTICS_FINGER_NONE 0
#define SYNAPTICS_FINGER_HOVER 10
#define SYNAPTICS_FINGER_LIGHT 30
#define SYNAPTICS_FINGER_NORMAL 80
#define SYNAPTICS_FINGER_HEAVY 110
#define SYNAPTICS_FINGER_FLAT 200
#define SYNAPTICS_FINGER_PALM 255
/* Width values */
#define SYNAPTICS_WIDTH_TWO_FINGERS 0
#define SYNAPTICS_WIDTH_THREE_OR_MORE 1
#define SYNAPTICS_WIDTH_PEN 2
#define SYNAPTICS_WIDTH_EXTENDED_W 2
#define SYNAPTICS_WIDTH_ADVANCEDGESTURE 2
#define SYNAPTICS_WIDTH_PASSTHROUGH 3
Major re-write of the recently-committed Synaptics Touchpad driver, prompted by jittery and/or random movement during tap gestures, lack of edge motion, and a general desire to make use of the extra features available with the native protocol. - Ditch the kernel thread; it was overkill for the small amount of processing required to deal with touchpad events. - If we fail to probe a Synaptics touchpad, issue a RESET command to ensure that whatever device is out there is left in a sane state (thanks to Reinoud Zandijk for the hint). - Completely re-write gesture support. - Put the touchpad in 80 packets per second mode and count them so they can be used to time gesture durations (instead of using mono_time). - Enhance up/down button support with options to use them to emulate the middle button or Z-axis events (like a traditional wheel mouse). - Add 'edge motion'. If a drag gesture is in progress, and the reported finger position moves to the touchpad's border region, continue to report movement events at a fixed rate as if the finger carried on moving in the same direction. This restores some functionality usually provided by the touchpad's firmware in PS/2 mode. - Filter successive movement events to reduce jitter. When scaling movement events, fold the remainder into the next event to prevent loss of information during slow/small finger movements. Pointer movement is now much more refined. - Add support for touchpads which can report more than one finger on the pad simultaneously. Optionally use this feature for middle/right button emulation (i.e. tap two fingers to emulate middle button). This feature is disabled by default (for now) to avoid surprise pasting of clipboard text. ;-)
2005-01-03 01:37:12 +03:00
#define SYNAPTICS_WIDTH_FINGER_MIN 4
#define SYNAPTICS_WIDTH_FINGER_NORMAL 5
#define SYNAPTICS_WIDTH_FINGER_MAX 7
#define SYNAPTICS_WIDTH_PALM_MIN 8
#define SYNAPTICS_WIDTH_PALM_MAX 14
#define SYNAPTICS_WIDTH_MAX 15
/* Extended W types */
#define SYNAPTICS_EW_WHEEL 0
#define SYNAPTICS_EW_SECONDARY_FINGER 1
#define SYNAPTICS_EW_FINGER_STATUS 2
Major re-write of the recently-committed Synaptics Touchpad driver, prompted by jittery and/or random movement during tap gestures, lack of edge motion, and a general desire to make use of the extra features available with the native protocol. - Ditch the kernel thread; it was overkill for the small amount of processing required to deal with touchpad events. - If we fail to probe a Synaptics touchpad, issue a RESET command to ensure that whatever device is out there is left in a sane state (thanks to Reinoud Zandijk for the hint). - Completely re-write gesture support. - Put the touchpad in 80 packets per second mode and count them so they can be used to time gesture durations (instead of using mono_time). - Enhance up/down button support with options to use them to emulate the middle button or Z-axis events (like a traditional wheel mouse). - Add 'edge motion'. If a drag gesture is in progress, and the reported finger position moves to the touchpad's border region, continue to report movement events at a fixed rate as if the finger carried on moving in the same direction. This restores some functionality usually provided by the touchpad's firmware in PS/2 mode. - Filter successive movement events to reduce jitter. When scaling movement events, fold the remainder into the next event to prevent loss of information during slow/small finger movements. Pointer movement is now much more refined. - Add support for touchpads which can report more than one finger on the pad simultaneously. Optionally use this feature for middle/right button emulation (i.e. tap two fingers to emulate middle button). This feature is disabled by default (for now) to avoid surprise pasting of clipboard text. ;-)
2005-01-03 01:37:12 +03:00
#endif /* _DEV_PCKBCPORT_SYNAPTICSREG_H_ */