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

title: Qualcomm Technologies Inc BAM DMA controller

maintainers:
  - Andy Gross <agross@kernel.org>
  - Bjorn Andersson <andersson@kernel.org>

allOf:
  - $ref: "dma-controller.yaml#"

properties:
  compatible:
    enum:
        # APQ8064, IPQ8064 and MSM8960
      - qcom,bam-v1.3.0
        # MSM8974, APQ8074 and APQ8084
      - qcom,bam-v1.4.0
        # MSM8916 and SDM845
      - qcom,bam-v1.7.0

  clocks:
    maxItems: 1

  clock-names:
    items:
      - const: bam_clk

  "#dma-cells":
    const: 1

  interrupts:
    maxItems: 1

  iommus:
    minItems: 1
    maxItems: 4

  num-channels:
    $ref: /schemas/types.yaml#/definitions/uint32
    description:
      Indicates supported number of DMA channels in a remotely controlled bam.

  qcom,controlled-remotely:
    type: boolean
    description:
      Indicates that the bam is controlled by remote proccessor i.e. execution
      environment.

  qcom,ee:
    $ref: /schemas/types.yaml#/definitions/uint32
    minimum: 0
    maximum: 7
    description:
      Indicates the active Execution Environment identifier (0-7) used in the
      secure world.

  qcom,num-ees:
    $ref: /schemas/types.yaml#/definitions/uint32
    description:
      Indicates supported number of Execution Environments in a remotely
      controlled bam.

  qcom,powered-remotely:
    type: boolean
    description:
      Indicates that the bam is powered up by a remote processor but must be
      initialized by the local processor.

  reg:
    maxItems: 1

required:
  - compatible
  - "#dma-cells"
  - num-channels
  - interrupts
  - qcom,ee
  - reg
  - qcom,num-ees

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    #include <dt-bindings/clock/qcom,gcc-sun.h>

    slimbam: bamdma@6C04000 {
        compatible = "qcom,bam-v1.7.0";
        qcom,controlled-remotely;
        reg = <0x6C04000 0x20000>, <0x6C8F000 0x1000>;
        reg-names = "bam", "bam_remote_mem";
        num-channels  = <31>;
        interrupts = <0 164 IRQ_TYPE_LEVEL_HIGH>;
        #dma-cells = <1>;
        qcom,ee = <1>;
        qcom,num-ees = <2>;
    };
...
