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