~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/PCI/endpoint/pci-test-function.rst

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /Documentation/PCI/endpoint/pci-test-function.rst (Version linux-6.12-rc7) and /Documentation/PCI/endpoint/pci-test-function.rst (Version linux-6.2.16)


  1 .. SPDX-License-Identifier: GPL-2.0                 1 .. SPDX-License-Identifier: GPL-2.0
  2                                                     2 
  3 =================                                   3 =================
  4 PCI Test Function                                   4 PCI Test Function
  5 =================                                   5 =================
  6                                                     6 
  7 :Author: Kishon Vijay Abraham I <kishon@ti.com>      7 :Author: Kishon Vijay Abraham I <kishon@ti.com>
  8                                                     8 
  9 Traditionally PCI RC has always been validated      9 Traditionally PCI RC has always been validated by using standard
 10 PCI cards like ethernet PCI cards or USB PCI c     10 PCI cards like ethernet PCI cards or USB PCI cards or SATA PCI cards.
 11 However with the addition of EP-core in linux      11 However with the addition of EP-core in linux kernel, it is possible
 12 to configure a PCI controller that can operate     12 to configure a PCI controller that can operate in EP mode to work as
 13 a test device.                                     13 a test device.
 14                                                    14 
 15 The PCI endpoint test device is a virtual devi     15 The PCI endpoint test device is a virtual device (defined in software)
 16 used to test the endpoint functionality and se     16 used to test the endpoint functionality and serve as a sample driver
 17 for other PCI endpoint devices (to use the EP      17 for other PCI endpoint devices (to use the EP framework).
 18                                                    18 
 19 The PCI endpoint test device has the following     19 The PCI endpoint test device has the following registers:
 20                                                    20 
 21         1) PCI_ENDPOINT_TEST_MAGIC                 21         1) PCI_ENDPOINT_TEST_MAGIC
 22         2) PCI_ENDPOINT_TEST_COMMAND               22         2) PCI_ENDPOINT_TEST_COMMAND
 23         3) PCI_ENDPOINT_TEST_STATUS                23         3) PCI_ENDPOINT_TEST_STATUS
 24         4) PCI_ENDPOINT_TEST_SRC_ADDR              24         4) PCI_ENDPOINT_TEST_SRC_ADDR
 25         5) PCI_ENDPOINT_TEST_DST_ADDR              25         5) PCI_ENDPOINT_TEST_DST_ADDR
 26         6) PCI_ENDPOINT_TEST_SIZE                  26         6) PCI_ENDPOINT_TEST_SIZE
 27         7) PCI_ENDPOINT_TEST_CHECKSUM              27         7) PCI_ENDPOINT_TEST_CHECKSUM
 28         8) PCI_ENDPOINT_TEST_IRQ_TYPE              28         8) PCI_ENDPOINT_TEST_IRQ_TYPE
 29         9) PCI_ENDPOINT_TEST_IRQ_NUMBER            29         9) PCI_ENDPOINT_TEST_IRQ_NUMBER
 30                                                    30 
 31 * PCI_ENDPOINT_TEST_MAGIC                          31 * PCI_ENDPOINT_TEST_MAGIC
 32                                                    32 
 33 This register will be used to test BAR0. A kno     33 This register will be used to test BAR0. A known pattern will be written
 34 and read back from MAGIC register to verify BA     34 and read back from MAGIC register to verify BAR0.
 35                                                    35 
 36 * PCI_ENDPOINT_TEST_COMMAND                        36 * PCI_ENDPOINT_TEST_COMMAND
 37                                                    37 
 38 This register will be used by the host driver      38 This register will be used by the host driver to indicate the function
 39 that the endpoint device must perform.             39 that the endpoint device must perform.
 40                                                    40 
 41 ========        ==============================     41 ========        ================================================================
 42 Bitfield        Description                        42 Bitfield        Description
 43 ========        ==============================     43 ========        ================================================================
 44 Bit 0           raise legacy IRQ                   44 Bit 0           raise legacy IRQ
 45 Bit 1           raise MSI IRQ                      45 Bit 1           raise MSI IRQ
 46 Bit 2           raise MSI-X IRQ                    46 Bit 2           raise MSI-X IRQ
 47 Bit 3           read command (read data from R     47 Bit 3           read command (read data from RC buffer)
 48 Bit 4           write command (write data to R     48 Bit 4           write command (write data to RC buffer)
 49 Bit 5           copy command (copy data from o     49 Bit 5           copy command (copy data from one RC buffer to another RC buffer)
 50 ========        ==============================     50 ========        ================================================================
 51                                                    51 
 52 * PCI_ENDPOINT_TEST_STATUS                         52 * PCI_ENDPOINT_TEST_STATUS
 53                                                    53 
 54 This register reflects the status of the PCI e     54 This register reflects the status of the PCI endpoint device.
 55                                                    55 
 56 ========        ==============================     56 ========        ==============================
 57 Bitfield        Description                        57 Bitfield        Description
 58 ========        ==============================     58 ========        ==============================
 59 Bit 0           read success                       59 Bit 0           read success
 60 Bit 1           read fail                          60 Bit 1           read fail
 61 Bit 2           write success                      61 Bit 2           write success
 62 Bit 3           write fail                         62 Bit 3           write fail
 63 Bit 4           copy success                       63 Bit 4           copy success
 64 Bit 5           copy fail                          64 Bit 5           copy fail
 65 Bit 6           IRQ raised                         65 Bit 6           IRQ raised
 66 Bit 7           source address is invalid          66 Bit 7           source address is invalid
 67 Bit 8           destination address is invalid     67 Bit 8           destination address is invalid
 68 ========        ==============================     68 ========        ==============================
 69                                                    69 
 70 * PCI_ENDPOINT_TEST_SRC_ADDR                       70 * PCI_ENDPOINT_TEST_SRC_ADDR
 71                                                    71 
 72 This register contains the source address (RC      72 This register contains the source address (RC buffer address) for the
 73 COPY/READ command.                                 73 COPY/READ command.
 74                                                    74 
 75 * PCI_ENDPOINT_TEST_DST_ADDR                       75 * PCI_ENDPOINT_TEST_DST_ADDR
 76                                                    76 
 77 This register contains the destination address     77 This register contains the destination address (RC buffer address) for
 78 the COPY/WRITE command.                            78 the COPY/WRITE command.
 79                                                    79 
 80 * PCI_ENDPOINT_TEST_IRQ_TYPE                       80 * PCI_ENDPOINT_TEST_IRQ_TYPE
 81                                                    81 
 82 This register contains the interrupt type (Leg     82 This register contains the interrupt type (Legacy/MSI) triggered
 83 for the READ/WRITE/COPY and raise IRQ (Legacy/     83 for the READ/WRITE/COPY and raise IRQ (Legacy/MSI) commands.
 84                                                    84 
 85 Possible types:                                    85 Possible types:
 86                                                    86 
 87 ======  ==                                         87 ======  ==
 88 Legacy  0                                          88 Legacy  0
 89 MSI     1                                          89 MSI     1
 90 MSI-X   2                                          90 MSI-X   2
 91 ======  ==                                         91 ======  ==
 92                                                    92 
 93 * PCI_ENDPOINT_TEST_IRQ_NUMBER                     93 * PCI_ENDPOINT_TEST_IRQ_NUMBER
 94                                                    94 
 95 This register contains the triggered ID interr     95 This register contains the triggered ID interrupt.
 96                                                    96 
 97 Admissible values:                                 97 Admissible values:
 98                                                    98 
 99 ======  ===========                                99 ======  ===========
100 Legacy  0                                         100 Legacy  0
101 MSI     [1 .. 32]                                 101 MSI     [1 .. 32]
102 MSI-X   [1 .. 2048]                               102 MSI-X   [1 .. 2048]
103 ======  ===========                               103 ======  ===========
                                                      

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php