Documentation/devicetree/bindings/mfd/qcom-pm8xxx.yaml

# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/mfd/qcom-pm8xxx.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Qualcomm PM8xxx PMIC multi-function devices

maintainers:
  - Satya Priya <quic_c_skakit@quicinc.com>

description: |
  The PM8xxx family of Power Management ICs are used to provide regulated
  voltages and other various functionality to Qualcomm SoCs.

properties:
  compatible:
    oneOf:
      - enum:
          - qcom,pm8058
          - qcom,pm8821
          - qcom,pm8901
          - qcom,pm8921
      - items:
          - enum:
              - qcom,pm8018
          - const: qcom,pm8921

  reg:
    maxItems: 1

  '#address-cells':
    const: 1

  '#size-cells':
    const: 0

  interrupts:
    maxItems: 1

  '#interrupt-cells':
    const: 2

  interrupt-controller: true

patternProperties:
  "gpio@[0-9a-f]+$":
    type: object
    $ref: /schemas/pinctrl/qcom,pmic-gpio.yaml#

  "keypad@[0-9a-f]+$":
    type: object
    $ref: /schemas/input/qcom,pm8921-keypad.yaml#

  "led@[0-9a-f]+$":
    type: object
    $ref: /schemas/leds/qcom,pm8058-led.yaml#

  "mpps@[0-9a-f]+$":
    type: object
    $ref: /schemas/pinctrl/qcom,pmic-mpp.yaml#

  "pwrkey@[0-9a-f]+$":
    type: object
    $ref: /schemas/input/qcom,pm8921-pwrkey.yaml#

  "rtc@[0-9a-f]+$":
    type: object
    $ref: /schemas/rtc/qcom-pm8xxx-rtc.yaml#

  "vibrator@[0-9a-f]+$":
    type: object
    $ref: /schemas/input/qcom,pm8xxx-vib.yaml#

  "xoadc@[0-9a-f]+$":
    type: object
    $ref: /schemas/iio/adc/qcom,pm8018-adc.yaml#

required:
  - compatible
  - '#address-cells'
  - '#size-cells'
  - interrupts
  - '#interrupt-cells'
  - interrupt-controller

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/irq.h>
    ssbi {
      #address-cells = <1>;
      #size-cells = <0>;
      pmic@0 {
        compatible = "qcom,pm8921";
        reg = <0>;
        #address-cells = <1>;
        #size-cells = <0>;
        interrupt-controller;
        #interrupt-cells = <2>;

        interrupt-parent = <&tlmm>;
        interrupts = <32 IRQ_TYPE_EDGE_RISING>;
      };
    };
...