1# Copyright (c), 2023 Nordic Semiconductor ASA
2# SPDX-License-Identifier: Apache-2.0
3
4description: |
5  Nordic nPM1300 PMIC
6
7  The PMIC has two buck converters and two LDOs.
8  The regulators need to be defined as child nodes, strictly following the
9  BUCK1,2 LDO1..2, node names. For
10  example:
11
12  pmic@6b {
13    reg = <0x6b>;
14    ...
15    regulators {
16      compatible = "nordic,npm1300-regulator";
17
18      BUCK1 {
19        /* all properties for BUCK1 */
20      };
21      BUCK2 {
22        /* all properties for BUCK2 */
23      };
24      LDO1 {
25        /* all properties for LDO1 */
26      };
27      LDO2 {
28        /* all properties for LDO2 */
29      };
30    };
31  };
32
33compatible: "nordic,npm1300-regulator"
34
35include: base.yaml
36
37properties:
38  dvs-gpios:
39    type: phandle-array
40    description: |
41      List of SOC GPIOs connected to PMIC GPIOs.
42      Set_dvs_mode will drive these pins as follows:
43        DVS mode 1 will enable the first pin
44        DVS mode 2 will enable the second pin
45        DVS mode 3 will drive the first and second pins
46        etc.
47      The effect of the mode change is defined by the enable-gpios
48      and pwm_gpios fields for each of the regulator blocks.
49
50child-binding:
51  include:
52    - name: regulator.yaml
53      property-allowlist:
54        - regulator-always-on
55        - regulator-boot-on
56        - regulator-boot-off
57        - regulator-min-microvolt
58        - regulator-max-microvolt
59        - regulator-init-microvolt
60        - regulator-allowed-modes
61        - regulator-initial-mode
62        - regulator-min-microamp
63        - regulator-max-microamp
64        - startup-delay-us
65        - off-on-delay-us
66
67  properties:
68    retention-microvolt:
69      type: int
70      description: |
71        Retention mode voltage in microvolts.
72
73    enable-gpios:
74      type: phandle-array
75      description: |
76        Regulator enable controlled by specified regulator GPIO pin.
77        When set regulator must be enabled/disabled using set_dvs_mode.
78
79    pwm-gpios:
80      type: phandle-array
81      description: |
82        Regulator enable controlled by specified regulator GPIO pin.
83        When set regulator must be enabled/disabled using set_dvs_mode.
84
85    retention-gpios:
86      type: phandle-array
87      description: |
88        Retention mode controlled by specified regulator GPIO pin.
89
90    soft-start-microamp:
91      type: int
92      enum:
93        - 10000
94        - 20000
95        - 35000
96        - 50000
97      description: |
98        Soft start current limit in microamps.
99