xref: /linux/Documentation/devicetree/bindings/mfd/samsung,s2mpg11-pmic.yaml (revision f6c42489fedfa42ba79bd17c49cf81c69ff39f8a)
1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/mfd/samsung,s2mpg11-pmic.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Samsung S2MPG11 Power Management IC
8
9maintainers:
10  - André Draszik <andre.draszik@linaro.org>
11
12description: |
13  This is part of the device tree bindings for the S2MPG11 Power Management IC
14  (PMIC).
15
16  The Samsung S2MPG11 is a Power Management IC for mobile applications with buck
17  converters, various LDOs, power meters, NTC thermistor inputs, and additional
18  GPIO interfaces and typically complements an S2MPG10 PMIC in a main/sub
19  configuration as the sub-PMIC.
20
21properties:
22  compatible:
23    const: samsung,s2mpg11-pmic
24
25  interrupts:
26    maxItems: 1
27
28  regulators:
29    type: object
30    $ref: /schemas/regulator/samsung,s2mpg11-regulator.yaml
31    description:
32      List of child nodes that specify the regulators.
33
34  wakeup-source: true
35
36patternProperties:
37  "^vinb(([1-9]|10)s|[abd])-supply$":
38    description:
39      Phandle to the power supply for each buck rail of this PMIC. There is a
40      1:1 mapping of numbered supply to rail, e.g. vinb1s-supply supplies
41      buck1s. The remaining mapping is as follows
42        vinba - bucka
43        vinbb - buck boost
44        vinbd - buckd
45
46  "^vinl[1-6]s-supply$":
47    description: |
48      Phandle to the power supply for one or multiple LDO rails of this PMIC.
49      The mapping of supply to rail(s) is as follows
50        vinl1s - ldo1s, ldo2s
51        vinl2s - ldo8s, ldo9s
52        vinl3s - ldo3s, ldo5s, ldo7s, ldo15s
53        vinl4s - ldo10s, ldo11s, ldo12s, ldo14s
54        vinl5s - ldo4s, ldo6s
55        vinl6s - ldo13s
56
57required:
58  - compatible
59  - interrupts
60  - regulators
61
62additionalProperties: false
63
64examples:
65  - |
66    #include <dt-bindings/gpio/gpio.h>
67    #include <dt-bindings/interrupt-controller/irq.h>
68    #include <dt-bindings/regulator/samsung,s2mpg10-regulator.h>
69
70    pmic {
71        compatible = "samsung,s2mpg11-pmic";
72        interrupts-extended = <&gpa0 7 IRQ_TYPE_LEVEL_LOW>;
73        pinctrl-names = "default";
74        pinctrl-0 = <&pmic_int>;
75        wakeup-source;
76
77        vinl1s-supply = <&buck8m>;
78        vinl2s-supply = <&buck6s>;
79
80        regulators {
81            buckd {
82                regulator-name = "vcc_ufs";
83                regulator-ramp-delay = <6250>;
84                enable-gpios = <&gpp0 1 GPIO_ACTIVE_HIGH>;
85                samsung,ext-control = <S2MPG11_EXTCTRL_UFS_EN>;
86            };
87        };
88    };
89