xref: /freebsd/sys/contrib/device-tree/Bindings/input/touchscreen/stmpe.txt (revision e1c4c8dd8d2d10b6104f06856a77bd5b4813a801)
1STMPE Touchscreen
2----------------
3
4Required properties:
5 - compatible: "st,stmpe-ts"
6
7Optional properties:
8- st,ave-ctrl		: Sample average control
9				0 -> 1 sample
10				1 -> 2 samples
11				2 -> 4 samples
12				3 -> 8 samples
13- st,touch-det-delay	: Touch detect interrupt delay (recommended is 3)
14				0 -> 10 us
15				1 -> 50 us
16				2 -> 100 us
17				3 -> 500 us
18				4 -> 1 ms
19				5 -> 5 ms
20				6 -> 10 ms
21				7 -> 50 ms
22- st,settling		: Panel driver settling time (recommended is 2)
23				0 -> 10 us
24				1 -> 100 us
25				2 -> 500 us
26				3 -> 1 ms
27				4 -> 5 ms
28				5 -> 10 ms
29				6 -> 50 ms
30				7 -> 100 ms
31- st,fraction-z		: Length of the fractional part in z (recommended is 7)
32			  (fraction-z ([0..7]) = Count of the fractional part)
33- st,i-drive		: current limit value of the touchscreen drivers
34				0 -> 20 mA (typical 35mA max)
35				1 -> 50 mA (typical 80 mA max)
36
37Optional properties common with MFD (deprecated):
38 - st,sample-time	: ADC conversion time in number of clock.
39				0 -> 36 clocks
40				1 -> 44 clocks
41				2 -> 56 clocks
42				3 -> 64 clocks
43				4 -> 80 clocks (recommended)
44				5 -> 96 clocks
45				6 -> 124 clocks
46 - st,mod-12b		: ADC Bit mode
47				0 -> 10bit ADC
48				1 -> 12bit ADC
49 - st,ref-sel		: ADC reference source
50				0 -> internal
51				1 -> external
52 - st,adc-freq		: ADC Clock speed
53				0 -> 1.625 MHz
54				1 -> 3.25 MHz
55				2 || 3 -> 6.5 MHz
56
57Node should be child node of stmpe node to which it belongs.
58
59Note that common ADC settings of stmpe_touchscreen (child) will take precedence
60over the settings done in MFD.
61
62Example:
63
64stmpe811@41 {
65	compatible = "st,stmpe811";
66	pinctrl-names = "default";
67	pinctrl-0 = <&pinctrl_touch_int>;
68	#address-cells = <1>;
69	#size-cells = <0>;
70	reg = <0x41>;
71	interrupts = <10 IRQ_TYPE_LEVEL_LOW>;
72	interrupt-parent = <&gpio4>;
73	interrupt-controller;
74	id = <0>;
75	blocks = <0x5>;
76	irq-trigger = <0x1>;
77	/* Common ADC settings */
78	/* 3.25 MHz ADC clock speed */
79	st,adc-freq = <1>;
80	/* 12-bit ADC */
81	st,mod-12b = <1>;
82	/* internal ADC reference */
83	st,ref-sel = <0>;
84	/* ADC converstion time: 80 clocks */
85	st,sample-time = <4>;
86
87	stmpe_touchscreen {
88		compatible = "st,stmpe-ts";
89		reg = <0>;
90		/* 8 sample average control */
91		st,ave-ctrl = <3>;
92		/* 5 ms touch detect interrupt delay */
93		st,touch-det-delay = <5>;
94		/* 1 ms panel driver settling time */
95		st,settling = <3>;
96		/* 7 length fractional part in z */
97		st,fraction-z = <7>;
98		/*
99		 * 50 mA typical 80 mA max touchscreen drivers
100		 * current limit value
101		 */
102		st,i-drive = <1>;
103	};
104	stmpe_adc {
105		compatible = "st,stmpe-adc";
106		st,norequest-mask = <0x0F>;
107	};
108};
109