Documentation/devicetree/bindings/power/supply/mediatek,mt6370-charger.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/power/supply/mediatek,mt6370-charger.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: MediaTek MT6370 Battery Charger
   8
   9 maintainers:
  10   - ChiaEn Wu <chiaen_wu@richtek.com>
  11
  12 description: |
  13   This module is part of the MT6370 MFD device.
  14   Provides Battery Charger, Boost for OTG devices and BC1.2 detection.
  15
  16 properties:
  17   compatible:
  18     const: mediatek,mt6370-charger
  19
  20   interrupts:
  21     description: |
  22       Specify what irqs are needed to be handled by MT6370 Charger driver.
  23       We need to use the IRQ "MT6370_IRQ_OVPCTRL_UVP_D" to know when USB
  24       is plugged in, and then the driver will enable BC1.2 detection.
  25       After the hardware of MT6370 completes the BC1.2 detection,
  26       IRQ "MT6370_IRQ_ATTACH" will be triggered, and the driver will know
  27       the result of BC1.2 detection.
  28       When the IRQ "MT6370_IRQ_CHG_MIVR" is triggered, it means that the
  29       hardware enters the "Minimum Input Voltage Regulation loop" and
  30       a workaround needs to be applied at this time.
  31       In summary, "MT6370_IRQ_OVPCTRL_UVP_D", "MT6370_IRQ_ATTACH" and
  32       "MT6370_IRQ_CHG_MIVR" are required in this charger driver.
  33     items:
  34       - description: irq of "USB is plugged in"
  35       - description: irq of "BC1.2 is done"
  36       - description: irq of "Minimum Input Voltage Regulation loop is active"
  37
  38   interrupt-names:
  39     items:
  40       - const: uvp_d_evt
  41       - const: attach_i
  42       - const: mivr
  43
  44   io-channels:
  45     description: |
  46       Use ADC channel to read VBUS, IBUS, IBAT, etc., info.
  47     minItems: 1
  48     items:
  49       - description: |
  50           VBUS voltage with lower accuracy (+-75mV) but higher measure
  51           range (1~22V)
  52       - description: |
  53           VBUS voltage with higher accuracy (+-30mV) but lower measure
  54           range (1~9.76V)
  55       - description: the main system input voltage
  56       - description: battery voltage
  57       - description: battery temperature-sense input voltage
  58       - description: IBUS current (required)
  59       - description: battery current
  60       - description: |
  61           regulated output voltage to supply for the PWM low-side gate driver
  62           and the bootstrap capacitor
  63       - description: IC junction temperature
  64
  65   io-channel-names:
  66     minItems: 1
  67     items:
  68       - const: vbusdiv5
  69       - const: vbusdiv2
  70       - const: vsys
  71       - const: vbat
  72       - const: ts_bat
  73       - const: ibus
  74       - const: ibat
  75       - const: chg_vddp
  76       - const: temp_jc
  77
  78   usb-otg-vbus-regulator:
  79     type: object
  80     description: OTG boost regulator.
  81     unevaluatedProperties: false
  82     $ref: /schemas/regulator/regulator.yaml#
  83
  84     properties:
  85       enable-gpios:
  86         maxItems: 1
  87
  88 required:
  89   - compatible
  90   - interrupts
  91   - interrupt-names
  92   - io-channels
  93
  94 additionalProperties: false
  95
  96 ...