tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

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: André Draszik <andre.draszik@linaro.org>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://patch.msgid.link/20260122-s2mpg1x-regulators-v7-5-3b1f9831fffd@linaro.org
Signed-off-by: Lee Jones <lee@kernel.org>

authored by

André Draszik and committed by
Lee Jones b356595f 189ccdc7

+54 -3
+54 -3
Documentation/devicetree/bindings/mfd/samsung,s2mpg10-pmic.yaml
··· 10 10 - André Draszik <andre.draszik@linaro.org> 11 11 12 12 description: | 13 - This is part of the device tree bindings for the S2MPG family of Power 14 - Management IC (PMIC). 13 + This is part of the device tree bindings for the S2MPG10 Power Management IC 14 + (PMIC). 15 15 16 16 The Samsung S2MPG10 is a Power Management IC for mobile applications with buck 17 17 converters, various LDOs, power meters, RTC, clock outputs, and additional 18 - GPIO interfaces. 18 + GPIO interfaces and is typically complemented by S2MPG10 PMIC in a main/sub 19 + configuration as the main PMIC. 19 20 20 21 properties: 21 22 compatible: ··· 32 31 33 32 regulators: 34 33 type: object 34 + $ref: /schemas/regulator/samsung,s2mpg10-regulator.yaml 35 35 description: 36 36 List of child nodes that specify the regulators. 37 37 38 38 system-power-controller: true 39 39 40 40 wakeup-source: true 41 + 42 + patternProperties: 43 + "^vinb([1-9]|10)m-supply$": 44 + description: 45 + Phandle to the power supply for each buck rail of this PMIC. There is a 46 + 1:1 mapping of supply to rail, e.g. vinb1m-supply supplies buck1m. 47 + 48 + "^vinl([1-9]|1[0-5])m-supply$": 49 + description: | 50 + Phandle to the power supply for one or multiple LDO rails of this PMIC. 51 + The mapping of supply to rail(s) is as follows: 52 + vinl1m - ldo13m 53 + vinl2m - ldo15m 54 + vinl3m - ldo1m, ldo5m, ldo7m 55 + vinl4m - ldo3m, ldo8m 56 + vinl5m - ldo16m 57 + vinl6m - ldo17m 58 + vinl7m - ldo6m, ldo11m, ldo24m, ldo28m 59 + vinl8m - ldo12m 60 + vinl9m - ldo2m, ldo4m 61 + vinl10m - ldo9m, ldo14m, ldo18m, 19m, ldo20m, ldo25m 62 + vinl11m - ldo23m, ldo31m 63 + vinl12m - ldo29m 64 + vinl13m - ldo30m 65 + vinl14m - ldo21m 66 + vinl15m - ldo10m, ldo22m, ldo26m, ldo27m 41 67 42 68 required: 43 69 - compatible ··· 77 49 - | 78 50 #include <dt-bindings/gpio/gpio.h> 79 51 #include <dt-bindings/interrupt-controller/irq.h> 52 + #include <dt-bindings/regulator/samsung,s2mpg10-regulator.h> 80 53 81 54 pmic { 82 55 compatible = "samsung,s2mpg10-pmic"; ··· 87 58 system-power-controller; 88 59 wakeup-source; 89 60 61 + vinl3m-supply = <&buck8m>; 62 + 90 63 clocks { 91 64 compatible = "samsung,s2mpg10-clk"; 92 65 #clock-cells = <1>; ··· 96 65 }; 97 66 98 67 regulators { 68 + buck8m { 69 + regulator-name = "vdd_mif"; 70 + regulator-min-microvolt = <450000>; 71 + regulator-max-microvolt = <1300000>; 72 + regulator-ramp-delay = <6250>; 73 + }; 74 + 75 + ldo1m { 76 + regulator-name = "vdd_ldo1"; 77 + regulator-min-microvolt = <700000>; 78 + regulator-max-microvolt = <1300000>; 79 + }; 80 + 81 + ldo20m { 82 + regulator-name = "vdd_dmics"; 83 + regulator-min-microvolt = <700000>; 84 + regulator-max-microvolt = <1300000>; 85 + regulator-always-on; 86 + samsung,ext-control = <S2MPG10_EXTCTRL_LDO20M_EN2>; 87 + }; 99 88 }; 100 89 };