Unverified Commit 60704710 authored by Stanislav Jakubek's avatar Stanislav Jakubek Committed by Mark Brown
Browse files

dt-bindings: regulator: sprd,sc2731-regulator: convert to YAML 

Convert the Spreadtrum SC2731 regulator bindings to DT schema.

Change during conversion:
  - switch compatible from sprd,sc27xx-regulator to sprd,sc2731-regulator,
    same as the only in-tree user has done back in 2019 [1]

[1] https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/arch/arm64/boot/dts/sprd/sc2731.dtsi?h=v6.9&id=0419a75b1808dda225b17ba1509f195f23c0db88



Signed-off-by: default avatarStanislav Jakubek <stano.jakubek@gmail.com>
Reviewed-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://patch.msgid.link/ZobxoobZvA8k3pyi@standask-GA-A55M-S2HP


Signed-off-by: default avatarMark Brown <broonie@kernel.org>
parent 32d11710

Documentation/devicetree/bindings/regulator/sprd,sc2731-regulator.txt

deleted100644 → 0
+0 −43
Original line number Diff line number Diff line 
Spreadtrum SC2731 Voltage regulators



The SC2731 integrates low-voltage and low quiescent current DCDC/LDO.

14 LDO and 3 DCDCs are designed for external use. All DCDCs/LDOs have

their own bypass (power-down) control signals. External tantalum or MLCC

ceramic capacitors are recommended to use with these LDOs.



Required properties:

 - compatible: should be "sprd,sc27xx-regulator".



List of regulators provided by this controller. It is named according to

its regulator type, BUCK_<name> and LDO_<name>. The definition for each

of these nodes is defined using the standard binding for regulators at

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



The valid names for regulators are:

BUCK:

	BUCK_CPU0, BUCK_CPU1, BUCK_RF

LDO:

	LDO_CAMA0, LDO_CAMA1, LDO_CAMMOT, LDO_VLDO, LDO_EMMCCORE, LDO_SDCORE,

	LDO_SDIO, LDO_WIFIPA, LDO_USB33, LDO_CAMD0, LDO_CAMD1, LDO_CON,

	LDO_CAMIO, LDO_SRAM



Example:

	regulators {

		compatible = "sprd,sc27xx-regulator";



		vddarm0: BUCK_CPU0 {

			regulator-name = "vddarm0";

			regulator-min-microvolt = <400000>;

			regulator-max-microvolt = <1996875>;

			regulator-ramp-delay = <25000>;

			regulator-always-on;

		};



		vddcama0: LDO_CAMA0 {

			regulator-name = "vddcama0";

			regulator-min-microvolt = <1200000>;

			regulator-max-microvolt = <3750000>;

			regulator-enable-ramp-delay = <100>;

		};

		...

	};

Documentation/devicetree/bindings/regulator/sprd,sc2731-regulator.yaml

0 → 100644
+67 −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/sprd,sc2731-regulator.yaml#

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



title: Spreadtrum SC2731 Power Management IC regulators



maintainers:

  - Orson Zhai <orsonzhai@gmail.com>

  - Baolin Wang <baolin.wang7@gmail.com>

  - Chunyan Zhang <zhang.lyra@gmail.com>



description: |

  The SC2731 integrates low-voltage and low quiescent current DCDC/LDO.

  14 LDO and 3 DCDCs are designed for external use. All DCDCs/LDOs have

  their own bypass (power-down) control signals. It is recommended to use

  external tantalum or MLCC ceramic capacitors with these LDOs.

  Valid names for the regulators are:

    BUCK:

      BUCK_CPU0, BUCK_CPU1, BUCK_RF

    LDO:

      LDO_CAMA0, LDO_CAMA1, LDO_CAMD0, LDO_CAMD1, LDO_CAMIO, LDO_CAMMOT,

      LDO_CON, LDO_EMMCCORE, LDO_SDCORE, LDO_SDIO, LDO_SRAM, LDO_USB33,

      LDO_VLDO, LDO_WIFIPA



properties:

  compatible:

    const: sprd,sc2731-regulator



patternProperties:

  "^BUCK_(CPU[0-1]|RF)$":

    type: object

    $ref: regulator.yaml#

    unevaluatedProperties: false



  "^LDO_(CAM(A0|A1|D0|D1|IO|MOT)|CON|EMMCCORE|SD(CORE|IO)|SRAM|USB33|VLDO|WIFIPA)$":

    type: object

    $ref: regulator.yaml#

    unevaluatedProperties: false



required:

  - compatible



additionalProperties: false



examples:

  - |

    regulators {

      compatible = "sprd,sc2731-regulator";



      BUCK_CPU0 {

        regulator-name = "vddarm0";

        regulator-min-microvolt = <400000>;

        regulator-max-microvolt = <1996875>;

        regulator-ramp-delay = <25000>;

        regulator-always-on;

      };



      LDO_CAMA0 {

        regulator-name = "vddcama0";

        regulator-min-microvolt = <1200000>;

        regulator-max-microvolt = <3750000>;

        regulator-enable-ramp-delay = <100>;

      };

    };

...