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