1 # SPDX-License-Identifier: GPL-2.0
2 # Copyright (C) 2021 Sebastian Reichel
3 %YAML 1.2
4 ---
5 $id: http://devicetree.org/schemas/power/supply/bq25890.yaml#
6 $schema: http://devicetree.org/meta-schemas/core.yaml#
7
8 title: Bq25890, bq25892, bq25895 and bq25896 Li-Ion Charger
9
10 maintainers:
11 - Sebastian Reichel <sre@kernel.org>
12
13 allOf:
14 - $ref: power-supply.yaml#
15
16 properties:
17 compatible:
18 oneOf:
19 - enum:
20 - ti,bq25890
21 - items:
22 - enum:
23 - ti,bq25892
24 - ti,bq25895
25 - ti,bq25896
26 - const: ti,bq25890
27
28 reg:
29 maxItems: 1
30
31 interrupts:
32 maxItems: 1
33
34 ti,battery-regulation-voltage:
35 $ref: /schemas/types.yaml#/definitions/uint32
36 description: maximum charging voltage (in uV)
37
38 ti,charge-current:
39 $ref: /schemas/types.yaml#/definitions/uint32
40 description: maximum charging current (in uA)
41
42 ti,termination-current:
43 $ref: /schemas/types.yaml#/definitions/uint32
44 description: |
45 charge will be terminated when current in constant-voltage phase
46 drops below this value (in uA)
47
48 ti,precharge-current:
49 $ref: /schemas/types.yaml#/definitions/uint32
50 description: maximum charge current during precharge phase (in uA)
51
52 ti,minimum-sys-voltage:
53 $ref: /schemas/types.yaml#/definitions/uint32
54 description: |
55 when battery is charging and it is below minimum system voltage,
56 the system will be regulated above minimum-sys-voltage setting (in uV)
57
58 ti,boost-voltage:
59 $ref: /schemas/types.yaml#/definitions/uint32
60 description: VBUS voltage level in boost mode (in uV)
61
62 ti,boost-max-current:
63 $ref: /schemas/types.yaml#/definitions/uint32
64 description: maximum allowed current draw in boost mode (in uA)
65
66 ti,boost-low-freq:
67 description: boost mode frequency will be 500kHz, otherwise 1.5MHz
68 type: boolean
69
70 ti,use-ilim-pin:
71 description: |
72 ILIM resistor will be used and the input current will be the lower
73 between the resistor setting and the IINLIM register setting
74 type: boolean
75
76 ti,thermal-regulation-threshold:
77 $ref: /schemas/types.yaml#/definitions/uint32
78 description: |
79 temperature above which the charge current is lowered, to avoid overheating
80 (in degrees Celsius). If omitted, the default setting will be used (120 degrees)
81
82 ti,ibatcomp-micro-ohms:
83 description: value of a resistor in series with the battery (in Micro Ohms)
84
85 ti,ibatcomp-clamp-microvolt:
86 description: max. charging voltage adjustment due to expected voltage drop on in-series resistor
87
88 required:
89 - compatible
90 - reg
91 - interrupts
92 - ti,battery-regulation-voltage
93 - ti,charge-current
94 - ti,termination-current
95 - ti,precharge-current
96 - ti,minimum-sys-voltage
97 - ti,boost-voltage
98 - ti,boost-max-current
99
100 unevaluatedProperties: false
101
102 examples:
103 - |
104 #include <dt-bindings/interrupt-controller/irq.h>
105 i2c {
106 #address-cells = <1>;
107 #size-cells = <0>;
108
109 charger@6a {
110 compatible = "ti,bq25890";
111 reg = <0x6a>;
112
113 interrupt-parent = <&gpio1>;
114 interrupts = <16 IRQ_TYPE_EDGE_FALLING>;
115
116 ti,battery-regulation-voltage = <4200000>;
117 ti,charge-current = <1000000>;
118 ti,termination-current = <50000>;
119 ti,precharge-current = <128000>;
120 ti,minimum-sys-voltage = <3600000>;
121 ti,boost-voltage = <5000000>;
122 ti,boost-max-current = <1000000>;
123
124 ti,use-ilim-pin;
125 ti,thermal-regulation-threshold = <120>;
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.