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