Merge tag 'block-6.13-20242901' of git://git.kernel.dk/linux
[drm/drm-misc.git] / Documentation / devicetree / bindings / input / touchscreen / touchscreen.yaml
blob431c13335c402f50a770988676bb0c20fb76da7c
1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/input/touchscreen/touchscreen.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: Common touchscreen
9 maintainers:
10   - Dmitry Torokhov <dmitry.torokhov@gmail.com>
12 properties:
13   panel:
14     description: If this touchscreen is integrally connected to a panel, this
15       is a reference to that panel. The presence of this reference indicates
16       that the touchscreen should be power sequenced together with the panel
17       and that they may share power and/or reset signals.
18     $ref: /schemas/types.yaml#/definitions/phandle
20   touchscreen-min-x:
21     description: minimum x coordinate reported
22     $ref: /schemas/types.yaml#/definitions/uint32
23     default: 0
25   touchscreen-min-y:
26     description: minimum y coordinate reported
27     $ref: /schemas/types.yaml#/definitions/uint32
28     default: 0
30   touchscreen-size-x:
31     description: horizontal resolution of touchscreen (maximum x coordinate reported + 1)
32     $ref: /schemas/types.yaml#/definitions/uint32
34   touchscreen-size-y:
35     description: vertical resolution of touchscreen (maximum y coordinate reported + 1)
36     $ref: /schemas/types.yaml#/definitions/uint32
38   touchscreen-max-pressure:
39     description: maximum reported pressure (arbitrary range dependent on the controller)
40     $ref: /schemas/types.yaml#/definitions/uint32
42   touchscreen-min-pressure:
43     description: minimum pressure on the touchscreen to be achieved in order
44       for the touchscreen driver to report a touch event.
45     $ref: /schemas/types.yaml#/definitions/uint32
47   touchscreen-fuzz-x:
48     description: horizontal noise value of the absolute input device (in pixels)
49     $ref: /schemas/types.yaml#/definitions/uint32
51   touchscreen-fuzz-y:
52     description: vertical noise value of the absolute input device (in pixels)
53     $ref: /schemas/types.yaml#/definitions/uint32
55   touchscreen-fuzz-pressure:
56     description: pressure noise value of the absolute input device (arbitrary
57       range dependent on the controller)
58     $ref: /schemas/types.yaml#/definitions/uint32
60   touchscreen-average-samples:
61     description: Number of data samples which are averaged for each read (valid
62       values dependent on the controller)
63     $ref: /schemas/types.yaml#/definitions/uint32
65   touchscreen-inverted-x:
66     description: X axis is inverted
67     type: boolean
69   touchscreen-inverted-y:
70     description: Y axis is inverted
71     type: boolean
73   touchscreen-swapped-x-y:
74     description: X and Y axis are swapped
75                  Swapping is done after inverting the axis
76     type: boolean
78   touchscreen-x-mm:
79     description: horizontal length in mm of the touchscreen
81   touchscreen-y-mm:
82     description: vertical length in mm of the touchscreen
84   touchscreen-x-plate-ohms:
85     description: Resistance of the X-plate in Ohms
87   touchscreen-y-plate-ohms:
88     description: Resistance of the Y-plate in Ohms
90 dependencies:
91   touchscreen-size-x: [ touchscreen-size-y ]
92   touchscreen-size-y: [ touchscreen-size-x ]
93   touchscreen-x-mm: [ touchscreen-y-mm ]
94   touchscreen-y-mm: [ touchscreen-x-mm ]
96 additionalProperties: true