xref: /freebsd/sys/contrib/device-tree/Bindings/power/supply/cpcap-battery.yaml (revision 9768746ba83efa02837c5b9c66348db6e900208f)
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  power-supplies: true
59
60required:
61  - compatible
62  - interrupts
63  - interrupt-names
64  - io-channels
65  - io-channel-names
66  - power-supplies
67
68additionalProperties: false
69
70examples:
71  - |
72    cpcap {
73      battery {
74        compatible = "motorola,cpcap-battery";
75        interrupts-extended =
76                <&cpcap 6 0>, <&cpcap 5 0>, <&cpcap 3 0>,
77                <&cpcap 20 0>, <&cpcap 54 0>, <&cpcap 57 0>;
78        interrupt-names =
79                "eol", "lowbph", "lowbpl",
80                "chrgcurr1", "battdetb", "cccal";
81        io-channels = <&cpcap_adc 0>, <&cpcap_adc 1>,
82                      <&cpcap_adc 5>, <&cpcap_adc 6>;
83        io-channel-names = "battdetb", "battp",
84                           "chg_isense", "batti";
85        power-supplies = <&cpcap_charger>;
86      };
87    };
88