xref: /freebsd/sys/contrib/device-tree/Bindings/power/supply/bq2415x.yaml (revision b197d4b893974c9eb4d7b38704c6d5c486235d6f) 
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/bq2415x.yaml#"
6$schema: "http://devicetree.org/meta-schemas/core.yaml#"
7
8title: Binding for TI bq2415x Li-Ion Charger
9
10maintainers:
11  - Sebastian Reichel <sre@kernel.org>
12
13allOf:
14  - $ref: power-supply.yaml#
15
16properties:
17  compatible:
18    enum:
19      - ti,bq24150
20      - ti,bq24150a
21      - ti,bq24151
22      - ti,bq24151a
23      - ti,bq24152
24      - ti,bq24153
25      - ti,bq24153a
26      - ti,bq24155
27      - ti,bq24156
28      - ti,bq24156a
29      - ti,bq24158
30
31  reg:
32    maxItems: 1
33
34  ti,current-limit:
35    $ref: /schemas/types.yaml#/definitions/uint32
36    description: initial maximum current charger can pull from power supply in mA.
37
38  ti,weak-battery-voltage:
39    $ref: /schemas/types.yaml#/definitions/uint32
40    description: |
41      weak battery voltage threshold in mV.
42      The chip will use slow precharge if battery voltage is below this value.
43
44  ti,battery-regulation-voltage:
45    $ref: /schemas/types.yaml#/definitions/uint32
46    description: maximum charging voltage in mV.
47
48  ti,charge-current:
49    $ref: /schemas/types.yaml#/definitions/uint32
50    description: maximum charging current in mA.
51
52  ti,termination-current:
53    $ref: /schemas/types.yaml#/definitions/uint32
54    description: |
55      charge will be terminated when current in constant-voltage phase drops
56      below this value (in mA).
57
58  ti,resistor-sense:
59    $ref: /schemas/types.yaml#/definitions/uint32
60    description: value of sensing resistor in milliohm.
61
62  ti,usb-charger-detection:
63    $ref: /schemas/types.yaml#/definitions/phandle
64    description: phandle to usb charger detection device (required for auto mode)
65
66required:
67  - compatible
68  - reg
69  - ti,current-limit
70  - ti,weak-battery-voltage
71  - ti,battery-regulation-voltage
72  - ti,charge-current
73  - ti,termination-current
74  - ti,resistor-sense
75
76additionalProperties: false
77
78examples:
79  - |
80    i2c0 {
81      #address-cells = <1>;
82      #size-cells = <0>;
83
84      charger@6b {
85        compatible = "ti,bq24150a";
86        reg = <0x6b>;
87
88        ti,current-limit = <100>;
89        ti,weak-battery-voltage = <3400>;
90        ti,battery-regulation-voltage = <4200>;
91        ti,charge-current = <650>;
92        ti,termination-current = <100>;
93        ti,resistor-sense = <68>;
94
95        ti,usb-charger-detection = <&isp1704>;
96      };
97    };
98