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
11 be followed in the host side and EP side is given below.
17 ---------------------------
19 To find the list of endpoint controller devices in the system::
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 ----------------------------
48 pci-epf-test device, the following commands can be used::
50 	# mount -t configfs none /sys/kernel/config
52 	# mkdir functions/pci_epf_test/func1
54 The "mkdir func1" above creates the pci-epf-test function device that will
60 	# ls functions/pci_epf_test/func1
66 when the device is bound to the driver. The pci-epf-test driver populates
69 	# cat functions/pci_epf_test/func1/vendorid
71 	# cat functions/pci_epf_test/func1/interrupt_pin
75 Configuring pci-epf-test Device
76 -------------------------------
78 The user can configure the pci-epf-test device using configfs entry. In order
82 	# echo 0x104c > functions/pci_epf_test/func1/vendorid
83 	# echo 0xb500 > functions/pci_epf_test/func1/deviceid
84 	# echo 16 > functions/pci_epf_test/func1/msi_interrupts
85 	# echo 8 > functions/pci_epf_test/func1/msix_interrupts
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
93 device to one of the controller driver present in the system::
95 	# ln -s functions/pci_epf_test/func1 controllers/51000000.pcie_ep/
102 --------------
104 In order for the endpoint device to establish a link with the host, the _start_
114 ------------
116 Note that the devices listed here correspond to the value populated in 1.4
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
132 or if you desire to compile and install in your system::
134 	# cd <kernel-dir>
135 	# make -C tools/pci install
137 The tool and script will be located in <rootfs>/usr/bin/
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