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