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