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/bq24190.yaml#
6 $schema: http://devicetree.org/meta-schemas/co 6 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 7
8 title: TI BQ2419x Li-Ion Battery Charger 8 title: TI BQ2419x Li-Ion Battery 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,bq24190 19 - ti,bq24190
20 - ti,bq24192 20 - ti,bq24192
21 - ti,bq24192i 21 - ti,bq24192i
22 - ti,bq24196 22 - ti,bq24196
23 - ti,bq24296 23 - ti,bq24296
24 24
25 reg: 25 reg:
26 maxItems: 1 26 maxItems: 1
27 27
28 interrupts: 28 interrupts:
29 maxItems: 1 29 maxItems: 1
30 30
31 usb-otg-vbus: 31 usb-otg-vbus:
32 $ref: /schemas/regulator/regulator.yaml# 32 $ref: /schemas/regulator/regulator.yaml#
33 description: | 33 description: |
34 Regulator that is used to control the VB 34 Regulator that is used to control the VBUS voltage direction for
35 either USB host mode or for charging on 35 either USB host mode or for charging on the OTG port
36 36
37 ti,system-minimum-microvolt: 37 ti,system-minimum-microvolt:
38 description: | 38 description: |
39 when power is connected and the battery 39 when power is connected and the battery is below minimum system voltage,
40 the system will be regulated above this 40 the system will be regulated above this setting.
41 41
42 omit-battery-class: 42 omit-battery-class:
43 type: boolean 43 type: boolean
44 description: | 44 description: |
45 If this property is set, the operating s 45 If this property is set, the operating system does not try to create a
46 battery device. 46 battery device.
47 47
48 monitored-battery: 48 monitored-battery:
49 $ref: /schemas/types.yaml#/definitions/pha 49 $ref: /schemas/types.yaml#/definitions/phandle
50 description: | 50 description: |
51 phandle to a "simple-battery" compatible 51 phandle to a "simple-battery" compatible node.
52 52
53 This property must be a phandle to a nod 53 This property must be a phandle to a node using the format described
54 in battery.yaml, with the following prop 54 in battery.yaml, with the following properties being required:
55 - precharge-current-microamp: maximum ch 55 - precharge-current-microamp: maximum charge current during precharge phase
56 (typically 56 (typically 20% of battery capacity).
57 - charge-term-current-microamp: a charge 57 - charge-term-current-microamp: a charge cycle terminates when the battery voltage is
58 above re 58 above recharge threshold, and the current is below this
59 setting 59 setting (typically 10% of battery capacity).
60 60
61 required: 61 required:
62 - compatible 62 - compatible
63 - reg 63 - reg
64 - interrupts 64 - interrupts
65 65
66 additionalProperties: false 66 additionalProperties: false
67 67
68 examples: 68 examples:
69 - | 69 - |
70 #include <dt-bindings/gpio/gpio.h> 70 #include <dt-bindings/gpio/gpio.h>
71 #include <dt-bindings/interrupt-controller 71 #include <dt-bindings/interrupt-controller/irq.h>
72 72
73 bat: battery { 73 bat: battery {
74 compatible = "simple-battery"; 74 compatible = "simple-battery";
75 precharge-current-microamp = <256000>; 75 precharge-current-microamp = <256000>;
76 charge-term-current-microamp = <128000>; 76 charge-term-current-microamp = <128000>;
77 }; 77 };
78 78
79 i2c { 79 i2c {
80 #address-cells = <1>; 80 #address-cells = <1>;
81 #size-cells = <0>; 81 #size-cells = <0>;
82 82
83 charger@6a { 83 charger@6a {
84 compatible = "ti,bq24190"; 84 compatible = "ti,bq24190";
85 reg = <0x6a>; 85 reg = <0x6a>;
86 interrupt-parent = <&gpiochip>; 86 interrupt-parent = <&gpiochip>;
87 interrupts = <10 IRQ_TYPE_EDGE_FALLING 87 interrupts = <10 IRQ_TYPE_EDGE_FALLING>;
88 monitored-battery = <&bat>; 88 monitored-battery = <&bat>;
89 ti,system-minimum-microvolt = <3200000 89 ti,system-minimum-microvolt = <3200000>;
90 90
91 usb_otg_vbus: usb-otg-vbus { }; 91 usb_otg_vbus: usb-otg-vbus { };
92 }; 92 };
93 }; 93 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.