xref: /linux/Documentation/devicetree/bindings/dma/qcom,bam-dma.yaml (revision e7e86d7697c6ed1dbbde18d7185c35b6967945ed) 
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...
122