xref: /freebsd/sys/contrib/device-tree/Bindings/power/supply/bq24190.txt (revision a03411e84728e9b267056fd31c7d1d9d1dc1b01e)
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