PCI Express Configuration - cl.cam.ac.uk fileThis page is intentionally left blank. PCI Express...
Transcript of PCI Express Configuration - cl.cam.ac.uk fileThis page is intentionally left blank. PCI Express...
PCI Express Configuration Test Methodology September 29, 2006 Revision 1.1
Document Number: 0002
This page is intentionally left blank.
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
2
Revision History
Document No. Rev. No. Description Rev. Date 0002 0.50 Initial Draft 8/18/2005 0002 0.90 WG Review Draft 9/8/2005 0002 1.0 Draft Release Candidate 9/23/2005 0002 1.1 Release for PCIe 1.1 9/29/06
The PCI-SIG disclaims all warranties and liability for the use of this document and the information contained herein and assumes no responsibility for any errors that may appear in this document, nor does the PCI-SIG make a commitment to update the information contained herein.
Contact the PCI-SIG office to obtain the latest revision of this checklist
Questions regarding the ths document or membership in the PCI-SIG may be forwarded to:
PCI-SIG 3855 SW 153rd Drive Beaverton, OR, 97006 Phone: 503-619-0569 Fax: 503-644-6708 e-mail [email protected] http://www.pcisig.com
DISCLAIMER
This document is provided "as is" with no warranties whatsoever, including any warranty of merchantability, noninfringement, fitness for any particular purpose, or any warranty otherwise arising out of any proposal, specification, or sample. The PCI-SIG disclaims all liability for infringement of proprietary rights, relating to use of information in this specification. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted herein.
All product names are trademarks, registered trademarks, or servicemarks of their respective owners.
Copyright © 1999, 2000, 2003, 2005, 2006 PCI-SIG
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
3
Contents 1 Test Procedure ........................................................................................................................ 7
1.1 PCIECV .......................................................................................................................... 8 1.2 End Point and Legacy Endpoint testing.......................................................................... 9 1.3 For Switches.................................................................................................................. 17 1.4 PCIE to PCI Bridge....................................................................................................... 30 1.5 How to Read the PCIECV test Logs............................................................................. 41
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
4
Figures Figure 1.1 New Hardware Wizard ...................................................................................... 7 Figure 1.2 PCIECV Default Menu..................................................................................... 8 Figure 1.3 PCI Express Legacy Endpoint Window.......................................................... 10 Figure 1.4 PCI Express End Point Tests.......................................................................... 11 Figure 1.5 Test Status Window........................................................................................ 12 Figure 1.6 Test Summary Window................................................................................. 12 Figure 1.7 Test Results .................................................................................................... 13 Figure 1.8 PCI Express Endpoint Test Menu (Exit Window) ......................................... 14 Figure 1.9 PCIECV Default Menu................................................................................... 15 Figure 1.10 Log Folder .................................................................................................... 15 Figure 1.11 Log File (for Test Just Run) ......................................................................... 15 Figure 1.12 Search Window ............................................................................................ 16 Figure 1.13 Example Test Results Log............................................................................ 16 Figure 1.14 Example Test Results Log – Search for “FAIL”.......................................... 17 Figure 1.15 PCIECV Default Menu................................................................................. 18 Figure 1.16 Test Status Window...................................................................................... 19 Figure 1.17 Test Summary WIndow................................................................................ 20 Figure 1.18 Test Result Window ..................................................................................... 21 Figure 1.19 Log Folder .................................................................................................... 22 Figure 1.20 Log File (for Test Just Run) ......................................................................... 22 Figure 1.21 Search Window ............................................................................................ 22 Figure 1.22 Example Test Results Log............................................................................ 23 Figure 1.23 Example Test Results Log – Seach for “FAIL” ........................................... 24 Figure 1.24 PCIECV Default Menu................................................................................. 25 Figure 1.25 Test Results Status Window......................................................................... 26 Figure 1.26 Test Results Summary.................................................................................. 26 Figure 1.27 Test Results Window.................................................................................... 27 Figure 1.28 Log Folder .................................................................................................... 28 Figure 1.29 Log File (for Test Just Run) ......................................................................... 28 Figure 1.30 Search Window ............................................................................................ 28 Figure 1.31 Example Test Results Log............................................................................ 29 Figure 1.32 Example Test Results Log – Search for “Fail” ............................................ 30 Figure 1.33 PCIECV Default Menu................................................................................. 31 Figure 1.34 PCI Express Endpoint Tests ......................................................................... 32 Figure 1.35 Test Results Status Window......................................................................... 33 Figure 1.36 Test Results Summary.................................................................................. 34 Figure 1.37 Test Results Window.................................................................................... 35 Figure 1.38 PCI Express Endpoint Tests ......................................................................... 36 Figure 1.39 PCIECV Default Menu................................................................................. 37 Figure 1.40 Log Folder .................................................................................................... 37 Figure 1.41 Log File (for Test Just Run) ......................................................................... 38 Figure 1.42 Search Window ............................................................................................ 38
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
5
Figure 1.43 Example Test Results Log............................................................................ 39 Figure 1.44 Example Test Results Log – Search for “Fail” ............................................ 40
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
6
1 Test Procedure
Always Check the release notes / Read me for last minute comments relative to the release. Power off system and remove AC power from power supply to remove V Aux power from system. Install vendor card in any Express slot then power on system After Windows loads if a "New Hardware Wizard" appears (Figure-1) press "Cancel" - Do not install ANY device drivers as it will alter test results
Figure 1.1 New Hardware Wizard
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
7
1.1 PCIECV
Start PCIECV - Start menu - Programs - PCIECV Application
-Then click on PCIECV Application
The Application will come up to the default menu below.
Figure 1.2 PCIECV Default Menu
Select either 1.1 Spec Only OR Test against either 1.0a/1.1 spec Test against 1.1 Spec Only – This will test a device as a strict 1.1 device only Test against either 1.0a or 1.1 Spec - This will test a device as a 1.0a device and will also test the device for implementation of any ECNs, Eratta or any updates to 1.1 spec. for each test. The individual test will pass if any of the test cases (1.0a or 1.1) pass for that individual test You are now ready to test
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
8
1.2 End Point and Legacy Endpoint testing
-Select either "PCI-Express Endpoint" or "PCI-Express Legacy Endpoint" (in this example we will select legacy)
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
9
Figure 1.4 PCI Express Legacy Endpoint Window
- Now select the device that matches the VID (Vendor ID) for the device you are testing (as shown above) *note if the device is a multi function then pick one of the functions
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
10
Figure 1.5 PCI Express End Point Tests
- Now select "Run all Tests" This will start the testing *if debugging then you can select to run single test from this menu - While running you will see the test running in the "dos window" with a status window popping up after every test section as shown
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
11
Figure 1.6 Test Status Window
- When the test completes you will get the screen below that gives you a summary. Click continue
Figure 1.7 Test Summary Window
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
12
- After you click continue you will now the see the results for each test * Passed - Test was successful * Failed - Test was not successful * Not Run - Devices does not support functions in this test
Figure 1.8 Test Results
- Record all Failed results on the "Compliance Workshop Test Results Report" Format of Failed results (from above "Test Results"): TD 1-4 DevCapControlStatusReg TD 1-7 AdvancedErrorReportingCap TD 1-16 PowerManagementCap TD 1-17 MSIXCapabilityStructureTest TD 1-18 BaseAddressRrgistersTest TD 1-19 MF_VirtualChannelCapabilityTest
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
13
TD 1-20 VendorSpecificCapabilityTest -Click "OK" -Select "Exit" then click "OK"
Figure 1.9 PCI Express Endpoint Test Menu (Exit Window)
-Again select "Exit" then click "OK"
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
14
Figure 1.10 PCIECV Default Menu
Go to the Log Folder - Start menu - Programs - PCIECV Application -Click on Log Folder
Figure 1.11 Log Folder
Find the log file from the test you just run. You can determine this by the date and time stamp of the log or from the file format name.
Figure 1.12 Log File (for Test Just Run)
After you find the file, right click and select rename. You should rename in the format of "Vendorname_ProductName.txt" Example: LSAB_Release1.txt" Now Double Click on the file and open
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
15
Click on edit and Find, and type "FAIL" in all caps and check Match case. Then Click "Find Next"
Figure 1.13 Search Window
Figure 1.14 Example Test Results Log
This will bring you to the first failure. The failure data will always be above the words FAIL and below the words ERROR as shown in Figure1.14. Note: Please see “How to Read the PCIECV Test Logs” following Figure 1.44 at the back of this document. This provides a brief description of how to read the test logs, which you may find especially helpful when testing to the option “Test against PCIe 1.0a or PCI 1.1 specs.
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
16
Figure 1.15 Example Test Results Log – Search for “FAIL”
In the above example you should talk the Vendor through the failure. In the above example; "Aux Power PM Enable failed default value test. Default value: 0x0 Value Read: 0x1 CFG 5.0.2 : All fields must default to any default values specified in the PCI Express specification except for Root Complexes and System Integrated devices." This means that the default should have been 0x0 but 0x1 was read back.
1.3 For Switches
For switches you will be running 2 tests - 1 test for the Up Stream port - 1 test for each of the Down Stream switch ports (which requires an end device plugged in) Note: A system reboot is required before running each downstream port test.
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
17
Start PCIECV
Figure 1.16 PCIECV Default Menu
Click on "Switch Upstream Port" On the next Screen click on the vendor's upstream port (make sure you select the correct bridge) - Now select the device that matches the VID (Vendor ID) for the device you are testing Note if one of the devices is a multi function device, then pick one of the functions - Now select "Run all Tests" This will start the testing *if debugging then you can select to run single test from this menu - While running you will see the test running in the "dos window" with a status window popping up after every test section as shown
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
18
Figure 1.17 Test Status Window
-When the test completes you will get the screen below that gives you a summary. Click continue
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
19
Figure 1.18 Test Summary Window
- After you click continue you will now the see the results for each test * Passed - Test was successful * Failed - Test was not successful * Not Run - Devices does not support functions in this test
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
20
Figure 1.19 Test Result Window
- Record all Failed results on the "Compliance Workshop Test Results Report" Format of Failed results (from above "Test Results"): TD 1-4 DevCapControlStatusReg TD 1-7 AdvancedErrorReportingCap TD 1-16 PowerManagementCap TD 1-17 MSIXCapabilityStructureTest TD 1-18 BaseAddressRrgistersTest TD 1-19 MF_VirtualChannelCapabilityTest TD 1-20 VendorSpecificCapabilityTest -Click "OK" -Select "Exit" the click "OK" Go to the Log Folder - Start menu - Programs - PCIECV Application - Click on Log Folder
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
21
Figure 1.20 Log Folder
Find the log file from the test you just run. You can determine this by the date and time stamp of the log or from the file format name.
Figure 1.21 Log File (for Test Just Run)
After you find the file right click and select rename. You should rename in the format of "Vendorname_ProductName_up.txt" Example: LSAB_Release1_up.txt" Now Double Click on the file and open Click on edit and Find and type "FAIL" in all caps and check Match case. Then Click "Find Next"
Figure 1.22 Search Window
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
22
Figure 1.23 Example Test Results Log
This will bring you to the first failure. The failure data always will be above the words FAIL, followed by text of the failure
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
23
Figure 1.24 Example Test Results Log – Search for “FAIL”
In the above example you should talk the Vendor through the failure. In the above example; "Aux Power PM Enable failed default value test. Default value: 0x0 Value Read: 0x1 CFG 5.0.2 : All fields must default to any default values specified in the PCI Express specification except for Root Complexes and System Integrated devices." This means that the default should have been 0x0 but 0x1 was read back.
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
24
Start PCIECV
Figure 1.25 PCIECV Default Menu
Click on "Switch Downstream Port" On the next Screen click on the vendor's Downstream port (This port MUST have an end device plugged in or the test will fail) - Now select the device that matches the VID (Vendor ID) for the device you are testing *note if the device is a multi function device then pick one of the functions - Now select "Run all Tests" This will start the testing *if debugging then you can select to run single test from this menu - While running you will see the test running in the "dos window" with a status window popping up after every test section as shown
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
25
Figure 1.26 Test Results Status Window
- When the test completes you will get the screen below that gives you a summary. Click continue
Figure 1.27 Test Results Summary
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
26
- After you click continue you will now the see the results for each test * Passed - Test was successful * Failed - Test was not successful * Not Run - Devices does not support functions in this test
Figure 1.28 Test Results Window
- Record all Failed results on the "Compliance Workshop Test Results Report" Format of Failed results (from above "Test Results"): TD 1-4 DevCapControlStatusReg TD 1-7 AdvancedErrorReportingCap TD 1-16 PowerManagementCap TD 1-17 MSIXCapabilityStructureTest TD 1-18 BaseAddressRrgistersTest TD 1-19 MF_VirtualChannelCapabilityTest TD 1-20 VendorSpecificCapabilityTest -Click "OK" -Select "Exit" the click "OK"
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
27
Go to the Log Folder - Start menu - Programs - PCIECV Application -Click on Log Folder
Figure 1.29 Log Folder
Find the log file from the test you just run. You can determine this by the date and time stamp of the log or from the file format name.
Figure 1.30 Log File (for Test Just Run)
After you find the file right click and select rename. You should rename in the format of "Vendorname_ProductName_down.txt" Example: LSAB_Release1_down.txt" Now Double Click on the file and open Click on edit and Find and type "FAIL" in all caps and check Match case. Then Click "Find Next"
Figure 1.31 Search Window
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
28
Figure 1.32 Example Test Results Log
This will bring you to the first failure. The failure data always will be above the words FAIL, followed by text of the failure
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
29
Figure 1.33 Example Test Results Log – Search for “Fail”
In the above example you should talk the Vendor through the failure. In the above example; "Aux Power PM Enable failed default value test. Default value: 0x0 Value Read: 0x1 CFG 5.0.2 : All fields must default to any default values specified in the PCI Express specification except for Root Complexes and System Integrated devices." This means that the default should have been 0x0 but 0x1 was read back.
1.4 PCIE to PCI Bridge
-Select PCIE to PCI Bridge
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
30
Figure 1.34 PCIECV Default Menu
- Now select the device that matches the VID (Vendor ID) for the device you are testing
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
31
Figure 1.35 PCI Express Endpoint Tests
- Now select "Run all Tests" This will start the testing *if debugging then you can select to run single test from this menu - While running you will see the test running in the "dos window" with a status window popping up after every test section as shown
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
32
Figure 1.36 Test Results Status Window
- When the test completes you will get the screen below that gives you a summary. Click continue
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
33
Figure 1.37 Test Results Summary
- After you click continue you will now the see the results for each test * Passed - Test was successful * Failed - Test was not successful * Not Run - Devices does not support functions in this test
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
34
Figure 1.38 Test Results Window
- Record all Failed results on the "Compliance Workshop Test Results Report" Format of Failed results (from above "Test Results"): TD 1-4 DevCapControlStatusReg TD 1-7 AdvancedErrorReportingCap TD 1-16 PowerManagementCap TD 1-17 MSIXCapabilityStructureTest TD 1-18 BaseAddressRrgistersTest TD 1-19 MF_VirtualChannelCapabilityTest TD 1-20 VendorSpecificCapabilityTest -Click "OK" -Select "Exit" the click "OK"
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
35
Figure 1.39 PCI Express Endpoint Tests
-Again select "Exit" the click "OK"
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
36
Figure 1.40 PCIECV Default Menu
Go to the Log Folder - Start menu - Programs - PCIECV Application - Click on Log Folder
Figure 1.41 Log Folder
Find the log file from the test you just run. You can determine this by the date and time stamp of the log or from the file format name.
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
37
Figure 1.42 Log File (for Test Just Run)
After you find the file right click and select rename. You should rename in the format of "Vendorname_ProductName_Bridge.txt" Example: LSAB_Release1_Bridge.txt" Now Double Click on the file and open Click on edit and Find and type "FAIL" in all caps and check Match case. Then Click "Find Next"
Figure 1.43 Search Window
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
38
Figure 1.44 Example Test Results Log
This will bring you to the first failure. The failure data always will be above the words FAIL, followed by text of the failure
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
39
Figure 1.45 Example Test Results Log – Search for “Fail”
In the above example you should talk the Vendor through the failure. In the above example; "Aux Power PM Enable failed default value test. Default value: 0x0 Value Read: 0x1 CFG 5.0.2 : All fields must default to any default values specified in the PCI Express specification except for Root Complexes and System Integrated devices." This means that the default should have been 0x0 but 0x1 was read back.
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
40
1.5 How to Read the PCIECV test Logs
Testing against the PCIe 1.1 spec Only
When the tests complete look at the test summary, which will indicate the overall number of passed and the number of failed tests.
If there are no overall failures, then a log review is not needed. If you have a failure, then open the log. When testing against the PCIe 1.1 spec Only, it is necessary
to pass the tests that are provided under this test suite option. o Click on Edit and Find and type "FAIL" in all caps and check Match case. o Then Click "Find Next", which will bring you to the first possible failure. o The failure data always will be above the words FAIL, followed by text of the failure o The test results summary at the bottom of the log, lumps test results together based on test
sections (i.e sub-tests under Test 1_16 may have one or more sub-test failures, but would be counted as one test failure for 1_16, in the summary roll-up at the bottom of the test log.
Testing against either the PCIe 1.0a or the PCIe 1.1 Spec
When the tests complete look at the test summary, which will indicate the overall number of passed and the number of failed tests.
If there are no overall failures, then a log review is not needed. If you have a failure, then open the log. When testing against “either” PCIe 1.0a or PCIe 1.1 spec, it
is necessary to pass either the original tests, or the tests based on the approved Errata and ECNs (that eventually will replace impacted tests (impacted by either approved Errata or ECNs)).
o Click on Edit and Find and type "FAIL" in all caps and check Match case. o Then Click "Find Next", which will bring you to the first possible failure. o The failure data always will be above the words FAIL, followed by text of the failure
When you find the “FAIL” you must check where you are in the logging process to insure you are looking at a “true failure”, or a test that was run to “test” if you implemented an ECN, Errata fix, etc…
o If you fail both the original “impacted test” and the new “replacement test”, then it is a true failure, but if it passes one and fails the other in either order, it is counted as a pass.
o The test results summary at the bottom of the log, lumps test results together based on test sections (i.e sub-tests under Test 1_16 may have one or more sub-test failures, but would be counted as one test failure for 1_16, in the summary roll-up at the bottom of the test log.
The following provides 4 examples. Below is example 1; In this example there is a FAIL in the “1_0A_BASE_ERRATA_C5” section but NO error in the “1_0A_BASE” section. This indicates that you have passed the “1_0A_BASE” but failed the “1_0A_BASE_ERRATA_C5” , which is automatically counted as a pass for this test. INFO ********************************************************* INFO Begin testing the following fields to 1_0A_BASE
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
41
INFO ********************************************************* …. ….. INFO ********************************************************* INFO End testing the above fields to 1_0A_BASE INFO ********************************************************* INFO ********************************************************* INFO Begin testing the following fields to 1_0A_BASE_ERRATA_C5 INFO ********************************************************* …. ….. ….. FAIL ……… ….. ….. INFO ********************************************************* INFO End Testing the above fields to 1_0A_BASE_ERRATA_C5 INFO ********************************************************* Below is example 2; In this example there is a FAIL in the “1_0A_BASE” section but NO error in the “1_0A_BASE_ERRATA_C5” section. This indicates that you have passed the “1_0A_BASE_ERRATA_C5” but failed the “1_0A_BASE” , which is automatically counted as a pass for this test. INFO ********************************************************* INFO Begin testing the following fields to 1_0A_BASE INFO ********************************************************* …. FAIL ……… ….. ….. INFO ********************************************************* INFO End testing the above fields to 1_0A_BASE INFO ********************************************************* INFO ********************************************************* INFO Begin testing the following fields to 1_0A_BASE_ERRATA_C5 INFO ********************************************************* …. …. ….. INFO ********************************************************* INFO End Testing the above fields to 1_0A_BASE_ERRATA_C5 INFO *********************************************************
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
42
Below is example 3; In this example there is a FAIL in the “1_0A_BASE” section and in the “1_0A_BASE_ERRATA_C5” section. This indicates that you have Failed both the “1_0A_BASE” and the “1_0A_BASE_ERRATA_C5” which is automatically counted as a Fail for this test. INFO ********************************************************* INFO Begin testing the following fields to 1_0A_BASE INFO ********************************************************* …. FAIL ……… ….. ….. INFO ********************************************************* INFO End testing the above fields to 1_0A_BASE INFO ********************************************************* INFO ********************************************************* INFO Begin testing the following fields to 1_0A_BASE_ERRATA_C5 INFO ********************************************************* …. …. FAIL ……… ….. ….. INFO ********************************************************* INFO End Testing the above fields to 1_0A_BASE_ERRATA_C5 INFO ********************************************************* Below is example 4. In this example there is NO requirement in the “1_0A_BASE” section and there is in the “1_0A_BASE_ERRATA_C5” section. In this example it indicates that you have Failed the “1_0A_BASE_ERRATA_C5”, but since there is NOT a requirement for “1_0A_BASE” this is counted as a Pass for this test. INFO ********************************************************* INFO Begin testing the following fields to 1_0A_BASE INFO ********************************************************* INFO ********************************************************* INFO End testing the above fields to 1_0A_BASE INFO ********************************************************* INFO ********************************************************* INFO Begin testing the following fields to 1_0A_BASE_ERRATA_C5 INFO ********************************************************* …. …. FAIL ………
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
43
….. ….. INFO ********************************************************* INFO End Testing the above fields to 1_0A_BASE_ERRATA_C5 INFO *********************************************************
PCI Express Configuration Test Methodology, Rev 1.1 <0002>
44