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