Documentation/devicetree/bindings/regulator/samsung,s2mps11.txt

   1 Binding for Samsung S2M family regulator block
   2 ==============================================
   3
   4 This is a part of device tree bindings for S2M family multi-function devices.
   5 More information can be found in bindings/mfd/sec-core.txt file.
   6
   7 The S2MPS11/13/14/15 and S2MPU02 devices provide buck and LDO regulators.
   8
   9 To register these with regulator framework instantiate under main device node
  10 a sub-node named "regulators" with more sub-nodes for each regulator using the
  11 common regulator binding documented in:
  12  - Documentation/devicetree/bindings/regulator/regulator.txt
  13
  14
  15 Names of regulators supported by different devices:
  16         - LDOn
  17                   - valid values for n are:
  18                         - S2MPS11: 1 to 38
  19                         - S2MPS13: 1 to 40
  20                         - S2MPS14: 1 to 25
  21                         - S2MPS15: 1 to 27
  22                         - S2MPU02: 1 to 28
  23                   - Example: LDO1, LDO2, LDO28
  24         - BUCKn
  25                   - valid values for n are:
  26                         - S2MPS11: 1 to 10
  27                         - S2MPS13: 1 to 10
  28                         - S2MPS14: 1 to 5
  29                         - S2MPS15: 1 to 10
  30                         - S2MPU02: 1 to 7
  31                   - Example: BUCK1, BUCK2, BUCK9
  32 Note: The 'n' in LDOn and BUCKn represents the LDO or BUCK number
  33 as per the datasheet of device.
  34
  35
  36 Optional properties of the nodes under "regulators" sub-node:
  37  - regulator-ramp-delay: ramp delay in uV/us. May be 6250, 12500,
  38    25000 (default) or 50000.
  39
  40    Additionally S2MPS11 supports disabling ramp delay for BUCK{2,3,4,6}
  41    by setting it to <0>.
  42
  43    Note: On S2MPS11 some bucks share the ramp rate setting i.e. same ramp value
  44    will be set for a particular group of bucks so provide the same
  45    regulator-ramp-delay value for them.
  46    Groups sharing ramp rate:
  47     - buck{1,6},
  48     - buck{3,4},
  49     - buck{7,8,10}.
  50
  51  - samsung,ext-control-gpios: On S2MPS14 the LDO10, LDO11 and LDO12 can be
  52    configured to external control over GPIO. To turn this feature on this
  53    property must be added to the regulator sub-node:
  54     - samsung,ext-control-gpios: GPIO specifier for one GPIO
  55                                  controlling this regulator (enable/disable)
  56   Example:
  57         LDO12 {
  58                 regulator-name = "V_EMMC_2.8V";
  59                 regulator-min-microvolt = <2800000>;
  60                 regulator-max-microvolt = <2800000>;
  61                 samsung,ext-control-gpios = <&gpk0 2 0>;
  62         };
  63
  64
  65 Example:
  66
  67         s2mps11_pmic@66 {
  68                 compatible = "samsung,s2mps11-pmic";
  69                 reg = <0x66>;
  70
  71                 regulators {
  72                         ldo1_reg: LDO1 {
  73                                 regulator-name = "VDD_ABB_3.3V";
  74                                 regulator-min-microvolt = <3300000>;
  75                                 regulator-max-microvolt = <3300000>;
  76                         };
  77
  78                         ldo2_reg: LDO2 {
  79                                 regulator-name = "VDD_ALIVE_1.1V";
  80                                 regulator-min-microvolt = <1100000>;
  81                                 regulator-max-microvolt = <1100000>;
  82                                 regulator-always-on;
  83                         };
  84
  85                         buck1_reg: BUCK1 {
  86                                 regulator-name = "vdd_mif";
  87                                 regulator-min-microvolt = <950000>;
  88                                 regulator-max-microvolt = <1350000>;
  89                                 regulator-always-on;
  90                                 regulator-boot-on;
  91                         };
  92
  93                         buck2_reg: BUCK2 {
  94                                 regulator-name = "vdd_arm";
  95                                 regulator-min-microvolt = <950000>;
  96                                 regulator-max-microvolt = <1350000>;
  97                                 regulator-always-on;
  98                                 regulator-boot-on;
  99                                 regulator-ramp-delay = <50000>;
 100                         };
 101                 };
 102         };