David Venhoff
cfcea9ee67
Based off b80915eb99
and compacted into a single commit so that it will fit on the uni git server
107 lines
3.6 KiB
Plaintext
107 lines
3.6 KiB
Plaintext
Device tree bindings for TI's ADS7843, ADS7845, ADS7846, ADS7873, TSC2046
|
|
SPI driven touch screen controllers.
|
|
|
|
The node for this driver must be a child node of a SPI controller, hence
|
|
all mandatory properties described in
|
|
|
|
Documentation/devicetree/bindings/spi/spi-bus.txt
|
|
|
|
must be specified.
|
|
|
|
Additional required properties:
|
|
|
|
compatible Must be one of the following, depending on the
|
|
model:
|
|
"ti,tsc2046"
|
|
"ti,ads7843"
|
|
"ti,ads7845"
|
|
"ti,ads7846"
|
|
"ti,ads7873"
|
|
|
|
interrupts An interrupt node describing the IRQ line the chip's
|
|
!PENIRQ pin is connected to.
|
|
vcc-supply A regulator node for the supply voltage.
|
|
|
|
|
|
Optional properties:
|
|
|
|
ti,vref-delay-usecs vref supply delay in usecs, 0 for
|
|
external vref (u16).
|
|
ti,vref-mv The VREF voltage, in millivolts (u16).
|
|
Set to 0 to use internal references
|
|
(ADS7846).
|
|
ti,keep-vref-on set to keep vref on for differential
|
|
measurements as well
|
|
ti,settle-delay-usec Settling time of the analog signals;
|
|
a function of Vcc and the capacitance
|
|
on the X/Y drivers. If set to non-zero,
|
|
two samples are taken with settle_delay
|
|
us apart, and the second one is used.
|
|
~150 uSec with 0.01uF caps (u16).
|
|
ti,penirq-recheck-delay-usecs If set to non-zero, after samples are
|
|
taken this delay is applied and penirq
|
|
is rechecked, to help avoid false
|
|
events. This value is affected by the
|
|
material used to build the touch layer
|
|
(u16).
|
|
ti,x-plate-ohms Resistance of the X-plate,
|
|
in Ohms (u16).
|
|
ti,y-plate-ohms Resistance of the Y-plate,
|
|
in Ohms (u16).
|
|
ti,x-min Minimum value on the X axis (u16).
|
|
ti,y-min Minimum value on the Y axis (u16).
|
|
ti,debounce-tol Tolerance used for filtering (u16).
|
|
ti,debounce-rep Additional consecutive good readings
|
|
required after the first two (u16).
|
|
ti,pendown-gpio-debounce Platform specific debounce time for the
|
|
pendown-gpio (u32).
|
|
pendown-gpio GPIO handle describing the pin the !PENIRQ
|
|
line is connected to.
|
|
wakeup-source use any event on touchscreen as wakeup event.
|
|
(Legacy property support: "linux,wakeup")
|
|
touchscreen-size-x General touchscreen binding, see [1].
|
|
touchscreen-size-y General touchscreen binding, see [1].
|
|
touchscreen-max-pressure General touchscreen binding, see [1].
|
|
touchscreen-min-pressure General touchscreen binding, see [1].
|
|
touchscreen-average-samples General touchscreen binding, see [1].
|
|
touchscreen-inverted-x General touchscreen binding, see [1].
|
|
touchscreen-inverted-y General touchscreen binding, see [1].
|
|
touchscreen-swapped-x-y General touchscreen binding, see [1].
|
|
|
|
[1] All general touchscreen properties are described in
|
|
Documentation/devicetree/bindings/input/touchscreen/touchscreen.txt.
|
|
|
|
Deprecated properties:
|
|
|
|
ti,swap-xy swap x and y axis
|
|
ti,x-max Maximum value on the X axis (u16).
|
|
ti,y-max Maximum value on the Y axis (u16).
|
|
ti,pressure-min Minimum reported pressure value
|
|
(threshold) - u16.
|
|
ti,pressure-max Maximum reported pressure value (u16).
|
|
ti,debounce-max Max number of additional readings per
|
|
sample (u16).
|
|
|
|
Example for a TSC2046 chip connected to an McSPI controller of an OMAP SoC::
|
|
|
|
spi_controller {
|
|
tsc2046@0 {
|
|
reg = <0>; /* CS0 */
|
|
compatible = "ti,tsc2046";
|
|
interrupt-parent = <&gpio1>;
|
|
interrupts = <8 0>; /* BOOT6 / GPIO 8 */
|
|
spi-max-frequency = <1000000>;
|
|
pendown-gpio = <&gpio1 8 0>;
|
|
vcc-supply = <®_vcc3>;
|
|
|
|
ti,x-min = /bits/ 16 <0>;
|
|
ti,x-max = /bits/ 16 <8000>;
|
|
ti,y-min = /bits/ 16 <0>;
|
|
ti,y-max = /bits/ 16 <4800>;
|
|
ti,x-plate-ohms = /bits/ 16 <40>;
|
|
ti,pressure-max = /bits/ 16 <255>;
|
|
|
|
wakeup-source;
|
|
};
|
|
};
|