xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/iommu/rockchip,iommu.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1Rockchip IOMMU
2==============
3
4A Rockchip DRM iommu translates io virtual addresses to physical addresses for
5its master device.  Each slave device is bound to a single master device, and
6shares its clocks, power domain and irq.
7
8Required properties:
9- compatible      : Should be "rockchip,iommu"
10- reg             : Address space for the configuration registers
11- interrupts      : Interrupt specifier for the IOMMU instance
12- interrupt-names : Interrupt name for the IOMMU instance
13- #iommu-cells    : Should be <0>.  This indicates the iommu is a
14                    "single-master" device, and needs no additional information
15                    to associate with its master device.  See:
16                    Documentation/devicetree/bindings/iommu/iommu.txt
17- clocks          : A list of clocks required for the IOMMU to be accessible by
18                    the host CPU.
19- clock-names     : Should contain the following:
20	"iface" - Main peripheral bus clock (PCLK/HCL) (required)
21	"aclk"  - AXI bus clock (required)
22
23Optional properties:
24- rockchip,disable-mmu-reset : Don't use the mmu reset operation.
25			       Some mmu instances may produce unexpected results
26			       when the reset operation is used.
27- rk_iommu,disable_reset_quirk  : Same with above, for compatible with previous code
28
29- rockchip,skip-mmu-read       : Some iommu instances are not able to be read, skip
30				 reading operation to make iommu work as normal
31
32Example:
33
34	vopl_mmu: iommu@ff940300 {
35		compatible = "rockchip,iommu";
36		reg = <0xff940300 0x100>;
37		interrupts = <GIC_SPI 16 IRQ_TYPE_LEVEL_HIGH>;
38		interrupt-names = "vopl_mmu";
39		clocks = <&cru ACLK_VOP1>, <&cru HCLK_VOP1>;
40		clock-names = "aclk", "iface";
41		#iommu-cells = <0>;
42	};
43