xref: /kernel/linux/linux-6.6/Documentation/devicetree/bindings/power/supply/qcom,pm8941-coincell.yaml

# SPDX-License-Identifier: GPL-2.0
%YAML 1.2
---
$id: http://devicetree.org/schemas/power/supply/qcom,pm8941-coincell.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Qualcomm Coincell Charger

description: |
  The hardware block controls charging for a coincell or capacitor that is
  used to provide power backup for certain features of the power management
  IC (PMIC)

maintainers:
  - Sebastian Reichel <sre@kernel.org>

properties:
  compatible:
    oneOf:
      - items:
          - enum:
              - qcom,pm8998-coincell
          - const: qcom,pm8941-coincell

      - const: qcom,pm8941-coincell

  reg:
    maxItems: 1

  qcom,rset-ohms:
    description: |
      Resistance (in ohms) for current-limiting resistor. If unspecified,
      inherit the previous configuration (e.g. from bootloader or hardware
      default value).
    enum: [ 800, 1200, 1700, 2100 ]

  qcom,vset-millivolts:
    $ref: /schemas/types.yaml#/definitions/uint32
    description: |
      Voltage (in millivolts) to apply for charging. If unspecified, inherit
      the previous configuration (e.g. from bootloader or hardware default
      value).
    enum: [ 2500, 3000, 3100, 3200 ]

  qcom,charger-disable:
    type: boolean
    description: defining this property disables charging

required:
  - compatible
  - reg

additionalProperties: false

examples:
  - |
    pmic {
      #address-cells = <1>;
      #size-cells = <0>;

      charger@2800 {
        compatible = "qcom,pm8941-coincell";
        reg = <0x2800>;
        qcom,rset-ohms = <2100>;
        qcom,vset-millivolts = <3000>;
      };
    };