Documentation/devicetree/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     unevaluatedProperties: false
  44     description:
  45       List of MT6357 BUCKs and LDOs regulators.
  46
  47   rtc:
  48     type: object
  49     $ref: /schemas/rtc/rtc.yaml#
  50     unevaluatedProperties: false
  51     description:
  52       MT6357 Real Time Clock.
  53     properties:
  54       compatible:
  55         const: mediatek,mt6357-rtc
  56       start-year: true
  57     required:
  58       - compatible
  59
  60   keys:
  61     type: object
  62     $ref: /schemas/input/mediatek,pmic-keys.yaml
  63     unevaluatedProperties: false
  64     description:
  65       MT6357 power and home keys.
  66
  67 required:
  68   - compatible
  69   - regulators
  70
  71 additionalProperties: false
  72
  73 examples:
  74   - |
  75     #include <dt-bindings/interrupt-controller/arm-gic.h>
  76
  77     pwrap {
  78         pmic {
  79             compatible = "mediatek,mt6357";
  80
  81             interrupt-parent = <&pio>;
  82             interrupts = <145 IRQ_TYPE_LEVEL_HIGH>;
  83             interrupt-controller;
  84             #interrupt-cells = <2>;
  85
  86             regulators {
  87                 mt6357_vproc_reg: buck-vproc {
  88                     regulator-name = "vproc";
  89                     regulator-min-microvolt = <518750>;
  90                     regulator-max-microvolt = <1312500>;
  91                     regulator-ramp-delay = <6250>;
  92                     regulator-enable-ramp-delay = <220>;
  93                     regulator-always-on;
  94                 };
  95
  96                 // ...
  97
  98                 mt6357_vusb33_reg: ldo-vusb33 {
  99                     regulator-name = "vusb33";
 100                     regulator-min-microvolt = <3000000>;
 101                     regulator-max-microvolt = <3100000>;
 102                     regulator-enable-ramp-delay = <264>;
 103                 };
 104             };
 105
 106             rtc {
 107                 compatible = "mediatek,mt6357-rtc";
 108             };
 109
 110             keys {
 111                 compatible = "mediatek,mt6357-keys";
 112             };
 113         };
 114     };