1Regulator DT binding for MAX77620 Power management IC from Maxim Semiconductor. 2 3Device has multiple DCDC(sd[0-3] and LDOs(ldo[0-8]). The input supply 4of these regulators are defined under parent device node. 5Details of regulator properties are defined as child node under 6sub-node "regulators" which is child node of device node. 7 8Please refer file <Documentation/devicetree/bindings/regulator/regulator.txt> 9for common regulator bindings used by client. 10 11Following are properties of parent node related to regulators. 12 13Optional properties: 14------------------- 15The input supply of regulators are the optional properties on the 16parent device node. The input supply of these regulators are provided 17through following properties: 18in-sd0-supply: Input supply for SD0, INA-SD0 or INB-SD0 pins. 19in-sd1-supply: Input supply for SD1. 20in-sd2-supply: Input supply for SD2. 21in-sd3-supply: Input supply for SD3. 22in-ldo0-1-supply: Input supply for LDO0 and LDO1. 23in-ldo2-supply: Input supply for LDO2. 24in-ldo3-5-supply: Input supply for LDO3 and LDO5 25in-ldo4-6-supply: Input supply for LDO4 and LDO6. 26in-ldo7-8-supply: Input supply for LDO7 and LDO8. 27 28Optional sub nodes for regulators under "regulators" subnode: 29------------------------------------------------------------ 30The subnodes name is the name of regulator and it must be one of: 31 sd[0-3], ldo[0-8] 32 33Each sub-node should contain the constraints and initialization 34information for that regulator. The definition for each of these 35nodes is defined using the standard binding for regulators found at 36<Documentation/devicetree/bindings/regulator/regulator.txt>. 37 38There are also additional properties for SD/LDOs. These additional properties 39are required to configure FPS configuration parameters for SDs and LDOs. 40Please refer <devicetree/bindings/mfd/max77620.txt> for more detail of Flexible 41Power Sequence (FPS). 42Following are additional properties: 43 44- maxim,active-fps-source: FPS source for the regulators to get 45 enabled/disabled when system is in 46 active state. Valid values are: 47 - MAX77620_FPS_SRC_0, 48 FPS source is FPS0. 49 - MAX77620_FPS_SRC_1, 50 FPS source is FPS1 51 - MAX77620_FPS_SRC_2 and 52 FPS source is FPS2 53 - MAX77620_FPS_SRC_NONE. 54 Regulator is not controlled 55 by FPS events and it gets 56 enabled/disabled by register 57 access. 58 Absence of this property will leave 59 the FPS configuration register for that 60 regulator to default configuration. 61 62- maxim,active-fps-power-up-slot: Sequencing event slot number on which 63 the regulator get enabled when 64 master FPS input event set to HIGH. 65 Valid values are 0 to 7. 66 This is applicable if FPS source is 67 selected as FPS0, FPS1 or FPS2. 68 69- maxim,active-fps-power-down-slot: Sequencing event slot number on which 70 the regulator get disabled when master 71 FPS input event set to LOW. 72 Valid values are 0 to 7. 73 This is applicable if FPS source is 74 selected as FPS0, FPS1 or FPS2. 75 76- maxim,suspend-fps-source: This is same as property 77 "maxim,active-fps-source" but value 78 get configured when system enters in 79 to suspend state. 80 81- maxim,suspend-fps-power-up-slot: This is same as property 82 "maxim,active-fps-power-up-slot" but 83 this value get configured into FPS 84 configuration register when system 85 enters into suspend. 86 This is applicable if suspend state 87 FPS source is selected as FPS0, FPS1 or 88 89- maxim,suspend-fps-power-down-slot: This is same as property 90 "maxim,active-fps-power-down-slot" but 91 this value get configured into FPS 92 configuration register when system 93 enters into suspend. 94 This is applicable if suspend state 95 FPS source is selected as FPS0, FPS1 or 96 FPS2. 97- maxim,ramp-rate-setting: integer, ramp rate(uV/us) setting to be 98 configured to the device. 99 The platform may have different ramp 100 rate than advertised ramp rate if it has 101 design variation from Maxim's 102 recommended. On this case, platform 103 specific ramp rate is used for ramp time 104 calculation and this property is used 105 for device register configurations. 106 The measured ramp rate of platform is 107 provided by the regulator-ramp-delay 108 as described in <devicetree/bindings/ 109 regulator/regulator.txt>. 110 Maxim Max77620 supports following ramp 111 delay: 112 SD: 13.75mV/us, 27.5mV/us, 55mV/us 113 LDOs: 5mV/us, 100mV/us 114 115Note: If the measured ramp delay is same as advertised ramp delay then it is not 116required to provide the ramp delay with property "maxim,ramp-rate-setting". The 117ramp rate can be provided by the regulator-ramp-delay which will be used for 118ramp time calculation for voltage change as well as for device configuration. 119 120Example: 121-------- 122#include <dt-bindings/mfd/max77620.h> 123... 124max77620@3c { 125 in-ldo0-1-supply = <&max77620_sd2>; 126 in-ldo7-8-supply = <&max77620_sd2>; 127 regulators { 128 sd0 { 129 regulator-name = "vdd-core"; 130 regulator-min-microvolt = <600000>; 131 regulator-max-microvolt = <1400000>; 132 regulator-boot-on; 133 regulator-always-on; 134 maxim,active-fps-source = <MAX77620_FPS_SRC_1>; 135 }; 136 137 sd1 { 138 regulator-name = "vddio-ddr"; 139 regulator-min-microvolt = <1200000>; 140 regulator-max-microvolt = <1200000>; 141 regulator-always-on; 142 regulator-boot-on; 143 maxim,active-fps-source = <MAX77620_FPS_SRC_0>; 144 }; 145 146 sd2 { 147 regulator-name = "vdd-pre-reg"; 148 regulator-min-microvolt = <1350000>; 149 regulator-max-microvolt = <1350000>; 150 }; 151 152 sd3 { 153 regulator-name = "vdd-1v8"; 154 regulator-min-microvolt = <1800000>; 155 regulator-max-microvolt = <1800000>; 156 regulator-always-on; 157 regulator-boot-on; 158 }; 159 160 ldo0 { 161 regulator-name = "avdd-sys"; 162 regulator-min-microvolt = <1200000>; 163 regulator-max-microvolt = <1200000>; 164 regulator-always-on; 165 regulator-boot-on; 166 }; 167 168 ldo1 { 169 regulator-name = "vdd-pex"; 170 regulator-min-microvolt = <1050000>; 171 regulator-max-microvolt = <1050000>; 172 }; 173 174 ldo2 { 175 regulator-name = "vddio-sdmmc3"; 176 regulator-min-microvolt = <1800000>; 177 regulator-max-microvolt = <3300000>; 178 }; 179 180 ldo3 { 181 regulator-name = "vdd-cam-hv"; 182 regulator-min-microvolt = <2800000>; 183 regulator-max-microvolt = <2800000>; 184 }; 185 186 ldo4 { 187 regulator-name = "vdd-rtc"; 188 regulator-min-microvolt = <1250000>; 189 regulator-max-microvolt = <1250000>; 190 regulator-always-on; 191 regulator-boot-on; 192 }; 193 194 ldo5 { 195 regulator-name = "avdd-ts-hv"; 196 regulator-min-microvolt = <3000000>; 197 regulator-max-microvolt = <3000000>; 198 }; 199 200 ldo6 { 201 regulator-name = "vdd-ts"; 202 regulator-min-microvolt = <1800000>; 203 regulator-max-microvolt = <1800000>; 204 regulator-always-on; 205 regulator-boot-on; 206 }; 207 208 ldo7 { 209 regulator-name = "vdd-gen-pll-edp"; 210 regulator-min-microvolt = <1050000>; 211 regulator-max-microvolt = <1050000>; 212 regulator-always-on; 213 regulator-boot-on; 214 }; 215 216 ldo8 { 217 regulator-name = "vdd-hdmi-dp"; 218 regulator-min-microvolt = <1050000>; 219 regulator-max-microvolt = <1050000>; 220 }; 221 }; 222}; 223