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/bq24257.yaml#
6 $schema: http://devicetree.org/meta-schemas/co 6 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 7
8 title: Bq24250, bq24251 and bq24257 Li-Ion Cha 8 title: Bq24250, bq24251 and bq24257 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 enum: 18 enum:
19 - ti,bq24250 19 - ti,bq24250
20 - ti,bq24251 20 - ti,bq24251
21 - ti,bq24257 21 - ti,bq24257
22 22
23 reg: 23 reg:
24 maxItems: 1 24 maxItems: 1
25 25
26 interrupts: 26 interrupts:
27 maxItems: 1 27 maxItems: 1
28 28
29 ti,battery-regulation-voltage: 29 ti,battery-regulation-voltage:
30 $ref: /schemas/types.yaml#/definitions/uin 30 $ref: /schemas/types.yaml#/definitions/uint32
31 description: maximum charging voltage in u 31 description: maximum charging voltage in uV
32 32
33 ti,charge-current: 33 ti,charge-current:
34 $ref: /schemas/types.yaml#/definitions/uin 34 $ref: /schemas/types.yaml#/definitions/uint32
35 description: maximum charging current in u 35 description: maximum charging current in uA
36 36
37 ti,termination-current: 37 ti,termination-current:
38 $ref: /schemas/types.yaml#/definitions/uin 38 $ref: /schemas/types.yaml#/definitions/uint32
39 description: | 39 description: |
40 charge will be terminated when current i 40 charge will be terminated when current in constant-voltage phase
41 drops below this value (in uA) 41 drops below this value (in uA)
42 42
43 pg-gpios: 43 pg-gpios:
44 description: | 44 description: |
45 GPIO used for connecting the bq2425x dev 45 GPIO used for connecting the bq2425x device PG (Power Good) pin.
46 This pin is not available on all devices 46 This pin is not available on all devices however it should be used if
47 possible as this is the recommended way 47 possible as this is the recommended way to obtain the charger's input PG
48 state. If this pin is not specified a so 48 state. If this pin is not specified a software-based approach for PG
49 detection is used. 49 detection is used.
50 maxItems: 1 50 maxItems: 1
51 51
52 ti,current-limit: 52 ti,current-limit:
53 $ref: /schemas/types.yaml#/definitions/uin 53 $ref: /schemas/types.yaml#/definitions/uint32
54 description: | 54 description: |
55 The maximum current to be drawn from the 55 The maximum current to be drawn from the charger's input (in uA).
56 If this property is not specified, the i 56 If this property is not specified, the input limit current is set
57 automatically using USB D+/D- signal bas 57 automatically using USB D+/D- signal based charger type detection.
58 If the hardware does not support the D+/ 58 If the hardware does not support the D+/D- based detection, a default
59 of 500,000 is used (=500mA) instead. 59 of 500,000 is used (=500mA) instead.
60 60
61 ti,ovp-voltage: 61 ti,ovp-voltage:
62 $ref: /schemas/types.yaml#/definitions/uin 62 $ref: /schemas/types.yaml#/definitions/uint32
63 description: | 63 description: |
64 Configures the over voltage protection v 64 Configures the over voltage protection voltage (in uV).
65 If not specified a default of 6,5000,000 65 If not specified a default of 6,5000,000 (=6.5V) is used.
66 66
67 ti,in-dpm-voltage: 67 ti,in-dpm-voltage:
68 $ref: /schemas/types.yaml#/definitions/uin 68 $ref: /schemas/types.yaml#/definitions/uint32
69 description: | 69 description: |
70 Configures the threshold input voltage f 70 Configures the threshold input voltage for the dynamic power path management (in uV).
71 If not specified a default of 4,360,000 71 If not specified a default of 4,360,000 (=4.36V) is used.
72 72
73 required: 73 required:
74 - compatible 74 - compatible
75 - reg 75 - reg
76 - interrupts 76 - interrupts
77 - ti,battery-regulation-voltage 77 - ti,battery-regulation-voltage
78 - ti,charge-current 78 - ti,charge-current
79 - ti,termination-current 79 - ti,termination-current
80 80
81 additionalProperties: false 81 additionalProperties: false
82 82
83 examples: 83 examples:
84 - | 84 - |
85 #include <dt-bindings/gpio/gpio.h> 85 #include <dt-bindings/gpio/gpio.h>
86 #include <dt-bindings/interrupt-controller 86 #include <dt-bindings/interrupt-controller/irq.h>
87 i2c { !! 87 i2c0 {
88 #address-cells = <1>; 88 #address-cells = <1>;
89 #size-cells = <0>; 89 #size-cells = <0>;
90 90
91 charger@6a { 91 charger@6a {
92 compatible = "ti,bq24257"; 92 compatible = "ti,bq24257";
93 reg = <0x6a>; 93 reg = <0x6a>;
94 interrupt-parent = <&gpio1>; 94 interrupt-parent = <&gpio1>;
95 interrupts = <16 IRQ_TYPE_EDGE_BOTH>; 95 interrupts = <16 IRQ_TYPE_EDGE_BOTH>;
96 96
97 pg-gpios = <&gpio1 28 GPIO_ACTIVE_HIGH 97 pg-gpios = <&gpio1 28 GPIO_ACTIVE_HIGH>;
98 98
99 ti,battery-regulation-voltage = <42000 99 ti,battery-regulation-voltage = <4200000>;
100 ti,charge-current = <1000000>; 100 ti,charge-current = <1000000>;
101 ti,termination-current = <50000>; 101 ti,termination-current = <50000>;
102 }; 102 };
103 }; 103 };
104 - | 104 - |
105 #include <dt-bindings/gpio/gpio.h> 105 #include <dt-bindings/gpio/gpio.h>
106 #include <dt-bindings/interrupt-controller 106 #include <dt-bindings/interrupt-controller/irq.h>
107 i2c { !! 107 i2c0 {
108 #address-cells = <1>; 108 #address-cells = <1>;
109 #size-cells = <0>; 109 #size-cells = <0>;
110 110
111 charger@6a { 111 charger@6a {
112 compatible = "ti,bq24250"; 112 compatible = "ti,bq24250";
113 reg = <0x6a>; 113 reg = <0x6a>;
114 interrupt-parent = <&gpio1>; 114 interrupt-parent = <&gpio1>;
115 interrupts = <16 IRQ_TYPE_EDGE_BOTH>; 115 interrupts = <16 IRQ_TYPE_EDGE_BOTH>;
116 116
117 ti,battery-regulation-voltage = <42000 117 ti,battery-regulation-voltage = <4200000>;
118 ti,charge-current = <500000>; 118 ti,charge-current = <500000>;
119 ti,termination-current = <50000>; 119 ti,termination-current = <50000>;
120 ti,current-limit = <900000>; 120 ti,current-limit = <900000>;
121 ti,ovp-voltage = <9500000>; 121 ti,ovp-voltage = <9500000>;
122 ti,in-dpm-voltage = <4440000>; 122 ti,in-dpm-voltage = <4440000>;
123 }; 123 };
124 }; 124 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.