# 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>;
};