linux/Documentation/devicetree/bindings/regulator/lp872x.txt
<<
>>
Prefs
   1Binding for TI/National Semiconductor LP872x Driver
   2
   3Required properties:
   4  - compatible: "ti,lp8720" or "ti,lp8725"
   5  - reg: I2C slave address. 0x7d = LP8720, 0x7a = LP8725
   6
   7Optional properties:
   8  - ti,general-config: the value of LP872X_GENERAL_CFG register (u8)
   9    (LP8720)
  10    bit[2]: BUCK output voltage control by external DVS pin or register
  11            1 = external pin, 0 = bit7 of register 08h
  12    bit[1]: sleep control by external DVS pin or register
  13            1 = external pin, 0 = bit6 of register 08h
  14    bit[0]: time step unit(usec). 1 = 25, 0 = 50
  15
  16    (LP8725)
  17    bit[7:6]: time step unit(usec). 00 = 32, 01 = 64, 10 = 128, 11 = 256
  18    bit[4]:   BUCK2 enable control. 1 = enable, 0 = disable
  19    bit[3]:   BUCK2 output voltage register address. 1 = 0Ah, 0 = 0Bh
  20    bit[2]:   BUCK1 output voltage control by external DVS pin or register
  21              1 = register 08h, 0 = DVS
  22    bit[1]:   LDO sleep control. 1 = sleep mode, 0 = normal
  23    bit[0]:   BUCK1 enable control, 1 = enable, 0 = disable
  24
  25    For more details, please see the datasheet.
  26
  27  - ti,update-config: define it when LP872X_GENERAL_CFG register should be set
  28  - ti,dvs-gpio: GPIO specifier for external DVS pin control of LP872x devices.
  29  - ti,dvs-vsel: DVS selector. 0 = SEL_V1, 1 = SEL_V2.
  30  - ti,dvs-state: initial DVS pin state. 0 = DVS_LOW, 1 = DVS_HIGH.
  31
  32  Sub nodes for regulator_init_data
  33    LP8720 has maximum 6 nodes. (child name: ldo1 ~ 5 and buck)
  34    LP8725 has maximum 9 nodes. (child name: ldo1 ~ 5, lilo1,2 and buck1,2)
  35    For more details, please see the following binding document.
  36    (Documentation/devicetree/bindings/regulator/regulator.txt)
  37
  38Datasheet
  39  - LP8720: http://www.ti.com/lit/ds/symlink/lp8720.pdf
  40  - LP8725: http://www.ti.com/lit/ds/symlink/lp8725.pdf
  41
  42Example 1) LP8720
  43
  44lp8720@7d {
  45        compatible = "ti,lp8720";
  46        reg = <0x7d>;
  47
  48        /* external DVS pin used, timestep is 25usec */
  49        ti,general-config = /bits/ 8 <0x03>;
  50        ti,update-config;
  51
  52        /*
  53         * The dvs-gpio depends on the processor environment.
  54         * For example, following GPIO specifier means GPIO134 in OMAP4.
  55         */
  56        ti,dvs-gpio = <&gpio5 6 0>;
  57        ti,dvs-vsel = /bits/ 8 <1>;             /* SEL_V2 */
  58        ti,dvs-state = /bits/ 8 <1>;            /* DVS_HIGH */
  59
  60        vaf: ldo1 {
  61                regulator-min-microvolt = <1200000>;
  62                regulator-max-microvolt = <3300000>;
  63        };
  64
  65        vmmc: ldo2 {
  66                regulator-min-microvolt = <1200000>;
  67                regulator-max-microvolt = <3300000>;
  68        };
  69
  70        vcam_io: ldo3 {
  71                regulator-min-microvolt = <1200000>;
  72                regulator-max-microvolt = <3300000>;
  73                regulator-boot-on;
  74        };
  75
  76        vcam_core: ldo4 {
  77                regulator-min-microvolt = <800000>;
  78                regulator-max-microvolt = <2850000>;
  79                regulator-boot-on;
  80        };
  81
  82        vcam: ldo5 {
  83                regulator-min-microvolt = <1200000>;
  84                regulator-max-microvolt = <3300000>;
  85        };
  86
  87        vcc: buck {
  88                regulator-name = "VBUCK";
  89                regulator-min-microvolt = <800000>;
  90                regulator-max-microvolt = <2300000>;
  91        };
  92};
  93
  94Example 2) LP8725
  95
  96lp8725@7a {
  97        compatible = "ti,lp8725";
  98        reg = <0x7a>;
  99
 100        /* Enable BUCK1,2, no DVS, normal LDO mode, timestep is 256usec */
 101        ti,general-config = /bits/ 8 <0xdd>;
 102        ti,update-config;
 103
 104        vcam_io: ldo1 {
 105                regulator-min-microvolt = <1200000>;
 106                regulator-max-microvolt = <3300000>;
 107        };
 108
 109        vcam_core: ldo2 {
 110                regulator-min-microvolt = <1200000>;
 111                regulator-max-microvolt = <3300000>;
 112        };
 113
 114        vcam: ldo3 {
 115                regulator-min-microvolt = <1200000>;
 116                regulator-max-microvolt = <3300000>;
 117        };
 118
 119        vcmmb_io: ldo4 {
 120                regulator-min-microvolt = <1200000>;
 121                regulator-max-microvolt = <3300000>;
 122                regulator-boot-on;
 123        };
 124
 125        vcmmb_core: ldo5 {
 126                regulator-min-microvolt = <1200000>;
 127                regulator-max-microvolt = <3300000>;
 128                regulator-boot-on;
 129        };
 130
 131        vaux1: lilo1 {
 132                regulator-name = "VAUX1";
 133                regulator-min-microvolt = <800000>;
 134                regulator-max-microvolt = <3300000>;
 135        };
 136
 137        vaux2: lilo2 {
 138                regulator-name = "VAUX2";
 139                regulator-min-microvolt = <800000>;
 140                regulator-max-microvolt = <3300000>;
 141        };
 142
 143        vcc1: buck1 {
 144                regulator-name = "VBUCK1";
 145                regulator-min-microvolt = <800000>;
 146                regulator-max-microvolt = <3000000>;
 147                regulator-min-microamp  = <460000>;
 148                regulator-max-microamp  = <1370000>;
 149                regulator-boot-on;
 150        };
 151
 152        vcc2: buck2 {
 153                regulator-name = "VBUCK2";
 154                regulator-min-microvolt = <800000>;
 155                regulator-max-microvolt = <3000000>;
 156                regulator-min-microamp  = <460000>;
 157                regulator-max-microamp  = <1370000>;
 158                regulator-boot-on;
 159        };
 160};
 161