xref: /freebsd/sys/contrib/device-tree/Bindings/iommu/xen,grant-dma.yaml (revision d5b0e70f7e04d971691517ce1304d86a1e367e2e)
1*d5b0e70fSEmmanuel Vadot# SPDX-License-Identifier: (GPL-2.0-only or BSD-2-Clause)
2*d5b0e70fSEmmanuel Vadot%YAML 1.2
3*d5b0e70fSEmmanuel Vadot---
4*d5b0e70fSEmmanuel Vadot$id: http://devicetree.org/schemas/iommu/xen,grant-dma.yaml#
5*d5b0e70fSEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
6*d5b0e70fSEmmanuel Vadot
7*d5b0e70fSEmmanuel Vadottitle: Xen specific IOMMU for virtualized devices (e.g. virtio)
8*d5b0e70fSEmmanuel Vadot
9*d5b0e70fSEmmanuel Vadotmaintainers:
10*d5b0e70fSEmmanuel Vadot  - Stefano Stabellini <sstabellini@kernel.org>
11*d5b0e70fSEmmanuel Vadot
12*d5b0e70fSEmmanuel Vadotdescription:
13*d5b0e70fSEmmanuel Vadot  The Xen IOMMU represents the Xen grant table interface. Grant mappings
14*d5b0e70fSEmmanuel Vadot  are to be used with devices connected to the Xen IOMMU using the "iommus"
15*d5b0e70fSEmmanuel Vadot  property, which also specifies the ID of the backend domain.
16*d5b0e70fSEmmanuel Vadot  The binding is required to restrict memory access using Xen grant mappings.
17*d5b0e70fSEmmanuel Vadot
18*d5b0e70fSEmmanuel Vadotproperties:
19*d5b0e70fSEmmanuel Vadot  compatible:
20*d5b0e70fSEmmanuel Vadot    const: xen,grant-dma
21*d5b0e70fSEmmanuel Vadot
22*d5b0e70fSEmmanuel Vadot  '#iommu-cells':
23*d5b0e70fSEmmanuel Vadot    const: 1
24*d5b0e70fSEmmanuel Vadot    description:
25*d5b0e70fSEmmanuel Vadot      The single cell is the domid (domain ID) of the domain where the backend
26*d5b0e70fSEmmanuel Vadot      is running.
27*d5b0e70fSEmmanuel Vadot
28*d5b0e70fSEmmanuel Vadotrequired:
29*d5b0e70fSEmmanuel Vadot  - compatible
30*d5b0e70fSEmmanuel Vadot  - "#iommu-cells"
31*d5b0e70fSEmmanuel Vadot
32*d5b0e70fSEmmanuel VadotadditionalProperties: false
33*d5b0e70fSEmmanuel Vadot
34*d5b0e70fSEmmanuel Vadotexamples:
35*d5b0e70fSEmmanuel Vadot  - |
36*d5b0e70fSEmmanuel Vadot    iommu {
37*d5b0e70fSEmmanuel Vadot        compatible = "xen,grant-dma";
38*d5b0e70fSEmmanuel Vadot        #iommu-cells = <1>;
39*d5b0e70fSEmmanuel Vadot    };
40