1 files changed, 194 insertions, 0 deletions

diff --git a/Documentation/devicetree/bindings/mfd/as3722.txt b/Documentation/devicetree/bindings/mfd/as3722.txt
new file mode 100644
index 000000000000..fc2191ecfd6b
--- /dev/null
+++ b/Documentation/devicetree/bindings/mfd/as3722.txt
@@ -0,0 +1,194 @@
+* ams AS3722 Power management IC.
+
+Required properties:
+-------------------
+- compatible: Must be "ams,as3722".
+- reg: I2C device address.
+- interrupt-controller: AS3722 has internal interrupt controller which takes the
+  interrupt request from internal sub-blocks like RTC, regulators, GPIOs as well
+  as external input.
+- #interrupt-cells: Should be set to 2 for IRQ number and flags.
+  The first cell is the IRQ number. IRQ numbers for different interrupt source
+  of AS3722 are defined at dt-bindings/mfd/as3722.h
+  The second cell is the flags, encoded as the trigger masks from binding document
+        interrupts.txt, using dt-bindings/irq.
+
+Optional submodule and their properties:
+=======================================
+
+Pinmux and GPIO:
+===============
+Device has 8 GPIO pins which can be configured as GPIO as well as the special IO
+functions.
+
+Please refer to pinctrl-bindings.txt in this directory for details of the
+common pinctrl bindings used by client devices, including the meaning of the
+phrase "pin configuration node".
+
+Following are properties which is needed if GPIO and pinmux functionality
+is required:
+    Required properties:
+    -------------------
+        - gpio-controller: Marks the device node as a GPIO controller.
+        - #gpio-cells: Number of GPIO cells. Refer to binding document
+                        gpio/gpio.txt
+
+    Optional properties:
+    --------------------
+        Following properties are require if pin control setting is required
+        at boot.
+        - pinctrl-names: A pinctrl state named "default" be defined, using the
+                bindings in pinctrl/pinctrl-binding.txt.
+        - pinctrl[0...n]: Properties to contain the phandle that refer to
+                different nodes of pin control settings. These nodes represents
+                the pin control setting of state 0 to state n. Each of these
+                nodes contains different subnodes to represents some desired
+                configuration for a list of pins. This configuration can
+                include the mux function to select on those pin(s), and
+                various pin configuration parameters, such as pull-up,
+                open drain.
+
+                Each subnode have following properties:
+                Required properties:
+                    - pins: List of pins. Valid values of pins properties are:
+                                gpio0, gpio1, gpio2, gpio3, gpio4, gpio5,
+                                gpio6, gpio7
+
+                Optional properties:
+                        function, bias-disable, bias-pull-up, bias-pull-down,
+                        bias-high-impedance, drive-open-drain.
+
+                        Valid values for function properties are:
+                                gpio, interrupt-out, gpio-in-interrupt,
+                                vsup-vbat-low-undebounce-out,
+                                vsup-vbat-low-debounce-out,
+                                voltage-in-standby, oc-pg-sd0, oc-pg-sd6,
+                                powergood-out, pwm-in, pwm-out, clk32k-out,
+                                watchdog-in, soft-reset-in
+
+Regulators:
+===========
+Device has multiple DCDC and LDOs. The node "regulators" is require if regulator
+functionality is needed.
+
+Following are properties of regulator subnode.
+
+    Optional properties:
+    -------------------
+        The input supply of regulators are the optional properties on the
+        regulator node. The input supply of these regulators are provided
+        through following properties:
+                vsup-sd2-supply: Input supply for SD2.
+                vsup-sd3-supply: Input supply for SD3.
+                vsup-sd4-supply: Input supply for SD4.
+                vsup-sd5-supply: Input supply for SD5.
+                vin-ldo0-supply: Input supply for LDO0.
+                vin-ldo1-6-supply: Input supply for LDO1 and LDO6.
+                vin-ldo2-5-7-supply: Input supply for LDO2, LDO5 and LDO7.
+                vin-ldo3-4-supply: Input supply for LDO3 and LDO4.
+                vin-ldo9-10-supply: Input supply for LDO9 and LDO10.
+                vin-ldo11-supply: Input supply for LDO11.
+
+    Optional sub nodes for regulators:
+    ---------------------------------
+        The subnodes name is the name of regulator and it must be one of:
+        sd[0-6], ldo[0-7], ldo[9-11]
+
+        Each sub-node should contain the constraints and initialization
+        information for that regulator. See regulator.txt for a description
+        of standard properties for these sub-nodes.
+        Additional optional custom properties  are listed below.
+                ams,ext-control: External control of the rail. The option of
+                        this properties will tell which external input is
+                        controlling this rail. Valid values are 0, 1, 2 ad 3.
+                        0: There is no external control of this rail.
+                        1: Rail is controlled by ENABLE1 input pin.
+                        2: Rail is controlled by ENABLE2 input pin.
+                        3: Rail is controlled by ENABLE3 input pin.
+                        Missing this property on DT will be assume as no
+                        external control. The external control pin macros
+                        are defined @dt-bindings/mfd/as3722.h
+
+                ams,enable-tracking: Enable tracking with SD1, only supported
+                        by LDO3.
+
+Example:
+--------
+#include <dt-bindings/mfd/as3722.h>
+...
+ams3722 {
+        compatible = "ams,as3722";
+        reg = <0x48>;
+
+        interrupt-parent = <&intc>;
+        interrupt-controller;
+        #interrupt-cells = <2>;
+
+        gpio-controller;
+        #gpio-cells = <2>;
+
+        pinctrl-names = "default";
+        pinctrl-0 = <&as3722_default>;
+
+        as3722_default: pinmux {
+                        gpio0 {
+                                pins = "gpio0";
+                                function = "gpio";
+                                bias-pull-down;
+                        };
+
+                        gpio1_2_4_7 {
+                                pins = "gpio1", "gpio2", "gpio4", "gpio7";
+                                function = "gpio";
+                                bias-pull-up;
+                        };
+
+                        gpio5 {
+                                pins = "gpio5";
+                                function = "clk32k_out";
+                        };
+        }
+
+        regulators {
+                        vsup-sd2-supply = <...>;
+                        ...
+
+                        sd0 {
+                                regulator-name = "vdd_cpu";
+                                regulator-min-microvolt = <700000>;
+                                regulator-max-microvolt = <1400000>;
+                                regulator-always-on;
+                                ams,ext-control = <2>;
+                        };
+
+                        sd1 {
+                                regulator-name = "vdd_core";
+                                regulator-min-microvolt = <700000>;
+                                regulator-max-microvolt = <1400000>;
+                                regulator-always-on;
+                                ams,ext-control = <1>;
+                        };
+
+                        sd2 {
+                                regulator-name = "vddio_ddr";
+                                regulator-min-microvolt = <1350000>;
+                                regulator-max-microvolt = <1350000>;
+                                regulator-always-on;
+                        };
+
+                        sd4 {
+                                regulator-name = "avdd-hdmi-pex";
+                                regulator-min-microvolt = <1050000>;
+                                regulator-max-microvolt = <1050000>;
+                                regulator-always-on;
+                        };
+
+                        sd5 {
+                                regulator-name = "vdd-1v8";
+                                regulator-min-microvolt = <1800000>;
+                                regulator-max-microvolt = <1800000>;
+                                regulator-always-on;
+                        };
+                        ....
+        };
+};