GTS Ethernet Intel® FPGA Hard IP User Guide: Agilex™ 3 FPGAs and SoCs

Download PDF
ID 848477
Date 4/07/2025
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents
Document Table of Contents x
1. Overview 2. Install and License the GTS Ethernet Intel® FPGA Hard IP 3. Configure and Generate Ethernet Hard IP variant 4. Integrate GTS Ethernet Intel® FPGA Hard IP into Your Application 5. Simulate and Compile (MAC+PCS) Design Example 6. Simulate and Compile (MII PCS Only/PCS66 OTN/PCS66 FlexE) Design Example 7. Simulate and Compile SyncE Design Example 8. Simulate and Compile PTP1588 Design Example 9. Troubleshoot and Diagnose Issues 10. Appendix A: Functional Description 11. Appendix B: Configuration Registers 12. Appendix C: Document Revision History for the GTS Ethernet Intel® FPGA Hard IP User Guide: Agilex 3 FPGAs and SoCs
1. Overview x
1.1. Release Information 1.2. High-Level Functional Overview 1.3. Acronyms 1.4. Agilex® 3 Ethernet Portfolio and Target Applications 1.5. Agilex® 3 Ethernet Hard IP Features 1.6. GTS Ethernet Intel® FPGA Hard IP Design Flow
1.5. Agilex® 3 Ethernet Hard IP Features x
1.5.1. Device Family Support 1.5.2. Device Speed Grade Support 1.5.3. Resource Utilization 1.5.4. Round-Trip Latency
3. Configure and Generate Ethernet Hard IP variant x
3.1. Create Quartus Project 3.2. Configure GTS Ethernet Hard IP 3.3. Generate HDL for Synthesis and Simulation 3.4. Generated File Structure 3.5. Generate GTS EHIP Design Example 3.6. Analog Parameter Options
3.5. Generate GTS EHIP Design Example x
3.5.1. Directory Structure
4. Integrate GTS Ethernet Intel® FPGA Hard IP into Your Application x
4.1. Implement Required Clocking 4.2. Implement Required Resets 4.3. Connect the Status Interface 4.4. Connect the MAC Avalon Streaming Client Interface 4.5. Connect the MII PCS Only Client Interface 4.6. Connect the PCS66 Client Interface – FlexE and OTN 4.7. Connect the Precision Time Protocol Interface 4.8. Connect the Ethernet Hard IP Reconfiguration Interface
4.1. Implement Required Clocking x
4.1.1. Implement MAC Synchronous Clock Connections 4.1.2. Implement Clock Connections to MAC Asynchronous Operation 4.1.3. Implement Clock Connections in Synchronous Ethernet Operation (Sync-E) 4.1.4. Implement Clock Connections in PTP-Based Design
4.2. Implement Required Resets x
4.2.1. Reset Sequence 4.2.2. Connect the GTS Reset Sequencer Intel® FPGA IP
4.2.2. Connect the GTS Reset Sequencer Intel® FPGA IP x
4.2.2.1. Requirements and Considerations for GTS Reset Sequencer Intel® FPGA IP
4.3. Connect the Status Interface x
4.3.1. Use i_stats_snapshot to Read Stats Counters
4.4. Connect the MAC Avalon Streaming Client Interface x
4.4.1. Connect the TX MAC Avalon Streaming Client Interface 4.4.2. Connect the RX MAC Avalon Streaming Client Interface 4.4.3. Connect the MAC Flow Control Interface
4.4.1. Connect the TX MAC Avalon Streaming Client Interface x
4.4.1.1. Drive the Ethernet Packet to the TX MAC Avalon Streaming Client Interface with Disabled Preamble Passthrough 4.4.1.2. Drive the Ethernet Packet on the TX MAC Avalon Streaming Client Interface with Enabled Preamble Passthrough 4.4.1.3. Use i_tx_skip_crc to Control Source Address, PAD, and CRC Insertion 4.4.1.4. Assert the i_tx_error to Invalidate a Packet
4.4.2. Connect the RX MAC Avalon Streaming Client Interface x
4.4.2.1. Receive Ethernet Frame on the RX MAC Avalon Streaming Client Interface with Preamble Passthrough Disabled 4.4.2.2. Receive Ethernet Frame with Preamble Passthrough Enabled 4.4.2.3. Receive Ethernet Frame with Remove CRC bytes Disabled 4.4.2.4. Monitor Status and Errors on the RX MAC Avalon Streaming Client Interface
4.4.3. Connect the MAC Flow Control Interface x
4.4.3.1. Connect the TX MAC Flow Control Interface 4.4.3.2. Connect the RX MAC Flow Control Interface
4.5. Connect the MII PCS Only Client Interface x
4.5.1. Connect the MII PCS Mode TX Interface 4.5.2. Connect the MII PCS Mode RX Interface
4.6. Connect the PCS66 Client Interface – FlexE and OTN x
4.6.1. Connect the FlexE and OTN Mode TX Interface 4.6.2. Connect the FlexE and OTN Mode RX Interface
4.7. Connect the Precision Time Protocol Interface x
4.7.1. Connect the Time-of-Day Interface 4.7.2. Connect the TX Two-Step Timestamp Interface 4.7.3. Connect the TX One-Step Timestamp Interface 4.7.4. Connect the RX Timestamp Interface 4.7.5. Connect the PTP Status Interface
4.7.3. Connect the TX One-Step Timestamp Interface x
4.7.3.1. PTP Field Offset for 1-Step Operation
5. Simulate and Compile (MAC+PCS) Design Example x
5.1. Design Example Features 5.2. Design Example Components 5.3. Simulate the Design Example 5.4. Compile the Design Example
5.3. Simulate the Design Example x
5.3.1. Simulation Testbench Flow 5.3.2. Verify the Simulation Results
6. Simulate and Compile (MII PCS Only/PCS66 OTN/PCS66 FlexE) Design Example x
6.1. Design Example Features 6.2. Design Example Components 6.3. Simulate the Design Example 6.4. Compile the Design Example
6.3. Simulate the Design Example x
6.3.1. Simulation Testbench Flow 6.3.2. Simulators Output
7. Simulate and Compile SyncE Design Example x
7.1. Design Example Features 7.2. Design Example Components 7.3. Simulate the Design Example 7.4. Compile the Design Example
7.3. Simulate the Design Example x
7.3.1. Simulation Testbench Flow 10GE Ethernet with SyncE 7.3.2. Simulator Output
8. Simulate and Compile PTP1588 Design Example x
8.1. Design Example Features 8.2. Design Example Components 8.3. Simulate the Design Example 8.4. Compile the Design Example
8.3. Simulate the Design Example x
8.3.1. Simulation Testbench Flow 8.3.2. Simulator Output
9. Troubleshoot and Diagnose Issues x
9.1. Enable Diagnostic Lookback Modes 9.2. Troubleshoot the Reset Sequence
9.1. Enable Diagnostic Lookback Modes x
9.1.1. Internal Serial Loopback 9.1.2. Enable MAC Loopback 9.1.3. Enable PCS Loopback 9.1.4. Enable External Loopback 9.1.5. Packet Client Loopback
9.2. Troubleshoot the Reset Sequence x
9.2.1. Debug the Power Up Reset Sequence 9.2.2. Debug the TX Reset Entry Sequence 9.2.3. Debug the TX Reset Exit Sequence 9.2.4. Debug the RX Reset Entry Sequence 9.2.5. Debug the RX Reset Exit Sequence 9.2.6. Debug the Auto Recovery Reset Sequence
10. Appendix A: Functional Description x
10.1. Datapath Description 10.2. GTS Ethernet Intel® FPGA Hard IP MAC 10.3. PCS, OTN, and FlexE Modes 10.4. Precision Time Protocol Interface
10.2. GTS Ethernet Intel® FPGA Hard IP MAC x
10.2.1. MAC TX Datapath 10.2.2. MAC RX Datapath 10.2.3. Congestion and Flow Control Using PAUSE or Priority Flow Control (PFC) 10.2.4. Link Fault Signaling 10.2.5. Order of Ethernet Transmission:
10.2.1. MAC TX Datapath x
10.2.1.1. Insert TX Preamble, Start, and SFD 10.2.1.2. Insert Source Address 10.2.1.3. Process Length/Type Field 10.2.1.4. Pad the Client Frame 10.2.1.5. Insert Frame Check Sequence (CRC-32) 10.2.1.6. Generate and Insert Inter-Packet Gap
10.2.2. MAC RX Datapath x
10.2.2.1. Process RX Preamble 10.2.2.2. Check RX Strict SFD 10.2.2.3. Check RX FCS 10.2.2.4. Handle RX Malformed Packet 10.2.2.5. Remove PAD Bytes and FCS Bytes from RX Frames 10.2.2.6. RX Undersized Frames, Oversized Frames, and Frames with Length Errors 10.2.2.7. Inter-Packet Gap
10.2.3. Congestion and Flow Control Using PAUSE or Priority Flow Control (PFC) x
10.2.3.1. Conditions Triggering XOFF Frame Transmission 10.2.3.2. Conditions Triggering XON Frame Transmission 10.2.3.3. Pause Control and Generation Interface 10.2.3.4. Pause Control Frame Filtering
10.3. PCS, OTN, and FlexE Modes x
10.3.1. PCS Mode 10.3.2. OTN Mode 10.3.3. FlexE Mode
10.4. Precision Time Protocol Interface x
10.4.1. Features 10.4.2. PTP User Flow 10.4.3. Make PTP UI Adjustments 10.4.4. Reference Time Interval
10.4.2. PTP User Flow x
10.4.2.1. PTP TX User Flow 10.4.2.2. PTP RX User Flow
10.4.3. Make PTP UI Adjustments x
10.4.3.1. Adjust TX UI 10.4.3.2. Adjust RX UI
11. Appendix B: Configuration Registers x
11.1. Ethernet Avalon® Memory-Mapped Interface Address Space 11.2. Packet Client Registers
1. Overview
2. Install and License the GTS Ethernet Intel® FPGA Hard IP
3. Configure and Generate Ethernet Hard IP variant
4. Integrate GTS Ethernet Intel® FPGA Hard IP into Your Application
5. Simulate and Compile (MAC+PCS) Design Example
6. Simulate and Compile (MII PCS Only/PCS66 OTN/PCS66 FlexE) Design Example
7. Simulate and Compile SyncE Design Example
8. Simulate and Compile PTP1588 Design Example
9. Troubleshoot and Diagnose Issues
10. Appendix A: Functional Description
11. Appendix B: Configuration Registers
12. Appendix C: Document Revision History for the GTS Ethernet Intel® FPGA Hard IP User Guide: Agilex 3 FPGAs and SoCs

8.3.2. Simulator Output

The following sample output illustrates a successful simulation test run for 10GE MAC with PTP VCS* MX simulator. The script output is similar for other supported simulators. 

TX PTP Command #6
# Egress Timestamp Request        : 0
# Insert Timestamp                : 1
# Update CorrectionField          : 0
# Clear UDP/IPv4 Checksum         : 0
# Update UDP/IPv6 Extended Bytes      : 0
# Add Peer-to-Peer (P2P) MinPathDelay : 0
# Add Asymmetry Delay             : 0
# Asymmetry Delay Sign            : 0
# Asymmetry & P2P MinPathDelay Select : 0
# Timestamp Field Offset          : 0x0014
# Correction Field Offset         : 0x001e
# TX Fingerprint Data             : 0x00000006
# TX Ingress Timestamp            : 0x000000000000000000000000
---------------------------------------------------------------
# Timestamps #6
----------------------------------------------------------------
# TX Egress Timestamp             : 0x0000000000000002cb00cd80
# RX Ingress Timestamp            : 0x0000000000000002cb00c580
# TX User Fingerprint             : 0x00000006
# TX Returned Fingerprint         : 0x00000006
-----------------------------------------------------------------
# Comparison #6
-----------------------------------------------------------------
# RX_ITS - TX_ETS         : 0x1ffffffffffffffffffffc800/-0.2188 ns
# TX Timestamp Fields     : 0xaa1516aa18191a1b1c1d
# RX Timestamp Fields     : 0x000000000000000266e5
# TX Compensation Fields  : 0x1e1f20212223bbcc
# RX Compensation Fields  : 0x1e1f20212224734d
-----------------------------------------------------------------
 # Begin PTP AVMM Test
 # The time now is 250000000000 
***************************************************************************************************

====>MATCH!  Read addr = 00040224, ReaddataValid = 1 Readdata = 00000010 Expected_Readdata = 00000010 

====>MATCH!  Read addr = 00040228, ReaddataValid = 1 Readdata = 00000011 Expected_Readdata = 00000011 

====>MATCH!  Read addr = 000402ec, ReaddataValid = 1 Readdata = 00000012 Expected_Readdata = 00000012 

====>MATCH!  Read addr = 00040320, ReaddataValid = 1 Readdata = 00000013 Expected_Readdata = 00000013 

====>MATCH!  Read addr = 00040324, ReaddataValid = 1 Readdata = 00000014 Expected_Readdata = 00000014 

====>MATCH!  Read addr = 00040328, ReaddataValid = 1 Readdata = 00000015 Expected_Readdata = 00000015 

====>MATCH!  Read addr = 0004033c, ReaddataValid = 1 Readdata = 00000016 Expected_Readdata = 00000016 

====>MATCH!  Read addr = 000403b4, ReaddataValid = 1 Readdata = 00000017 Expected_Readdata = 00000017 

====>MATCH!  Read addr = 0004041c, ReaddataValid = 1 Readdata = 00000018 Expected_Readdata = 00000018 

====>MATCH!  Read addr = 00040420, ReaddataValid = 1 Readdata = 00000019 Expected_Readdata = 00000019 

====>MATCH!  Read addr = 00040024, ReaddataValid = 1 Readdata = 00000010 Expected_Readdata = 00000010 

====>MATCH!  Read addr = 00040028, ReaddataValid = 1 Readdata = 00000011 Expected_Readdata = 00000011 

====>MATCH!  Read addr = 000400ec, ReaddataValid = 1 Readdata = 00000012 Expected_Readdata = 00000012 

====>MATCH!  Read addr = 00040120, ReaddataValid = 1 Readdata = 00000013 Expected_Readdata = 00000013 

====>MATCH!  Read addr = 00040124, ReaddataValid = 1 Readdata = 00000014 Expected_Readdata = 00000014 

====>MATCH!  Read addr = 00040128, ReaddataValid = 1 Readdata = 00000015 Expected_Readdata = 00000015 

====>MATCH!  Read addr = 0004013c, ReaddataValid = 1 Readdata = 00000016 Expected_Readdata = 00000016 

====>MATCH!  Read addr = 000401b4, ReaddataValid = 1 Readdata = 00000017 Expected_Readdata = 00000017 

====>MATCH!  Read addr = 0004021c, ReaddataValid = 1 Readdata = 00000018 Expected_Readdata = 00000018 

====>MATCH!  Read addr = 00040220, ReaddataValid = 1 Readdata = 00000019 Expected_Readdata = 00000019 

====>MATCH!  Read addr = 10000010, ReaddataValid = 1 Readdata = 00cae0d4 Expected_Readdata = 00cae0d4 

====>MATCH!  Read addr = 10000020, ReaddataValid = 1 Readdata = 0000e0d8 Expected_Readdata = 0000e0d8 

PTP AVMM Test Completed
****Starting AVMM Read/Write****
====>MATCH!  Read addr = 00000104, ReaddataValid = 1 Readdata = abcdef01 Expected_Readdata = abcdef01 

====>MATCH!  Read addr = 00000108, ReaddataValid = 1 Readdata = 00000007 Expected_Readdata = 00000007 

====>MATCH!  Read addr = 00100004, ReaddataValid = 1 Readdata = 12153524 Expected_Readdata = 12153524 

====>MATCH!  Read addr = 00100008, ReaddataValid = 1 Readdata = c0895e81 Expected_Readdata = c0895e81 

====>MATCH!  Read addr = 00100080, ReaddataValid = 1 Readdata = deadc0de Expected_Readdata = deadc0de 

The time now is 260000000000 

====>MATCH!  Read addr = 00300080, ReaddataValid = 1 Readdata = deadc0de Expected_Readdata = deadc0de 

====>MATCH!  Read addr = 00000af0, ReaddataValid = 1 Readdata = 00000000 Expected_Readdata = 00000000 

====>MATCH!  Read addr = 00050014, ReaddataValid = 1 Readdata = 22334455 Expected_Readdata = 22334455 

====>MATCH!  Read addr = 0005001c, ReaddataValid = 1 Readdata = 000005ee Expected_Readdata = 000005ee 

====>MATCH!  Read addr = 00050014, ReaddataValid = 1 Readdata = 01234567 Expected_Readdata = 01234567 

====>MATCH!  Read addr = 00050018, ReaddataValid = 1 Readdata = 000089ab Expected_Readdata = 000089ab 

====>MATCH!  Read addr = 000a5000, ReaddataValid = 1 Readdata = 00000000 Expected_Readdata = 00000000 

**** AVMM Read/Write Operation Completed for IP_INST[  0]****
**** AVMM Read/Write 50030 ****  0
====>MATCH!  Read addr = 00050030, ReaddataValid = 1 Readdata = 00000000 Expected_Readdata = 00000000 

====>MATCH!  Read addr = 00050030, ReaddataValid = 1 Readdata = 000001f5 Expected_Readdata = 000001f5 

====>MATCH!  Read addr = 00050030, ReaddataValid = 1 Readdata = 00000000 Expected_Readdata = 00000000 

**** AVMM Read/Write 50030 DONE ****  0
**** AVMM Read/Write 50000[3] ****  0
====>MATCH!  Read addr = 00050000, ReaddataValid = 1 Readdata = 00000000 Expected_Readdata = 00000000 

====>MATCH!  Read addr = 00050000, ReaddataValid = 1 Readdata = 00000008 Expected_Readdata = 00000008 

====>MATCH!  Read addr = 00050000, ReaddataValid = 1 Readdata = 00000000 Expected_Readdata = 00000000 

**** AVMM Read/Write 50000[3] DONE ****  0
** Testbench complete
The following sample waveforms illustrates a simulation test run for 10GE MAC with PTP VCS* MX simulator.
Level Two Title