xref: /linux/Documentation/devicetree/bindings/iommu/qcom,apq8064-iommu.yaml (revision 527a0f2bdcfe77fce22f006b97e42e4da3137c86)
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4
5$id: http://devicetree.org/schemas/iommu/qcom,apq8064-iommu.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Qualcomm APQ8064 IOMMU
9
10maintainers:
11  - David Heidelberg <david@ixit.cz>
12
13description:
14  The MSM IOMMU is an implementation compatible with the ARM VMSA short
15  descriptor page tables. It provides address translation for bus masters
16  outside of the CPU, each connected to the IOMMU through a port called micro-TLB.
17
18properties:
19  compatible:
20    const: qcom,apq8064-iommu
21
22  clocks:
23    items:
24      - description: interface clock for register accesses
25      - description: functional clock for bus accesses
26
27  clock-names:
28    items:
29      - const: smmu_pclk
30      - const: iommu_clk
31
32  reg:
33    maxItems: 1
34
35  interrupts:
36    description: Specifiers for the MMU fault interrupts.
37    minItems: 1
38    items:
39      - description: non-secure mode interrupt
40      - description: secure mode interrupt (for instances which supports it)
41
42  "#iommu-cells":
43    const: 1
44    description: Each IOMMU specifier describes a single Stream ID.
45
46  qcom,ncb:
47    $ref: /schemas/types.yaml#/definitions/uint32
48    description: The total number of context banks in the IOMMU.
49    minimum: 1
50    maximum: 4
51
52required:
53  - reg
54  - interrupts
55  - clocks
56  - clock-names
57  - qcom,ncb
58
59additionalProperties: false
60
61examples:
62  - |
63    #include <dt-bindings/clock/qcom,mmcc-msm8960.h>
64    #include <dt-bindings/interrupt-controller/irq.h>
65    #include <dt-bindings/interrupt-controller/arm-gic.h>
66
67    iommu@7500000 {
68            compatible = "qcom,apq8064-iommu";
69            reg = <0x07500000 0x100000>;
70            interrupts = <GIC_SPI 63 IRQ_TYPE_LEVEL_HIGH>,
71                         <GIC_SPI 64 IRQ_TYPE_LEVEL_HIGH>;
72            clocks = <&clk SMMU_AHB_CLK>,
73                     <&clk MDP_AXI_CLK>;
74            clock-names = "smmu_pclk",
75                          "iommu_clk";
76            #iommu-cells = <1>;
77            qcom,ncb = <2>;
78    };
79