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