xref: /linux/Documentation/devicetree/bindings/power/supply/bq25890.yaml (revision 42874e4eb35bdfc54f8514685e50434098ba4f6c) 
1# SPDX-License-Identifier: GPL-2.0
2# Copyright (C) 2021 Sebastian Reichel
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/power/supply/bq25890.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Bq25890, bq25892, bq25895 and bq25896 Li-Ion Charger
9
10maintainers:
11  - Sebastian Reichel <sre@kernel.org>
12
13allOf:
14  - $ref: power-supply.yaml#
15
16properties:
17  compatible:
18    oneOf:
19      - enum:
20          - ti,bq25890
21      - items:
22          - enum:
23              - ti,bq25892
24              - ti,bq25895
25              - ti,bq25896
26          - const: ti,bq25890
27
28  reg:
29    maxItems: 1
30
31  interrupts:
32    maxItems: 1
33
34  ti,battery-regulation-voltage:
35    $ref: /schemas/types.yaml#/definitions/uint32
36    description: maximum charging voltage (in uV)
37
38  ti,charge-current:
39    $ref: /schemas/types.yaml#/definitions/uint32
40    description: maximum charging current (in uA)
41
42  ti,termination-current:
43    $ref: /schemas/types.yaml#/definitions/uint32
44    description: |
45      charge will be terminated when current in constant-voltage phase
46      drops below this value (in uA)
47
48  ti,precharge-current:
49    $ref: /schemas/types.yaml#/definitions/uint32
50    description: maximum charge current during precharge phase (in uA)
51
52  ti,minimum-sys-voltage:
53    $ref: /schemas/types.yaml#/definitions/uint32
54    description: |
55      when battery is charging and it is below minimum system voltage,
56      the system will be regulated above minimum-sys-voltage setting (in uV)
57
58  ti,boost-voltage:
59    $ref: /schemas/types.yaml#/definitions/uint32
60    description: VBUS voltage level in boost mode (in uV)
61
62  ti,boost-max-current:
63    $ref: /schemas/types.yaml#/definitions/uint32
64    description: maximum allowed current draw in boost mode (in uA)
65
66  ti,boost-low-freq:
67    description: boost mode frequency will be 500kHz, otherwise 1.5MHz
68    type: boolean
69
70  ti,use-ilim-pin:
71    description: |
72      ILIM resistor will be used and the input current will be the lower
73      between the resistor setting and the IINLIM register setting
74    type: boolean
75
76  ti,thermal-regulation-threshold:
77    $ref: /schemas/types.yaml#/definitions/uint32
78    description: |
79      temperature above which the charge current is lowered, to avoid overheating
80      (in degrees Celsius). If omitted, the default setting will be used (120 degrees)
81
82  ti,ibatcomp-micro-ohms:
83    description: value of a resistor in series with the battery (in Micro Ohms)
84
85  ti,ibatcomp-clamp-microvolt:
86    description: max. charging voltage adjustment due to expected voltage drop on in-series resistor
87
88required:
89  - compatible
90  - reg
91  - interrupts
92  - ti,battery-regulation-voltage
93  - ti,charge-current
94  - ti,termination-current
95  - ti,precharge-current
96  - ti,minimum-sys-voltage
97  - ti,boost-voltage
98  - ti,boost-max-current
99
100unevaluatedProperties: false
101
102examples:
103  - |
104    #include <dt-bindings/interrupt-controller/irq.h>
105    i2c {
106      #address-cells = <1>;
107      #size-cells = <0>;
108
109      charger@6a {
110        compatible = "ti,bq25890";
111        reg = <0x6a>;
112
113        interrupt-parent = <&gpio1>;
114        interrupts = <16 IRQ_TYPE_EDGE_FALLING>;
115
116        ti,battery-regulation-voltage = <4200000>;
117        ti,charge-current = <1000000>;
118        ti,termination-current = <50000>;
119        ti,precharge-current = <128000>;
120        ti,minimum-sys-voltage = <3600000>;
121        ti,boost-voltage = <5000000>;
122        ti,boost-max-current = <1000000>;
123
124        ti,use-ilim-pin;
125        ti,thermal-regulation-threshold = <120>;
126      };
127    };
128