[PATCH 2/3] dt-bindings: dma: snps,dw-axi-dmac: Add iommu property

[Krzysztof Kozlowski]

On 15/10/2025 02:13, Khairul Anuar Romli wrote:
> Agilex5 integrates an ARM SMMU v3 (System Memory Management Unit) with
> dedicated Translation Buffer Units (TBUs) assigned to various peripherals,
> including the Synopsys DesignWare AXI DMA controller.
> 
> Each TBU handles address translation for its associated device by mapping
> stream IDs to memory access permissions and virtual-to-physical address
> mappings via the SMMU core.
> 
> The DesignWare AXI DMAC instances on Agilex5 are connected to their
> respective TBUs. These TBUs forward DMA transactions from the controller
> through the SMMU, enabling IOMMU-based features such as:
> - Address translation for DMA operations
> - Isolation and protection of memory regions accessed by the DMA controller
> - Support for secure and virtualized environments through enforced access
>   control
> 
> To support this configuration, the `iommus` property must be added to the
> binding schema for `snps,dw-axi-dmac`. This allows the device tree to
> associate each DMA controller with the correct SMMU stream ID, enabling
> the Linux IOMMU framework to configure translation contexts at runtime.
> 
> This change documents the IOMMU support for the DMA controller on Agilex5
> and allows proper integration with the SMMUv3 hardware.
> 
> Signed-off-by: Adrian Ng Ho Yin <adrianhoyin.ng at altera.com>
> Signed-off-by: Khairul Anuar Romli <khairul.anuar.romli at altera.com>
> ---
> Changes in v3:
> 	- Refined commit messages with detailed hardware descriptions.
> 	- Remove redundant commit message and add hardware use for iommu.
> Changes in v2:
>         - Updated the commit message to clarify the need for the changes
> 	  and the hardware used of this changes.
> ---
>  Documentation/devicetree/bindings/dma/snps,dw-axi-dmac.yaml | 3 +++
>  1 file changed, 3 insertions(+)

Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski at linaro.org>

Best regards,
Krzysztof