xref: /OK3568_Linux_fs/u-boot/doc/device-tree-bindings/regulator/sandbox.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunSandbox, PMIC regulators
2*4882a593Smuzhiyun
3*4882a593SmuzhiyunThis device uses two drivers:
4*4882a593Smuzhiyun- drivers/power/pmic/sandbox.c (as parent I/O device)
5*4882a593Smuzhiyun- drivers/power/regulator/sandbox.c (for child regulators)
6*4882a593Smuzhiyun
7*4882a593SmuzhiyunThis file describes the binding info for the REGULATOR driver.
8*4882a593Smuzhiyun
9*4882a593SmuzhiyunFirst, please read the binding info for the PMIC:
10*4882a593Smuzhiyun- doc/device-tree-bindings/pmic/sandbox.txt
11*4882a593Smuzhiyun
12*4882a593SmuzhiyunRequired subnodes:
13*4882a593Smuzhiyun- ldoN { };
14*4882a593Smuzhiyun- buckN { };
15*4882a593Smuzhiyun
16*4882a593SmuzhiyunThe sandbox PMIC can support: ldo1, ldo2, buck1, buck2.
17*4882a593Smuzhiyun
18*4882a593SmuzhiyunFor each PMIC's regulator subnode, there is one required property:
19*4882a593Smuzhiyun- regulator-name: used for regulator uclass platform data '.name'
20*4882a593Smuzhiyun
21*4882a593SmuzhiyunOptional:
22*4882a593Smuzhiyun- regulator-min-microvolt: minimum allowed Voltage to set
23*4882a593Smuzhiyun- regulator-max-microvolt: minimum allowed Voltage to set
24*4882a593Smuzhiyun- regulator-min-microamps: minimum allowed Current limit to set (LDO1/BUCK1)
25*4882a593Smuzhiyun- regulator-max-microamps: minimum allowed Current limit to set (LDO1/BUCK1)
26*4882a593Smuzhiyun- regulator-always-on: regulator should be never disabled
27*4882a593Smuzhiyun- regulator-boot-on: regulator should be enabled by the bootloader
28*4882a593Smuzhiyun
29*4882a593SmuzhiyunExample PMIC's regulator subnodes:
30*4882a593Smuzhiyun
31*4882a593Smuzhiyunldo1 {
32*4882a593Smuzhiyun	regulator-name = "VDD_1.0V";
33*4882a593Smuzhiyun	regulator-min-microvolt = <1000000>;
34*4882a593Smuzhiyun	regulator-max-microvolt = <1200000>;
35*4882a593Smuzhiyun	regulator-min-microamps = <100000>;
36*4882a593Smuzhiyun	regulator-max-microamps = <400000>;
37*4882a593Smuzhiyun	regulator-always-on;
38*4882a593Smuzhiyun};
39*4882a593Smuzhiyun
40*4882a593Smuzhiyunbuck2 {
41*4882a593Smuzhiyun	regulator-name = "VDD_1.8V";
42*4882a593Smuzhiyun	regulator-min-microvolt = <1800000>;
43*4882a593Smuzhiyun	regulator-max-microvolt = <1800000>;
44*4882a593Smuzhiyun	regulator-boot-on;
45*4882a593Smuzhiyun};
46