Input: da9062 - update bindings docs to account for da9061
authorSteve Twiss <stwiss.opensource@diasemi.com>
Wed, 9 Nov 2016 00:15:31 +0000 (16:15 -0800)
committerDmitry Torokhov <dmitry.torokhov@gmail.com>
Wed, 9 Nov 2016 00:23:50 +0000 (16:23 -0800)
Add binding information for DA9061 onkey.

This patch updates the compatible string "dlg,da9061-onkey" to support
DA9061, removes the reference to KEY_SLEEP (which the driver no longer
supports) and fixes a typo in the example for DA9063.

Supporting KEY_SLEEP was not the general convention and the typical
solution should have been for KEY_POWER to support both cases of suspend
and S/W power off. This change was sent to the DA9063 ONKEY device
driver in a separate patch, but the documentation was not updated at
that time.
f889bea Report KEY_POWER instead of KEY_SLEEP during power key-press

This patch also adds two new examples, one for DA9062 and one for DA9061.
The DA9061 examples uses a fall-back compatible string for the DA9062
onkey driver.

Signed-off-by: Steve Twiss <stwiss.opensource@diasemi.com>
Signed-off-by: Dmitry Torokhov <dmitry.torokhov@gmail.com>
Documentation/devicetree/bindings/input/da9062-onkey.txt

index ab0e0488fe928ffe618fc69a10870ec291ed5b84..5f9fbc68e58a45bd95af3ea2a5998d581a328b52 100644 (file)
@@ -1,32 +1,47 @@
-* Dialog DA9062/63 OnKey Module
+* Dialog DA9061/62/63 OnKey Module
 
-This module is part of the DA9062/DA9063. For more details about entire
-chips see Documentation/devicetree/bindings/mfd/da9062.txt and
-Documentation/devicetree/bindings/mfd/da9063.txt
+This module is part of the DA9061/DA9062/DA9063. For more details about entire
+DA9062 and DA9061 chips see Documentation/devicetree/bindings/mfd/da9062.txt
+For DA9063 see Documentation/devicetree/bindings/mfd/da9063.txt
 
-This module provides KEY_POWER, KEY_SLEEP and events.
+This module provides the KEY_POWER event.
 
 Required properties:
 
-- compatible: should be one of:
-       dlg,da9062-onkey
-       dlg,da9063-onkey
+- compatible: should be one of the following valid compatible string lines:
+       "dlg,da9061-onkey", "dlg,da9062-onkey"
+       "dlg,da9062-onkey"
+       "dlg,da9063-onkey"
 
 Optional properties:
 
-  - dlg,disable-key-power : Disable power-down using a long key-press. If this
+- dlg,disable-key-power : Disable power-down using a long key-press. If this
     entry exists the OnKey driver will remove support for the KEY_POWER key
-    press. If this entry does not exist then by default the key-press
-    triggered power down is enabled and the OnKey will support both KEY_POWER
-    and KEY_SLEEP.
+    press when triggered using a long press of the OnKey.
 
-Example:
-
-       pmic0: da9062@58 {
+Example: DA9063
 
+       pmic0: da9063@58 {
                onkey {
                        compatible = "dlg,da9063-onkey";
                        dlg,disable-key-power;
                };
+       };
+
+Example: DA9062
+
+       pmic0: da9062@58 {
+               onkey {
+                       compatible = "dlg,da9062-onkey";
+                       dlg,disable-key-power;
+               };
+       };
+
+Example: DA9061 using a fall-back compatible for the DA9062 onkey driver
 
+       pmic0: da9061@58 {
+               onkey {
+                       compatible = "dlg,da9061-onkey", "dlg,da9062-onkey";
+                       dlg,disable-key-power;
+               };
        };