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-min-microvolt
57        - regulator-max-microvolt
58        - regulator-init-microvolt
59        - regulator-allowed-modes
60        - regulator-initial-mode
61        - regulator-min-microamp
62        - regulator-max-microamp
63        - startup-delay-us
64        - off-on-delay-us
65
66  properties:
67    retention-microvolt:
68      type: int
69      description: |
70        Retention mode voltage in microvolts.
71
72    enable-gpios:
73      type: phandle-array
74      description: |
75        Regulator enable controlled by specified regulator GPIO pin.
76        When set regulator must be enabled/disabled using set_dvs_mode.
77
78    pwm-gpios:
79      type: phandle-array
80      description: |
81        Regulator enable controlled by specified regulator GPIO pin.
82        When set regulator must be enabled/disabled using set_dvs_mode.
83
84    retention-gpios:
85      type: phandle-array
86      description: |
87        Retention mode controlled by specified regulator GPIO pin.
88
89    soft-start-microamp:
90      type: int
91      enum:
92        - 10000
93        - 20000
94        - 35000
95        - 50000
96      description: |
97        Soft start current limit in microamps.
98