1 # SPDX-License-Identifier: (GPL-2.0-only OR BS
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/virtio/pci-
5 $schema: http://devicetree.org/meta-schemas/co
6
7 title: virtio-iommu device using the virtio-pc
8
9 maintainers:
10 - Jean-Philippe Brucker <jean-philippe@linaro
11
12 description: |
13 When virtio-iommu uses the PCI transport, it
14 discovered dynamically by the PCI probing in
15 device tree statically describes the relatio
16 masters. Therefore, the PCI root complex tha
17 contains a child node representing the IOMMU
18
19 DMA from the IOMMU device isn't managed by a
20 virtio-iommu node doesn't have an "iommus" p
21 the iommu-map property of the root complex.
22
23 properties:
24 # If compatible is present, it should contai
25 # according to the PCI Bus Binding specifica
26 # built-in identification methods, compatibl
27 compatible:
28 oneOf:
29 - items:
30 - const: virtio,pci-iommu
31 - const: pci1af4,1057
32 - items:
33 - const: pci1af4,1057
34
35 reg:
36 description: |
37 PCI address of the IOMMU. As defined in
38 reference, the reg property is a five-ce
39 phys.mid phys.lo size.hi size.lo). phys.
40 BDF as 0b00000000 bbbbbbbb dddddfff 0000
41 zero. See Documentation/devicetree/bindi
42
43 '#iommu-cells':
44 const: 1
45
46 required:
47 - compatible
48 - reg
49 - '#iommu-cells'
50
51 additionalProperties: false
52
53 examples:
54 - |
55 bus {
56 #address-cells = <2>;
57 #size-cells = <2>;
58
59 pcie@40000000 {
60 device_type = "pci";
61 #address-cells = <3>;
62 #size-cells = <2>;
63 reg = <0x0 0x40000000 0x0 0x10000
64 ranges = <0x02000000 0x0 0x4100000
65
66 /*
67 * The IOMMU manages all functions
68 * itself. Omit BDF 00:01.0.
69 */
70 iommu-map = <0x0 &iommu0 0x0 0x8
71 0x9 &iommu0 0x9 0xfff
72
73 /* The IOMMU programming interface
74 iommu0: iommu@1,0 {
75 compatible = "pci1af4,1057";
76 reg = <0x800 0 0 0 0>;
77 #iommu-cells = <1>;
78 };
79 };
80
81 pcie@50000000 {
82 device_type = "pci";
83 #address-cells = <3>;
84 #size-cells = <2>;
85 reg = <0x0 0x50000000 0x0 0x10000
86 ranges = <0x02000000 0x0 0x5100000
87
88 /*
89 * The IOMMU also manages all func
90 * with endpoint IDs 0x10000 - 0x1
91 */
92 iommu-map = <0x0 &iommu0 0x10000 0
93 };
94
95 ethernet {
96 /* The IOMMU manages this platform
97 iommus = <&iommu0 0x20000>;
98 };
99 };
100
101 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.