PCI/endpoint/pci-test-howto.rst

1 .. SPDX-License-Identifier: GPL-2.0
9 This document is a guide to help users use pci-epf-test function driver
13 Endpoint Device
16 Endpoint Controller Devices
17 ---------------------------
19 To find the list of endpoint controller devices in the system::
26 	# ls /sys/kernel/config/pci_ep/controllers
30 Endpoint Function Drivers
31 -------------------------
33 To find the list of endpoint function drivers in the system::
35 	# ls /sys/bus/pci-epf/drivers
40 	# ls /sys/kernel/config/pci_ep/functions
44 Creating pci-epf-test Device
45 ----------------------------
47 PCI endpoint function device can be created using the configfs. To create
48 pci-epf-test device, the following commands can be used::
50 	# mount -t configfs none /sys/kernel/config
51 	# cd /sys/kernel/config/pci_ep/
54 The "mkdir func1" above creates the pci-epf-test function device that will
57 The PCI endpoint framework populates the directory with the following
65 The PCI endpoint function driver populates these entries with default values
66 when the device is bound to the driver. The pci-epf-test driver populates
75 Configuring pci-epf-test Device
76 -------------------------------
78 The user can configure the pci-epf-test device using configfs entry. In order
88 Binding pci-epf-test Device to EP Controller
89 --------------------------------------------
91 In order for the endpoint function device to be useful, it has to be bound to
92 a PCI endpoint controller driver. Use the configfs to bind the function
95 	# ln -s functions/pci_epf_test/func1 controllers/51000000.pcie_ep/
97 Once the above step is completed, the PCI endpoint is ready to establish a link
102 --------------
104 In order for the endpoint device to establish a link with the host, the _start_
114 ------------
123 Using Endpoint Test function Device
124 -----------------------------------
126 pcitest.sh added in tools/pci/ can be used to run all the default PCI endpoint
129 	# cd <kernel-dir>
130 	# make -C tools/pci
134 	# cd <kernel-dir>
135 	# make -C tools/pci install
191 	SET IRQ TYPE TO MSI-X:          OKAY
192 	MSI-X1:         OKAY
193 	MSI-X2:         OKAY
194 	MSI-X3:         OKAY
195 	MSI-X4:         OKAY
196 	MSI-X5:         OKAY
197 	MSI-X6:         OKAY
198 	MSI-X7:         OKAY
199 	MSI-X8:         OKAY
200 	MSI-X9:         NOT OKAY
201 	MSI-X10:        NOT OKAY
202 	MSI-X11:        NOT OKAY
203 	MSI-X12:        NOT OKAY
204 	MSI-X13:        NOT OKAY
205 	MSI-X14:        NOT OKAY
206 	MSI-X15:        NOT OKAY
207 	MSI-X16:        NOT OKAY
209 	MSI-X2047:      NOT OKAY
210 	MSI-X2048:      NOT OKAY