1 # SPDX-License-Identifier: GPL-2.0-only 1 # SPDX-License-Identifier: GPL-2.0-only
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/input/hid-o 4 $id: http://devicetree.org/schemas/input/hid-over-i2c.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: HID over I2C Devices 7 title: HID over I2C Devices
8 8
9 maintainers: 9 maintainers:
10 - Benjamin Tissoires <benjamin.tissoires@redh 10 - Benjamin Tissoires <benjamin.tissoires@redhat.com>
11 - Jiri Kosina <jkosina@suse.cz> 11 - Jiri Kosina <jkosina@suse.cz>
12 12
13 description: |+ 13 description: |+
14 HID over I2C provides support for various Hu 14 HID over I2C provides support for various Human Interface Devices over the
15 I2C bus. These devices can be for example to 15 I2C bus. These devices can be for example touchpads, keyboards, touch screens
16 or sensors. 16 or sensors.
17 17
18 The specification has been written by Micros 18 The specification has been written by Microsoft and is currently available here:
19 https://msdn.microsoft.com/en-us/library/win 19 https://msdn.microsoft.com/en-us/library/windows/hardware/hh852380.aspx
20 20
21 If this binding is used, the kernel module i 21 If this binding is used, the kernel module i2c-hid will handle the communication
22 with the device and the generic hid core lay 22 with the device and the generic hid core layer will handle the protocol.
23 23
24 allOf: 24 allOf:
25 - $ref: /schemas/input/touchscreen/touchscre 25 - $ref: /schemas/input/touchscreen/touchscreen.yaml#
26 26
27 properties: 27 properties:
28 compatible: 28 compatible:
29 oneOf: 29 oneOf:
30 - items: 30 - items:
31 - enum: 31 - enum:
32 - wacom,w9013 32 - wacom,w9013
33 - const: hid-over-i2c 33 - const: hid-over-i2c
34 - description: Just "hid-over-i2c" alone 34 - description: Just "hid-over-i2c" alone is allowed, but not recommended.
35 const: hid-over-i2c 35 const: hid-over-i2c
36 36
37 reg: 37 reg:
38 maxItems: 1 38 maxItems: 1
39 39
40 interrupts: 40 interrupts:
41 maxItems: 1 41 maxItems: 1
42 42
43 hid-descr-addr: 43 hid-descr-addr:
44 description: HID descriptor address 44 description: HID descriptor address
45 $ref: /schemas/types.yaml#/definitions/uin 45 $ref: /schemas/types.yaml#/definitions/uint32
46 46
47 panel: true 47 panel: true
48 48
49 post-power-on-delay-ms: 49 post-power-on-delay-ms:
50 description: Time required by the device a 50 description: Time required by the device after enabling its regulators
51 or powering it on, before it is ready fo 51 or powering it on, before it is ready for communication.
52 52
53 touchscreen-inverted-x: true 53 touchscreen-inverted-x: true
54 54
55 touchscreen-inverted-y: true 55 touchscreen-inverted-y: true
56 56
57 vdd-supply: 57 vdd-supply:
58 description: 3.3V supply 58 description: 3.3V supply
59 59
60 vddl-supply: 60 vddl-supply:
61 description: 1.8V supply 61 description: 1.8V supply
62 62
63 wakeup-source: true 63 wakeup-source: true
64 64
65 required: 65 required:
66 - compatible 66 - compatible
67 - reg 67 - reg
68 - interrupts 68 - interrupts
69 69
70 additionalProperties: false 70 additionalProperties: false
71 71
72 examples: 72 examples:
73 - | 73 - |
74 i2c { 74 i2c {
75 #address-cells = <1>; 75 #address-cells = <1>;
76 #size-cells = <0>; 76 #size-cells = <0>;
77 77
78 hid@2c { 78 hid@2c {
79 compatible = "hid-over-i2c"; 79 compatible = "hid-over-i2c";
80 reg = <0x2c>; 80 reg = <0x2c>;
81 hid-descr-addr = <0x0020>; 81 hid-descr-addr = <0x0020>;
82 interrupts = <3 2>; 82 interrupts = <3 2>;
83 }; 83 };
84 }; 84 };
85 ... 85 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.