pca953x: add example how to use interrupt-controller and gpio-controller

It is not completely obvious that these are required and
how to use them. So we provide a tested example.

Signed-off-by: H. Nikolaus Schaller <hns@goldelico.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: Linus Walleij <linus.walleij@linaro.org>

diff --git a/Documentation/devicetree/bindings/gpio/gpio-pca953x.txt b/Documentation/devicetree/bindings/gpio/gpio-pca953x.txt
index 6a7cddb..88f2286 100644 (file)
--- a/Documentation/devicetree/bindings/gpio/gpio-pca953x.txt
+++ b/Documentation/devicetree/bindings/gpio/gpio-pca953x.txt
@@ -31,6 +31,10 @@ Required properties:
        ti,tca9554
        onnn,pca9654
        exar,xra1202
+ - gpio-controller: if used as gpio expander.
+ - #gpio-cells: if used as gpio expander.
+ - interrupt-controller: if to be used as interrupt expander.
+ - #interrupt-cells: if to be used as interrupt expander.
 
 Optional properties:
  - reset-gpios: GPIO specification for the RESET input. This is an
@@ -48,3 +52,32 @@ Example:
                interrupt-parent = <&gpio3>;
                interrupts = <23 IRQ_TYPE_LEVEL_LOW>;
        };
+
+
+Example with Interrupts:
+
+
+       gpio99: gpio@22 {
+               compatible = "nxp,pcal6524";
+               reg = <0x22>;
+               interrupt-parent = <&gpio6>;
+               interrupts = <1 IRQ_TYPE_EDGE_FALLING>; /* gpio6_161 */
+               interrupt-controller;
+               #interrupt-cells = <2>;
+               vcc-supply = <&vdds_1v8_main>;
+               gpio-controller;
+               #gpio-cells = <2>;
+               gpio-line-names =
+                       "hdmi-ct-hpd", "hdmi.ls-oe", "p02", "p03", "vibra", "fault2", "p06", "p07",
+                       "en-usb", "en-host1", "en-host2", "chg-int", "p14", "p15", "mic-int", "en-modem",
+                       "shdn-hs-amp", "chg-status+red", "green", "blue", "en-esata", "fault1", "p26", "p27";
+       };
+
+       ts3a227@3b {
+               compatible = "ti,ts3a227e";
+               reg = <0x3b>;
+               interrupt-parent = <&gpio99>;
+               interrupts = <14 IRQ_TYPE_EDGE_RISING>;
+               ti,micbias = <0>;       /* 2.1V */
+       };
+