€•%n      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ//translations/zh_CN/PCI/endpoint/pci-test-howto”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ//translations/zh_TW/PCI/endpoint/pci-test-howto”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ//translations/it_IT/PCI/endpoint/pci-test-howto”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ//translations/ja_JP/PCI/endpoint/pci-test-howto”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ//translations/ko_KR/PCI/endpoint/pci-test-howto”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ//translations/pt_BR/PCI/endpoint/pci-test-howto”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ//translations/sp_SP/PCI/endpoint/pci-test-howto”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh·sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1hµhhh²hh³ŒI/var/lib/git/docbuild/linux/Documentation/PCI/endpoint/pci-test-howto.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒPCI Test User Guide”h]”hŒPCI Test User Guide”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒ
field_list”“”)”}”(hhh]”hŒfield”“”)”}”(hhh]”(hŒ
field_name”“”)”}”(hŒAuthor”h]”hŒAuthor”…””}”(hhéh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhhäh³hÇh´K ubhŒ
field_body”“”)”}”(hŒ'Kishon Vijay Abraham I <kishon@ti.com>
”h]”hŒ	paragraph”“”)”}”(hŒ&Kishon Vijay Abraham I <kishon@ti.com>”h]”(hŒKishon Vijay Abraham I <”…””}”(hhÿh²hh³Nh´NubhŒ	reference”“”)”}”(hŒkishon@ti.com”h]”hŒkishon@ti.com”…””}”(hj	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:kishon@ti.com”uh1j  hhÿubhŒ>”…””}”(hhÿh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Khhùubah}”(h]”h ]”h"]”h$]”h&]”uh1h÷hhäubeh}”(h]”h ]”h"]”h$]”h&]”uh1hâh³hÇh´Khhßh²hubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhhÊh²hh³hÇh´Kubhþ)”}”(hŒÈThis document is a guide to help users use pci-epf-test function driver
and pci_endpoint_test host driver for testing PCI. The list of steps to
be followed in the host side and EP side is given below.”h]”hŒÈThis document is a guide to help users use pci-epf-test function driver
and pci_endpoint_test host driver for testing PCI. The list of steps to
be followed in the host side and EP side is given below.”…””}”(hj5  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K	hhÊh²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒEndpoint Device”h]”hŒEndpoint Device”…””}”(hjF  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjC  h²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒEndpoint Controller Devices”h]”hŒEndpoint Controller Devices”…””}”(hjW  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjT  h²hh³hÇh´Kubhþ)”}”(hŒ?To find the list of endpoint controller devices in the system::”h]”hŒ>To find the list of endpoint controller devices in the system:”…””}”(hje  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KhjT  h²hubhŒliteral_block”“”)”}”(hŒ+# ls /sys/class/pci_epc/
  51000000.pcie_ep”h]”hŒ+# ls /sys/class/pci_epc/
  51000000.pcie_ep”…””}”hju  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´KhjT  h²hubhþ)”}”(hŒ%If PCI_ENDPOINT_CONFIGFS is enabled::”h]”hŒ$If PCI_ENDPOINT_CONFIGFS is enabled:”…””}”(hjƒ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KhjT  h²hubjt  )”}”(hŒ=# ls /sys/kernel/config/pci_ep/controllers
  51000000.pcie_ep”h]”hŒ=# ls /sys/kernel/config/pci_ep/controllers
  51000000.pcie_ep”…””}”hj‘  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´KhjT  h²hubeh}”(h]”Œendpoint-controller-devices”ah ]”h"]”Œendpoint controller devices”ah$]”h&]”uh1hÈhjC  h²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒEndpoint Function Drivers”h]”hŒEndpoint Function Drivers”…””}”(hjª  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj§  h²hh³hÇh´Kubhþ)”}”(hŒ=To find the list of endpoint function drivers in the system::”h]”hŒ<To find the list of endpoint function drivers in the system:”…””}”(hj¸  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K!hj§  h²hubjt  )”}”(hŒ,# ls /sys/bus/pci-epf/drivers
  pci_epf_test”h]”hŒ,# ls /sys/bus/pci-epf/drivers
  pci_epf_test”…””}”hjÆ  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´K#hj§  h²hubhþ)”}”(hŒ%If PCI_ENDPOINT_CONFIGFS is enabled::”h]”hŒ$If PCI_ENDPOINT_CONFIGFS is enabled:”…””}”(hjÔ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K&hj§  h²hubjt  )”}”(hŒ7# ls /sys/kernel/config/pci_ep/functions
  pci_epf_test”h]”hŒ7# ls /sys/kernel/config/pci_ep/functions
  pci_epf_test”…””}”hjâ  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´K(hj§  h²hubeh}”(h]”Œendpoint-function-drivers”ah ]”h"]”Œendpoint function drivers”ah$]”h&]”uh1hÈhjC  h²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒCreating pci-epf-test Device”h]”hŒCreating pci-epf-test Device”…””}”(hjû  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjø  h²hh³hÇh´K-ubhþ)”}”(hŒƒPCI endpoint function device can be created using the configfs. To create
pci-epf-test device, the following commands can be used::”h]”hŒ‚PCI endpoint function device can be created using the configfs. To create
pci-epf-test device, the following commands can be used:”…””}”(hj	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K/hjø  h²hubjt  )”}”(hŒp# mount -t configfs none /sys/kernel/config
# cd /sys/kernel/config/pci_ep/
# mkdir functions/pci_epf_test/func1”h]”hŒp# mount -t configfs none /sys/kernel/config
# cd /sys/kernel/config/pci_ep/
# mkdir functions/pci_epf_test/func1”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´K2hjø  h²hubhþ)”}”(hŒlThe "mkdir func1" above creates the pci-epf-test function device that will
be probed by pci_epf_test driver.”h]”hŒpThe â€œmkdir func1â€ above creates the pci-epf-test function device that will
be probed by pci_epf_test driver.”…””}”(hj%  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K6hjø  h²hubhþ)”}”(hŒ[The PCI endpoint framework populates the directory with the following
configurable fields::”h]”hŒZThe PCI endpoint framework populates the directory with the following
configurable fields:”…””}”(hj3  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K9hjø  h²hubjt  )”}”(hŒì# ls functions/pci_epf_test/func1
  baseclass_code        interrupt_pin   progif_code     subsys_id
  cache_line_size       msi_interrupts  revid           subsys_vendorid
  deviceid              msix_interrupts subclass_code   vendorid”h]”hŒì# ls functions/pci_epf_test/func1
  baseclass_code        interrupt_pin   progif_code     subsys_id
  cache_line_size       msi_interrupts  revid           subsys_vendorid
  deviceid              msix_interrupts subclass_code   vendorid”…””}”hjA  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´K<hjø  h²hubhþ)”}”(hŒËThe PCI endpoint function driver populates these entries with default values
when the device is bound to the driver. The pci-epf-test driver populates
vendorid with 0xffff and interrupt_pin with 0x0001::”h]”hŒÊThe PCI endpoint function driver populates these entries with default values
when the device is bound to the driver. The pci-epf-test driver populates
vendorid with 0xffff and interrupt_pin with 0x0001:”…””}”(hjO  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KAhjø  h²hubjt  )”}”(hŒn# cat functions/pci_epf_test/func1/vendorid
  0xffff
# cat functions/pci_epf_test/func1/interrupt_pin
  0x0001”h]”hŒn# cat functions/pci_epf_test/func1/vendorid
  0xffff
# cat functions/pci_epf_test/func1/interrupt_pin
  0x0001”…””}”hj]  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´KEhjø  h²hubeh}”(h]”Œcreating-pci-epf-test-device”ah ]”h"]”Œcreating pci-epf-test device”ah$]”h&]”uh1hÈhjC  h²hh³hÇh´K-ubhÉ)”}”(hhh]”(hÎ)”}”(hŒConfiguring pci-epf-test Device”h]”hŒConfiguring pci-epf-test Device”…””}”(hjv  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjs  h²hh³hÇh´KLubhþ)”}”(hŒÇThe user can configure the pci-epf-test device using configfs entry. In order
to change the vendorid and the number of MSI interrupts used by the function
device, the following commands can be used::”h]”hŒÆThe user can configure the pci-epf-test device using configfs entry. In order
to change the vendorid and the number of MSI interrupts used by the function
device, the following commands can be used:”…””}”(hj„  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KNhjs  h²hubjt  )”}”(hŒÞ# echo 0x104c > functions/pci_epf_test/func1/vendorid
# echo 0xb500 > functions/pci_epf_test/func1/deviceid
# echo 32 > functions/pci_epf_test/func1/msi_interrupts
# echo 2048 > functions/pci_epf_test/func1/msix_interrupts”h]”hŒÞ# echo 0x104c > functions/pci_epf_test/func1/vendorid
# echo 0xb500 > functions/pci_epf_test/func1/deviceid
# echo 32 > functions/pci_epf_test/func1/msi_interrupts
# echo 2048 > functions/pci_epf_test/func1/msix_interrupts”…””}”hj’  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´KRhjs  h²hubhþ)”}”(hŒ7By default, pci-epf-test uses the following BAR sizes::”h]”hŒ6By default, pci-epf-test uses the following BAR sizes:”…””}”(hj   h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KWhjs  h²hubjt  )”}”(hX¹  # grep . functions/pci_epf_test/func1/pci_epf_test.0/bar?_size
  functions/pci_epf_test/func1/pci_epf_test.0/bar0_size:131072
  functions/pci_epf_test/func1/pci_epf_test.0/bar1_size:131072
  functions/pci_epf_test/func1/pci_epf_test.0/bar2_size:131072
  functions/pci_epf_test/func1/pci_epf_test.0/bar3_size:131072
  functions/pci_epf_test/func1/pci_epf_test.0/bar4_size:131072
  functions/pci_epf_test/func1/pci_epf_test.0/bar5_size:1048576”h]”hX¹  # grep . functions/pci_epf_test/func1/pci_epf_test.0/bar?_size
  functions/pci_epf_test/func1/pci_epf_test.0/bar0_size:131072
  functions/pci_epf_test/func1/pci_epf_test.0/bar1_size:131072
  functions/pci_epf_test/func1/pci_epf_test.0/bar2_size:131072
  functions/pci_epf_test/func1/pci_epf_test.0/bar3_size:131072
  functions/pci_epf_test/func1/pci_epf_test.0/bar4_size:131072
  functions/pci_epf_test/func1/pci_epf_test.0/bar5_size:1048576”…””}”hj®  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´KYhjs  h²hubhŒdefinition_list”“”)”}”(hhh]”hŒdefinition_list_item”“”)”}”(hŒzThe user can override a default value using e.g.::
# echo 1048576 > functions/pci_epf_test/func1/pci_epf_test.0/bar1_size
”h]”(hŒterm”“”)”}”(hŒ2The user can override a default value using e.g.::”h]”hŒ2The user can override a default value using e.g.::”…””}”(hjÉ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÇ  h³hÇh´KbhjÃ  ubhŒ
definition”“”)”}”(hhh]”hþ)”}”(hŒF# echo 1048576 > functions/pci_epf_test/func1/pci_epf_test.0/bar1_size”h]”hŒF# echo 1048576 > functions/pci_epf_test/func1/pci_epf_test.0/bar1_size”…””}”(hjÜ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KbhjÙ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j×  hjÃ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÁ  h³hÇh´Kbhj¾  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼  hjs  h²hh³hÇh´Nubhþ)”}”(hŒ}Overriding the default BAR sizes can only be done before binding the
pci-epf-test device to a PCI endpoint controller driver.”h]”hŒ}Overriding the default BAR sizes can only be done before binding the
pci-epf-test device to a PCI endpoint controller driver.”…””}”(hjü  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kdhjs  h²hubhþ)”}”(hŒšNote: Some endpoint controllers might have fixed-size BARs or reserved BARs;
for such controllers, the corresponding BAR size in configfs will be ignored.”h]”hŒšNote: Some endpoint controllers might have fixed-size BARs or reserved BARs;
for such controllers, the corresponding BAR size in configfs will be ignored.”…””}”(hj
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kghjs  h²hubeh}”(h]”Œconfiguring-pci-epf-test-device”ah ]”h"]”Œconfiguring pci-epf-test device”ah$]”h&]”uh1hÈhjC  h²hh³hÇh´KLubhÉ)”}”(hhh]”(hÎ)”}”(hŒ,Binding pci-epf-test Device to EP Controller”h]”hŒ,Binding pci-epf-test Device to EP Controller”…””}”(hj#  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj   h²hh³hÇh´Klubhþ)”}”(hŒÔIn order for the endpoint function device to be useful, it has to be bound to
a PCI endpoint controller driver. Use the configfs to bind the function
device to one of the controller driver present in the system::”h]”hŒÓIn order for the endpoint function device to be useful, it has to be bound to
a PCI endpoint controller driver. Use the configfs to bind the function
device to one of the controller driver present in the system:”…””}”(hj1  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Knhj   h²hubjt  )”}”(hŒB# ln -s functions/pci_epf_test/func1 controllers/51000000.pcie_ep/”h]”hŒB# ln -s functions/pci_epf_test/func1 controllers/51000000.pcie_ep/”…””}”hj?  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´Krhj   h²hubhþ)”}”(hŒ^Once the above step is completed, the PCI endpoint is ready to establish a link
with the host.”h]”hŒ^Once the above step is completed, the PCI endpoint is ready to establish a link
with the host.”…””}”(hjM  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kthj   h²hubeh}”(h]”Œ,binding-pci-epf-test-device-to-ep-controller”ah ]”h"]”Œ,binding pci-epf-test device to ep controller”ah$]”h&]”uh1hÈhjC  h²hh³hÇh´KlubhÉ)”}”(hhh]”(hÎ)”}”(hŒStart the Link”h]”hŒStart the Link”…””}”(hjf  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjc  h²hh³hÇh´Kyubhþ)”}”(hŒtIn order for the endpoint device to establish a link with the host, the _start_
field should be populated with '1'::”h]”hŒwIn order for the endpoint device to establish a link with the host, the _start_
field should be populated with â€˜1â€™:”…””}”(hjt  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K{hjc  h²hubjt  )”}”(hŒ-# echo 1 > controllers/51000000.pcie_ep/start”h]”hŒ-# echo 1 > controllers/51000000.pcie_ep/start”…””}”hj‚  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´K~hjc  h²hubeh}”(h]”Œstart-the-link”ah ]”h"]”Œstart the link”ah$]”h&]”uh1hÈhjC  h²hh³hÇh´Kyubeh}”(h]”Œendpoint-device”ah ]”h"]”Œendpoint device”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒRootComplex Device”h]”hŒRootComplex Device”…””}”(hj£  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj   h²hh³hÇh´K‚ubhÉ)”}”(hhh]”(hÎ)”}”(hŒlspci Output”h]”hŒlspci Output”…””}”(hj´  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj±  h²hh³hÇh´K…ubhþ)”}”(hŒRNote that the devices listed here correspond to the value populated in 1.4
above::”h]”hŒQNote that the devices listed here correspond to the value populated in 1.4
above:”…””}”(hjÂ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K‡hj±  h²hubjt  )”}”(hŒy00:00.0 PCI bridge: Texas Instruments Device 8888 (rev 01)
01:00.0 Unassigned class [ff00]: Texas Instruments Device b500”h]”hŒy00:00.0 PCI bridge: Texas Instruments Device 8888 (rev 01)
01:00.0 Unassigned class [ff00]: Texas Instruments Device b500”…””}”hjÐ  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´KŠhj±  h²hubeh}”(h]”Œlspci-output”ah ]”h"]”Œlspci output”ah$]”h&]”uh1hÈhj   h²hh³hÇh´K…ubhÉ)”}”(hhh]”(hÎ)”}”(hŒ#Using Endpoint Test function Device”h]”hŒ#Using Endpoint Test function Device”…””}”(hjé  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjæ  h²hh³hÇh´Kubhþ)”}”(hŒÉKselftest added in tools/testing/selftests/pci_endpoint can be used to run all
the default PCI endpoint tests. To build the Kselftest for PCI endpoint
subsystem, the following commands should be used::”h]”hŒÈKselftest added in tools/testing/selftests/pci_endpoint can be used to run all
the default PCI endpoint tests. To build the Kselftest for PCI endpoint
subsystem, the following commands should be used:”…””}”(hj÷  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K‘hjæ  h²hubjt  )”}”(hŒ@# cd <kernel-dir>
# make -C tools/testing/selftests/pci_endpoint”h]”hŒ@# cd <kernel-dir>
# make -C tools/testing/selftests/pci_endpoint”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´K•hjæ  h²hubhþ)”}”(hŒ8or if you desire to compile and install in your system::”h]”hŒ7or if you desire to compile and install in your system:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K˜hjæ  h²hubjt  )”}”(hŒ^# cd <kernel-dir>
# make -C tools/testing/selftests/pci_endpoint INSTALL_PATH=/usr/bin install”h]”hŒ^# cd <kernel-dir>
# make -C tools/testing/selftests/pci_endpoint INSTALL_PATH=/usr/bin install”…””}”hj!  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´Kšhjæ  h²hubhþ)”}”(hŒ-The test will be located in <rootfs>/usr/bin/”h]”hŒ-The test will be located in <rootfs>/usr/bin/”…””}”(hj/  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Khjæ  h²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒKselftest Output”h]”hŒKselftest Output”…””}”(hj@  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj=  h²hh³hÇh´K ubjt  )”}”(hXû  # pci_endpoint_test
TAP version 13
1..16
# Starting 16 tests from 9 test cases.
#  RUN           pci_ep_bar.BAR0.BAR_TEST ...
#            OK  pci_ep_bar.BAR0.BAR_TEST
ok 1 pci_ep_bar.BAR0.BAR_TEST
#  RUN           pci_ep_bar.BAR1.BAR_TEST ...
#            OK  pci_ep_bar.BAR1.BAR_TEST
ok 2 pci_ep_bar.BAR1.BAR_TEST
#  RUN           pci_ep_bar.BAR2.BAR_TEST ...
#            OK  pci_ep_bar.BAR2.BAR_TEST
ok 3 pci_ep_bar.BAR2.BAR_TEST
#  RUN           pci_ep_bar.BAR3.BAR_TEST ...
#            OK  pci_ep_bar.BAR3.BAR_TEST
ok 4 pci_ep_bar.BAR3.BAR_TEST
#  RUN           pci_ep_bar.BAR4.BAR_TEST ...
#            OK  pci_ep_bar.BAR4.BAR_TEST
ok 5 pci_ep_bar.BAR4.BAR_TEST
#  RUN           pci_ep_bar.BAR5.BAR_TEST ...
#            OK  pci_ep_bar.BAR5.BAR_TEST
ok 6 pci_ep_bar.BAR5.BAR_TEST
#  RUN           pci_ep_basic.CONSECUTIVE_BAR_TEST ...
#            OK  pci_ep_basic.CONSECUTIVE_BAR_TEST
ok 7 pci_ep_basic.CONSECUTIVE_BAR_TEST
#  RUN           pci_ep_basic.LEGACY_IRQ_TEST ...
#            OK  pci_ep_basic.LEGACY_IRQ_TEST
ok 8 pci_ep_basic.LEGACY_IRQ_TEST
#  RUN           pci_ep_basic.MSI_TEST ...
#            OK  pci_ep_basic.MSI_TEST
ok 9 pci_ep_basic.MSI_TEST
#  RUN           pci_ep_basic.MSIX_TEST ...
#            OK  pci_ep_basic.MSIX_TEST
ok 10 pci_ep_basic.MSIX_TEST
#  RUN           pci_ep_data_transfer.memcpy.READ_TEST ...
#            OK  pci_ep_data_transfer.memcpy.READ_TEST
ok 11 pci_ep_data_transfer.memcpy.READ_TEST
#  RUN           pci_ep_data_transfer.memcpy.WRITE_TEST ...
#            OK  pci_ep_data_transfer.memcpy.WRITE_TEST
ok 12 pci_ep_data_transfer.memcpy.WRITE_TEST
#  RUN           pci_ep_data_transfer.memcpy.COPY_TEST ...
#            OK  pci_ep_data_transfer.memcpy.COPY_TEST
ok 13 pci_ep_data_transfer.memcpy.COPY_TEST
#  RUN           pci_ep_data_transfer.dma.READ_TEST ...
#            OK  pci_ep_data_transfer.dma.READ_TEST
ok 14 pci_ep_data_transfer.dma.READ_TEST
#  RUN           pci_ep_data_transfer.dma.WRITE_TEST ...
#            OK  pci_ep_data_transfer.dma.WRITE_TEST
ok 15 pci_ep_data_transfer.dma.WRITE_TEST
#  RUN           pci_ep_data_transfer.dma.COPY_TEST ...
#            OK  pci_ep_data_transfer.dma.COPY_TEST
ok 16 pci_ep_data_transfer.dma.COPY_TEST
# PASSED: 16 / 16 tests passed.
# Totals: pass:16 fail:0 xfail:0 xpass:0 skip:0 error:0”h]”hXû  # pci_endpoint_test
TAP version 13
1..16
# Starting 16 tests from 9 test cases.
#  RUN           pci_ep_bar.BAR0.BAR_TEST ...
#            OK  pci_ep_bar.BAR0.BAR_TEST
ok 1 pci_ep_bar.BAR0.BAR_TEST
#  RUN           pci_ep_bar.BAR1.BAR_TEST ...
#            OK  pci_ep_bar.BAR1.BAR_TEST
ok 2 pci_ep_bar.BAR1.BAR_TEST
#  RUN           pci_ep_bar.BAR2.BAR_TEST ...
#            OK  pci_ep_bar.BAR2.BAR_TEST
ok 3 pci_ep_bar.BAR2.BAR_TEST
#  RUN           pci_ep_bar.BAR3.BAR_TEST ...
#            OK  pci_ep_bar.BAR3.BAR_TEST
ok 4 pci_ep_bar.BAR3.BAR_TEST
#  RUN           pci_ep_bar.BAR4.BAR_TEST ...
#            OK  pci_ep_bar.BAR4.BAR_TEST
ok 5 pci_ep_bar.BAR4.BAR_TEST
#  RUN           pci_ep_bar.BAR5.BAR_TEST ...
#            OK  pci_ep_bar.BAR5.BAR_TEST
ok 6 pci_ep_bar.BAR5.BAR_TEST
#  RUN           pci_ep_basic.CONSECUTIVE_BAR_TEST ...
#            OK  pci_ep_basic.CONSECUTIVE_BAR_TEST
ok 7 pci_ep_basic.CONSECUTIVE_BAR_TEST
#  RUN           pci_ep_basic.LEGACY_IRQ_TEST ...
#            OK  pci_ep_basic.LEGACY_IRQ_TEST
ok 8 pci_ep_basic.LEGACY_IRQ_TEST
#  RUN           pci_ep_basic.MSI_TEST ...
#            OK  pci_ep_basic.MSI_TEST
ok 9 pci_ep_basic.MSI_TEST
#  RUN           pci_ep_basic.MSIX_TEST ...
#            OK  pci_ep_basic.MSIX_TEST
ok 10 pci_ep_basic.MSIX_TEST
#  RUN           pci_ep_data_transfer.memcpy.READ_TEST ...
#            OK  pci_ep_data_transfer.memcpy.READ_TEST
ok 11 pci_ep_data_transfer.memcpy.READ_TEST
#  RUN           pci_ep_data_transfer.memcpy.WRITE_TEST ...
#            OK  pci_ep_data_transfer.memcpy.WRITE_TEST
ok 12 pci_ep_data_transfer.memcpy.WRITE_TEST
#  RUN           pci_ep_data_transfer.memcpy.COPY_TEST ...
#            OK  pci_ep_data_transfer.memcpy.COPY_TEST
ok 13 pci_ep_data_transfer.memcpy.COPY_TEST
#  RUN           pci_ep_data_transfer.dma.READ_TEST ...
#            OK  pci_ep_data_transfer.dma.READ_TEST
ok 14 pci_ep_data_transfer.dma.READ_TEST
#  RUN           pci_ep_data_transfer.dma.WRITE_TEST ...
#            OK  pci_ep_data_transfer.dma.WRITE_TEST
ok 15 pci_ep_data_transfer.dma.WRITE_TEST
#  RUN           pci_ep_data_transfer.dma.COPY_TEST ...
#            OK  pci_ep_data_transfer.dma.COPY_TEST
ok 16 pci_ep_data_transfer.dma.COPY_TEST
# PASSED: 16 / 16 tests passed.
# Totals: pass:16 fail:0 xfail:0 xpass:0 skip:0 error:0”…””}”hjN  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´K£hj=  h²hubhþ)”}”(hŒçTestcase 16 (pci_ep_data_transfer.dma.COPY_TEST) will fail for most of the DMA
capable endpoint controllers due to the absence of the MEMCPY over DMA. For such
controllers, it is advisable to skip this testcase using this
command::”h]”hŒæTestcase 16 (pci_ep_data_transfer.dma.COPY_TEST) will fail for most of the DMA
capable endpoint controllers due to the absence of the MEMCPY over DMA. For such
controllers, it is advisable to skip this testcase using this
command:”…””}”(hj\  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KÛhj=  h²hubjt  )”}”(hŒO# pci_endpoint_test -f pci_ep_bar -f pci_ep_basic -v memcpy -T COPY_TEST -v dma”h]”hŒO# pci_endpoint_test -f pci_ep_bar -f pci_ep_basic -v memcpy -T COPY_TEST -v dma”…””}”hjj  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1js  h³hÇh´Kàhj=  h²hubeh}”(h]”Œkselftest-output”ah ]”h"]”Œkselftest output”ah$]”h&]”uh1hÈhjæ  h²hh³hÇh´K ubhÉ)”}”(hhh]”(hÎ)”}”(hŒKselftest EP Doorbell”h]”hŒKselftest EP Doorbell”…””}”(hjƒ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj€  h²hh³hÇh´Kãubhþ)”}”(hŒbIf the Endpoint MSI controller is used for the doorbell usecase, run below
command for testing it:”h]”hŒbIf the Endpoint MSI controller is used for the doorbell usecase, run below
command for testing it:”…””}”(hj‘  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kåhj€  h²hubhŒblock_quote”“”)”}”(hX+  # pci_endpoint_test -f pcie_ep_doorbell

# Starting 1 tests from 1 test cases.
#  RUN           pcie_ep_doorbell.DOORBELL_TEST ...
#            OK  pcie_ep_doorbell.DOORBELL_TEST
ok 1 pcie_ep_doorbell.DOORBELL_TEST
# PASSED: 1 / 1 tests passed.
# Totals: pass:1 fail:0 xfail:0 xpass:0 skip:0 error:0”h]”(hþ)”}”(hŒ'# pci_endpoint_test -f pcie_ep_doorbell”h]”hŒ'# pci_endpoint_test -f pcie_ep_doorbell”…””}”(hj¥  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kèhj¡  ubhþ)”}”(hX  # Starting 1 tests from 1 test cases.
#  RUN           pcie_ep_doorbell.DOORBELL_TEST ...
#            OK  pcie_ep_doorbell.DOORBELL_TEST
ok 1 pcie_ep_doorbell.DOORBELL_TEST
# PASSED: 1 / 1 tests passed.
# Totals: pass:1 fail:0 xfail:0 xpass:0 skip:0 error:0”h]”hX  # Starting 1 tests from 1 test cases.
#  RUN           pcie_ep_doorbell.DOORBELL_TEST ...
#            OK  pcie_ep_doorbell.DOORBELL_TEST
ok 1 pcie_ep_doorbell.DOORBELL_TEST
# PASSED: 1 / 1 tests passed.
# Totals: pass:1 fail:0 xfail:0 xpass:0 skip:0 error:0”…””}”(hj³  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kêhj¡  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jŸ  h³hÇh´Kèhj€  h²hubeh}”(h]”Œkselftest-ep-doorbell”ah ]”h"]”Œkselftest ep doorbell”ah$]”h&]”uh1hÈhjæ  h²hh³hÇh´Kãubeh}”(h]”Œ#using-endpoint-test-function-device”ah ]”h"]”Œ#using endpoint test function device”ah$]”h&]”uh1hÈhj   h²hh³hÇh´Kubeh}”(h]”Œrootcomplex-device”ah ]”h"]”Œrootcomplex device”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K‚ubeh}”(h]”Œpci-test-user-guide”ah ]”h"]”Œpci test user guide”ah$]”h&]”uh1hÈhhh²hh³hÇh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÇuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÍNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j
  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÇŒ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jä  já  j  jš  j¤  j¡  jõ  jò  jp  jm  j  j  j`  j]  j•  j’  jÜ  jÙ  jã  jà  jÔ  jÑ  j}  jz  jÌ  jÉ  uŒ	nametypes”}”(jä  ‰j  ‰j¤  ‰jõ  ‰jp  ‰j  ‰j`  ‰j•  ‰jÜ  ‰jã  ‰jÔ  ‰j}  ‰jÌ  ‰uh}”(já  hÊjš  jC  j¡  jT  jò  j§  jm  jø  j  js  j]  j   j’  jc  jÙ  j   jà  j±  jÑ  jæ  jz  j=  jÉ  j€  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”hŒsystem_message”“”)”}”(hhh]”hþ)”}”(hŒ`Blank line missing before literal block (after the "::")? Interpreted as a definition list item.”h]”hŒdBlank line missing before literal block (after the â€œ::â€)? Interpreted as a definition list item.”…””}”(hjq  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýhjn  ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œline”KcŒsource”hÇuh1jl  hjÙ  ubaŒtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.