Commit b356595f authored by André Draszik's avatar André Draszik Committed by Lee Jones
Browse files

dt-bindings: mfd: samsung,s2mpg10-pmic: Link to its regulators 



Update the regulators node to link to the correct and expected
samsung,s2mpg10-regulators binding, in order to describe the regulators
available on this PMIC.

Additionally, describe the supply inputs of the regulator rails, with
the supply names matching the datasheet.

While at it, update the description and example slightly.

Note: S2MPG10 is typically used as the main-PMIC together with an
S2MPG11 PMIC in a main/sub configuration, hence the datasheet and the
binding both suffix the supplies with an 'm'.

Signed-off-by: default avatarAndré Draszik <andre.draszik@linaro.org>
Reviewed-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://patch.msgid.link/20260122-s2mpg1x-regulators-v7-5-3b1f9831fffd@linaro.org


Signed-off-by: default avatarLee Jones <lee@kernel.org>
parent 189ccdc7

Documentation/devicetree/bindings/mfd/samsung,s2mpg10-pmic.yaml

+54 −3
Original line number Diff line number Diff line
@@ -10,12 +10,13 @@ maintainers: 
  - André Draszik <andre.draszik@linaro.org>



description: |

  This is part of the device tree bindings for the S2MPG family of Power

  Management IC (PMIC).

  This is part of the device tree bindings for the S2MPG10 Power Management IC

  (PMIC).



  The Samsung S2MPG10 is a Power Management IC for mobile applications with buck

  converters, various LDOs, power meters, RTC, clock outputs, and additional

  GPIO interfaces.

  GPIO interfaces and is typically complemented by S2MPG10 PMIC in a main/sub

  configuration as the main PMIC.



properties:

  compatible:
@@ -31,6 +32,7 @@ properties: 


  regulators:

    type: object

    $ref: /schemas/regulator/samsung,s2mpg10-regulator.yaml

    description:

      List of child nodes that specify the regulators.
@@ -38,6 +40,32 @@ properties: 


  wakeup-source: true



patternProperties:

  "^vinb([1-9]|10)m-supply$":

    description:

      Phandle to the power supply for each buck rail of this PMIC. There is a

      1:1 mapping of supply to rail, e.g. vinb1m-supply supplies buck1m.



  "^vinl([1-9]|1[0-5])m-supply$":

    description: |

      Phandle to the power supply for one or multiple LDO rails of this PMIC.

      The mapping of supply to rail(s) is as follows:

        vinl1m - ldo13m

        vinl2m - ldo15m

        vinl3m - ldo1m, ldo5m, ldo7m

        vinl4m - ldo3m, ldo8m

        vinl5m - ldo16m

        vinl6m - ldo17m

        vinl7m - ldo6m, ldo11m, ldo24m, ldo28m

        vinl8m - ldo12m

        vinl9m - ldo2m, ldo4m

        vinl10m - ldo9m, ldo14m, ldo18m, 19m, ldo20m, ldo25m

        vinl11m - ldo23m, ldo31m

        vinl12m - ldo29m

        vinl13m - ldo30m

        vinl14m - ldo21m

        vinl15m - ldo10m, ldo22m, ldo26m, ldo27m



required:

  - compatible

  - interrupts
@@ -49,6 +77,7 @@ examples: 
  - |

    #include <dt-bindings/gpio/gpio.h>

    #include <dt-bindings/interrupt-controller/irq.h>

    #include <dt-bindings/regulator/samsung,s2mpg10-regulator.h>



    pmic {

        compatible = "samsung,s2mpg10-pmic";
@@ -58,6 +87,8 @@ examples: 
        system-power-controller;

        wakeup-source;



        vinl3m-supply = <&buck8m>;



        clocks {

            compatible = "samsung,s2mpg10-clk";

            #clock-cells = <1>;
@@ -65,5 +96,25 @@ examples: 
        };



        regulators {

            buck8m {

                regulator-name = "vdd_mif";

                regulator-min-microvolt = <450000>;

                regulator-max-microvolt = <1300000>;

                regulator-ramp-delay = <6250>;

            };



            ldo1m {

                regulator-name = "vdd_ldo1";

                regulator-min-microvolt = <700000>;

                regulator-max-microvolt = <1300000>;

            };



            ldo20m {

                regulator-name = "vdd_dmics";

                regulator-min-microvolt = <700000>;

                regulator-max-microvolt = <1300000>;

                regulator-always-on;

                samsung,ext-control = <S2MPG10_EXTCTRL_LDO20M_EN2>;

            };

        };

    };