GTS AXI Streaming IP for PCI Express* User Guide: Agilex™ 5 and Agilex™ 3 FPGAs and SoCs

Download PDF
ID 813754
Date 8/04/2025
Public
Document Table of Contents
Document Table of Contents x
1. Introduction 2. Features 3. Getting Started with GTS AXI Streaming IP 4. IP Architecture and Functional Description 5. IP Parameters 6. Interfaces and Signals 7. Registers 8. Document Revision History for the GTS AXI Streaming IP for PCI Express* User Guide: Agilex™ 5 and Agilex™ 3 FPGAs and SoCs A. Troubleshooting/Debugging B. PIPE Mode Simulation C. Implementation of Address Translation Services (ATS) in Endpoint Mode
1. Introduction x
1.1. About PCI Express* 1.2. Goal of the GTS AXI Streaming IP for PCI Express* User Guide 1.3. Example Use Models
2. Features x
2.1. Supported Features 2.2. Device Family Support 2.3. Release Information 2.4. Recommended FPGA Fabric Speed Grades 2.5. Resource Utilization 2.6. IP Core and Design Example Support Levels
3. Getting Started with GTS AXI Streaming IP x
3.1. Downloading and Installing Quartus® Prime Software 3.2. Configuring and Generating the GTS AXI Streaming IP 3.3. Configuring and Generating GTS System PLL Clocks IP 3.4. Configuring and Generating GTS Reset Sequencer IP 3.5. Instantiating and Connecting GTS AXI Streaming IP Interfaces (and Other IPs) 3.6. Simulating the GTS AXI Streaming IP Variant 3.7. Compiling the GTS AXI Streaming IP Variant
4. IP Architecture and Functional Description x
4.1. Clocking 4.2. Resets 4.3. PCIe* Hard IP 4.4. Hard IP Interface (IF) Adaptor 4.5. Interrupts 4.6. Transaction Ordering 4.7. TX Non-Posted Metering Requirement on Application 4.8. AXI4-Stream Interface 4.9. Tag Allocation 4.10. Power Management 4.11. Config Retry Status Enable 4.12. Hot-Plug 4.13. Configuration Space Extension 4.14. Page Request Service (EP only) 4.15. Precision Time Measurement (PTM) 4.16. Single Root I/O Virtualization (SR-IOV) 4.17. Transaction Layer Packet (TLP) Bypass Mode 4.18. Scalable IOV
4.1. Clocking x
4.1.1. Reference Clock
4.5. Interrupts x
4.5.1. Legacy Interrupt 4.5.2. Message Signaled Interrupts (MSI) 4.5.3. Message Signal Interrupt Extended (MSI-X)
4.8. AXI4-Stream Interface x
4.8.1. Header Format 4.8.2. Prefix Format 4.8.3. Function Number Format 4.8.4. BAR Number Format 4.8.5. Data and Header Packing Scheme
4.10. Power Management x
4.10.1. Endpoint D3 Entry 4.10.2. Endpoint L2 Exit
4.16. Single Root I/O Virtualization (SR-IOV) x
4.16.1. SR-IOV Implementation
4.17. Transaction Layer Packet (TLP) Bypass Mode x
4.17.1. AXI-Lite Usage for TLP Bypass Mode 4.17.2. Configuration TLP 4.17.3. Transmit Interface 4.17.4. Receive Interface 4.17.5. Malformed TLP 4.17.6. ECRC
5. IP Parameters x
5.1. System Settings 5.2. PCIe0/PCIe1 5.3. Diagnostics
5.2. PCIe0/PCIe1 x
5.2.1. Interfaces Port 0/Interfaces Port 1 5.2.2. PCIe0/PCIe1 Settings
5.2.1. Interfaces Port 0/Interfaces Port 1 x
5.2.1.1. AXI Interfaces 0/AXI Interface 1 Settings
5.2.2. PCIe0/PCIe1 Settings x
5.2.2.1. PCIe0/PCIe1 Configuration, Debug and Extension Options 5.2.2.2. PCIe0/PCIe1 Base Address Registers 5.2.2.3. PCIe0/PCIe1 Device Identification Registers 5.2.2.4. PCIe0/PCIe1 PCI Express / PCI Capabilities
5.2.2.4. PCIe0/PCIe1 PCI Express / PCI Capabilities x
5.2.2.4.1. PCIe0/PCIe1 Device 5.2.2.4.2. PCIe0/PCIe1 Link 5.2.2.4.3. PCIe0/PCIe1 Slot 5.2.2.4.4. PCIe0/PCIe1 Legacy Interrupt Pin Register 5.2.2.4.5. PCIe0/PCIe1 PTM 5.2.2.4.6. PCIe0/PCIe1 LTR 5.2.2.4.7. PCIe0/PCIe1 MSI 5.2.2.4.8. PCIe0/PCIe1 MSI-X 5.2.2.4.9. PCIe0/PCIe1 PASID 5.2.2.4.10. PCIe0/PCIe1 DEV SER 5.2.2.4.11. PCIe0/PCIe1 PRS 5.2.2.4.12. PCIe0/PCIe1 Power Management 5.2.2.4.13. PCIe0/PCIe1 VSEC 5.2.2.4.14. PCIe0/PCIe1 ATS 5.2.2.4.15. PCIe0/PCIe1 TPH 5.2.2.4.16. PCIe0/PCIe1 ACS 5.2.2.4.17. PCIe0/PCIe1 Hot-Plug 5.2.2.4.18. PCIe0/PCIe1 VIRTIO
5.2.2.4.10. PCIe0/PCIe1 DEV SER x
5.2.2.4.10.1. Implementing Device Serial Number (DSN) with Runtime Update Support
5.2.2.4.18. PCIe0/PCIe1 VIRTIO x
5.2.2.4.18.1. PCIe0/PCIe1 PF<n> VIRTIO STRUCTURES
6. Interfaces and Signals x
6.1. Overview 6.2. Clocks and Resets 6.3. AXI4-Stream Interfaces 6.4. Configuration Intercept Interface 6.5. Configuration Extension Bus (CEB) Interface 6.6. Control Shadow Interface 6.7. Transmit Flow Control Credit Interface 6.8. Completion Timeout Interface 6.9. Control and Status Register Responder Interface 6.10. Function Level Reset Interface 6.11. TLP Bypass Error Reporting Interface 6.12. Error Interface 6.13. VF Error Flag Interface 6.14. VIRTIO PCI* Configuration Access Interface 6.15. Precision Time Measurement (PTM) Interface 6.16. Serial Data Signals 6.17. Miscellaneous Signals
6.2. Clocks and Resets x
6.2.1. Interface Clock Signals 6.2.2. Interface Reset Signals
6.3. AXI4-Stream Interfaces x
6.3.1. AXI4-Stream Receive (RX) Interface 6.3.2. AXI4-Stream Transmit (TX) Interface
6.4. Configuration Intercept Interface x
6.4.1. Configuration Intercept Request Interface 6.4.2. Configuration Intercept Response Interface
6.5. Configuration Extension Bus (CEB) Interface x
6.5.1. Configuration Extension Bus Request Interface 6.5.2. Configuration Extension Bus Response Interface
6.10. Function Level Reset Interface x
6.10.1. Function Level Reset Received Interface 6.10.2. Function Level Reset Completion Interface
6.14. VIRTIO PCI* Configuration Access Interface x
6.14.1. VIRTIO PCI Configuration Access Request Interface 6.14.2. VIRTIO PCI Configuration Access Completion Interface
7. Registers x
7.1. Register Address Map 7.2. PCI Express* Configuration Space 7.3. HIP Port and Status Registers 7.4. Soft Register Address Map 7.5. Indirect Register Access 7.6. Virtual Function (VF) PCI Express* Configuration Space 7.7. Altera-Defined VSEC Capability Register
7.2. PCI Express* Configuration Space x
7.2.1. PCI Express* Configuration Header Registers 7.2.2. PCI Express* Capability Structures 7.2.3. Physical Layer 16.0 GT/s Extended Capability Structures
7.3. HIP Port and Status Registers x
7.3.1. Root Port Interrupt Registers 7.3.2. PTM Registers
7.4. Soft Register Address Map x
7.4.1. Control Registers 7.4.2. Debug Registers 7.4.3. Performance Monitor Registers
7.6. Virtual Function (VF) PCI Express* Configuration Space x
7.6.1. VF PCI-Compatible Configuration Space Header Type0 7.6.2. VF PCI Express* Capability Structure 7.6.3. VF Message Signal Interrupt Extended (MSI-X) Capability Structure 7.6.4. VF Alternative Routing ID (ARI) Capability Structure 7.6.5. VF TLP Processing Hints (TPH) Capability Structure 7.6.6. VF Address Translation Services (ATS) Capability Structure 7.6.7. VF Access Control Services (ACS) Capability Structure
7.6.1. VF PCI-Compatible Configuration Space Header Type0 x
7.6.1.1. Vendor ID and Device ID Registers 7.6.1.2. Command Registers 7.6.1.3. Status Registers 7.6.1.4. Revision ID and Class Code Register 7.6.1.5. BIST, Header Type, Latency Timer, and Cache Line Size Registers 7.6.1.6. Subsystem Vendor ID and Subsystem ID Register 7.6.1.7. Capabilities Pointer
7.6.2. VF PCI Express* Capability Structure x
7.6.2.1. PCI Express* Capability List Register 7.6.2.2. PCI Express* Device Capabilities Register 7.6.2.3. PCI Express* Device Control and Status Register 7.6.2.4. Link Capabilities Register 7.6.2.5. Link Control and Status Register 7.6.2.6. PCI Express* Device Capabilities 2 Register 7.6.2.7. PCI Express* Device Control and Status 2 Register 7.6.2.8. Link Capabilities 2 Register 7.6.2.9. Link Control and Status 2 Register
7.6.3. VF Message Signal Interrupt Extended (MSI-X) Capability Structure x
7.6.3.1. MSI-X Control Register 7.6.3.2. MSI-X Table Offset Register 7.6.3.3. MSI-X Pending Bit Array Register
7.6.4. VF Alternative Routing ID (ARI) Capability Structure x
7.6.4.1. ARI Enhanced Capability Header Register 7.6.4.2. ARI Capability and Control Registers
7.6.5. VF TLP Processing Hints (TPH) Capability Structure x
7.6.5.1. TPH Requester Enhanced Capability Header 7.6.5.2. TPH Requester Capability Register 7.6.5.3. TPH Requester Control Register
7.6.6. VF Address Translation Services (ATS) Capability Structure x
7.6.6.1. ATS Enhanced Capability Header 7.6.6.2. ATS Capability Register and Control Register
7.6.7. VF Access Control Services (ACS) Capability Structure x
7.6.7.1. ACS Extended Capability Header 7.6.7.2. ACS Capability and Control Register 7.6.7.3. Egress Control Vector
A. Troubleshooting/Debugging x
A.1. Hardware A.2. Debug Toolkit
A.1. Hardware x
A.1.1. Debugging Link Training Issues A.1.2. Debugging Data Transfer and Performance Issues
A.1.1. Debugging Link Training Issues x
A.1.1.1. Generic Tools and Utilities A.1.1.2. Signal Tap Logic Analyzer
A.2. Debug Toolkit x
A.2.1. Overview A.2.2. Enabling the Agilex™ 5 Debug Toolkit A.2.3. Launching the Agilex™ 5 Debug Toolkit A.2.4. Using the Agilex™ 5 Debug Toolkit A.2.5. Using the Agilex™ 5 Link Inspector
A.2.4. Using the Agilex™ 5 Debug Toolkit x
A.2.4.1. Main View A.2.4.2. Toolkit Parameters A.2.4.3. Channel Parameters A.2.4.4. Eye Viewer
A.2.4.2. Toolkit Parameters x
A.2.4.2.1. Agilex™ 5 Information A.2.4.2.2. Event Counter A.2.4.2.3. P0 Configuration Space
A.2.4.3. Channel Parameters x
A.2.4.3.1. General PHY A.2.4.3.2. TX Path A.2.4.3.3. RX Path
B. PIPE Mode Simulation x
B.1. PIPE Mode Interfaces
C. Implementation of Address Translation Services (ATS) in Endpoint Mode x
C.1. Sending Translated/Untranslated Requests C.2. Sending a Page Request Message from the Endpoint (EP) to the Root Complex (RC) C.3. Invalidating Requests/Completions
1. Introduction
2. Features
3. Getting Started with GTS AXI Streaming IP
4. IP Architecture and Functional Description
5. IP Parameters
6. Interfaces and Signals
7. Registers
8. Document Revision History for the GTS AXI Streaming IP for PCI Express* User Guide: Agilex™ 5 and Agilex™ 3 FPGAs and SoCs
A. Troubleshooting/Debugging
B. PIPE Mode Simulation
C. Implementation of Address Translation Services (ATS) in Endpoint Mode

8. Document Revision History for the GTS AXI Streaming IP for PCI Express* User Guide: Agilex™ 5 and Agilex™ 3 FPGAs and SoCs

Document Version Quartus® Prime Version IP Version Changes
2025.08.04 25.1.1 9.0.0 Made the following changes:
  • Corrected Reference Clock bullets in the Supported Features topic.
  • Updated the Release information topic for the current release.
  • Added parameters, PCIe0 Standard next address pointer for PF and PCIe0 Standard next address pointer for VF, in the GTS AXI Streaming IP Parameters: Interfaces Port 0/Interfaces Port 1 Settings Tab table.
  • Added a note for the Enable SR-IOV support parameter in the GTS AXI Streaming IP Parameters: PCIe0/PCIe1 Device Tab table.
  • Removed note in the PCIe0/PCIe1 Link topic.
  • Removed the VF Table size parameter from the GTS AXI Streaming IP Parameters: PCIe* 0/ PCIe* 1 PF/VF MSI-X Tabs table.
  • Updated the descriptions of the Table offset and Pending bit array (PBA) offset parameters in the GTS AXI Streaming IP Parameters: PCIe* 0/ PCIe* 1 PF/VF MSI-X Tabs table.
  • Added parameter, Enable Device Serial Number Write Access, in the GTS AXI Streaming IP Parameters: PCIe0/PCIe1 DEV SER Tab table.
  • Added new topic, Implementing Device Serial Number (DSN) with Runtime Update Support in the PCIe0/PCIe1 DEV SER section.
  • Updated the figure and information about TLP credits in the Transmit Flow Control Credit Interface section.
  • Updated the p<n>_ss_app_st_flrrcvd

    _tdata[19:0] signal width and description in the Function Level Reset Received Interface table.

  • Updated the p<n>_ss_app_st_flrcmpl

    _tdata[19:0] signal width and description in the Function Level Reset Completion Interface table.

  • Added signal, p<0>_ss_app_st_flrcmpl_tready, signal in the Function Level Reset Completion Interface table.
  • Updated the Function Level Reset Completion Interface waveform figure in the Function Level Reset Completion Interface section.
  • Added the PIPE Mode Interfaces section in the PIPE Mode Simulation appendix chapter.
  • Updated the IP name instances from Intel FPGA IP to IP throughout the user guide.
2025.04.07 25.1 8.0.0 Made the following changes:
  • Updated the Introduction section with information about support for the Agilex™ 3 FPGAs.
  • Updated the Supported Features section with information about support for the Agilex™ 3 FPGAs.
  • Removed the IP Support Status section in the Features chapter.
  • Added new section Device Family Support in the Features chapter.
  • Updated the Release Information section for the 25.1 release.
  • Updated the Recommended FPGA Fabric Speed Grades section with information about support for the Agilex™ 3 FPGAs..
  • Updated the Resource Utilization section with resource usage for the Agilex™ 3 devices and split up the table for Agilex™ 5 E-Series and D-Series devices.
  • Updated the IP Core and Design Example Support Levels section with information about the Agilex™ 3 FPGAs.
  • Updated the IP Architecture and Functional Description section with information about the Agilex™ 3 FPGAs and added new figures for Agilex™ 3 and Agilex™ 5 D-Series FPGAs.
  • Updated the PCIe* Hard IP section with information about the Agilex™ 3 FPGAs and added new figures for Agilex™ 3 and Agilex™ 5 D-Series FPGAs.
  • Updated the Data and Header Packing Scheme section with information about the header endian format.
  • Added information in the Transaction Layer Packet (TLP) Bypass Mode section that the mode is only supported in Agilex™ 5 FPGAs.
  • Added new parameters PCIe* 0/1 AXI-ST Interface Latency and PCIe* 0/1 AXI-ST Sideband Header in the GTS AXI Streaming IP Parameters: AXI Interfaces 0/AXI Interface 1 Settings Tab table in the AXI Interfaces 0/AXI Interface 1 Settings section.
  • Updated the GTS AXI Streaming IP—Top-Level Signals figure in the Overview section.
  • Updated the timing diagrams in the Interface Reset Signals section.
  • Added note in Header Format topic in the AXI4-Stream Interfaces section.
  • Updated the AXI4-Stream Receive (RX) Interface section with information and timing diagrams about the sideband header mode.
  • Updated the AXI4-Stream Transmit (TX) Interface with information and timing diagrams about the sideband header mode.
  • Updated the eye viewer results figures in the Eye Viewer section.
  • Added the LTSSM Sequence Dump File Format for Production Device in the Using the Link Inspector section.
2025.01.24 24.3.1 7.0.0 Made the following changes:
  • Updated the Reference Clock section with information about the common and independent reference clock architecture.
  • Updated the Legacy Interrupt section with address information.
  • Updated the Message Signaled Interrupts (MSI) section with additional information about the pending bit and register.
  • Added new topics Endpoint D3 Entry and Endpoint L2 Exit in the Power Management section.
  • Updated the PCIe1 Hard IP Mode parameter values in the GTS AXI Streaming Parameters: System Settings Tab table in the System Settings section.
  • Added new topic PCIe0/PCIe1 Configuration, Debug and Extension Options in the PCIe0/PCIe1 Settings section.
  • Added new parameters L0s exit latency, L1 exit latency, and Active State Power Management (ASPM) Support in the GTS AXI Streaming Parameters: Power Management Tab table in the PCIe0/PCIe1 PCI Express / PCI Capabilities section.
  • Updated the Credit Limit Update on Transmit Flow Control Credit Interface figure in the Transmit Flow Control Credit Interface section.
  • Updated the MSI-X Capability Structure figure in the PCI Express Capability Structures section.
2024.11.04 24.3 6.0.0 Made the following changes:
  • Updated the Supported Features topic with new feature support.
  • Updated the Feature Support Status table with new feature support.
  • Updated the Agilex™ 5 Recommended FPGA Fabric Speed Grades for All AXI-Stream Width and Frequencies table with the recommended FPGA fabric speed grades.
  • Updated the Completion Buffer Size table in the TX Non-Posted Metering Requirement on Application section with Port 1 information for D-Series devices.
  • Updated the Credit Advertised by GTS AXI Streaming IP table in the TX Non-Posted Metering Requirement on Application section with x8 controller information.
  • Added new section Power Management in the IP Architecture and Functional Description chapter.
  • Added new section Config Retry Status Enable in the IP Architecture and Functional Description chapter.
  • Added new section Hot-Plug in the IP Architecture and Functional Description chapter.
  • Added new section Configuration Space Extension in the IP Architecture and Functional Description chapter.
  • Added new section Page Request Service (EP only) in the IP Architecture and Functional Description chapter.
  • Combined the E-Series and D-Series IP Parameters chapters.
  • Updated the IP Parameters chapter extensively with chapter reorganization and addition of new feature parameter tabs.
  • Updated the GTS AXI Streaming IP—Top-Level Signals figure in the Overview section.
  • Updated signal names in the Interface Clock Signals section.
  • Removed the i_gpio_perst0/1_n signals from the Interface Reset Signals section.
  • Added new section Configuration Extension Bus Interface in the Interfaces and Signals chapter.
  • Updated the Completion Timeout Interface section in the Interfaces and Signals chapter.
  • Corrected typographical error in the Function Level Reset Received Interface section in the Interfaces and Signals chapter.
  • Added new section Error Interface in the Interfaces and Signals chapter.
  • Added new section VIRTIO PCI Configuration Access Interface in the Interfaces and Signals chapter.
  • Updated the Control Register Address Map table in the Control Registers section with information about hot plug and power management control registers.
  • Added Appendix C. Implementation of Address Translation Services (ATS) in Endpoint Mode with information about the Address Translation Services.
2024.08.07 24.2 5.0.0 Made the following changes:
  • Updated the Feature Support Status table with information about PCIe* 4.0 x8, PCIe* 3.0 x8, lane reversal, FASTSIM, and PIPE mode support.
  • Updated the Resource Utilization for GTS AXI Streaming IP for Agilex™ 5 Devices table.
  • Updated the Agilex™ 5 Recommended FPGA Fabric Speed Grades for All AXI-Stream Width and Frequencies table with the recommended FPGA fabric speed grades.
  • Added note in Recommended FPGA Fabric Speed Grades about speed grades supported for PCIe* 4.0.
  • Updated the GTS AXI Streaming IP Support Matrix for Agilex™ 5 Device table with PCIe* 4.0 x8 and PCIe* 3.0 x8 support levels.
  • Added information about PCIe* 4.0 x8 and PCIe* 3.0 x8 support in several tables and figures.
  • Updated the IP Architecture and Functional Description section with information about Agilex™ 5 D-Series FPGA support for PCIe* x8 or x4 and reference clock requirements.
  • Added information about Agilex™ 5 D-Series FPGA support in several sections.
  • Updated the Connecting Clock and Reset Signals of GTS AXI Streaming IP figure with new signal and port names.
  • Updated the Clocking section with information about supported pld_clk frequencies for PCIe* Gen4 x8 and PCIe* 3.0 x8 support.
  • Updated the Resets section extensively and added a new table Pin Location Assignment for p0_pin_perst_n_i and p0_pin_perst_n_1_i Ports.
  • Updated the Resets section extensively and added a new table Pin Location Assignment for p0_pin_perst_n_i and p0_pin_perst_n_1_i Ports.
  • Updated the PCIe* Hard IP section with a new figure Agilex™ 5 PCIe* 4.0 x8 Hard IP Block Diagram for D-Series FPGAs and information about the Agilex™ 5 D-Series FPGAs.
  • Updated the timing diagram figures in the Interrupts section with corrected signal names.
  • Updated IP Parameters chapter name to IP Parameters for E-Series FPGA.
  • Updated the GTS AXI Streaming IP Parameters: PCIe* Interfaces 0 Settings Tab table with new Enable CVP (Intel VSEC) and Enable Configuration Intercept Interface Monitor parameters.
  • Updated the GTS AXI Streaming IP Parameters: PCIe* 0 Base Address Registers Tab table with BAR<n> size parameter value.
  • Updated the GTS AXI Streaming IP Parameters: PCIe* 0 PCI Express* / PCI Capabilities Tab0 table with PF<n> Enable MSI parameter value.
  • Added new chapter IP Parameters for D-Series FPGAs.
  • Updated all the sections in the Interfaces and Signals chapter and replaced p0 in the tables and figures with p<n> as support is added for two ports: port 0 and port 1.
  • Updated the Interface Clock Signals table with new clock signals and supported frequencies for x8 modes.
  • Updated the Interface Reset Signals table with new reset signals and descriptions.
  • Updated the reset sequence descriptions in the Interface Reset Signals section.
  • Updated the descriptions for p<n>_ss_app_vf_err_overflow and p<n>_ss_app_vfnonfatalmsg_ready signals in the VF Error Flag Interface table.
  • Updated the description for p<n>_ss_app_surprise_down_err signal in the Miscellaneous Signals table.
  • Removed the details of the registers from several sections in the Registers chapter and added link to the Excel-based register map.
  • Updated the Registers chapter with a new section Intel-Defined VSEC Capability Register.
  • Updated the Launching the Debug Toolkit section with new image for initialization.
  • Updated the Eye Viewer topic in Using the Agilex™ 5 Debug Toolkit with details about using the Eye Viewer tool.
  • Added Appendix B. PIPE Mode Simulation with information about PIPE mode simulation details.
2024.05.15 24.1 4.0.0 Corrected the recommended FPGA fabric speed grades for the PCIe* 3.0 x2 link configuration in Table: Agilex™ 5 Recommended FPGA Fabric Speed Grades for All AXI-Stream Width and Frequencies.
2024.05.10 24.1 4.0.0 Initial release.
Level Two Title