Merge tag 'for-5.14-rc3-tag' of git://git.kernel.org/pub/scm/linux/kernel/git/kdave...
[linux-2.6-microblaze.git] / Documentation / devicetree / bindings / mfd / wm831x.txt
1 Cirrus Logic/Wolfson Microelectronics wm831x PMICs
2
3 System PMICs with a wide range of additional features.
4
5 Required properties:
6
7   - compatible : One of the following chip-specific strings:
8         "wlf,wm8310"
9         "wlf,wm8311"
10         "wlf,wm8312"
11         "wlf,wm8320"
12         "wlf,wm8321"
13         "wlf,wm8325"
14         "wlf,wm8326"
15
16   - reg : I2C slave address when connected using I2C, chip select number
17     when using SPI.
18
19   - gpio-controller : Indicates this device is a GPIO controller.
20   - #gpio-cells : Must be 2. The first cell is the pin number and the
21     second cell is used to specify optional parameters (currently unused).
22
23   - interrupts : The interrupt line the IRQ signal for the device is
24     connected to.
25
26   - interrupt-controller : wm831x devices contain interrupt controllers and
27     may provide interrupt services to other devices.
28   - #interrupt-cells: Must be 2. The first cell is the IRQ number, and the
29     second cell is the flags, encoded as the trigger masks from
30     ../interrupt-controller/interrupts.txt
31
32 Optional sub-nodes:
33   - phys : Contains a phandle to the USB PHY.
34   - regulators : Contains sub-nodes for each of the regulators supplied by
35     the device. The regulators are bound using their names listed below:
36
37     dcdc1 : DCDC1
38     dcdc2 : DCDC2
39     dcdc3 : DCDC3
40     dcdc4 : DCDC3
41     isink1 : ISINK1
42     isink2 : ISINK2
43     ldo1 : LDO1
44     ldo2 : LDO2
45     ldo3 : LDO3
46     ldo4 : LDO4
47     ldo5 : LDO5
48     ldo7 : LDO7
49     ldo11 : LDO11
50
51     The bindings details of each regulator can be found in:
52     ../regulator/regulator.txt
53
54 Example:
55
56 wm8310: pmic@36 {
57         compatible = "wlf,wm8310";
58         reg = <0x36>;
59
60         gpio-controller;
61         #gpio-cells = <2>;
62
63         interrupts = <347>;
64         interrupt-parent = <&gic>;
65
66         interrupt-controller;
67         #interrupt-cells = <2>;
68
69         regulators {
70                 dcdc1: dcdc1 {
71                         regulator-name = "DCDC1";
72                         regulator-min-microvolt = <600000>;
73                         regulator-max-microvolt = <600000>;
74                 };
75                 ldo1: ldo1 {
76                         regulator-name = "LDO1";
77                         regulator-min-microvolt = <1700000>;
78                         regulator-max-microvolt = <1700000>;
79                 };
80         };
81 };