xref: /freebsd/sys/contrib/device-tree/Bindings/power/supply/bq24257.txt (revision e8d8bef961a50d4dc22501cde4fb9fb0be1b2532)
1Binding for TI bq24250/bq24251/bq24257 Li-Ion Charger
2
3Required properties:
4- compatible: Should contain one of the following:
5 * "ti,bq24250"
6 * "ti,bq24251"
7 * "ti,bq24257"
8- reg: integer, i2c address of the device.
9- interrupts: Interrupt mapping for GPIO IRQ (configure for both edges). Use in
10    conjunction with "interrupt-parent".
11- ti,battery-regulation-voltage: integer, maximum charging voltage in uV.
12- ti,charge-current: integer, maximum charging current in uA.
13- ti,termination-current: integer, charge will be terminated when current in
14    constant-voltage phase drops below this value (in uA).
15
16Optional properties:
17- pg-gpios: GPIO used for connecting the bq2425x device PG (Power Good) pin.
18    This pin is not available on all devices however it should be used if
19    possible as this is the recommended way to obtain the charger's input PG
20    state. If this pin is not specified a software-based approach for PG
21    detection is used.
22- ti,current-limit: The maximum current to be drawn from the charger's input
23    (in uA). If this property is not specified, the input limit current is
24    set automatically using USB D+/D- signal based charger type detection.
25    If the hardware does not support the D+/D- based detection, a default
26    of 500,000 is used (=500mA) instead.
27- ti,ovp-voltage: Configures the over voltage protection voltage (in uV). If
28    not specified a default of 6,5000,000 (=6.5V) is used.
29- ti,in-dpm-voltage: Configures the threshold input voltage for the dynamic
30    power path management (in uV). If not specified a default of 4,360,000
31    (=4.36V) is used.
32
33Example:
34
35bq24257 {
36	compatible = "ti,bq24257";
37	reg = <0x6a>;
38	interrupt-parent = <&gpio1>;
39	interrupts = <16 IRQ_TYPE_EDGE_BOTH>;
40
41	pg-gpios = <&gpio1 28 GPIO_ACTIVE_HIGH>;
42
43	ti,battery-regulation-voltage = <4200000>;
44	ti,charge-current = <1000000>;
45	ti,termination-current = <50000>;
46};
47
48Example:
49
50bq24250 {
51	compatible = "ti,bq24250";
52	reg = <0x6a>;
53	interrupt-parent = <&gpio1>;
54	interrupts = <16 IRQ_TYPE_EDGE_BOTH>;
55
56	ti,battery-regulation-voltage = <4200000>;
57	ti,charge-current = <500000>;
58	ti,termination-current = <50000>;
59	ti,current-limit = <900000>;
60	ti,ovp-voltage = <9500000>;
61	ti,in-dpm-voltage = <4440000>;
62};
63