xref: /freebsd/sys/contrib/device-tree/Bindings/power/supply/bq24190.txt (revision 7fdf597e96a02165cfe22ff357b857d5fa15ed8a)
1TI BQ24190 Li-Ion Battery Charger
2
3Required 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
12Optional 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
24child 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
30Notes:
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
35Example:
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	};
62