| Yadwinder Singh Brar | aa32aca | 2013-06-29 18:21:20 +0530 | [diff] [blame^] | 1 | |
| 2 | * Samsung S2MPS11 Voltage and Current Regulator |
| 3 | |
| 4 | The Samsung S2MP211 is a multi-function device which includes voltage and |
| 5 | current regulators, RTC, charger controller and other sub-blocks. It is |
| 6 | interfaced to the host controller using a I2C interface. Each sub-block is |
| 7 | addressed by the host system using different I2C slave address. |
| 8 | |
| 9 | Required properties: |
| 10 | - compatible: Should be "samsung,s2mps11-pmic". |
| 11 | - reg: Specifies the I2C slave address of the pmic block. It should be 0x66. |
| 12 | |
| 13 | Optional properties: |
| 14 | - interrupt-parent: Specifies the phandle of the interrupt controller to which |
| 15 | the interrupts from s2mps11 are delivered to. |
| 16 | - interrupts: Interrupt specifiers for interrupt sources. |
| 17 | |
| 18 | Optional nodes: |
| 19 | - regulators: The regulators of s2mps11 that have to be instantiated should be |
| 20 | included in a sub-node named 'regulators'. Regulator nodes included in this |
| 21 | sub-node should be of the format as listed below. |
| 22 | |
| 23 | regulator_name { |
| 24 | [standard regulator constraints....]; |
| 25 | }; |
| 26 | |
| 27 | regulator-ramp-delay for BUCKs = [6250/12500/25000(default)/50000] uV/us |
| 28 | |
| 29 | BUCK[2/3/4/6] supports disabling ramp delay on hardware, so explictly |
| 30 | regulator-ramp-delay = <0> can be used for them to disable ramp delay. |
| 31 | In absence of regulator-ramp-delay property, default ramp delay will be used. |
| 32 | |
| 33 | NOTE: Some BUCKs share the ramp rate setting i.e. same ramp value will be set |
| 34 | for a particular group of BUCKs. So provide same regulator-ramp-delay<value>. |
| 35 | Grouping of BUCKs sharing ramp rate setting is as follow : BUCK[1, 6], |
| 36 | BUCK[3, 4], and BUCK[7, 8, 10] |
| 37 | |
| 38 | The regulator constraints inside the regulator nodes use the standard regulator |
| 39 | bindings which are documented elsewhere. |
| 40 | |
| 41 | The following are the names of the regulators that the s2mps11 pmic block |
| 42 | supports. Note: The 'n' in LDOn and BUCKn represents the LDO or BUCK number |
| 43 | as per the datasheet of s2mps11. |
| 44 | |
| 45 | - LDOn |
| 46 | - valid values for n are 1 to 28 |
| 47 | - Example: LDO0, LD01, LDO28 |
| 48 | - BUCKn |
| 49 | - valid values for n are 1 to 9. |
| 50 | - Example: BUCK1, BUCK2, BUCK9 |
| 51 | |
| 52 | Example: |
| 53 | |
| 54 | s2mps11_pmic@66 { |
| 55 | compatible = "samsung,s2mps11-pmic"; |
| 56 | reg = <0x66>; |
| 57 | |
| 58 | regulators { |
| 59 | ldo1_reg: LDO1 { |
| 60 | regulator-name = "VDD_ABB_3.3V"; |
| 61 | regulator-min-microvolt = <3300000>; |
| 62 | regulator-max-microvolt = <3300000>; |
| 63 | }; |
| 64 | |
| 65 | ldo2_reg: LDO2 { |
| 66 | regulator-name = "VDD_ALIVE_1.1V"; |
| 67 | regulator-min-microvolt = <1100000>; |
| 68 | regulator-max-microvolt = <1100000>; |
| 69 | regulator-always-on; |
| 70 | }; |
| 71 | |
| 72 | buck1_reg: BUCK1 { |
| 73 | regulator-name = "vdd_mif"; |
| 74 | regulator-min-microvolt = <950000>; |
| 75 | regulator-max-microvolt = <1350000>; |
| 76 | regulator-always-on; |
| 77 | regulator-boot-on; |
| 78 | }; |
| 79 | |
| 80 | buck2_reg: BUCK2 { |
| 81 | regulator-name = "vdd_arm"; |
| 82 | regulator-min-microvolt = <950000>; |
| 83 | regulator-max-microvolt = <1350000>; |
| 84 | regulator-always-on; |
| 85 | regulator-boot-on; |
| 86 | regulator-ramp-delay = <50000>; |
| 87 | }; |
| 88 | }; |
| 89 | }; |