blob: 58ccca4416b1cf0099ca08d9e9a94645e1d64826 [file] [log] [blame]
Kishon Vijay Abraham I0cfb5122017-03-27 15:15:15 +05301Driver for PCI Endpoint Test Function
2
3This driver should be used as a host side driver if the root complex is
4connected to a configurable PCI endpoint running *pci_epf_test* function
5driver configured according to [1].
6
7The "pci_endpoint_test" driver can be used to perform the following tests.
8
9The PCI driver for the test device performs the following tests
10 *) verifying addresses programmed in BAR
11 *) raise legacy IRQ
12 *) raise MSI IRQ
Gustavo Pimentelc2e00e32018-07-19 10:32:19 +020013 *) raise MSI-X IRQ
Kishon Vijay Abraham I0cfb5122017-03-27 15:15:15 +053014 *) read data
15 *) write data
16 *) copy data
17
18This misc driver creates /dev/pci-endpoint-test.<num> for every
19*pci_epf_test* function connected to the root complex and "ioctls"
20should be used to perform the above tests.
21
22ioctl
23-----
24 PCITEST_BAR: Tests the BAR. The number of the BAR to be tested
25 should be passed as argument.
26 PCITEST_LEGACY_IRQ: Tests legacy IRQ
27 PCITEST_MSI: Tests message signalled interrupts. The MSI number
28 to be tested should be passed as argument.
Gustavo Pimentelc2e00e32018-07-19 10:32:19 +020029 PCITEST_MSIX: Tests message signalled interrupts. The MSI-X number
30 to be tested should be passed as argument.
Gustavo Pimentele0332712018-07-19 10:32:20 +020031 PCITEST_SET_IRQTYPE: Changes driver IRQ type configuration. The IRQ type
32 should be passed as argument (0: Legacy, 1:MSI, 2:MSI-X).
33 PCITEST_GET_IRQTYPE: Gets driver IRQ type configuration.
Kishon Vijay Abraham I0cfb5122017-03-27 15:15:15 +053034 PCITEST_WRITE: Perform write tests. The size of the buffer should be passed
35 as argument.
36 PCITEST_READ: Perform read tests. The size of the buffer should be passed
37 as argument.
38 PCITEST_COPY: Perform read tests. The size of the buffer should be passed
39 as argument.
40
41[1] -> Documentation/PCI/endpoint/function/binding/pci-test.txt