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/bq256xx.yaml#
6 $schema: http://devicetree.org/meta-schemas/core.yaml#
7
8 title: TI bq256xx Switch Mode Buck Charger
9
10 maintainers:
11 - Andrew Davis <afd@ti.com>
12
13 description: |
14 The bq256xx devices are a family of highly-integrated battery charge
15 management and system power management ICs for single cell Li-ion and Li-
16 polymer batteries.
17
18 Datasheets:
19 - https://www.ti.com/lit/ds/symlink/bq25600.pdf
20 - https://www.ti.com/lit/ds/symlink/bq25601.pdf
21 - https://www.ti.com/lit/ds/symlink/bq25600d.pdf
22 - https://www.ti.com/lit/ds/symlink/bq25601d.pdf
23 - https://www.ti.com/lit/ds/symlink/bq25611d.pdf
24 - https://www.ti.com/lit/ds/symlink/bq25618.pdf
25 - https://www.ti.com/lit/ds/symlink/bq25619.pdf
26
27 properties:
28 compatible:
29 enum:
30 - ti,bq25600
31 - ti,bq25601
32 - ti,bq25600d
33 - ti,bq25601d
34 - ti,bq25611d
35 - ti,bq25618
36 - ti,bq25619
37
38 reg:
39 maxItems: 1
40
41 ti,watchdog-timeout-ms:
42 default: 0
43 description: |
44 Watchdog timer in ms. 0 (default) disables the watchdog
45 minimum: 0
46 maximum: 160000
47 enum: [ 0, 40000, 80000, 160000]
48
49 input-voltage-limit-microvolt:
50 description: |
51 Minimum input voltage limit in µV with a 100000 µV step
52 minimum: 3900000
53 maximum: 5400000
54
55 input-current-limit-microamp:
56 description: |
57 Maximum input current limit in µA with a 100000 µA step
58 minimum: 100000
59 maximum: 3200000
60
61 monitored-battery:
62 $ref: /schemas/types.yaml#/definitions/phandle
63 description: phandle to the battery node being monitored
64
65 interrupts:
66 maxItems: 1
67 description: |
68 Interrupt sends an active low, 256 μs pulse to host to report the charger
69 device status and faults.
70
71 ti,no-thermistor:
72 type: boolean
73 description: Indicates that no thermistor is connected to the TS pin
74
75 required:
76 - compatible
77 - reg
78 - monitored-battery
79
80 allOf:
81 - if:
82 properties:
83 compatible:
84 contains:
85 enum:
86 - ti,bq25600
87 - ti,bq25601
88 - ti,bq25600d
89 - ti,bq25601d
90 then:
91 properties:
92 ti,no-thermistor: false
93
94 additionalProperties: false
95
96 examples:
97 - |
98 bat: battery {
99 compatible = "simple-battery";
100 constant-charge-current-max-microamp = <2040000>;
101 constant-charge-voltage-max-microvolt = <4352000>;
102 precharge-current-microamp = <180000>;
103 charge-term-current-microamp = <180000>;
104 };
105 #include <dt-bindings/gpio/gpio.h>
106 #include <dt-bindings/interrupt-controller/irq.h>
107 i2c {
108
109 clock-frequency = <400000>;
110
111 #address-cells = <1>;
112 #size-cells = <0>;
113
114 charger@6b {
115 compatible = "ti,bq25601";
116 reg = <0x6b>;
117 monitored-battery = <&bat>;
118
119 interrupt-parent = <&gpio1>;
120 interrupts = <16 IRQ_TYPE_EDGE_FALLING>;
121 ti,watchdog-timeout-ms = <40000>;
122
123 input-voltage-limit-microvolt = <4500000>;
124 input-current-limit-microamp = <2400000>;
125 };
126 };
127 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.