1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2# Copyright (C) 2020 Texas Instruments Incorporated
3%YAML 1.2
4---
5$id: "http://devicetree.org/schemas/power/supply/bq25980.yaml#"
6$schema: "http://devicetree.org/meta-schemas/core.yaml#"
7
8title: TI BQ25980 Flash Charger
9
10maintainers:
11  - Dan Murphy <dmurphy@ti.com>
12  - Ricardo Rivera-Matos <r-rivera-matos@ti.com>
13
14description: |
15  The BQ25980, BQ25975, and BQ25960 are a series of flash chargers intended
16  for use in high-power density portable electronics. These inductorless
17  switching chargers can provide over 97% efficiency by making use of the
18  switched capacitor architecture.
19
20allOf:
21  - $ref: power-supply.yaml#
22
23properties:
24  compatible:
25    enum:
26      - ti,bq25980
27      - ti,bq25975
28      - ti,bq25960
29
30  reg:
31    maxItems: 1
32
33  ti,watchdog-timeout-ms:
34    description: |
35      Watchdog timer in milli seconds. 0 disables the watchdog.
36    default: 0
37    minimum: 0
38    maximum: 300000
39    enum: [ 0, 5000, 10000, 50000, 300000]
40
41  ti,sc-ovp-limit-microvolt:
42    description: |
43      Minimum input voltage limit in micro volts with a when the charger is in
44      switch cap mode. 100000 micro volt step.
45    default: 17800000
46    minimum: 14000000
47    maximum: 22000000
48
49  ti,sc-ocp-limit-microamp:
50    description: |
51      Maximum input current limit in micro amps with a 100000 micro amp step.
52    minimum: 100000
53    maximum: 3300000
54
55  ti,bypass-ovp-limit-microvolt:
56    description: |
57      Minimum input voltage limit in micro volts with a when the charger is in
58      switch cap mode. 50000 micro volt step.
59    minimum: 7000000
60    maximum: 12750000
61
62  ti,bypass-ocp-limit-microamp:
63    description: |
64      Maximum input current limit in micro amps with a 100000 micro amp step.
65    minimum: 100000
66    maximum: 3300000
67
68  ti,bypass-enable:
69    type: boolean
70    description: Enables bypass mode at boot time
71
72  interrupts:
73    description: |
74      Indicates that the device state has changed.
75
76  monitored-battery:
77    $ref: /schemas/types.yaml#/definitions/phandle
78    description: phandle to the battery node being monitored
79
80required:
81  - compatible
82  - reg
83  - monitored-battery
84
85unevaluatedProperties: false
86
87examples:
88  - |
89    bat: battery {
90      compatible = "simple-battery";
91      constant-charge-current-max-microamp = <4000000>;
92      constant-charge-voltage-max-microvolt = <8400000>;
93      precharge-current-microamp = <160000>;
94      charge-term-current-microamp = <160000>;
95    };
96    #include <dt-bindings/gpio/gpio.h>
97    #include <dt-bindings/interrupt-controller/irq.h>
98    i2c0 {
99      #address-cells = <1>;
100      #size-cells = <0>;
101
102      bq25980: charger@65 {
103          compatible = "ti,bq25980";
104          reg = <0x65>;
105          interrupt-parent = <&gpio1>;
106          interrupts = <16 IRQ_TYPE_EDGE_FALLING>;
107          ti,watchdog-timer = <0>;
108          ti,sc-ocp-limit-microamp = <2000000>;
109          ti,sc-ovp-limit-microvolt = <17800000>;
110          monitored-battery = <&bat>;
111      };
112    };
113
114...
115