kernel/Documentation/devicetree/bindings/mfd/s2mpa01.txt

   1
   2 * Samsung S2MPA01 Voltage and Current Regulator
   3
   4 The Samsung S2MPA01 is a multi-function device which includes high
   5 efficiency buck converters including Dual-Phase buck converter, various LDOs,
   6 and an RTC. It is interfaced to the host controller using an I2C interface.
   7 Each sub-block is addressed by the host system using different I2C slave
   8 addresses.
   9
  10 Required properties:
  11 - compatible: Should be "samsung,s2mpa01-pmic".
  12 - reg: Specifies the I2C slave address of the PMIC block. It should be 0x66.
  13
  14 Optional properties:
  15 - interrupt-parent: Specifies the phandle of the interrupt controller to which
  16   the interrupts from s2mpa01 are delivered to.
  17 - interrupts: An interrupt specifier for the sole interrupt generated by the
  18   device.
  19
  20 Optional nodes:
  21 - regulators: The regulators of s2mpa01 that have to be instantiated should be
  22   included in a sub-node named 'regulators'. Regulator nodes and constraints
  23   included in this sub-node use the standard regulator bindings which are
  24   documented elsewhere.
  25
  26 Properties for BUCK regulator nodes:
  27 - regulator-ramp-delay: ramp delay in uV/us. May be 6250, 12500
  28   (default), 25000, or 50000. May be 0 for disabling the ramp delay on
  29   BUCK{1,2,3,4}.
  30
  31  In the absence of the regulator-ramp-delay property, the default ramp
  32  delay will be used.
  33
  34   NOTE: Some BUCKs share the ramp rate setting i.e. same ramp value will be set
  35   for a particular group of BUCKs. So provide same regulator-ramp-delay=<value>.
  36
  37   The following BUCKs share ramp settings:
  38   * 1 and 6
  39   * 2 and 4
  40   * 8, 9, and 10
  41
  42 The following are the names of the regulators that the s2mpa01 PMIC block
  43 supports. Note: The 'n' in LDOn and BUCKn represents the LDO or BUCK number
  44 as per the datasheet of s2mpa01.
  45
  46         - LDOn
  47                   - valid values for n are 1 to 26
  48                   - Example: LDO1, LD02, LDO26
  49         - BUCKn
  50                   - valid values for n are 1 to 10.
  51                   - Example: BUCK1, BUCK2, BUCK9
  52
  53 Example:
  54
  55         s2mpa01_pmic@66 {
  56                 compatible = "samsung,s2mpa01-pmic";
  57                 reg = <0x66>;
  58
  59                 regulators {
  60                         ldo1_reg: LDO1 {
  61                                 regulator-name = "VDD_ALIVE";
  62                                 regulator-min-microvolt = <1000000>;
  63                                 regulator-max-microvolt = <1000000>;
  64                         };
  65
  66                         ldo2_reg: LDO2 {
  67                                 regulator-name = "VDDQ_MMC2";
  68                                 regulator-min-microvolt = <2800000>;
  69                                 regulator-max-microvolt = <2800000>;
  70                                 regulator-always-on;
  71                         };
  72
  73                         buck1_reg: BUCK1 {
  74                                 regulator-name = "vdd_mif";
  75                                 regulator-min-microvolt = <950000>;
  76                                 regulator-max-microvolt = <1350000>;
  77                                 regulator-always-on;
  78                                 regulator-boot-on;
  79                         };
  80
  81                         buck2_reg: BUCK2 {
  82                                 regulator-name = "vdd_arm";
  83                                 regulator-min-microvolt = <950000>;
  84                                 regulator-max-microvolt = <1350000>;
  85                                 regulator-always-on;
  86                                 regulator-boot-on;
  87                                 regulator-ramp-delay = <50000>;
  88                         };
  89                 };
  90         };