qcom,bam-dma.yaml

  1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/dma/qcom,bam-dma.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Qualcomm Technologies Inc BAM DMA controller
  8
  9maintainers:
 10  - Andy Gross <agross@kernel.org>
 11  - Bjorn Andersson <andersson@kernel.org>
 12
 13allOf:
 14  - $ref: dma-controller.yaml#
 15
 16properties:
 17  compatible:
 18    oneOf:
 19      - enum:
 20          # APQ8064, IPQ8064 and MSM8960
 21          - qcom,bam-v1.3.0
 22          # MSM8974, APQ8074 and APQ8084
 23          - qcom,bam-v1.4.0
 24          # MSM8916, SDM630
 25          - qcom,bam-v1.7.0
 26      - items:
 27          - enum:
 28              # SDM845, SM6115, SM8150, SM8250 and QCM2290
 29              - qcom,bam-v1.7.4
 30          - const: qcom,bam-v1.7.0
 31
 32  clocks:
 33    maxItems: 1
 34
 35  clock-names:
 36    items:
 37      - const: bam_clk
 38
 39  "#dma-cells":
 40    const: 1
 41
 42  interrupts:
 43    maxItems: 1
 44
 45  dma-coherent: true
 46
 47  iommus:
 48    minItems: 1
 49    maxItems: 6
 50
 51  num-channels:
 52    $ref: /schemas/types.yaml#/definitions/uint32
 53    description:
 54      Indicates supported number of DMA channels in a remotely controlled bam.
 55
 56  qcom,controlled-remotely:
 57    type: boolean
 58    description:
 59      Indicates that the bam is controlled by remote processor i.e. execution
 60      environment.
 61
 62  qcom,ee:
 63    $ref: /schemas/types.yaml#/definitions/uint32
 64    minimum: 0
 65    maximum: 7
 66    description:
 67      Indicates the active Execution Environment identifier (0-7) used in the
 68      secure world.
 69
 70  qcom,num-ees:
 71    $ref: /schemas/types.yaml#/definitions/uint32
 72    description:
 73      Indicates supported number of Execution Environments in a remotely
 74      controlled bam.
 75
 76  qcom,powered-remotely:
 77    type: boolean
 78    description:
 79      Indicates that the bam is powered up by a remote processor but must be
 80      initialized by the local processor.
 81
 82  reg:
 83    maxItems: 1
 84
 85required:
 86  - compatible
 87  - "#dma-cells"
 88  - interrupts
 89  - qcom,ee
 90  - reg
 91
 92anyOf:
 93  - required:
 94      - qcom,powered-remotely
 95      - num-channels
 96      - qcom,num-ees
 97  - required:
 98      - qcom,controlled-remotely
 99      - num-channels
100      - qcom,num-ees
101  - required:
102      - clocks
103      - clock-names
104
105additionalProperties: false
106
107examples:
108  - |
109    #include <dt-bindings/interrupt-controller/arm-gic.h>
110    #include <dt-bindings/clock/qcom,gcc-msm8974.h>
111
112    dma-controller@f9944000 {
113        compatible = "qcom,bam-v1.4.0";
114        reg = <0xf9944000 0x19000>;
115        interrupts = <GIC_SPI 239 IRQ_TYPE_LEVEL_HIGH>;
116        clocks = <&gcc GCC_BLSP2_AHB_CLK>;
117        clock-names = "bam_clk";
118        #dma-cells = <1>;
119        qcom,ee = <0>;
120    };
121...