Merge tag 'for-v5.12' of git://git.kernel.org/pub/scm/linux/kernel/git/sre/linux...
[platform/kernel/linux-starfive.git] / Documentation / devicetree / bindings / power / supply / ltc4162-l.yaml
1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 # Copyright (C) 2020 Topic Embedded Products
3 %YAML 1.2
4 ---
5 $id: "http://devicetree.org/schemas/power/supply/ltc4162-l.yaml#"
6 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
7
8 title: Linear Technology (Analog Devices) LTC4162-L Charger
9
10 maintainers:
11   - Mike Looijmans <mike.looijmans@topic.nl>
12
13 description: |
14   The LTC ® 4162-L is an advanced monolithic synchronous step-down switching
15   battery charger and PowerPath (TM) manager that seamlessly manages power
16   distribution between input sources such as wall adapters, backplanes, solar
17   panels, etc., and a rechargeable Lithium-Ion/Polymer battery.
18
19   Specifications about the charger can be found at:
20     https://www.analog.com/en/products/ltc4162-s.html
21
22 properties:
23   compatible:
24     enum:
25       - lltc,ltc4162-l
26
27   reg:
28     maxItems: 1
29     description: I2C address of the charger.
30
31   lltc,rsnsb-micro-ohms:
32     $ref: /schemas/types.yaml#/definitions/uint32
33     description: Battery sense resistor in microohm.
34     minimum: 1000
35
36   lltc,rsnsi-micro-ohms:
37     $ref: /schemas/types.yaml#/definitions/uint32
38     description: Input current sense resistor in microohm.
39     minimum: 1000
40
41   lltc,cell-count:
42     $ref: /schemas/types.yaml#/definitions/uint32
43     description: |
44       Number of battery cells. If not provided, will be obtained from the chip
45       once the external power is applied. Omit this when the number of cells
46       is somewhat dynamic. Without it, several measurements will return 0 until
47       the charger is connected to an external supply.
48
49 required:
50   - compatible
51   - reg
52   - lltc,rsnsb-micro-ohms
53   - lltc,rsnsi-micro-ohms
54
55 additionalProperties: false
56
57 examples:
58   - |
59     i2c0 {
60       #address-cells = <1>;
61       #size-cells = <0>;
62       charger: battery-charger@68 {
63               compatible = "lltc,ltc4162-l";
64               reg = <0x68>;
65               lltc,rsnsb-micro-ohms = <10000>;
66               lltc,rsnsi-micro-ohms = <16000>;
67               lltc,cell-count = <2>;
68       };
69     };