Documentation/devicetree/bindings/iommu/renesas,ipmmu-vmsa.txt

   1 * Renesas VMSA-Compatible IOMMU
   2
   3 The IPMMU is an IOMMU implementation compatible with the ARM VMSA page tables.
   4 It provides address translation for bus masters outside of the CPU, each
   5 connected to the IPMMU through a port called micro-TLB.
   6
   7
   8 Required Properties:
   9
  10   - compatible: Must contain SoC-specific and generic entries from below.
  11
  12     - "renesas,ipmmu-r8a73a4" for the R8A73A4 (R-Mobile APE6) IPMMU.
  13     - "renesas,ipmmu-r8a7790" for the R8A7790 (R-Car H2) IPMMU.
  14     - "renesas,ipmmu-r8a7791" for the R8A7791 (R-Car M2-W) IPMMU.
  15     - "renesas,ipmmu-r8a7793" for the R8A7793 (R-Car M2-N) IPMMU.
  16     - "renesas,ipmmu-r8a7794" for the R8A7794 (R-Car E2) IPMMU.
  17     - "renesas,ipmmu-vmsa" for generic R-Car Gen2 VMSA-compatible IPMMU.
  18
  19   - reg: Base address and size of the IPMMU registers.
  20   - interrupts: Specifiers for the MMU fault interrupts. For instances that
  21     support secure mode two interrupts must be specified, for non-secure and
  22     secure mode, in that order. For instances that don't support secure mode a
  23     single interrupt must be specified.
  24
  25   - #iommu-cells: Must be 1.
  26
  27 Each bus master connected to an IPMMU must reference the IPMMU in its device
  28 node with the following property:
  29
  30   - iommus: A reference to the IPMMU in two cells. The first cell is a phandle
  31     to the IPMMU and the second cell the number of the micro-TLB that the
  32     device is connected to.
  33
  34
  35 Example: R8A7791 IPMMU-MX and VSP1-D0 bus master
  36
  37         ipmmu_mx: mmu@fe951000 {
  38                 compatible = "renasas,ipmmu-r8a7791", "renasas,ipmmu-vmsa";
  39                 reg = <0 0xfe951000 0 0x1000>;
  40                 interrupts = <0 222 IRQ_TYPE_LEVEL_HIGH>,
  41                              <0 221 IRQ_TYPE_LEVEL_HIGH>;
  42                 #iommu-cells = <1>;
  43         };
  44
  45         vsp1@fe928000 {
  46                 ...
  47                 iommus = <&ipmmu_mx 13>;
  48                 ...
  49         };