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 7title: MediaTek MT6370 Battery Charger 8 9maintainers: 10 - ChiaEn Wu <chiaen_wu@richtek.com> 11 12description: | 13 This module is part of the MT6370 MFD device. 14 Provides Battery Charger, Boost for OTG devices and BC1.2 detection. 15 16properties: 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 88required: 89 - compatible 90 - interrupts 91 - interrupt-names 92 - io-channels 93 94additionalProperties: false 95 96... 97