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

[Brian Norris]

From: Caesar Wang <wxt at rock-chips.com>

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

Signed-off-by: Caesar Wang <wxt at rock-chips.com>
Cc: Rob Herring <robh+dt at kernel.org>
Cc: Jiri Kosina <jikos at kernel.org>
Cc: linux-input at vger.kernel.org
Signed-off-by: Brian Norris <briannorris at chromium.org>
---
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 at 2c {
-- 
2.11.0.483.g087da7b7c-goog