[PATCH v5 1/2] devicetree: i2c-hid: Add regulator support

From: Brian Norris
Date: Thu Feb 09 2017 - 21:04:07 EST


From: Caesar Wang <wxt@xxxxxxxxxxxxxx>

Document a "vdd-supply" and an initialization delay. Can be used for
powering on/off a HID.

Signed-off-by: Caesar Wang <wxt@xxxxxxxxxxxxxx>
Cc: Rob Herring <robh+dt@xxxxxxxxxx>
Cc: Jiri Kosina <jikos@xxxxxxxxxx>
Cc: linux-input@xxxxxxxxxxxxxxx
Signed-off-by: Brian Norris <briannorris@xxxxxxxxxxxx>
---
Sorry for the delay on resending this. I *think* I've addressed all the
concerns from last time though?

v2:
* add compatible property for wacom, per Rob's request
* name the regulator property specifically (VDD)

v3:
* remove wacom property, per Benjamin's request
* add delay property

v4: no change

v5:
* change name to "post-power-on-delay-ms"
* reword to describe how the power sequencing properties require a
specific 'compatible' property
---
Documentation/devicetree/bindings/input/hid-over-i2c.txt | 16 ++++++++++++++++
1 file changed, 16 insertions(+)

diff --git a/Documentation/devicetree/bindings/input/hid-over-i2c.txt b/Documentation/devicetree/bindings/input/hid-over-i2c.txt
index 488edcb264c4..28e8bd8b7d64 100644
--- a/Documentation/devicetree/bindings/input/hid-over-i2c.txt
+++ b/Documentation/devicetree/bindings/input/hid-over-i2c.txt
@@ -17,6 +17,22 @@ Required properties:
- interrupt-parent: the phandle for the interrupt controller
- interrupts: interrupt line

+Additional optional properties:
+
+Some devices may support additional optional properties to help with, e.g.,
+power sequencing. The following properties can be supported by one or more
+device-specific compatible properties, which should be used in addition to the
+"hid-over-i2c" string.
+
+- compatible:
+ * "wacom,w9013" (Wacom W9013 digitizer). Supports:
+ - vdd-supply
+ - post-power-on-delay-ms
+
+- vdd-supply: phandle of the regulator that provides the supply voltage.
+- post-power-on-delay-ms: time required by the device after enabling its regulators
+ before it is ready for communication. Must be used with 'vdd-supply'.
+
Example:

i2c-hid-dev@2c {
--
2.11.0.483.g087da7b7c-goog