xref: /freebsd/sys/contrib/device-tree/Bindings/regulator/maxim,max77802.yaml (revision a64729f5077d77e13b9497cb33ecb3c82e606ee8)
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
7title: Maxim MAX77802 Power Management IC regulators
8
9maintainers:
10  - Javier Martinez Canillas <javier@dowhile0.org>
11  - Krzysztof Kozlowski <krzk@kernel.org>
12
13description: |
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
36patternProperties:
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
86additionalProperties: false
87