xref: /freebsd/sys/contrib/device-tree/Bindings/mfd/wm831x.txt (revision e0c4386e7e71d93b0edc0c8fa156263fc4a8b0b6)
1Cirrus Logic/Wolfson Microelectronics wm831x PMICs
2
3System PMICs with a wide range of additional features.
4
5Required 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
32Optional 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
54Example:
55
56wm8310: 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};
82