# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/iommu/brcm,bcm2712-iommu.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Broadcom BCM2712 IOMMU

maintainers:
  - Daniel Drake <dan@reactivated.net>
  - Florian Fainelli <florian.fainelli@broadcom.com>
  - Jim Quinlan <james.quinlan@broadcom.com>

description:
  The BCM2712 SoC features multiple independent IOMMU instances providing
  address translation for multimedia hardware blocks, such as the VC6 display
  pipeline, camera receivers, and ISP. Each IOMMU has its own page tables,
  control registers, and local TLB, and is additionally linked to a centralized
  L2 TLB (IOMMUC).

properties:
  compatible:
    const: brcm,bcm2712-iommu

  reg:
    maxItems: 1

  '#iommu-cells':
    const: 0

  brcm,iommu-cache:
    $ref: /schemas/types.yaml#/definitions/phandle
    description:
      Phandle to the shared IOMMU cache (IOMMUC). Each IOMMU instance caches
      translated descriptors in this centralized L2 TLB cache block and must
      trigger cache invalidation commands on it when updating or unmapping page
      table entries.

required:
  - compatible
  - reg
  - '#iommu-cells'
  - brcm,iommu-cache

additionalProperties: false

examples:
  - |
    iommu@5200 {
        compatible = "brcm,bcm2712-iommu";
        reg = <0x5200 0x80>;
        brcm,iommu-cache = <&iommuc>;
        #iommu-cells = <0>;
    };