GNU Linux-libre 6.1.90-gnu
[releases.git] / Documentation / devicetree / bindings / regulator / maxim,max77802.yaml
1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/regulator/maxim,max77802.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Maxim MAX77802 Power Management IC regulators
8
9 maintainers:
10   - Javier Martinez Canillas <javier@dowhile0.org>
11   - Krzysztof Kozlowski <krzk@kernel.org>
12
13 description: |
14   This is a part of device tree bindings for Maxim MAX77802 Power Management
15   Integrated Circuit (PMIC).
16
17   The Maxim MAX77686 provides 10 high-efficiency Buck and 32 Low-DropOut (LDO)
18   regulators.
19
20   See also Documentation/devicetree/bindings/mfd/maxim,max77802.yaml for
21   additional information and example.
22
23   Certain regulators support "regulator-initial-mode" and "regulator-mode".
24   The valid modes list is defined in the dt-bindings/regulator/maxim,max77802.h
25   and their meaning is::
26     1 - Normal regulator voltage output mode.
27     3 - Low Power which reduces the quiescent current down to only 1uA
28
29   The standard "regulator-mode" property can only be used for regulators that
30   support changing their mode to Low Power Mode during suspend. These
31   regulators are:: bucks 2-4 and LDOs 1-35. Also, it only takes effect if the
32   regulator has been enabled for the given suspend state using
33   "regulator-on-in-suspend" and has not been disabled for that state using
34   "regulator-off-in-suspend".
35
36 patternProperties:
37   # LDO1, LDO3, LDO20, LDO21
38   "^LDO([13]|2[01])$":
39     type: object
40     $ref: regulator.yaml#
41     unevaluatedProperties: false
42     description:
43       LDOs supporting the regulator-initial-mode property and changing their
44       mode during normal operation.
45
46   # LDO2, LDO4-15, LDO17-19, LDO23-30, LDO32-35
47   "^LDO([24-9]|1[0-5789]|2[3-9]|3[02345])$":
48     type: object
49     $ref: regulator.yaml#
50     unevaluatedProperties: false
51     description:
52       LDOs supporting the regulator-mode property (changing mode to Low Power
53       Mode during suspend).
54
55     properties:
56       regulator-initial-mode: false
57
58   # buck2-4
59   "^BUCK[2-4]$":
60     type: object
61     $ref: regulator.yaml#
62     unevaluatedProperties: false
63     description:
64       bucks supporting the regulator-mode property (changing mode to Low Power
65       Mode during suspend).
66
67     properties:
68       regulator-initial-mode: false
69
70   # buck1, buck5-10
71   "^BUCK([15-9]|10)$":
72     type: object
73     $ref: regulator.yaml#
74     unevaluatedProperties: false
75
76     properties:
77       regulator-initial-mode: false
78
79     patternProperties:
80       regulator-state-(standby|mem|disk):
81         type: object
82         additionalProperties: true
83         properties:
84           regulator-mode: false
85
86 additionalProperties: false