25G Ethernet Intel Stratix 10 FPGA IP Design Example User Guide

RSS

UG-20110 | 2019.05.10

25G Ethernet Intel FPGA IP Quick Start Guide

The 25G Ethernet (25GbE) Intel^® FPGA IP core for Intel^® Stratix^® 10 devices provides the capability of generating design examples for selected configurations.

Figure 1. Development Stages for the Design Example

Directory Structure

Figure 2. Directory Structure for the 25G and 10G/25G Ethernet Design Examples

The simulation files (testbench for simulation only) are located in <design_example_dir>/example_testbench.
The compilation-only design example is located in <design_example_dir>/compilation_test_design.
The hardware configuration and test files (the design example in hardware) are located in <design_example_dir>/hardware_test_design.

Table 1. Directory and File Descriptions
File Names	Description
eth_ex_25g.qpf	Intel^® Quartus^® Prime project file.
eth_ex_25g.qsf	Intel^® Quartus^® Prime project settings file.
eth_ex_25g.sdc	Synopsys Design Constraints file. You can copy and modify this file for your own 25GbE Intel^® FPGA IP core design.
eth_ex_25g.v	Top-level Verilog HDL design example file. Single-channel design uses Verilog file.
common/	Hardware design example support files.
hwtest/main.tcl	Main file for accessing System Console.

Generating the Design Example

Figure 3. Procedure

Figure 4. Example Design Tab in the 25G Ethernet Intel^® FPGA IP Parameter Editor

Follow these steps to generate the hardware design example and testbench:

In the Intel^® Quartus^® Prime Pro Edition software, click File > New Project Wizard to create a new Quartus Prime project, or File > Open Project to open an existing Quartus Prime project. The wizard prompts you to specify a device.
In the IP Catalog, locate and select 25G Ethernet Intel^® FPGA IP . The New IP Variation window appears.
Specify a top-level name for your IP variation and click OK. The parameter editor adds the top-level .ip file to the current project automatically. If you are prompted to manually add the .ip file to the project, click Project > Add/Remove Files in Project to add the file.
In the Intel^® Quartus^® Prime Pro Edition software, you must select a specific Intel^® Stratix^® 10 device in the Device field, or keep the default device that the Intel^® Quartus^® Prime software proposes.
Note: The hardware design example overwrites the selection with the device on the target board. You specify the target board from the menu of design example options in the Example Design tab (Step 8).
Click OK. The parameter editor appears.
On the IP tab, specify the parameters for your IP core variation.
On the Example Design tab, for Example Design Files, select the Simulation option to generate the testbench, and select the Synthesis option to generate the hardware design example. Only Verilog HDL files are generated.
Note: A functional VHDL IP core is not available. Specify Verilog HDL only, for your IP core design example.
For Target Development Kit, select the Intel Stratix 10 L-Tile GX Transceiver Signal Integrity Development Kit.
Click Generate Example Design. The Select Example Design Directory window appears.
If you want to modify the design example directory path or name from the defaults displayed (alt_e25s10_0_example_design), browse to the new path and type the new design example directory name (<design_example_dir>).
Click OK.

Design Example Parameters

Table 2. Parameters in the Example Design Tab
Parameter	Description
Example Design	Available example designs for the IP parameter settings.
Example Design Files	The files to generate for the different development phase. Simulation—generates the necessary files for simulating the example design. Synthesis—generates the synthesis files. Use these files to compile the design in the Intel^® Quartus^® Prime Pro Edition software for hardware testing and perform static timing analysis.
Generate File Format	The format of the RTL files for simulation—Verilog.
Select Board	Supported hardware for design implementation. When you select an Intel FPGA development board, the `Target Device` is the one that matches the device on the Development Kit. If this menu is not available, there is no supported board for the options that you select. Intel^® Stratix^® 10 L-Tile GX Transceiver Signal Integrity Development Kit: This option allows you to test the design example on the selected Intel FPGA IP development kit. This option automatically selects the `Target Device` to match the device on the Intel FPGA IP development kit. If your board revision has a different device grade, you can change the target device. None: This option excludes the hardware aspects for the design example.

Simulating the 25G Ethernet Intel FPGA IP Design Example Testbench

Procedure

You can compile and simulate the design by running a simulation script from the command prompt.

At the command prompt, change the working directory to <design_example_dir>/example_testbench.

Run the simulation script for the supported simulator of your choice. The script compiles and runs the testbench in the simulator.

Table 3. Steps to Simulate the Testbench
Simulator	Instructions
ModelSim*	In the command line, type vsim do run_vsim.do Note: The ModelSim* -AE and ModelSim* -ASE simulatorscannot simulate this IP core. You must use another supported ModelSim* simulator such as ModelSim* SE.
VCS*	In the command line, type sh run_vcs.sh
NCSim	In the command line, type sh run_ncsim.sh
Xcelium*	In the command line, type sh run_xcelium.sh

A successful simulation ends with the following message:

Simulation Passed.

Testbench complete.

After successful completion, you can analyze the results.

Compiling and Configuring the Design Example in Hardware

The 25G Ethernet Intel^® FPGA IP core parameter editor allows you to compile and configure the design example on a target development kit.

Procedure

To compile and configure a design example on hardware, follow these steps:

Launch the Intel^® Quartus^® Prime Pro Edition software and select Processing > Start Compilation to compile the design.
After you generate an SRAM object file .sof, follow these steps to program the hardware design example on the Intel^® Stratix^® 10 device:
1. On the Tools menu, click Programmer.
2. In the Programmer, click Hardware Setup.
3. Select a programming device.
4. Select and add the Intel^® Stratix^® 10 GX board to your Intel^® Quartus^® Prime Pro Edition session.
5. Ensure that Mode is set to JTAG.
6. Select the Intel^® Stratix^® 10 device and click Add Device. The Programmer displays a block diagram of the connections between the devices on your board.
7. In the row with your .sof, check the box for the .sof.
8. Check the box in the Program/Configure column.
9. Click Start.
Note: This design targets the Intel^® Stratix^® 10 device. Please contact your Intel^® FPGA representative to inquire about a platform suitable to run this hardware example.

Testing the 25G Ethernet Intel FPGA IP Design in Hardware

Procedure

After you compile the 25G Ethernet Intel^® FPGA IP core design example and configure it on your Intel^® Stratix^® 10 device, you can use the System Console to program the IP core and its embedded Native PHY IP core registers.

To turn on the System Console and test the hardware design example, follow these steps:

In the Intel^® Quartus^® Prime Pro Edition software, select Tools > System Debugging Tools > System Console to launch the system console.
In the Tcl Console pane, type cd hwtest to change directory to /hardware_test_design/hwtest.
Type source main.tcl to open a connection to the JTAG master.

Follow the test procedure in the Hardware Testing section of the design example and observe the test results in the System Console.

10G/25G Ethernet Single-Channel Design Example for Intel Stratix 10 Devices

The 10G/25G Ethernet single-channel design example demonstrates an Ethernet solution for Intel^® Stratix^® 10 devices using the 25G Ethernet Intel^® FPGA IP core.

Generate the design example from the Example Design tab of the 25G Ethernet Intel^® FPGA IP parameter editor. You can choose to generate the design with or without the IEEE 1588v2 feature. You can also choose to generate the design with or without the Reed-Solomon Forward Error Correction (RS-FEC) feature.

Features

Supports single Ethernet channel operating at either 10G or 25G.
Generate design example with IEEE 1588v2 feature.
Generate design example with RS-FEC feature.
Generates design example separately from Intel^® Stratix^® 10 Transceiver Native PHY.
Provides testbench and simulation script.

Functional Description

The 10G/25G Ethernet single-channel design example consists of two core variants—MAC+PCS+PMA and MAC+PCS. The following block diagrams show the design components and the top-level signals of the two core variants in the 10G/25G Ethernet single-channel design example.

Figure 5. Block Diagram—10G/25G Ethernet Single-Channel Design Example (MAC+PCS+PMA Core Variant) Without the IEEE 1588v2 Feature

Figure 6. Block Diagram—10G/25G Ethernet Single-Channel Design Example (MAC+PCS+PMA Core Variant) with the IEEE 1588v2 Feature

Figure 7. Block Diagram—10G/25G Ethernet Single-Channel Design Example (MAC+PCS Core Variant) Without the IEEE 1588v2 Feature

Figure 8. Block Diagram—10G/25G Ethernet Single-Channel Design Example (MAC+PCS Core Variant) with the IEEE 1588v2 Feature

Design Components

Table 4. Design Components
Component	Description
25G Ethernet Intel^® FPGA IP	Consists of MAC, PCS, and Transceiver PHY, with the following configuration: Core Variant: MAC+PCS+PMA, MAC+PCS Enable flow control: Optional Enable link fault generation: Optional Enable preamble passthrough: Optional Enable statistics collection: Optional Enable MAC statistics counters: Optional Enable 10G/25G dynamic rate switching: Selected Enable Native PHY Debug Master Endpoint (NPDME): Optional Reference clock frequency: 644.531250/322.265625 For the design example with the IEEE 1588 feature, the following additional parameters are configured: Enable IEEE 1588: Selected Time of day format: Enable 96-bit timestamp format ¹ For the design example with the RS-FEC feature, the following additional parameter is configured: Enable RS-FEC: Selected
Reconfiguration Sequencer	Reconfigures the transceiver channel speed from 10 Gbps to 25 Gbps, and vice versa.
ATX PLL	Generates TX serial clocks for the 10G and 25G transceivers.
Client logic	Consists of: Traffic generator, which generates burst packets to the 25G Ethernet Intel^® FPGA IP core for transmission. Traffic monitor, which receives burst packets from the 25G Ethernet Intel^® FPGA IP core.
Source and Probe	Source and probe signals, including system reset input signal, which you can use for debugging.
Design Components for the IEEE 1588v2 Feature
Sampling PLL	Generates the clocks for the IEEE 1588v2 design components. `latency_sclk`: 156.25 MHz for latency measurement. `sampling_clk`: 250 MHz for ToD synchronization
Time-of-day (ToD) Sync	Synchronizes the 10G and 25G ToDs.
ToD Tx	ToD for transmit paths for the 10G and 25G transceivers.
ToD Rx	ToD for receive paths for the 10G and 25G transceivers.
Master Precision Time Protocol (PTP)	Master PTP consists of a packet generator and a packet receiver. Packet generator: Obtains timestamp information from the 25G Ethernet Intel^® FPGA IP core and generates Avalon^® -ST packets such as Sync packet and Delay Response packet. Packet receiver: Obtains the delay request packet information from the 25G Ethernet Intel^® FPGA IP core and produces timestamp values.
Slave PTP	Slave PTP consists of a packet generator, a packet receiver, and packet compute. Packet generator: Obtains timestamp information from the 25G Ethernet Intel^® FPGA IP core and generates Avalon^® -ST packets such as Delay Request packet. Packet receiver: Obtains the Sync and Delay Response packets information from the 25G Ethernet Intel^® FPGA IP core and produces timestamp values. Packet compute: Calculates and produces the delay and offsets value based on the timestamp values.

¹ The 10G/25G Ethernet single-channel design example with IEEE 1588v2 feature only supports 96-bit timestamp format.

Simulation

The testbench sends traffic through the IP core, exercising the transmit side and receive side of the IP core.

Testbench

Figure 9. Block Diagram of the 10G/25G Ethernet Single-Channel Design Example Simulation Testbench

Table 5. Testbench Components
Component	Description
Device under test (DUT)	The 25G Ethernet Intel^® FPGA IP core.
Reconfiguration Sequencer	Reconfigures the transceiver channel speed from 10 Gbps to 25 Gbps, and vice versa.
Ethernet Packet Generator and Packet Monitor	Packet generator generates frames and transmit to the DUT. Packet Monitor monitors TX and RX datapaths and displays the frames in the simulator console.
ATX PLL	Generates a TX serial clock for the Intel^® Stratix^® 10 10G/25G transceiver which is wrapped in the 25G Ethernet Intel^® FPGA IP core.

Note: For the 10G/25G Ethernet single-channel design example with IEEE 1588v2 feature simulation testbench, refer to Figure 6.

Simulation Design Example Components

Table 6. 10G/25G Ethernet Single-Channel Design Example Testbench File Descriptions
File Name	Description
Testbench and Simulation Files
basic_avl_tb_top..sv	Top-level testbench file. The testbench instantiates the DUT, performs Avalon^® -MM configuration on design components and client logic, and sends and receives packet to or from .
Testbench Scripts
run_vsim.do	The ModelSim script to run the testbench.
run_vcs.sh	The Synopsys VCS* script to run the testbench.
run_ncsim.sh	The Cadence NCSim script to run the testbench.
run_xcelium.sh	The Xcelium* script to run the testbench.

Test Case—Design Example Without the IEEE 1588v2 Feature

The simulation test case performs the following actions:

Instantiates 25G Ethernet Intel^® FPGA IP and ATX PLL.
Starts up the design example with an operating speed of 25G.
Waits for RX clock and PHY status signal to settle.
Prints PHY status.
Sends and receives 10 valid data on 25G speed.
Performs channel reset and switches to 10G speed.
Waits for RX clock and PHY status signal to settle.
Prints PHY status.
Sends and receives another 10 valid data on 10G speed.
Performs channel reset and switches to 25G speed.
Waits for RX clock and PHY status signal to settle.
Prints PHY status.
Sends and receives another 10 valid data on 25G speed.
Analyzes the results. The successful testbench displays "Simulation PASSED.".

The following sample output illustrates a successful simulation test run:

Waiting for RX alignment
RX deskew locked
RX lane alignmnet locked
TX enabled
** Sending Packet            1...
** Sending Packet            2...
** Sending Packet            3...
** Sending Packet            4...
** Sending Packet            5...
** Sending Packet            6...
** Sending Packet            7...
** Sending Packet            8...
** Received Packet           1...
** Received Packet           2...
** Sending Packet            9...
** Sending Packet           10...
** Received Packet           3...
** Received Packet           4...
** Received Packet           5...
** Received Packet           7...
** Received Packet           8...
** Received Packet           9...
** Received Packet          10...
Switching to 10G mode: 10G Reconfig start
Switching to 10G mode: 10G Reconfig End
Waiting for RX alignment
RX deskew locked
RX lane alignment locked
TX enabled
** Sending Packet            1...
** Sending Packet            2...
** Sending Packet            3...
** Sending Packet            4...
** Sending Packet            5...
** Sending Packet            6...
** Sending Packet            7...
** Sending Packet            8...
** Received Packet           1...
** Received Packet           2...
** Sending Packet            9...
** Sending Packet           10...
** Received Packet           3...
** Received Packet           4...
** Received Packet           5...
** Received Packet           7...
** Received Packet           8...
** Received Packet           9...
** Received Packet          10...
Switching to 25G mode: 25G Reconfig start
Switching to 25G mode: 25G Reconfig End
Waiting for RX alignment
RX deskew locked
RX lane alignment locked
TX enabled
** Sending Packet            1...
** Sending Packet            2...
** Sending Packet            3...
** Sending Packet            4...
** Sending Packet            5...
** Sending Packet            6...
** Sending Packet            7...
** Sending Packet            8...
** Received Packet           1...
** Received Packet           2...
** Sending Packet            9...
** Sending Packet           10...
** Received Packet           3...
** Received Packet           4...
** Received Packet           5...
** Received Packet           7...
** Received Packet           8...
** Received Packet           9...
** Received Packet          10...
**
** Testbench complete.
**

Test Case—Design Example with the IEEE 1588v2 Feature

Note: For 10G/25G Ethernet single-channel design example with IEEE 1588v2 feature simulation testbench, refer to Figure 6.

The simulation test case performs the following actions:

Instantiates 25G Ethernet Intel^® FPGA IP, ATX PLL, and IO PLL (sampling PLL).
Starts up the design example with an operating speed of 25G.
Waits for RX clock and PHY status signal to settle.
Prints PHY status.
Checks for 10 valid data on 25G speed.
Switches to 10G speed.
Waits for RX clock and PHY status signal to settle.
Prints PHY status.
Checks for another 10 valid data on 10G speed.
Switches to 25G speed once all 10 valid data passes.
Waits for RX clock and PHY status signal to settle.
Prints PHY status.
Checks for another 10 valid data on 25G speed.
Analyzes the results. The successful testbench displays "Simulation PASSED." when the PTP delay and offset data is within the threshold value.

The following sample output illustrates a successful simulation test run:

# Running at 25G mode...
# 
# 
# Waiting for RX alignment...
# iatpg_pipeline_global_en is set
# iatpg_pipeline_global_en is set
# RX deskew locked.
# RX lane aligmnent locked.
# 
# Sending packets...
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000064457
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000064bb4
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000fffffffff8a2
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000643b5
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000520
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000634fb
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000063f3b
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000063a1a
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x00000000000000000006445a
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000063e95
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000648d5
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000643b5
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000520
# Offset within tolerence range.
# 
# 
# 
# Finished sending packets.
# 
# 
# 
# Switching to 10G mode: 10G Reconfig starts...
# Switching to 10G mode: 10G Reconfig End.
# 
# Waiting for RX alignment...
# RX deskew locked.
# RX lane aligmnent locked.
# 
# Configuring 1588 period...
# Configuring 1588 period done.
# 
# Sending packets...
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000e5a7d
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000002013
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000e0764
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000ffffffff99a0
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000e0764
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000ffffffffa66d
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000dfa97
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000006660
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000e1431
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000005993
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000e2db7
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000ffffffffccc0
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000e1431
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000ffffffff8006
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000e60e4
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000fffffffff320
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000dfa97
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000005993
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000e874b
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000ce0
# Offset within tolerence range.
# 
# 
# 
# Finished sending packets.
# 
# 
# 
# Switching to 25G mode: 25G Reconfig start...
# Switching to 25G mode: 25G Reconfig end.
# 
# Waiting for RX alignment...
# RX deskew locked.
# RX lane aligmnent locked.
# 
# Configuring 1588 period...
# Configuring 1588 period done.
# 
# Sending packets...
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000063c58
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000063c58
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x00000000000000000006502f
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x00000000000000000006502f
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x00000000000000000006554d
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000064b10
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000064b10
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000064bb4
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000064bb4
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000065a6c
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# 
# Finished sending packets.
# 
# **
# ** Testbench complete.
# **

25G Ethernet Single-Channel Design Example for Intel Stratix 10 Devices

The 25G Ethernet single-channel design example demonstrates an Ethernet solution for Intel^® Stratix^® 10 devices using the 25G Ethernet Intel^® FPGA IP core.

Features

Supports single Ethernet channel operating at 25G.
Generates design example with IEEE 1588v2 feature.
Generates design example with RS-FEC feature.
Generates design example separately from Intel^® Stratix^® 10 Transceiver Native PHY.
Provides testbench and simulation script.

Hardware and Software Requirements

Intel^® uses the following hardware and software to test the design example in a Linux system:

Intel^® Quartus^® Prime Pro Edition software.
ModelSim* -SE, NCSim (Verilog only), VCS* , and Xcelium* simulator.
Intel^® Stratix^® 10 L-Tile GX Transceiver Signal Integrity Development Kit (1SX280LU2F50E2VG) for hardware testing.

Functional Description

The 25G Ethernet single-channel design example consists of two core variants—MAC+PCS+PMA and MAC+PCS. The following block diagrams show the design components and the top-level signals of the two core variants in the 25G Ethernet single-channel design example.

Figure 12. Block Diagram—25G Ethernet Single-Channel Design Example (MAC+PCS+PMA Core Variant) Without the IEEE 1588v2 Feature

Figure 13. Block Diagram—25G Ethernet Single-Channel Design Example (MAC+PCS+PMA Core Variant) with the IEEE 1588v2 Feature

Figure 14. Block Diagram—25G Ethernet Single-Channel Design Example (MAC+PCS Core Variant) Without the IEEE 1588v2 Feature

Figure 15. Block Diagram—25G Ethernet Single-Channel Design Example (MAC+PCS Core Variant) with the IEEE 1588v2 Feature

Design Components

Table 8. Design Components
Component	Description
25G Ethernet Intel^® FPGA IP	Consists of MAC, PCS, and Transceiver PHY, with the following configuration: Core Variant: MAC+PCS+PMA, MAC+PCS Enable flow control: Optional Enable link fault generation: Optional Enable preamble passthrough: Optional Enable statistics collection: Optional Enable MAC statistics counters: Optional Enable 10G/25G dynamic rate switching: Not selected Enable Native PHY Debug Master Endpoint (NPDME): Optional Reference clock frequency: 644.531250/322.265625 For the design example with the IEEE 1588 feature, the following additional parameters are configured: Enable IEEE 1588: Selected Time of day format: Enable 96-bit timestamp format ² For the design example with the RS-FEC feature, the following additional parameter is configured: Enable RS-FEC: Selected
ATX PLL	Generates TX serial clocks for the 25G transceiver.
Client logic	Consists of: Traffic generator, which generates burst packets to the 25G Ethernet Intel^® FPGA IP core for transmission. Traffic monitor, which monitors burst packets that are coming from the 25G Ethernet Intel^® FPGA IP core.
Source and Probe	Source and probe signals, including system reset input signal, which you can use for debugging.
Design Components for the IEEE 1588v2 Feature
Sampling PLL	Generates the clocks for the IEEE 1588v2 design components. `latency_sclk`: 156.25 MHz for latency measurement. `sampling_clk`: 250 MHz for ToD synchronization
Time-of-day (ToD) Sync	Synchronizes the 25G ToD.
ToD Tx	ToD for transmit paths for the 25G transceiver.
ToD Rx	ToD for receive paths for the 25G transceiver.
Master Precision Time Protocol (PTP)	Master PTP consists of a packet generator and a packet receiver. Packet generator: Obtains timestamp information from the 25G Ethernet Intel^® FPGA IP core and generates Avalon^® -ST packets such as Sync packet and Delay Response packet. Packet receiver: Obtains the delay request packet information from the 25G Ethernet Intel^® FPGA IP core and produces timestamp values.
Slave PTP	Slave PTP consists of a packet generator, a packet receiver, and a packet compute. Packet generator: Obtains timestamp information from the 25G Ethernet Intel^® FPGA IP core and generates Avalon^® -ST packets such as Delay Request packet. Packet receiver: Obtains the Sync and Delay Response packets information from the 25G Ethernet Intel^® FPGA IP core and produces timestamp values. Packet compute: Calculates and produces the delay and offsets value based on the timestamp values.

² The 25G Ethernet single-channel design example with IEEE 1588v2 feature only supports 96-bit timestamp format.

Simulation

The testbench sends traffic through the IP core, exercising the transmit side and receive side of the IP core.

Testbench

Figure 16. Block Diagram of the 25G Ethernet Single-Channel Design Example Simulation Testbench

Table 9. Testbench Components
Component	Description
Device under test (DUT)	The 25G Ethernet Intel^® FPGA IP core.
Reconfiguration Sequencer	Reconfigures the transceiver channel speed from 10 Gbps to 25 Gbps, and vice versa.
Ethernet Packet Generator and Packet Monitor	Packet generator generates frames and transmit to the DUT. Packet Monitor monitors TX and RX datapaths and displays the frames in the simulator console.
ATX PLL	Generates a TX serial clock for the Intel^® Stratix^® 10 10G/25G transceiver which is wrapped in the 25G Ethernet Intel^® FPGA IP core.

Note: For the 25G Ethernet single-channel design example with IEEE 1588v2 feature simulation testbench, refer to Figure 13.

Simulation Design Example Components

Table 10. 25G Ethernet Single-Channel Design Example Testbench File Descriptions
File Name	Description
Testbench and Simulation Files
basic_avl_tb_top.v	Top-level testbench file. The testbench instantiates the DUT, performs Avalon^® -MM configuration on design components and client logic, and sends and receives packet to or from .
Testbench Scripts
run_vsim.do	The ModelSim script to run the testbench.
run_vcs.sh	The Synopsys VCS* script to run the testbench.
run_ncsim.sh	The Cadence NCSim script to run the testbench.
run_xcelium.sh	The Xcelium* script to run the testbench.

Test Case—Design Example Without the IEEE 1588v2 Feature

The simulation test case performs the following actions:

Instantiates and ATX PLL.
Waits for RX clock and PHY status signal to settle.
Prints PHY status.
Analyzes the results. The successful testbench sends ten packets, receives ten packets, and displays "Testbench complete."

Figure 17. Sample Simulation Output for Design Example Without the IEEE 1588v2 Feature

Test Case—Design Example with the IEEE 1588v2 Feature

Note: For 25G Ethernet single-channel design example with IEEE 1588v2 feature simulation testbench, refer to Figure 13.

The simulation test case performs the following actions:

Instantiates , ATX PLL, and IO PLL (sampling PLL).
Waits for RX clock and PHY status signal to settle.
Prints PHY status.
Checks for 10 valid data.
Analyzes the results. The successful testbench displays "Testbench complete." when the PTP delay and offset data are within the threshold values.

The following sample output illustrates a successful simulation test run:

# 
# Waiting for RX alignment...
# iatpg_pipeline_global_en is set
# iatpg_pipeline_global_en is set
# RX deskew locked.
# RX lane aligmnent locked.
# 
# Sending packets...
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000064457
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000064bb4
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000fffffffff8a2
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000643b5
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000520
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000634fb
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000063f3b
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000063a1a
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x00000000000000000006445a
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000063e95
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000648d5
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000000
# Offset within tolerence range.
# 
# 
# Delay (sec[95:48],ns[47:16],fns[15:0]): 0x0000000000000000000643b5
# Offset(sec[95:48],ns[47:16],fns[15:0]): 0x000000000000000000000520
# Offset within tolerence range.
# 
# 
# 
# Finished sending packets.
# 
# **
# ** Testbench complete.
# **

Figure 18. Sample Simulation Output for Design Example with the IEEE 1588v2 Feature (Part 1 of 2)

Figure 19. Sample Simulation Output for Design Example with the IEEE 1588v2 Feature (Part 2 of 2)

Compilation

Follow the procedure in Compiling and Configuring the Design Example in Hardware to compile and configure the design example in the selected hardware.

You can estimate resource utilization and Fmax using the compilation-only design example. You can compile your design using the Start Compilation command on the Processing menu in the Intel^® Quartus^® Prime Pro Edition software. A successful compilation generates the compilation report summary.

For more information, refer to Design Compilation in the Compiler User Guide: Intel^® Quartus^® Prime Pro Edition .

Hardware Testing

In the hardware design example, you can program the IP core in internal serial loopback mode and generate traffic on the transmit side that loops back through the receive side.

Follow the procedure at the provided related information link to test the design example in the selected hardware.

Test Procedure—Design Example With and Without the IEEE 1588v2 Feature

Follow these steps to test the design example in hardware:

Before you run the hardware testing for this design example, you must reset the system:
1. Click Tools > In-System Sources & Probes Editor tool for the default Source and Probe GUI.
2. Toggle the system reset signal (Source[0]) from 0 to 1 to apply the reset and return the system reset signal back to 0 to release the system from the reset state.
3. Monitor the Probe signals and ensure that the status is valid.
To perform internal serial loopback test, refer to the Test Procedure—Design Example Without the IEEE 1588v2 Feature section of the 10G/25G Ethernet Single-Channel Design Example for Intel^® Stratix^® 10 Devices chapter.

25G Ethernet Multi-Channel Design Example for Intel Stratix 10 Devices

The 25G Ethernet multi-channel design example demonstrates an Ethernet solution for Intel^® Stratix^® 10 devices using the 25G Ethernet Intel^® FPGA IP core.

Generate the design example from the Example Design tab of the 25G Ethernet Intel^® FPGA IP parameter editor.

Features

Supports up to four Ethernet channels operating at 25G.
Provides testbench and simulation script.

Hardware and Software Requirements

Intel^® uses the following hardware and software to test the design example in a Linux system:

Intel^® Quartus^® Prime Pro Edition software.
ModelSim* -SE, NCSim (Verilog only), VCS* , and Xcelium* simulator.
Intel^® Stratix^® 10 L-Tile GX Transceiver Signal Integrity Development Kit (1SX280LU2F50E2VG) for hardware testing.

Functional Description

The 25G Ethernet multi-channel design example consists of various components. The following block diagram shows the design components and the top-level signals of the design example.

Figure 20. Block Diagram—25G Ethernet Multi-Channel Design Example (MAC+PCS+PMA Core Variant)

Design Components

Table 11. Design Components
Component	Description
25G Ethernet Intel^® FPGA IP	Consists of MAC, PCS, and Transceiver PHY, with the following configuration: Core Variant: MAC+PCS+PMA Enable RS-FEC: Not selected Enable flow control: Optional Enable link fault generation: Optional Enable preamble passthrough: Optional Enable statistics collection: Optional Enable MAC statistics counters: Optional Enable IEEE 1588: Not selected Enable 10G/25G dynamic rate switching: Not selected Enable Native PHY Debug Master Endpoint (NPDME): Optional Reference clock frequency: 644.531250/322.265625
ATX PLL	Generates TX serial clocks for the 25G transceiver.
Client logic	Consists of: Traffic generator, which generates burst packets to the 25G Ethernet Intel^® FPGA IP core for transmission. Traffic monitor, which receives burst packets from the 25G Ethernet Intel^® FPGA IP core.
Source and Probe	Source and probe signals, including system reset input signal, which you can use for debugging.

Simulation

The testbench sends traffic through the IP core, exercising the transmit side and receive side of the IP core.

Testbench

Figure 21. Block Diagram of the 25G Ethernet Multi-Channel Design Example Simulation Testbench

Table 12. Testbench Components
Component	Description
Device under test (DUT)	The 25G Ethernet Intel^® FPGA IP core.
Reconfiguration Sequencer	Reconfigures the transceiver channel speed from 10 Gbps to 25 Gbps, and vice versa.
Ethernet Packet Generator and Packet Monitor	Packet generator generates frames and transmit to the DUT. Packet Monitor monitors TX and RX datapaths and displays the frames in the simulator console.
ATX PLL	Generates a TX serial clock for the Intel^® Stratix^® 10 10G/25G transceiver which is wrapped in the 25G Ethernet Intel^® FPGA IP core.

Simulation Design Example Components

Table 13. 25G Ethernet Multi-Channel Design Example Testbench File Descriptions
File Name	Description
Testbench and Simulation Files
basic_avl_tb_top.v	Top-level testbench file. The testbench instantiates the DUT, performs Avalon^® -MM configuration on design components and client logic, and sends and receives packet to or from the 25G Ethernet Intel^® FPGA IP.
Testbench Scripts
run_vsim.do	The ModelSim script to run the testbench.
run_vcs.sh	The Synopsys VCS* script to run the testbench.
run_ncsim.sh	The Cadence NCSim script to run the testbench.
run_xcelium.sh	The Xcelium* script to run the testbench.

Test Case

The simulation test case performs the following steps:

Instantiates 25G Ethernet Intel^® FPGA IP and ATX PLL.
Waits for PHY status signal to settle.
Prints PHY status.
Analyzes the results. The successful testbench sends and receives packets, and displays "Testbench complete."

Figure 22. Sample Simulation Output when Ethernet Channel is Configured to 1This figure shows a successful simulation test run when the Ethernet channel (i.e., LINK) is configured to 1.

Figure 23. Sample Simulation Output when Ethernet Channel is Configured to 4 (Part 1 of 2)This figure shows a successful simulation test run when the Ethernet channel (i.e., LINK) is configured to 4.

Figure 24. Sample Simulation Output when Ethernet Channel is Configured to 4 (Part 2 of 2)This figure shows a successful simulation test run when the Ethernet channel (i.e., LINK) is configured to 4.

Compilation

Follow the procedure in Compiling and Configuring the Design Example in Hardware to compile and configure the design example in the selected hardware.

For more information, refer to Design Compilation in the Compiler User Guide: Intel^® Quartus^® Prime Pro Edition .

Hardware Testing

In the hardware design example, you can program the IP core in internal serial loopback mode and generate traffic on the transmit side that loops back through the receive side.

Follow the procedure at the provided related information link to test the design example in the selected hardware.

Test Procedure

Follow these steps to test the design example in hardware:

Before you run the hardware testing for this design example, you must reset the system:
1. Click Tools > In-System Sources & Probes Editor tool for the default Source and Probe GUI.
2. Toggle the system reset signal (Source[0]) from 0 to 1 to apply the reset and return the system reset signal back to 0 to release the system from the reset state.
3. Monitor the Probe signals and ensure that the status is valid.
To perform internal serial loopback test, refer to the Test Procedure—Design Example Without the IEEE 1588v2 Feature section of the 10G/25G Ethernet Single-Channel Design Example for Intel^® Stratix^® 10 Devices chapter.
Note: link_num is valid for 0 to 3 only.

25G Ethernet Intel FPGA IP Design Example References

This section provides information about the 25G Ethernet Intel^® FPGA IP core interface signals and registers in the design examples.

Design Example Interface Signals

The 25G Ethernet Intel^® FPGA IP core testbench is self-contained and does not require you to drive any input signals.

Table 14. Hardware Design Example Interface Signals for 25G Ethernet Intel^® FPGA IP Core for Intel^® Stratix^® 10 Devices
Signal	Direction	Comments
`clk100`	Input	Drive at 100 MHz. The intent is to drive this from a 100 Mhz oscillator on the board.
`clk_ref`	Input	Drive at 644.53125 MHz or 322.265625 MHz from an oscillator on the board.
`cpu_resetn`	Input	Resets the IP core. Active low. Drives the global hard reset `csr_reset_n` to the IP core.
`tx_serial`	Output	Transceiver PHY output serial data.
`rx_serial`	Input	Transceiver PHY input serial data.
`user_led[7:0]`	Output	Status signals. The hardware design example connects these bits to drive LEDs on the target board. Individual bits reflect the following signal values and clock behavior: [0]: Main reset signal to IP core [1]: Reserved [2]: Divided version of `clk50` [3]: Divided version of 100 MHz status clock [4]: `tx_lanes_stable` [5]: `rx_block_lock` [6]: `rx_am_lock` [7]: `rx_pcs_ready`

Design Example Registers

Table 15. Hardware Design Example Register Map for 25G Ethernet Intel^® FPGA IP Core for Intel^® Stratix^® 10 DevicesYou access these registers with the `reg_read` and `reg_write` functions in the System Console.
Word Offset	Register Category
Variant: Single-Channel
0X0000–0X0DFF	Register range to access the Status Registers.
0X4000–0X7FFF	Register range to access the Reconfiguration Registers.
0X10000–0X10001	Register range to access the Reconfiguration Registers module for 10G/25G switching.
0x1020	32-bit `average_offset_fnsec_r` register: Read this register to obtain average offset value [47:16] in fractional nanosecond, which is derived from the offset adjustment data [96:0] of the PTP slave.
0x1021	32-bit `average_offset_fnsec_to_mem` register: Read this register to obtain average offset value [15:0] in fractional nanosecond, which is derived from the offset adjustment data [96:0] of the PTP slave. Bit [31:16]: Reserved.
0x1030	32-bit `average_delay_fnsec_r` register: Read this register to obtain average delay value [47:16] in fractional nanosecond, which is derived from the offset adjustment data [191:96] of the PTP slave.
0x1031	32-bit `average_delay_fnsec_to_mem` register: Read this register to obtain average delay value [15:0] in fractional nanosecond, which is derived from the offset adjustment data [191:96] of the PTP slave. Bit [31:16]: Reserved.
Variant: Multi-Channel
0x00000–0x30DFF	For multi-channel design examples, the base address of all channels are incremented with 0x10000. This corresponds to: Channel 0 Range: 0x00300–00DFF Channel 1 Range: 0x10300–10DFF Channel 2 Range: 0x20300–20DFF Channel 3 Range: 0x30300–30DFF
0x04000-0x37FFF	For multi-channel design examples, the base address of all channels are incremented with 0x10000. This corresponds to: Channel 0 Range: 0x04000-0x07FFF Channel 1 Range: 0x14000-0x17FFF Channel 2 Range: 0x24000-0x27FFF Channel 3 Range: 0x34000-0x37FFF

Note:

For Intel^® Stratix^® 10 H-tile production device, disable the background calibration prior to accessing the transceiver core reconfiguration register, as described in the Disabling Background Calibration section of the 25G Ethernet Intel^® FPGA IP User Guide.
Dynamic reconfiguration switching for 10G/25G is not available for multi-channel designs.
For single-channel design example, 0x4000 is the base address of the PHY registers. For example, to read the background calibration register, type reg_read 0x4542.
For multi-channel design example, the base address of the PHY registers is 0x4000 + (0x10000 * <link num>). For example, to read the background calibration register at channel 2, type reg_read 0x24542.

25G Ethernet Intel Stratix 10 FPGA IP Design Example User Guide Archives

If an IP core version is not listed, the user guide for the previous IP core version applies.

IP Core Version	User Guide
18.1	25G Ethernet Intel^® Stratix^® 10 FPGA IP Design Example User Guide
18.0	25G Ethernet Intel^® Stratix^® 10 FPGA IP Design Example User Guide

Document Revision History for the 25G Ethernet Intel Stratix 10 FPGA IP Design Example User Guide

Document Version	Intel^® Quartus^® Prime Version	Changes
2019.05.10	19.1	Renamed Altera Debug Master Endpoint (ADME) to Native PHY Debug Master Endpoint (NPDME). Updated the hardware testing steps for the following topics: Test Procedure—Design Example Without the IEEE 1588v2 Feature for 10G/25G Ethernet single-channel design example. Test Procedure—Design Example with the IEEE 1588v2 Feature for 10G/25G Ethernet single-channel design example. Test Procedure—Design Example With and Without the IEEE 1588v2 Feature for 25G Ethernet single-channel design example. Test Procedure for 25G Ethernet multi-channel design example. Updated the following Figures: Block Diagram—10G/25G Ethernet Single-Channel Design Example (MAC+PCS+PMA Core Variant) Without the IEEE 1588v2 Feature Block Diagram—10G/25G Ethernet Single-Channel Design Example (MAC+PCS+PMA Core Variant) with the IEEE 1588v2 Feature Block Diagram—10G/25G Ethernet Single-Channel Design Example (MAC+PCS Core Variant) Without the IEEE 1588v2 Feature Block Diagram—10G/25G Ethernet Single-Channel Design Example (MAC+PCS Core Variant) with the IEEE 1588v2 Feature Updated Table: Hardware Design Example Register Map for 25G Ethernet Intel^® FPGA IP Core for Intel^® Stratix^® 10 Devices to include reconfiguration registers (0x04000-0x37FFF). Updated the note section in the Design Example Registers topic. Made editorial updates throughout the document.
2019.01.07	18.1	Updated the Generating the Design Example topic to correct target development kit in Step 8 from Stratix 10 GX FPGA Development Kit to Intel Stratix 10 L-Tile GX Transceiver Signal Integrity Development Kit. Updated Figure: Block Diagram—10G/25G Ethernet Single-Channel Design Example (MAC+PCS+PMA Core Variant) with the IEEE 1588v2 Feature. Added a note to Design Example Registers topic.
2018.10.03	18.1	Updated Table: Parameters in the Example Design Tab to update the description for Select Board. Updated the Hardware and Software Requirements topics for all design example chapters. Updated the Design Components topics for all design example chapters. Added new Figures: Block Diagram—25G Ethernet Single-Channel Design Example (MAC+PCS Core Variant) Without the IEEE 1588v2 Feature Block Diagram—25G Ethernet Single-Channel Design Example (MAC+PCS Core Variant) Without the IEEE 1588v2 Feature Block Diagram—25G Ethernet Single-Channel Design Example (MAC+PCS Core Variant) Without the IEEE 1588v2 Feature Block Diagram—25G Ethernet Single-Channel Design Example (MAC+PCS Core Variant) with the IEEE 1588v2 Feature Updated Figures: Example Design Tab in the 25G Ethernet Intel FPGA IP Parameter Editor Block Diagram—25G Ethernet Single-Channel Design Example (MAC+PCS+PMA Core Variant) with the IEEE 1588v2 Feature Block Diagram—25G Ethernet Single-Channel Design Example (MAC+PCS+PMA Core Variant) Without the IEEE 1588v2 Feature Block Diagram—25G Ethernet Multi-Channel Design Example (MAC+PCS+PMA Core Variant) Block Diagram—10G/25G Ethernet Single-Channel Design Example (MAC+PCS+PMA) Without the IEEE 1588v2 Feature Block Diagram—10G/25G Ethernet Single-Channel Design Example (MAC+PCS+PMA) with the IEEE 1588v2 Feature Removed Figure: Sample Simulation Output for Design Example with the IEEE 1588v2 Feature (Part 1 of 2) and Sample Simulation Output for Design Example with the IEEE 1588v2 Feature (Part 2 of 2). Updated the simulation sample output of the Test Case—Design Example with the IEEE 1588v2 Feature topic for 25G Ethernet Single-Channel design example. Updated the simulation sample output of the Test Case—Design Example with the IEEE 1588v2 Feature topic for the 10G/25G Ethernet design example. Restructured descriptions for Features topics for all design example chapters. Streamlined the contents and document organization.
2018.06.25	18.0	Initial release.