Unverified Commit ea98b9eb authored by Krzysztof Kozlowski's avatar Krzysztof Kozlowski Committed by Mark Brown
Browse files

regulator: dt-bindings: samsung,s2m: convert to dtschema 



Convert the regulators of Samsung
S2MPS11/S2MPS13/S2MPS14/S2MPS15/S2MPU02 family of PMICs to DT schema
format.

Signed-off-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Message-Id: <20211008113931.134847-1-krzysztof.kozlowski@canonical.com>
Signed-off-by: default avatarMark Brown <broonie@kernel.org>
parent 1790cd35

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

deleted100644 → 0
+0 −102
Original line number Diff line number Diff line 
Binding for Samsung S2M family regulator block

==============================================



This is a part of device tree bindings for S2M family multi-function devices.

More information can be found in bindings/mfd/sec-core.txt file.



The S2MPS11/13/14/15 and S2MPU02 devices provide buck and LDO regulators.



To register these with regulator framework instantiate under main device node

a sub-node named "regulators" with more sub-nodes for each regulator using the

common regulator binding documented in:

 - Documentation/devicetree/bindings/regulator/regulator.txt





Names of regulators supported by different devices:

	- LDOn

		  - valid values for n are:

			- S2MPS11: 1 to 38

			- S2MPS13: 1 to 40

			- S2MPS14: 1 to 25

			- S2MPS15: 1 to 27

			- S2MPU02: 1 to 28

		  - Example: LDO1, LDO2, LDO28

	- BUCKn

		  - valid values for n are:

			- S2MPS11: 1 to 10

			- S2MPS13: 1 to 10

			- S2MPS14: 1 to 5

			- S2MPS15: 1 to 10

			- S2MPU02: 1 to 7

		  - Example: BUCK1, BUCK2, BUCK9

Note: The 'n' in LDOn and BUCKn represents the LDO or BUCK number

as per the datasheet of device.





Optional properties of the nodes under "regulators" sub-node:

 - regulator-ramp-delay: ramp delay in uV/us. May be 6250, 12500,

   25000 (default) or 50000.



   Additionally S2MPS11 supports disabling ramp delay for BUCK{2,3,4,6}

   by setting it to <0>.



   Note: On S2MPS11 some bucks share the ramp rate setting i.e. same ramp value

   will be set for a particular group of bucks so provide the same

   regulator-ramp-delay value for them.

   Groups sharing ramp rate:

    - buck{1,6},

    - buck{3,4},

    - buck{7,8,10}.



 - samsung,ext-control-gpios: On S2MPS14 the LDO10, LDO11 and LDO12 can be

   configured to external control over GPIO. To turn this feature on this

   property must be added to the regulator sub-node:

    - samsung,ext-control-gpios: GPIO specifier for one GPIO

                                 controlling this regulator (enable/disable)

  Example:

	LDO12 {

		regulator-name = "V_EMMC_2.8V";

		regulator-min-microvolt = <2800000>;

		regulator-max-microvolt = <2800000>;

		samsung,ext-control-gpios = <&gpk0 2 0>;

	};





Example:



	s2mps11_pmic@66 {

		compatible = "samsung,s2mps11-pmic";

		reg = <0x66>;



		regulators {

			ldo1_reg: LDO1 {

				regulator-name = "VDD_ABB_3.3V";

				regulator-min-microvolt = <3300000>;

				regulator-max-microvolt = <3300000>;

			};



			ldo2_reg: LDO2 {

				regulator-name = "VDD_ALIVE_1.1V";

				regulator-min-microvolt = <1100000>;

				regulator-max-microvolt = <1100000>;

				regulator-always-on;

			};



			buck1_reg: BUCK1 {

				regulator-name = "vdd_mif";

				regulator-min-microvolt = <950000>;

				regulator-max-microvolt = <1350000>;

				regulator-always-on;

				regulator-boot-on;

			};



			buck2_reg: BUCK2 {

				regulator-name = "vdd_arm";

				regulator-min-microvolt = <950000>;

				regulator-max-microvolt = <1350000>;

				regulator-always-on;

				regulator-boot-on;

				regulator-ramp-delay = <50000>;

			};

		};

	};

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

0 → 100644
+44 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause

%YAML 1.2

---

$id: http://devicetree.org/schemas/regulator/samsung,s2mps11.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Samsung S2MPS11 Power Management IC regulators



maintainers:

  - Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>



description: |

  This is a part of device tree bindings for S2M and S5M family of Power

  Management IC (PMIC).



  The S2MPS11 provides buck and LDO regulators.



  See also Documentation/devicetree/bindings/mfd/samsung,s2mps11.yaml for

  additional information and example.



patternProperties:

  # 38 LDOs

  "^LDO([1-9]|[1-2][0-9]|3[0-8])$":

    type: object

    $ref: regulator.yaml#

    unevaluatedProperties: false

    description:

      Properties for single LDO regulator.



    required:

      - regulator-name



  # 10 bucks

  "^BUCK([1-9]|10)$":

    type: object

    $ref: regulator.yaml#

    unevaluatedProperties: false

    description:

      Properties for single BUCK regulator.



    required:

      - regulator-name



additionalProperties: false

Documentation/devicetree/bindings/regulator/samsung,s2mps13.yaml

0 → 100644
+44 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause

%YAML 1.2

---

$id: http://devicetree.org/schemas/regulator/samsung,s2mps13.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Samsung S2MPS13 Power Management IC regulators



maintainers:

  - Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>



description: |

  This is a part of device tree bindings for S2M and S5M family of Power

  Management IC (PMIC).



  The S2MPS13 provides buck and LDO regulators.



  See also Documentation/devicetree/bindings/mfd/samsung,s2mps11.yaml for

  additional information and example.



patternProperties:

  # 40 LDOs

  "^LDO([1-9]|[1-3][0-9]|40)$":

    type: object

    $ref: regulator.yaml#

    unevaluatedProperties: false

    description:

      Properties for single LDO regulator.



    required:

      - regulator-name



  # 10 bucks

  "^BUCK([1-9]|10)$":

    type: object

    $ref: regulator.yaml#

    unevaluatedProperties: false

    description:

      Properties for single BUCK regulator.



    required:

      - regulator-name



additionalProperties: false

Documentation/devicetree/bindings/regulator/samsung,s2mps14.yaml

0 → 100644
+44 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause

%YAML 1.2

---

$id: http://devicetree.org/schemas/regulator/samsung,s2mps14.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Samsung S2MPS14 Power Management IC regulators



maintainers:

  - Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>



description: |

  This is a part of device tree bindings for S2M and S5M family of Power

  Management IC (PMIC).



  The S2MPS14 provides buck and LDO regulators.



  See also Documentation/devicetree/bindings/mfd/samsung,s2mps11.yaml for

  additional information and example.



patternProperties:

  # 25 LDOs

  "^LDO([1-9]|[1][0-9]|2[0-5])$":

    type: object

    $ref: regulator.yaml#

    unevaluatedProperties: false

    description:

      Properties for single LDO regulator.



    required:

      - regulator-name



  # 5 bucks

  "^BUCK[1-5]$":

    type: object

    $ref: regulator.yaml#

    unevaluatedProperties: false

    description:

      Properties for single BUCK regulator.



    required:

      - regulator-name



additionalProperties: false

Documentation/devicetree/bindings/regulator/samsung,s2mps15.yaml

0 → 100644
+44 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause

%YAML 1.2

---

$id: http://devicetree.org/schemas/regulator/samsung,s2mps15.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Samsung S2MPS15 Power Management IC regulators



maintainers:

  - Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>



description: |

  This is a part of device tree bindings for S2M and S5M family of Power

  Management IC (PMIC).



  The S2MPS15 provides buck and LDO regulators.



  See also Documentation/devicetree/bindings/mfd/samsung,s2mps11.yaml for

  additional information and example.



patternProperties:

  # 27 LDOs

  "^LDO([1-9]|[1][0-9]|2[0-7])$":

    type: object

    $ref: regulator.yaml#

    unevaluatedProperties: false

    description:

      Properties for single LDO regulator.



    required:

      - regulator-name



  # 10 bucks

  "^BUCK([1-9]|10)$":

    type: object

    $ref: regulator.yaml#

    unevaluatedProperties: false

    description:

      Properties for single BUCK regulator.



    required:

      - regulator-name



additionalProperties: false