xref: /openbmc/linux/Documentation/devicetree/bindings/mfd/as3711.txt (revision e5451c8f8330e03ad3cfa16048b4daf961af434f)
1*64710af3SGuennadi LiakhovetskiAS3711 is an I2C PMIC from Austria MicroSystems with multiple DCDC and LDO power
2*64710af3SGuennadi Liakhovetskisupplies, a battery charger and an RTC. So far only bindings for the two stepup
3*64710af3SGuennadi LiakhovetskiDCDC converters are defined. Other DCDC and LDO supplies are configured, using
4*64710af3SGuennadi Liakhovetskistandard regulator properties, they must belong to a sub-node, called
5*64710af3SGuennadi Liakhovetski"regulators" and be called "sd1" to "sd4" and "ldo1" to "ldo8." Stepup converter
6*64710af3SGuennadi Liakhovetskiconfiguration should be placed in a subnode, called "backlight."
7*64710af3SGuennadi Liakhovetski
8*64710af3SGuennadi LiakhovetskiCompulsory properties:
9*64710af3SGuennadi Liakhovetski- compatible		: must be "ams,as3711"
10*64710af3SGuennadi Liakhovetski- reg			: specifies the I2C address
11*64710af3SGuennadi Liakhovetski
12*64710af3SGuennadi LiakhovetskiTo use the SU1 converter as a backlight source the following two properties must
13*64710af3SGuennadi Liakhovetskibe provided:
14*64710af3SGuennadi Liakhovetski- su1-dev		: framebuffer phandle
15*64710af3SGuennadi Liakhovetski- su1-max-uA		: maximum current
16*64710af3SGuennadi Liakhovetski
17*64710af3SGuennadi LiakhovetskiTo use the SU2 converter as a backlight source the following two properties must
18*64710af3SGuennadi Liakhovetskibe provided:
19*64710af3SGuennadi Liakhovetski- su2-dev		: framebuffer phandle
20*64710af3SGuennadi Liakhovetski- su1-max-uA		: maximum current
21*64710af3SGuennadi Liakhovetski
22*64710af3SGuennadi LiakhovetskiAdditionally one of these properties must be provided to select the type of
23*64710af3SGuennadi Liakhovetskifeedback used:
24*64710af3SGuennadi Liakhovetski- su2-feedback-voltage	: voltage feedback is used
25*64710af3SGuennadi Liakhovetski- su2-feedback-curr1	: CURR1 input used for current feedback
26*64710af3SGuennadi Liakhovetski- su2-feedback-curr2	: CURR2 input used for current feedback
27*64710af3SGuennadi Liakhovetski- su2-feedback-curr3	: CURR3 input used for current feedback
28*64710af3SGuennadi Liakhovetski- su2-feedback-curr-auto: automatic current feedback selection
29*64710af3SGuennadi Liakhovetski
30*64710af3SGuennadi Liakhovetskiand one of these to select the over-voltage protection pin
31*64710af3SGuennadi Liakhovetski- su2-fbprot-lx-sd4	: LX_SD4 is used for over-voltage protection
32*64710af3SGuennadi Liakhovetski- su2-fbprot-gpio2	: GPIO2 is used for over-voltage protection
33*64710af3SGuennadi Liakhovetski- su2-fbprot-gpio3	: GPIO3 is used for over-voltage protection
34*64710af3SGuennadi Liakhovetski- su2-fbprot-gpio4	: GPIO4 is used for over-voltage protection
35*64710af3SGuennadi Liakhovetski
36*64710af3SGuennadi LiakhovetskiIf "su2-feedback-curr-auto" is selected, one or more of the following properties
37*64710af3SGuennadi Liakhovetskihave to be specified:
38*64710af3SGuennadi Liakhovetski- su2-auto-curr1	: use CURR1 input for current feedback
39*64710af3SGuennadi Liakhovetski- su2-auto-curr2	: use CURR2 input for current feedback
40*64710af3SGuennadi Liakhovetski- su2-auto-curr3	: use CURR3 input for current feedback
41*64710af3SGuennadi Liakhovetski
42*64710af3SGuennadi LiakhovetskiExample:
43*64710af3SGuennadi Liakhovetski
44*64710af3SGuennadi Liakhovetskias3711@40 {
45*64710af3SGuennadi Liakhovetski	compatible = "ams,as3711";
46*64710af3SGuennadi Liakhovetski	reg = <0x40>;
47*64710af3SGuennadi Liakhovetski
48*64710af3SGuennadi Liakhovetski	regulators {
49*64710af3SGuennadi Liakhovetski		sd4 {
50*64710af3SGuennadi Liakhovetski			regulator-name = "1.215V";
51*64710af3SGuennadi Liakhovetski			regulator-min-microvolt = <1215000>;
52*64710af3SGuennadi Liakhovetski			regulator-max-microvolt = <1235000>;
53*64710af3SGuennadi Liakhovetski		};
54*64710af3SGuennadi Liakhovetski		ldo2 {
55*64710af3SGuennadi Liakhovetski			regulator-name = "2.8V CPU";
56*64710af3SGuennadi Liakhovetski			regulator-min-microvolt = <2800000>;
57*64710af3SGuennadi Liakhovetski			regulator-max-microvolt = <2800000>;
58*64710af3SGuennadi Liakhovetski			regulator-always-on;
59*64710af3SGuennadi Liakhovetski			regulator-boot-on;
60*64710af3SGuennadi Liakhovetski		};
61*64710af3SGuennadi Liakhovetski	};
62*64710af3SGuennadi Liakhovetski
63*64710af3SGuennadi Liakhovetski	backlight {
64*64710af3SGuennadi Liakhovetski		compatible = "ams,as3711-bl";
65*64710af3SGuennadi Liakhovetski		su2-dev = <&lcdc>;
66*64710af3SGuennadi Liakhovetski		su2-max-uA = <36000>;
67*64710af3SGuennadi Liakhovetski		su2-feedback-curr-auto;
68*64710af3SGuennadi Liakhovetski		su2-fbprot-gpio4;
69*64710af3SGuennadi Liakhovetski		su2-auto-curr1;
70*64710af3SGuennadi Liakhovetski		su2-auto-curr2;
71*64710af3SGuennadi Liakhovetski		su2-auto-curr3;
72*64710af3SGuennadi Liakhovetski	};
73*64710af3SGuennadi Liakhovetski};
74