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