xref: /freebsd/sys/contrib/device-tree/Bindings/input/fsl,mpr121-touchkey.yaml (revision b97ee269eae3cbaf35c18f51a459aea581c2a7dc) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/input/fsl,mpr121-touchkey.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Freescale MPR121 capacitive touch sensor controller
8
9maintainers:
10  - Dmitry Torokhov <dmitry.torokhov@gmail.com>
11
12description: |
13  The MPR121 supports up to 12 completely independent electrodes/capacitance
14  sensing inputs in which 8 are multifunctional for LED driving and GPIO.
15  https://www.nxp.com/docs/en/data-sheet/MPR121.pdf
16
17allOf:
18  - $ref: input.yaml#
19
20anyOf:
21  - required: [ interrupts ]
22  - required: [ poll-interval ]
23
24properties:
25  compatible:
26    const: fsl,mpr121-touchkey
27
28  reg:
29    maxItems: 1
30
31  interrupts:
32    maxItems: 1
33
34  vdd-supply: true
35
36  linux,keycodes:
37    minItems: 1
38    maxItems: 12
39
40  wakeup-source:
41    description: Use any event on keypad as wakeup event.
42    type: boolean
43
44required:
45  - compatible
46  - reg
47  - vdd-supply
48  - linux,keycodes
49
50unevaluatedProperties: false
51
52examples:
53  - |
54    // Example with interrupts
55    #include "dt-bindings/input/input.h"
56    i2c {
57        #address-cells = <1>;
58        #size-cells = <0>;
59
60        touchkey@5a {
61            compatible = "fsl,mpr121-touchkey";
62            reg = <0x5a>;
63            interrupt-parent = <&gpio1>;
64            interrupts = <28 2>;
65            autorepeat;
66            vdd-supply = <&ldo4_reg>;
67            linux,keycodes = <KEY_0>, <KEY_1>, <KEY_2>, <KEY_3>,
68                             <KEY_4>, <KEY_5>, <KEY_6>, <KEY_7>,
69                             <KEY_8>, <KEY_9>, <KEY_A>, <KEY_B>;
70        };
71    };
72
73  - |
74    // Example with polling
75    #include "dt-bindings/input/input.h"
76    i2c {
77        #address-cells = <1>;
78        #size-cells = <0>;
79
80        touchkey@5a {
81            compatible = "fsl,mpr121-touchkey";
82            reg = <0x5a>;
83            poll-interval = <20>;
84            autorepeat;
85            vdd-supply = <&ldo4_reg>;
86            linux,keycodes = <KEY_0>, <KEY_1>, <KEY_2>, <KEY_3>,
87                             <KEY_4>, <KEY_5>, <KEY_6>, <KEY_7>,
88                             <KEY_8>, <KEY_9>, <KEY_A>, <KEY_B>;
89        };
90    };
91