CoCalc -- atmel,maxtouch.yaml

GitHub Repository: torvalds/linux
Path: blob/master/Documentation/devicetree/bindings/input/atmel,maxtouch.yaml
⁵¹⁶⁵⁸ views
1
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
%YAML 1.2
3
---
4
$id: http://devicetree.org/schemas/input/atmel,maxtouch.yaml#
5
$schema: http://devicetree.org/meta-schemas/core.yaml#
6

7
title: Atmel maXTouch touchscreen/touchpad
8

9
maintainers:
10
  - Nick Dyer <nick@shmanahar.org>
11
  - Linus Walleij <linusw@kernel.org>
12

13
description: |
14
  Atmel maXTouch touchscreen or touchpads such as the mXT244
15
  and similar devices.
16

17
allOf:
18
  - $ref: input.yaml#
19
  - $ref: touchscreen/touchscreen.yaml#
20

21
properties:
22
  compatible:
23
    const: atmel,maxtouch
24

25
  reg:
26
    maxItems: 1
27

28
  interrupts:
29
    maxItems: 1
30

31
  vdda-supply:
32
    description:
33
      Optional regulator for the AVDD analog voltage.
34

35
  vdd-supply:
36
    description:
37
      Optional regulator for the VDD digital voltage.
38

39
  reset-gpios:
40
    maxItems: 1
41
    description:
42
      Optional GPIO specifier for the touchscreen's reset pin
43
      (active low). The line must be flagged with
44
      GPIO_ACTIVE_LOW.
45

46
  wake-gpios:
47
    maxItems: 1
48
    description:
49
      Optional GPIO specifier for the touchscreen's wake pin
50
      (active low). The line must be flagged with
51
      GPIO_ACTIVE_LOW.
52

53
  linux,gpio-keymap:
54
    $ref: /schemas/types.yaml#/definitions/uint32-array
55
    description: |
56
      When enabled, the SPT_GPIOPWN_T19 object sends messages
57
      on GPIO bit changes. An array of up to 8 entries can be provided
58
      indicating the Linux keycode mapped to each bit of the status byte,
59
      starting at the LSB. Linux keycodes are defined in
60
      <dt-bindings/input/input.h>.
61

62
      Note: the numbering of the GPIOs and the bit they start at varies
63
      between maXTouch devices. You must either refer to the documentation,
64
      or experiment to determine which bit corresponds to which input. Use
65
      KEY_RESERVED for unused padding values.
66

67
  linux,keycodes:
68
    minItems: 1
69
    maxItems: 8
70

71
  atmel,wakeup-method:
72
    $ref: /schemas/types.yaml#/definitions/uint32
73
    description: |
74
      The WAKE line is an active-low input that is used to wake up the touch
75
      controller from deep-sleep mode before communication with the controller
76
      could be started. This optional feature used to minimize current
77
      consumption when the controller is in deep sleep mode. This feature is
78
      relevant only to some controller families, like mXT1386 controller for
79
      example.
80

81
      The WAKE pin can be connected in one of the following ways:
82
       1) left permanently low
83
       2) connected to the I2C-compatible SCL pin
84
       3) connected to a GPIO pin on the host
85
    enum:
86
      - 0 # ATMEL_MXT_WAKEUP_NONE
87
      - 1 # ATMEL_MXT_WAKEUP_I2C_SCL
88
      - 2 # ATMEL_MXT_WAKEUP_GPIO
89
    default: 0
90

91
  wakeup-source:
92
    type: boolean
93

94
required:
95
  - compatible
96
  - reg
97
  - interrupts
98

99
unevaluatedProperties: false
100

101
examples:
102
  - |
103
    #include <dt-bindings/interrupt-controller/irq.h>
104
    #include <dt-bindings/input/atmel-maxtouch.h>
105
    #include <dt-bindings/gpio/gpio.h>
106
    i2c {
107
      #address-cells = <1>;
108
      #size-cells = <0>;
109
      touchscreen@4a {
110
        compatible = "atmel,maxtouch";
111
        reg = <0x4a>;
112
        interrupt-parent = <&gpio>;
113
        interrupts = <26 IRQ_TYPE_EDGE_FALLING>;
114
        reset-gpios = <&gpio 27 GPIO_ACTIVE_LOW>;
115
        vdda-supply = <&ab8500_ldo_aux2_reg>;
116
        vdd-supply = <&ab8500_ldo_aux5_reg>;
117
        atmel,wakeup-method = <ATMEL_MXT_WAKEUP_I2C_SCL>;
118
      };
119
    };
120

121
...
122

123
Product

Resources

Company
