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

title: Qualcomm Technologies, Inc. I2C PMIC Controller Multi-Function Device

maintainers:
  - David Collins <quic_collinsd@quicinc.com>

description: |
  I2C PMIC controller multi-function devices communicate over an I2C bus. An I2C
  PMIC controller node typically contains one or more child nodes corresponding
  to the device's peripherals.

  The controller also handles interrupts for all of the peripherals on the bus.
  The controller takes a summary interrupt, deciphers which peripheral triggered
  the interrupt, and determines which of the peripheral's interrupts were
  triggered. It then notifies peripheral subdevices about the interrupts.

properties:
  compatible:
    const: qcom,i2c-pmic

  reg:
    description: 7-bit I2C address of the device
    maxItems: 1

  '#address-cells':
    const: 1

  '#size-cells':
    const: 0

  interrupts:
    maxItems: 1
    description: Summary interrupt specifier

  interrupt-controller: true

  '#interrupt-cells':
    const: 3

  qcom,periph-map:
    description: |
      List of peripheral addresses specifying the mapping of peripherals to
      summary status register bits. The mapping is ordered from the least
      significant status bit to the most significant.
    $ref: /schemas/types.yaml#/definitions/uint32-array
    items:
      minimum: 0x0
      maximum: 0xff

required:
  - compatible
  - reg

additionalProperties: true

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

        pmic@8 {
            compatible = "qcom,i2c-pmic";
            reg = <0x8>;
            interrupt-parent = <&tlmm_pinmux>;
            interrupts = <83 0>;
            interrupt-controller;
            #interrupt-cells = <3>;
            #address-cells = <1>;
            #size-cells = <0>;
            pinctrl-names = "default";
            pinctrl-0 = <&smb_stat_active>;
            qcom,periph-map = <0x10 0x11 0x12 0x13 0x14 0x16 0x36>;
        };
    };