← Back to branch summary

~ubuntu-branches/ubuntu/precise/linux-ti-omap4/precise

« back to all changes in this revision

Viewing changes to Documentation/arm/Sharp-LH/ADC-LH7-Touchscreen

  • Committer: Bazaar Package Importer
  • Author(s): Paolo Pisati
  • Date: 2011-06-29 15:23:51 UTC
  • mfrom: (26.1.1 natty-proposed)
  • Revision ID: james.westby@ubuntu.com-20110629152351-xs96tm303d95rpbk
Tags: 3.0.0-1200.2
* Rebased against 3.0.0-6.7
* BSP from TI based on 3.0.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
Documentation/arm/Sharp-LH/ADC-LH7-Touchscreen
1
 
README on the ADC/Touchscreen Controller
2
 
========================================
3
 
 
4
 
The LH79524 and LH7A404 include a built-in Analog to Digital
5
 
controller (ADC) that is used to process input from a touchscreen.
6
 
The driver only implements a four-wire touch panel protocol.
7
 
 
8
 
The touchscreen driver is maintenance free except for the pen-down or
9
 
touch threshold.  Some resistive displays and board combinations may
10
 
require tuning of this threshold.  The driver exposes some of its
11
 
internal state in the sys filesystem.  If the kernel is configured
12
 
with it, CONFIG_SYSFS, and sysfs is mounted at /sys, there will be a
13
 
directory
14
 
 
15
 
  /sys/devices/platform/adc-lh7.0
16
 
 
17
 
containing these files.
18
 
 
19
 
  -r--r--r--    1 root     root         4096 Jan  1 00:00 samples
20
 
  -rw-r--r--    1 root     root         4096 Jan  1 00:00 threshold
21
 
  -r--r--r--    1 root     root         4096 Jan  1 00:00 threshold_range
22
 
 
23
 
The threshold is the current touch threshold.  It defaults to 750 on
24
 
most targets.
25
 
 
26
 
  # cat threshold
27
 
 750
28
 
 
29
 
The threshold_range contains the range of valid values for the
30
 
threshold.  Values outside of this range will be silently ignored.
31
 
 
32
 
  # cat threshold_range
33
 
  0 1023
34
 
 
35
 
To change the threshold, write a value to the threshold file.
36
 
 
37
 
  # echo 500 > threshold
38
 
  # cat threshold
39
 
  500
40
 
 
41
 
The samples file contains the most recently sampled values from the
42
 
ADC.  There are 12.  Below are typical of the last sampled values when
43
 
the pen has been released.  The first two and last two samples are for
44
 
detecting whether or not the pen is down.  The third through sixth are
45
 
X coordinate samples.  The seventh through tenth are Y coordinate
46
 
samples.
47
 
 
48
 
  # cat samples
49
 
  1023 1023 0 0 0 0 530 529 530 529 1023 1023
50
 
 
51
 
To determine a reasonable threshold, press on the touch panel with an
52
 
appropriate stylus and read the values from samples.
53
 
 
54
 
  # cat samples
55
 
  1023 676 92 103 101 102 855 919 922 922 1023 679
56
 
 
57
 
The first and eleventh samples are discarded.  Thus, the important
58
 
values are the second and twelfth which are used to determine if the
59
 
pen is down.  When both are below the threshold, the driver registers
60
 
that the pen is down.  When either is above the threshold, it
61
 
registers then pen is up.