aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/input
diff options
context:
space:
mode:
authorMauro Carvalho Chehab <mchehab@s-opensource.com>2017-04-04 20:47:27 -0400
committerDmitry Torokhov <dmitry.torokhov@gmail.com>2017-04-05 18:45:01 -0400
commit7b11fdc39feae7abce7b47a54e3880ad2d392345 (patch)
treedf4323970438a87e4f86e662deb122e784e7503d /Documentation/input
parent2f438935561cc24caf839a9fb07f4ee51b8acd2f (diff)
Input: ntrig - convert documentation into ReST format
This file require minimum adjustments to be a valid ReST file. Do it, in order to be able to parse it with Sphinx. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com> Signed-off-by: Dmitry Torokhov <dmitry.torokhov@gmail.com>
Diffstat (limited to 'Documentation/input')
-rw-r--r--Documentation/input/ntrig.txt49
1 files changed, 30 insertions, 19 deletions
diff --git a/Documentation/input/ntrig.txt b/Documentation/input/ntrig.txt
index be1fd981f73f..a6b22ce6c61c 100644
--- a/Documentation/input/ntrig.txt
+++ b/Documentation/input/ntrig.txt
@@ -1,7 +1,11 @@
1.. include:: <isonum.txt>
2
3=========================
1N-Trig touchscreen Driver 4N-Trig touchscreen Driver
2------------------------- 5=========================
3 Copyright (c) 2008-2010 Rafi Rubin <rafi@seas.upenn.edu> 6
4 Copyright (c) 2009-2010 Stephane Chatty 7:Copyright: |copy| 2008-2010 Rafi Rubin <rafi@seas.upenn.edu>
8:Copyright: |copy| 2009-2010 Stephane Chatty
5 9
6This driver provides support for N-Trig pen and multi-touch sensors. Single 10This driver provides support for N-Trig pen and multi-touch sensors. Single
7and multi-touch events are translated to the appropriate protocols for 11and multi-touch events are translated to the appropriate protocols for
@@ -22,16 +26,18 @@ but only for that one device.
22 26
23The following parameters are used to configure filters to reduce noise: 27The following parameters are used to configure filters to reduce noise:
24 28
25activate_slack number of fingers to ignore before processing events 29+-----------------------+-----------------------------------------------------+
26 30|activate_slack |number of fingers to ignore before processing events |
27activation_height size threshold to activate immediately 31+-----------------------+-----------------------------------------------------+
28activation_width 32|activation_height, |size threshold to activate immediately |
29 33|activation_width | |
30min_height size threshold bellow which fingers are ignored 34+-----------------------+-----------------------------------------------------+
31min_width both to decide activation and during activity 35|min_height, |size threshold bellow which fingers are ignored |
32 36|min_width |both to decide activation and during activity |
33deactivate_slack the number of "no contact" frames to ignore before 37+-----------------------+-----------------------------------------------------+
34 propagating the end of activity events 38|deactivate_slack |the number of "no contact" frames to ignore before |
39| |propagating the end of activity events |
40+-----------------------+-----------------------------------------------------+
35 41
36When the last finger is removed from the device, it sends a number of empty 42When the last finger is removed from the device, it sends a number of empty
37frames. By holding off on deactivation for a few frames we can tolerate false 43frames. By holding off on deactivation for a few frames we can tolerate false
@@ -44,15 +50,20 @@ Additional sysfs items
44---------------------- 50----------------------
45 51
46These nodes just provide easy access to the ranges reported by the device. 52These nodes just provide easy access to the ranges reported by the device.
47sensor_logical_height the range for positions reported during activity
48sensor_logical_width
49 53
50sensor_physical_height internal ranges not used for normal events but 54+-----------------------+-----------------------------------------------------+
51sensor_physical_width useful for tuning 55|sensor_logical_height, | the range for positions reported during activity |
56|sensor_logical_width | |
57+-----------------------+-----------------------------------------------------+
58|sensor_physical_height,| internal ranges not used for normal events but |
59|sensor_physical_width | useful for tuning |
60+-----------------------+-----------------------------------------------------+
52 61
53All N-Trig devices with product id of 1 report events in the ranges of 62All N-Trig devices with product id of 1 report events in the ranges of
54X: 0-9600 63
55Y: 0-7200 64* X: 0-9600
65* Y: 0-7200
66
56However not all of these devices have the same physical dimensions. Most 67However not all of these devices have the same physical dimensions. Most
57seem to be 12" sensors (Dell Latitude XT and XT2 and the HP TX2), and 68seem to be 12" sensors (Dell Latitude XT and XT2 and the HP TX2), and
58at least one model (Dell Studio 17) has a 17" sensor. The ratio of physical 69at least one model (Dell Studio 17) has a 17" sensor. The ratio of physical