xref: /freebsd/sys/contrib/device-tree/Bindings/dma/qcom,bam-dma.yaml (revision 734e82fe33aa764367791a7d603b383996c6b40b) 
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    enum:
19        # APQ8064, IPQ8064 and MSM8960
20      - qcom,bam-v1.3.0
21        # MSM8974, APQ8074 and APQ8084
22      - qcom,bam-v1.4.0
23        # MSM8916 and SDM845
24      - qcom,bam-v1.7.0
25
26  clocks:
27    maxItems: 1
28
29  clock-names:
30    items:
31      - const: bam_clk
32
33  "#dma-cells":
34    const: 1
35
36  interrupts:
37    maxItems: 1
38
39  iommus:
40    minItems: 1
41    maxItems: 4
42
43  num-channels:
44    $ref: /schemas/types.yaml#/definitions/uint32
45    description:
46      Indicates supported number of DMA channels in a remotely controlled bam.
47
48  qcom,controlled-remotely:
49    type: boolean
50    description:
51      Indicates that the bam is controlled by remote proccessor i.e. execution
52      environment.
53
54  qcom,ee:
55    $ref: /schemas/types.yaml#/definitions/uint32
56    minimum: 0
57    maximum: 7
58    description:
59      Indicates the active Execution Environment identifier (0-7) used in the
60      secure world.
61
62  qcom,num-ees:
63    $ref: /schemas/types.yaml#/definitions/uint32
64    description:
65      Indicates supported number of Execution Environments in a remotely
66      controlled bam.
67
68  qcom,powered-remotely:
69    type: boolean
70    description:
71      Indicates that the bam is powered up by a remote processor but must be
72      initialized by the local processor.
73
74  reg:
75    maxItems: 1
76
77required:
78  - compatible
79  - "#dma-cells"
80  - interrupts
81  - qcom,ee
82  - reg
83
84additionalProperties: false
85
86examples:
87  - |
88    #include <dt-bindings/interrupt-controller/arm-gic.h>
89    #include <dt-bindings/clock/qcom,gcc-msm8974.h>
90
91    dma-controller@f9944000 {
92        compatible = "qcom,bam-v1.4.0";
93        reg = <0xf9944000 0x19000>;
94        interrupts = <GIC_SPI 239 IRQ_TYPE_LEVEL_HIGH>;
95        clocks = <&gcc GCC_BLSP2_AHB_CLK>;
96        clock-names = "bam_clk";
97        #dma-cells = <1>;
98        qcom,ee = <0>;
99    };
100...
101