Documentation/devicetree/bindings/power/supply/cpcap-battery.yaml

   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
   8 title: Motorola CPCAP PMIC battery
   9
  10 maintainers:
  11   - Tony Lindgren <tony@atomide.com>
  12   - Sebastian Reichel <sre@kernel.org>
  13
  14 description: |
  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
  19 allOf:
  20   - $ref: power-supply.yaml#
  21
  22 properties:
  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
  60 required:
  61   - compatible
  62   - interrupts
  63   - interrupt-names
  64   - io-channels
  65   - io-channel-names
  66   - power-supplies
  67
  68 additionalProperties: false
  69
  70 examples:
  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     };