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