xref: /freebsd/sys/contrib/device-tree/Bindings/power/supply/bq25980.yaml (revision 06c3fb2749bda94cb5201f81ffdb8fa6c3161b2e) 
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  - Andrew Davis <afd@ti.com>
12
13description: |
14  The BQ25980, BQ25975, and BQ25960 are a series of flash chargers intended
15  for use in high-power density portable electronics. These inductorless
16  switching chargers can provide over 97% efficiency by making use of the
17  switched capacitor architecture.
18
19allOf:
20  - $ref: power-supply.yaml#
21
22properties:
23  compatible:
24    enum:
25      - ti,bq25980
26      - ti,bq25975
27      - ti,bq25960
28
29  reg:
30    maxItems: 1
31
32  ti,watchdog-timeout-ms:
33    description: |
34      Watchdog timer in milli seconds. 0 disables the watchdog.
35    default: 0
36    minimum: 0
37    maximum: 300000
38    enum: [ 0, 5000, 10000, 50000, 300000]
39
40  ti,sc-ovp-limit-microvolt:
41    description: |
42      Minimum input voltage limit in micro volts with a when the charger is in
43      switch cap mode. 100000 micro volt step.
44    default: 17800000
45    minimum: 14000000
46    maximum: 22000000
47
48  ti,sc-ocp-limit-microamp:
49    description: |
50      Maximum input current limit in micro amps with a 100000 micro amp step.
51    minimum: 100000
52    maximum: 3300000
53
54  ti,bypass-ovp-limit-microvolt:
55    description: |
56      Minimum input voltage limit in micro volts with a when the charger is in
57      switch cap mode. 50000 micro volt step.
58    minimum: 7000000
59    maximum: 12750000
60
61  ti,bypass-ocp-limit-microamp:
62    description: |
63      Maximum input current limit in micro amps with a 100000 micro amp step.
64    minimum: 100000
65    maximum: 3300000
66
67  ti,bypass-enable:
68    type: boolean
69    description: Enables bypass mode at boot time
70
71  interrupts:
72    maxItems: 1
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    i2c {
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-timeout-ms = <0>;
108          ti,sc-ocp-limit-microamp = <2000000>;
109          ti,sc-ovp-limit-microvolt = <17800000>;
110          monitored-battery = <&bat>;
111      };
112    };
113
114...
115