xref: /linux/Documentation/devicetree/bindings/regulator/maxim,max77802.yaml (revision 7ae9fb1b7ecbb5d85d07857943f677fd1a559b18)
16b9d48b4SKrzysztof Kozlowski# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
26b9d48b4SKrzysztof Kozlowski%YAML 1.2
36b9d48b4SKrzysztof Kozlowski---
46b9d48b4SKrzysztof Kozlowski$id: http://devicetree.org/schemas/regulator/maxim,max77802.yaml#
56b9d48b4SKrzysztof Kozlowski$schema: http://devicetree.org/meta-schemas/core.yaml#
66b9d48b4SKrzysztof Kozlowski
76b9d48b4SKrzysztof Kozlowskititle: Maxim MAX77802 Power Management IC regulators
86b9d48b4SKrzysztof Kozlowski
96b9d48b4SKrzysztof Kozlowskimaintainers:
106b9d48b4SKrzysztof Kozlowski  - Javier Martinez Canillas <javier@dowhile0.org>
118a1e6bb3SKrzysztof Kozlowski  - Krzysztof Kozlowski <krzk@kernel.org>
126b9d48b4SKrzysztof Kozlowski
136b9d48b4SKrzysztof Kozlowskidescription: |
146b9d48b4SKrzysztof Kozlowski  This is a part of device tree bindings for Maxim MAX77802 Power Management
156b9d48b4SKrzysztof Kozlowski  Integrated Circuit (PMIC).
166b9d48b4SKrzysztof Kozlowski
176b9d48b4SKrzysztof Kozlowski  The Maxim MAX77686 provides 10 high-efficiency Buck and 32 Low-DropOut (LDO)
186b9d48b4SKrzysztof Kozlowski  regulators.
196b9d48b4SKrzysztof Kozlowski
206b9d48b4SKrzysztof Kozlowski  See also Documentation/devicetree/bindings/mfd/maxim,max77802.yaml for
216b9d48b4SKrzysztof Kozlowski  additional information and example.
226b9d48b4SKrzysztof Kozlowski
236b9d48b4SKrzysztof Kozlowski  Certain regulators support "regulator-initial-mode" and "regulator-mode".
246b9d48b4SKrzysztof Kozlowski  The valid modes list is defined in the dt-bindings/regulator/maxim,max77802.h
256b9d48b4SKrzysztof Kozlowski  and their meaning is::
266b9d48b4SKrzysztof Kozlowski    1 - Normal regulator voltage output mode.
276b9d48b4SKrzysztof Kozlowski    3 - Low Power which reduces the quiescent current down to only 1uA
286b9d48b4SKrzysztof Kozlowski
296b9d48b4SKrzysztof Kozlowski  The standard "regulator-mode" property can only be used for regulators that
306b9d48b4SKrzysztof Kozlowski  support changing their mode to Low Power Mode during suspend. These
316b9d48b4SKrzysztof Kozlowski  regulators are:: bucks 2-4 and LDOs 1-35. Also, it only takes effect if the
326b9d48b4SKrzysztof Kozlowski  regulator has been enabled for the given suspend state using
336b9d48b4SKrzysztof Kozlowski  "regulator-on-in-suspend" and has not been disabled for that state using
346b9d48b4SKrzysztof Kozlowski  "regulator-off-in-suspend".
356b9d48b4SKrzysztof Kozlowski
366b9d48b4SKrzysztof KozlowskipatternProperties:
376b9d48b4SKrzysztof Kozlowski  # LDO1, LDO3, LDO20, LDO21
386b9d48b4SKrzysztof Kozlowski  "^LDO([13]|2[01])$":
396b9d48b4SKrzysztof Kozlowski    type: object
406b9d48b4SKrzysztof Kozlowski    $ref: regulator.yaml#
416b9d48b4SKrzysztof Kozlowski    unevaluatedProperties: false
426b9d48b4SKrzysztof Kozlowski    description:
436b9d48b4SKrzysztof Kozlowski      LDOs supporting the regulator-initial-mode property and changing their
446b9d48b4SKrzysztof Kozlowski      mode during normal operation.
456b9d48b4SKrzysztof Kozlowski
466b9d48b4SKrzysztof Kozlowski  # LDO2, LDO4-15, LDO17-19, LDO23-30, LDO32-35
476b9d48b4SKrzysztof Kozlowski  "^LDO([24-9]|1[0-5789]|2[3-9]|3[02345])$":
486b9d48b4SKrzysztof Kozlowski    type: object
496b9d48b4SKrzysztof Kozlowski    $ref: regulator.yaml#
506b9d48b4SKrzysztof Kozlowski    unevaluatedProperties: false
516b9d48b4SKrzysztof Kozlowski    description:
526b9d48b4SKrzysztof Kozlowski      LDOs supporting the regulator-mode property (changing mode to Low Power
536b9d48b4SKrzysztof Kozlowski      Mode during suspend).
546b9d48b4SKrzysztof Kozlowski
556b9d48b4SKrzysztof Kozlowski    properties:
566b9d48b4SKrzysztof Kozlowski      regulator-initial-mode: false
576b9d48b4SKrzysztof Kozlowski
586b9d48b4SKrzysztof Kozlowski  # buck2-4
596b9d48b4SKrzysztof Kozlowski  "^BUCK[2-4]$":
606b9d48b4SKrzysztof Kozlowski    type: object
616b9d48b4SKrzysztof Kozlowski    $ref: regulator.yaml#
626b9d48b4SKrzysztof Kozlowski    unevaluatedProperties: false
636b9d48b4SKrzysztof Kozlowski    description:
646b9d48b4SKrzysztof Kozlowski      bucks supporting the regulator-mode property (changing mode to Low Power
656b9d48b4SKrzysztof Kozlowski      Mode during suspend).
666b9d48b4SKrzysztof Kozlowski
676b9d48b4SKrzysztof Kozlowski    properties:
686b9d48b4SKrzysztof Kozlowski      regulator-initial-mode: false
696b9d48b4SKrzysztof Kozlowski
706b9d48b4SKrzysztof Kozlowski  # buck1, buck5-10
716b9d48b4SKrzysztof Kozlowski  "^BUCK([15-9]|10)$":
726b9d48b4SKrzysztof Kozlowski    type: object
736b9d48b4SKrzysztof Kozlowski    $ref: regulator.yaml#
746b9d48b4SKrzysztof Kozlowski    unevaluatedProperties: false
756b9d48b4SKrzysztof Kozlowski
766b9d48b4SKrzysztof Kozlowski    properties:
776b9d48b4SKrzysztof Kozlowski      regulator-initial-mode: false
786b9d48b4SKrzysztof Kozlowski
796b9d48b4SKrzysztof Kozlowski    patternProperties:
80*7621aabdSRob Herring      "^regulator-state-(standby|mem|disk)$":
816b9d48b4SKrzysztof Kozlowski        type: object
82de6fbef1SRob Herring        additionalProperties: true
836b9d48b4SKrzysztof Kozlowski        properties:
846b9d48b4SKrzysztof Kozlowski          regulator-mode: false
856b9d48b4SKrzysztof Kozlowski
866b9d48b4SKrzysztof KozlowskiadditionalProperties: false
87