1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-C 1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/bus/xlnx,ve 4 $id: http://devicetree.org/schemas/bus/xlnx,versal-net-cdx.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: AMD CDX bus controller 7 title: AMD CDX bus controller
8 8
9 description: | 9 description: |
10 CDX bus controller for AMD devices is implem 10 CDX bus controller for AMD devices is implemented to dynamically
11 detect CDX bus and devices using the firmwar 11 detect CDX bus and devices using the firmware.
12 The CDX bus manages multiple FPGA based hard 12 The CDX bus manages multiple FPGA based hardware devices, which
13 can support network, crypto or any other spe 13 can support network, crypto or any other specialized type of
14 devices. These FPGA based devices can be add 14 devices. These FPGA based devices can be added/modified dynamically
15 on run-time. 15 on run-time.
16 16
17 All devices on the CDX bus will have a uniqu 17 All devices on the CDX bus will have a unique streamid (for IOMMU)
18 and a unique device ID (for MSI) correspondi 18 and a unique device ID (for MSI) corresponding to a requestor ID
19 (one to one associated with the device). The 19 (one to one associated with the device). The streamid and deviceid
20 are used to configure SMMU and GIC-ITS respe 20 are used to configure SMMU and GIC-ITS respectively.
21 21
22 iommu-map property is used to define the set 22 iommu-map property is used to define the set of stream ids
23 corresponding to each device and the associa 23 corresponding to each device and the associated IOMMU.
24 24
25 The MSI writes are accompanied by sideband d 25 The MSI writes are accompanied by sideband data (Device ID).
26 The msi-map property is used to associate th 26 The msi-map property is used to associate the devices with the
27 device ID as well as the associated ITS cont 27 device ID as well as the associated ITS controller.
28 28
29 rproc property (xlnx,rproc) is used to ident 29 rproc property (xlnx,rproc) is used to identify the remote processor
30 with which APU (Application Processor Unit) 30 with which APU (Application Processor Unit) interacts to find out
31 the bus and device configuration. 31 the bus and device configuration.
32 32
33 maintainers: 33 maintainers:
34 - Nipun Gupta <nipun.gupta@amd.com> 34 - Nipun Gupta <nipun.gupta@amd.com>
35 - Nikhil Agarwal <nikhil.agarwal@amd.com> 35 - Nikhil Agarwal <nikhil.agarwal@amd.com>
36 36
37 properties: 37 properties:
38 compatible: 38 compatible:
39 const: xlnx,versal-net-cdx 39 const: xlnx,versal-net-cdx
40 40
41 iommu-map: true 41 iommu-map: true
42 42
43 msi-map: true 43 msi-map: true
44 44
45 xlnx,rproc: 45 xlnx,rproc:
46 $ref: /schemas/types.yaml#/definitions/pha 46 $ref: /schemas/types.yaml#/definitions/phandle
47 description: 47 description:
48 phandle to the remoteproc_r5 rproc node 48 phandle to the remoteproc_r5 rproc node using which APU interacts
49 with remote processor. 49 with remote processor.
50 50
51 ranges: true 51 ranges: true
52 52
53 "#address-cells": 53 "#address-cells":
54 enum: [1, 2] 54 enum: [1, 2]
55 55
56 "#size-cells": 56 "#size-cells":
57 enum: [1, 2] 57 enum: [1, 2]
58 58
59 required: 59 required:
60 - compatible 60 - compatible
61 - iommu-map 61 - iommu-map
62 - msi-map 62 - msi-map
63 - xlnx,rproc 63 - xlnx,rproc
64 - ranges 64 - ranges
65 - "#address-cells" 65 - "#address-cells"
66 - "#size-cells" 66 - "#size-cells"
67 67
68 additionalProperties: false 68 additionalProperties: false
69 69
70 examples: 70 examples:
71 - | 71 - |
72 cdx { 72 cdx {
73 compatible = "xlnx,versal-net-cdx"; 73 compatible = "xlnx,versal-net-cdx";
74 #address-cells = <1>; 74 #address-cells = <1>;
75 #size-cells = <1>; 75 #size-cells = <1>;
76 /* define map for RIDs 250-259 */ 76 /* define map for RIDs 250-259 */
77 iommu-map = <250 &smmu 250 10>; 77 iommu-map = <250 &smmu 250 10>;
78 /* define msi map for RIDs 250-259 */ 78 /* define msi map for RIDs 250-259 */
79 msi-map = <250 &its 250 10>; 79 msi-map = <250 &its 250 10>;
80 xlnx,rproc = <&remoteproc_r5>; 80 xlnx,rproc = <&remoteproc_r5>;
81 ranges; 81 ranges;
82 }; 82 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.