Bindings/mfd/mediatek,mt6357.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/mediatek,mt6357.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: MediaTek MT6357 PMIC
   8
   9 maintainers:
  10   - Flora Fu <flora.fu@mediatek.com>
  11   - Alexandre Mergnat <amergnat@baylibre.com>
  12
  13 description: |
  14   MT6357 is a power management system chip containing 5 buck
  15   converters and 29 LDOs. Supported features are audio codec,
  16   USB battery charging, fuel gauge, RTC
  17
  18   This is a multifunction device with the following sub modules:
  19   - Regulator
  20   - RTC
  21   - Keys
  22
  23   It is interfaced to host controller using SPI interface by a proprietary hardware
  24   called PMIC wrapper or pwrap. This MFD is a child device of pwrap.
  25   See the following for pwrap node definitions:
  26   Documentation/devicetree/bindings/soc/mediatek/mediatek,pwrap.yaml
  27
  28 properties:
  29   compatible:
  30     const: mediatek,mt6357
  31
  32   interrupts:
  33     maxItems: 1
  34
  35   interrupt-controller: true
  36
  37   "#interrupt-cells":
  38     const: 2
  39
  40   regulators:
  41     type: object
  42     $ref: /schemas/regulator/mediatek,mt6357-regulator.yaml
  43     description:
  44       List of MT6357 BUCKs and LDOs regulators.
  45
  46   rtc:
  47     type: object
  48     $ref: /schemas/rtc/rtc.yaml#
  49     unevaluatedProperties: false
  50     description:
  51       MT6357 Real Time Clock.
  52     properties:
  53       compatible:
  54         const: mediatek,mt6357-rtc
  55       start-year: true
  56     required:
  57       - compatible
  58
  59   keys:
  60     type: object
  61     $ref: /schemas/input/mediatek,pmic-keys.yaml
  62     description:
  63       MT6357 power and home keys.
  64
  65 required:
  66   - compatible
  67   - regulators
  68
  69 additionalProperties: false
  70
  71 examples:
  72   - |
  73     #include <dt-bindings/interrupt-controller/arm-gic.h>
  74
  75     pwrap {
  76         pmic {
  77             compatible = "mediatek,mt6357";
  78
  79             interrupt-parent = <&pio>;
  80             interrupts = <145 IRQ_TYPE_LEVEL_HIGH>;
  81             interrupt-controller;
  82             #interrupt-cells = <2>;
  83
  84             regulators {
  85                 mt6357_vproc_reg: buck-vproc {
  86                     regulator-name = "vproc";
  87                     regulator-min-microvolt = <518750>;
  88                     regulator-max-microvolt = <1312500>;
  89                     regulator-ramp-delay = <6250>;
  90                     regulator-enable-ramp-delay = <220>;
  91                     regulator-always-on;
  92                 };
  93
  94                 // ...
  95
  96                 mt6357_vusb33_reg: ldo-vusb33 {
  97                     regulator-name = "vusb33";
  98                     regulator-min-microvolt = <3000000>;
  99                     regulator-max-microvolt = <3100000>;
 100                     regulator-enable-ramp-delay = <264>;
 101                 };
 102             };
 103
 104             rtc {
 105                 compatible = "mediatek,mt6357-rtc";
 106             };
 107
 108             keys {
 109                 compatible = "mediatek,mt6357-keys";
 110             };
 111         };
 112     };