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