xref: /linux/Documentation/devicetree/bindings/mfd/ti,bq25703a.yaml (revision d30c1683aaecb93d2ab95685dc4300a33d3cea7a) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/mfd/ti,bq25703a.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: BQ25703A Charger Manager/Buck/Boost Converter
8
9maintainers:
10  - Chris Morgan <macromorgan@hotmail.com>
11
12allOf:
13  - $ref: /schemas/power/supply/power-supply.yaml#
14
15properties:
16  compatible:
17    const: ti,bq25703a
18
19  reg:
20    const: 0x6b
21
22  input-current-limit-microamp:
23    description:
24      Maximum total input current allowed used for both charging and
25      powering the device.
26    minimum: 50000
27    maximum: 6400000
28    default: 3250000
29
30  interrupts:
31    maxItems: 1
32
33  monitored-battery:
34    description:
35      A minimum of constant-charge-current-max-microamp,
36      constant-charge-voltage-max-microvolt, and
37      voltage-min-design-microvolt are required.
38
39  regulators:
40    type: object
41    additionalProperties: false
42    description:
43      Boost converter regulator output of bq257xx.
44
45    properties:
46      vbus:
47        type: object
48        $ref: /schemas/regulator/regulator.yaml
49        additionalProperties: false
50
51        properties:
52          regulator-name: true
53          regulator-min-microamp:
54            minimum: 0
55            maximum: 6350000
56          regulator-max-microamp:
57            minimum: 0
58            maximum: 6350000
59          regulator-min-microvolt:
60            minimum: 4480000
61            maximum: 20800000
62          regulator-max-microvolt:
63            minimum: 4480000
64            maximum: 20800000
65          enable-gpios:
66            description:
67              The BQ25703 may require both a register write and a GPIO
68              toggle to enable the boost regulator.
69
70        required:
71          - regulator-name
72          - regulator-min-microamp
73          - regulator-max-microamp
74          - regulator-min-microvolt
75          - regulator-max-microvolt
76
77unevaluatedProperties: false
78
79required:
80  - compatible
81  - reg
82  - input-current-limit-microamp
83  - monitored-battery
84  - power-supplies
85
86examples:
87  - |
88    #include <dt-bindings/gpio/gpio.h>
89    #include <dt-bindings/interrupt-controller/irq.h>
90    #include <dt-bindings/pinctrl/rockchip.h>
91    i2c {
92        #address-cells = <1>;
93        #size-cells = <0>;
94
95        bq25703: charger@6b {
96            compatible = "ti,bq25703a";
97            reg = <0x6b>;
98            input-current-limit-microamp = <5000000>;
99            interrupt-parent = <&gpio0>;
100            interrupts = <RK_PD5 IRQ_TYPE_LEVEL_LOW>;
101            monitored-battery = <&battery>;
102            power-supplies = <&fusb302>;
103
104            regulators {
105                usb_otg_vbus: vbus {
106                    enable-gpios = <&gpio4 RK_PA6 GPIO_ACTIVE_HIGH>;
107                    regulator-max-microamp = <960000>;
108                    regulator-max-microvolt = <5088000>;
109                    regulator-min-microamp = <512000>;
110                    regulator-min-microvolt = <4992000>;
111                    regulator-name = "usb_otg_vbus";
112                };
113            };
114        };
115    };
116
117...
118