xref: /linux/Documentation/devicetree/bindings/power/supply/cpcap-battery.yaml (revision fbf5df34a4dbcd09d433dd4f0916bf9b2ddb16de) 
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/cpcap-battery.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Motorola CPCAP PMIC battery
9
10maintainers:
11  - Tony Lindgren <tony@atomide.com>
12  - Sebastian Reichel <sre@kernel.org>
13
14description: |
15  Motorola CPCAP is a PMIC found in some mobile phones, e.g.
16  the Droid 4. This binding describes its battery fuel gauge
17  sub-function.
18
19allOf:
20  - $ref: power-supply.yaml#
21
22properties:
23  compatible:
24    const: motorola,cpcap-battery
25
26  interrupts:
27    items:
28      - description: eol interrupt
29      - description: low battery percentage interrupt
30      - description: critical battery percentage interrupt
31      - description: charger detect interrupt
32      - description: battery detect interrupt
33      - description: coulomb counter calibration interrupt
34
35  interrupt-names:
36    items:
37      - const: eol
38      - const: lowbph
39      - const: lowbpl
40      - const: chrgcurr1
41      - const: battdetb
42      - const: cccal
43
44  io-channels:
45    items:
46      - description: battery temperature
47      - description: battery voltage
48      - description: battery charge current
49      - description: battery current
50
51  io-channel-names:
52    items:
53      - const: battdetb
54      - const: battp
55      - const: chg_isense
56      - const: batti
57
58  monitored-battery: true
59  power-supplies: true
60
61required:
62  - compatible
63  - interrupts
64  - interrupt-names
65  - io-channels
66  - io-channel-names
67  - power-supplies
68
69additionalProperties: false
70
71examples:
72  - |
73    cpcap {
74      battery {
75        compatible = "motorola,cpcap-battery";
76        interrupts-extended =
77                <&cpcap 6 0>, <&cpcap 5 0>, <&cpcap 3 0>,
78                <&cpcap 20 0>, <&cpcap 54 0>, <&cpcap 57 0>;
79        interrupt-names =
80                "eol", "lowbph", "lowbpl",
81                "chrgcurr1", "battdetb", "cccal";
82        io-channels = <&cpcap_adc 0>, <&cpcap_adc 1>,
83                      <&cpcap_adc 5>, <&cpcap_adc 6>;
84        io-channel-names = "battdetb", "battp",
85                           "chg_isense", "batti";
86        power-supplies = <&cpcap_charger>;
87      };
88    };
89