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

regulator: dt-bindings: dlg,slg51000: Convert to DT schema



Convert the bindings for Dialog Semiconductor SLG51000 Voltage Regulator
to DT schema.

Signed-off-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://lore.kernel.org/r/20230727085434.16596-1-krzysztof.kozlowski@linaro.org


Signed-off-by: default avatarMark Brown <broonie@kernel.org>
parent d2d54819
Loading
Loading
Loading
Loading
+132 −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/dlg,slg51000.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Dialog Semiconductor SLG51000 Voltage Regulator

maintainers:
  - Eric Jeong <eric.jeong.opensource@diasemi.com>
  - Support Opensource <support.opensource@diasemi.com>

properties:
  compatible:
    const: dlg,slg51000

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  dlg,cs-gpios:
    maxItems: 1
    description:
      GPIO for chip select

  vin3-supply:
    description:
      Input supply for ldo3, required if regulator is enabled

  vin4-supply:
    description:
      Input supply for ldo4, required if regulator is enabled

  vin5-supply:
    description:
      Input supply for ldo5, required if regulator is enabled

  vin6-supply:
    description:
      Input supply for ldo6, required if regulator is enabled

  vin7-supply:
    description:
      Input supply for ldo7, required if regulator is enabled

  regulators:
    type: object
    additionalProperties: false

    patternProperties:
      "^ldo[1-7]$":
        type: object
        $ref: /schemas/regulator/regulator.yaml#
        unevaluatedProperties: false

        properties:
          enable-gpios:
            maxItems: 1

        required:
          - regulator-name

required:
  - compatible
  - reg
  - regulators

additionalProperties: false

examples:
  - |
    #include <dt-bindings/gpio/gpio.h>
    #include <dt-bindings/interrupt-controller/irq.h>
    #include <dt-bindings/regulator/dlg,da9121-regulator.h>
    i2c {
        #address-cells = <1>;
        #size-cells = <0>;

        pmic@75 {
            compatible = "dlg,slg51000";
            reg = <0x75>;
            dlg,cs-gpios = <&tlmm 69 GPIO_ACTIVE_HIGH>;
            vin5-supply = <&vreg_s1f_1p2>;
            vin6-supply = <&vreg_s1f_1p2>;

            regulators {
                ldo1 {
                    regulator-name = "slg51000_b_ldo1";
                    regulator-min-microvolt = <2400000>;
                    regulator-max-microvolt = <3300000>;
                };

                ldo2 {
                    regulator-name = "slg51000_b_ldo2";
                    regulator-min-microvolt = <2400000>;
                    regulator-max-microvolt = <3300000>;
                };

                ldo3 {
                    regulator-name = "slg51000_b_ldo3";
                    regulator-min-microvolt = <1200000>;
                    regulator-max-microvolt = <3750000>;
                };

                ldo4 {
                    regulator-name = "slg51000_b_ldo4";
                    regulator-min-microvolt = <1200000>;
                    regulator-max-microvolt = <3750000>;
                };

                ldo5 {
                    regulator-name = "slg51000_b_ldo5";
                    regulator-min-microvolt = <500000>;
                    regulator-max-microvolt = <1200000>;
                };

                ldo6 {
                    regulator-name = "slg51000_b_ldo6";
                    regulator-min-microvolt = <500000>;
                    regulator-max-microvolt = <1200000>;
                };

                ldo7 {
                    regulator-name = "slg51000_b_ldo7";
                    regulator-min-microvolt = <1200000>;
                    regulator-max-microvolt = <3750000>;
                };
            };
        };
    };
+0 −88
Original line number Diff line number Diff line
* Dialog Semiconductor SLG51000 Voltage Regulator

Required properties:
- compatible : Should be "dlg,slg51000" for SLG51000
- reg : Specifies the I2C slave address.
- xxx-supply: Input voltage supply regulator for ldo3 to ldo7.
  These entries are required if regulators are enabled for a device.
  An absence of these properties can cause the regulator registration to fail.
  If some of input supply is powered through battery or always-on supply then
  also it is required to have these parameters with proper node handle of always
  on power supply.
    vin3-supply: Input supply for ldo3
    vin4-supply: Input supply for ldo4
    vin5-supply: Input supply for ldo5
    vin6-supply: Input supply for ldo6
    vin7-supply: Input supply for ldo7

Optional properties:
- interrupt-parent : Specifies the reference to the interrupt controller.
- interrupts : IRQ line information.
- dlg,cs-gpios : Specify a valid GPIO for chip select

Sub-nodes:
- regulators : This node defines the settings for the regulators.
  The content of the sub-node is defined by the standard binding
  for regulators; see regulator.txt.

  The SLG51000 regulators are bound using their names listed below:
    ldo1
    ldo2
    ldo3
    ldo4
    ldo5
    ldo6
    ldo7

Optional properties for regulators:
- enable-gpios : Specify a valid GPIO for platform control of the regulator.

Example:
	pmic: slg51000@75 {
		compatible = "dlg,slg51000";
		reg = <0x75>;

		regulators {
			ldo1 {
			        regulator-name = "ldo1";
			        regulator-min-microvolt = <2400000>;
			        regulator-max-microvolt = <3300000>;
			};

			ldo2 {
			        regulator-name = "ldo2";
			        regulator-min-microvolt = <2400000>;
			        regulator-max-microvolt = <3300000>;
			};

			ldo3 {
			        regulator-name = "ldo3";
			        regulator-min-microvolt = <1200000>;
			        regulator-max-microvolt = <3750000>;
			};

			ldo4 {
			        regulator-name = "ldo4";
			        regulator-min-microvolt = <1200000>;
			        regulator-max-microvolt = <3750000>;
			};

			ldo5 {
			        regulator-name = "ldo5";
			        regulator-min-microvolt = <500000>;
			        regulator-max-microvolt = <1200000>;
			};

			ldo6 {
			        regulator-name = "ldo6";
			        regulator-min-microvolt = <500000>;
			        regulator-max-microvolt = <1200000>;
			};

			ldo7 {
			        regulator-name = "ldo7";
			        regulator-min-microvolt = <1200000>;
			        regulator-max-microvolt = <3750000>;
			};
		};
	};
+1 −1
Original line number Diff line number Diff line
@@ -6010,7 +6010,7 @@ F: Documentation/devicetree/bindings/mfd/da90*.txt
F:	Documentation/devicetree/bindings/mfd/dlg,da90*.yaml
F:	Documentation/devicetree/bindings/regulator/da92*.txt
F:	Documentation/devicetree/bindings/regulator/dlg,da9*.yaml
F:	Documentation/devicetree/bindings/regulator/slg51000.txt
F:	Documentation/devicetree/bindings/regulator/dlg,slg51000.yaml
F:	Documentation/devicetree/bindings/sound/da[79]*.txt
F:	Documentation/devicetree/bindings/thermal/da90??-thermal.txt
F:	Documentation/devicetree/bindings/watchdog/da90??-wdt.txt