Documentation/devicetree/bindings/mfd/samsung,s2mpa01.yaml

   1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/mfd/samsung,s2mpa01.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Samsung S2MPA01 Power Management IC
   8
   9 maintainers:
  10   - Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
  11
  12 description: |
  13   This is a part of device tree bindings for S2M and S5M family of Power
  14   Management IC (PMIC).
  15
  16   The Samsung S2MPA01 is a Power Management IC which includes voltage
  17   and current regulators, RTC, clock outputs and other sub-blocks.
  18
  19 properties:
  20   compatible:
  21     const: samsung,s2mpa01-pmic
  22
  23   interrupts:
  24     maxItems: 1
  25
  26   reg:
  27     maxItems: 1
  28
  29   regulators:
  30     $ref: ../regulator/samsung,s2mpa01.yaml
  31     description:
  32       List of child nodes that specify the regulators.
  33
  34   wakeup-source: true
  35
  36 required:
  37   - compatible
  38   - reg
  39   - regulators
  40
  41 additionalProperties: false
  42
  43 examples:
  44   - |
  45     #include <dt-bindings/interrupt-controller/irq.h>
  46
  47     i2c {
  48         #address-cells = <1>;
  49         #size-cells = <0>;
  50
  51         pmic@66 {
  52             compatible = "samsung,s2mpa01-pmic";
  53             reg = <0x66>;
  54
  55             regulators {
  56                 ldo1_reg: LDO1 {
  57                     regulator-name = "VDD_ALIVE";
  58                     regulator-min-microvolt = <1000000>;
  59                     regulator-max-microvolt = <1000000>;
  60                 };
  61
  62                 ldo2_reg: LDO2 {
  63                     regulator-name = "VDDQ_MMC2";
  64                     regulator-min-microvolt = <2800000>;
  65                     regulator-max-microvolt = <2800000>;
  66                     regulator-always-on;
  67                 };
  68
  69                 // ...
  70
  71                 buck1_reg: BUCK1 {
  72                     regulator-name = "vdd_mif";
  73                     regulator-min-microvolt = <950000>;
  74                     regulator-max-microvolt = <1350000>;
  75                     regulator-always-on;
  76                     regulator-boot-on;
  77                 };
  78
  79                 buck2_reg: BUCK2 {
  80                     regulator-name = "vdd_arm";
  81                     regulator-min-microvolt = <950000>;
  82                     regulator-max-microvolt = <1350000>;
  83                     regulator-always-on;
  84                     regulator-boot-on;
  85                     regulator-ramp-delay = <50000>;
  86                 };
  87
  88                 // ...
  89             };
  90         };
  91     };