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