1# Copyright (c), 2021 NXP
2# SPDX-License-Identifier: Apache-2.0
3
4description: |
5  NXP PCA9420 PMIC
6
7  The PMIC has two buck converters and two LDOs. All need to be defined as
8  children nodes, strictly following the BUCK1, BUCK2, LDO1 and LDO2 node names.
9  For example:
10
11  pmic@61 {
12    reg = <0x61>;
13    ...
14    BUCK1 {
15      /* all properties for BUCK1 */
16    };
17    BUCK2 {
18      /* all properties for BUCK2 */
19    };
20    LDO1 {
21      /* all properties for LDO1 */
22    };
23    LDO2 {
24      /* all properties for LDO2 */
25    };
26  };
27
28
29compatible: "nxp,pca9420"
30
31include: base.yaml
32
33properties:
34  nxp,enable-modesel-pins:
35    type: boolean
36    description:
37      When enabled, the PMIC will be configured to allow mode selection using
38      the MODESEL0/1 inputs.
39
40  nxp,vin-ilim-microamp:
41    type: int
42    default: 425000
43    enum:
44      - 85000
45      - 255000
46      - 425000
47      - 595000
48      - 765000
49      - 935000
50      - 1105000
51    description: |
52      VIN input current limit, in microamperes. Value reflects typical value,
53      below you can find min/typical/max values:
54
55      - 74 mA/85 mA/98 mA
56      - 222 mA/255 mA/293 mA
57      - 370 mA/425 mA/489 mA
58      - 517 mA/595 mA/684 mA
59      - 665 mA/765 mA/880 mA
60      - 813 mA/935 mA/1075 mA
61      - 961 mA/1105 mA/1271 mA
62
63      To disable current limit, set property to zero. Defaults to 425mA, the IC
64      default value.
65
66  nxp,asys-uvlo-sel-millivolt:
67    type: int
68    default: 2700
69    enum:
70      - 2400
71      - 2500
72      - 2600
73      - 2700
74    description: |
75      ASYS UVLO (under voltage lock out) threshold, in millivolts. Defaults to
76      2700mV to match the IC default value.
77
78child-binding:
79  include:
80    - name: regulator.yaml
81      property-allowlist:
82        - regulator-always-on
83        - regulator-boot-on
84        - regulator-min-microvolt
85        - regulator-max-microvolt
86
87  description: Voltage output of PMIC controller regulator
88  properties:
89    enable-inverted:
90      type: boolean
91      description: |
92        If the enable bit should be zero to turn the regulator on, add this
93        property.
94
95    nxp,mode0-microvolt:
96      type: int
97      description: |
98        The voltage level to be configured for mode 0, in microvolts. Setting
99        this value to zero will disable the source in mode 0.
100
101    nxp,mode1-microvolt:
102      type: int
103      description: |
104        The voltage level to be configured for mode 1, in microvolts. Setting
105        this value to zero will disable the source in mode 1.
106
107    nxp,mode2-microvolt:
108      type: int
109      description: |
110        The voltage level to be configured for mode 2, in microvolts. Setting
111        this value to zero will disable the source in mode 2.
112
113    nxp,mode3-microvolt:
114      type: int
115      description: |
116        The voltage level to be configured for mode 3, in microvolts. Setting
117        this value to zero will disable the source in mode 3.
118