Merge tag 'for-4.21/block-20190102' of git://git.kernel.dk/linux-block
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / power / supply / bq24190.txt
1 TI BQ24190 Li-Ion Battery Charger
2
3 Required properties:
4 - compatible: contains one of the following:
5     * "ti,bq24190"
6     * "ti,bq24192"
7     * "ti,bq24192i"
8     * "ti,bq24196"
9 - reg: integer, I2C address of the charger.
10 - interrupts[-extended]: configuration for charger INT pin.
11
12 Optional properties:
13 - monitored-battery: phandle of battery characteristics devicetree node
14   The charger uses the following battery properties:
15     + precharge-current-microamp: maximum charge current during precharge
16       phase (typically 20% of battery capacity).
17     + charge-term-current-microamp: a charge cycle terminates when the
18       battery voltage is above recharge threshold, and the current is below
19       this setting (typically 10% of battery capacity).
20   See also Documentation/devicetree/bindings/power/supply/battery.txt
21 - ti,system-minimum-microvolt: when power is connected and the battery is below
22   minimum system voltage, the system will be regulated above this setting.
23
24 child nodes:
25 - usb-otg-vbus:
26   Usage: optional
27   Description: Regulator that is used to control the VBUS voltage direction for
28                either USB host mode or for charging on the OTG port.
29
30 Notes:
31 - Some circuit boards wire the chip's "OTG" pin high (enabling 500mA default
32   charge current on USB SDP ports, among other features). To simulate this on
33   boards that wire the pin to a GPIO, set a gpio-hog.
34
35 Example:
36
37         bat: battery {
38                 compatible = "simple-battery";
39                 precharge-current-microamp = <256000>;
40                 charge-term-current-microamp = <128000>;
41                 // etc.
42         };
43
44         bq24190: charger@6a {
45                 compatible = "ti,bq24190";
46                 reg = <0x6a>;
47                 interrupts-extended = <&gpiochip 10 IRQ_TYPE_EDGE_FALLING>;
48                 monitored-battery = <&bat>;
49                 ti,system-minimum-microvolt = <3200000>;
50
51                 usb_otg_vbus: usb-otg-vbus { };
52         };
53
54         &twl_gpio {
55                 otg {
56                         gpio-hog;
57                         gpios = <6 0>;
58                         output-high;
59                         line-name = "otg-gpio";
60                 };
61         };