xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/power/supply/bq25890.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunBinding for TI bq25890 Li-Ion Charger
2*4882a593Smuzhiyun
3*4882a593SmuzhiyunThis driver will support the bq25892, the bq25896 and the bq25890. There are
4*4882a593Smuzhiyunother ICs in the same family but those have not been tested.
5*4882a593Smuzhiyun
6*4882a593SmuzhiyunRequired properties:
7*4882a593Smuzhiyun- compatible: Should contain one of the following:
8*4882a593Smuzhiyun    * "ti,bq25890"
9*4882a593Smuzhiyun    * "ti,bq25892"
10*4882a593Smuzhiyun    * "ti,bq25895"
11*4882a593Smuzhiyun    * "ti,bq25896"
12*4882a593Smuzhiyun- reg: integer, i2c address of the device.
13*4882a593Smuzhiyun- interrupts: interrupt line;
14*4882a593Smuzhiyun- ti,battery-regulation-voltage: integer, maximum charging voltage (in uV);
15*4882a593Smuzhiyun- ti,charge-current: integer, maximum charging current (in uA);
16*4882a593Smuzhiyun- ti,termination-current: integer, charge will be terminated when current in
17*4882a593Smuzhiyun    constant-voltage phase drops below this value (in uA);
18*4882a593Smuzhiyun- ti,precharge-current: integer, maximum charge current during precharge
19*4882a593Smuzhiyun    phase (in uA);
20*4882a593Smuzhiyun- ti,minimum-sys-voltage: integer, when battery is charging and it is below
21*4882a593Smuzhiyun    minimum system voltage, the system will be regulated above
22*4882a593Smuzhiyun    minimum-sys-voltage setting (in uV);
23*4882a593Smuzhiyun- ti,boost-voltage: integer, VBUS voltage level in boost mode (in uV);
24*4882a593Smuzhiyun- ti,boost-max-current: integer, maximum allowed current draw in boost mode
25*4882a593Smuzhiyun    (in uA).
26*4882a593Smuzhiyun
27*4882a593SmuzhiyunOptional properties:
28*4882a593Smuzhiyun- ti,boost-low-freq: boolean, if present boost mode frequency will be 500kHz,
29*4882a593Smuzhiyun    otherwise 1.5MHz;
30*4882a593Smuzhiyun- ti,use-ilim-pin: boolean, if present the ILIM resistor will be used and the
31*4882a593Smuzhiyun    input current will be the lower between the resistor setting and the IINLIM
32*4882a593Smuzhiyun    register setting;
33*4882a593Smuzhiyun- ti,thermal-regulation-threshold: integer, temperature above which the charge
34*4882a593Smuzhiyun    current is lowered, to avoid overheating (in degrees Celsius). If omitted,
35*4882a593Smuzhiyun    the default setting will be used (120 degrees);
36*4882a593Smuzhiyun- ti,ibatcomp-micro-ohms: integer, value of a resistor in series with
37*4882a593Smuzhiyun    the battery;
38*4882a593Smuzhiyun- ti,ibatcomp-clamp-microvolt: integer, maximum charging voltage adjustment due
39*4882a593Smuzhiyun    to expected voltage drop on in-series resistor;
40*4882a593Smuzhiyun
41*4882a593SmuzhiyunExample:
42*4882a593Smuzhiyun
43*4882a593Smuzhiyunbq25890 {
44*4882a593Smuzhiyun	compatible = "ti,bq25890";
45*4882a593Smuzhiyun	reg = <0x6a>;
46*4882a593Smuzhiyun
47*4882a593Smuzhiyun	interrupt-parent = <&gpio1>;
48*4882a593Smuzhiyun	interrupts = <16 IRQ_TYPE_EDGE_FALLING>;
49*4882a593Smuzhiyun
50*4882a593Smuzhiyun	ti,battery-regulation-voltage = <4200000>;
51*4882a593Smuzhiyun	ti,charge-current = <1000000>;
52*4882a593Smuzhiyun	ti,termination-current = <50000>;
53*4882a593Smuzhiyun	ti,precharge-current = <128000>;
54*4882a593Smuzhiyun	ti,minimum-sys-voltage = <3600000>;
55*4882a593Smuzhiyun	ti,boost-voltage = <5000000>;
56*4882a593Smuzhiyun	ti,boost-max-current = <1000000>;
57*4882a593Smuzhiyun
58*4882a593Smuzhiyun	ti,use-ilim-pin;
59*4882a593Smuzhiyun	ti,thermal-regulation-threshold = <120>;
60*4882a593Smuzhiyun};
61