3.1. Parameter Editor Parameters
The Ethernet Subsystem Intel FPGA IP parameter has two tabs, Ethernet Subsystem tab and an Example Design tab.
For more information about the Example Design tab, refer to Ethernet SS IP Example Design.
Parameter | Range | Default Setting | Parameter Description |
---|---|---|---|
Number of devices | 1 | 1 | Only 1 device is supported in this version. |
Device 0 Configuration | |||
Tile 0 Configuration | |||
Tiles | E, F | E | Per tile configuration which shows the supported tiles within the subsystem. The allowed values are based on the FPGA device. |
Enable Multi Tile |
|
Off | When enabled, generates RTL for multiple tiles instantiated in one design and maintains unique instance names and RTL files for each tile, using the Tile Number parameter value to differentiate between them.
Note: This parameter doesn't generate multiple instances of IP when enabled; it is still a single instance but with a unique name as per your selection.
|
Tile Number | 0-5 | 0 | Use the value entered in the Tile Number to tag the internal RTL module names and the instance names, and is valid only when Enable Multi Tile is set. Setting Enable Multi Tile is required to generate unique module names for common files across tiles. |
Main Configuration | |||
General Configuration | |||
Product | Agilex | Agilex | Only Agilex is supported in this version. |
NUM_ENABLED_PORTS | 1-16 | 1 | Set the number of 10GE/25GE/40GE/50GE/100GE/200GE/400GE port(s) to be enabled. The IP determines the number of transceiver channels based on the port profile. |
Enable JTAG to Avalon® Master Bridge |
|
Disable | Enable this parameter to add a JTAG to Avalon® memory-mapped interface Master bridge connecting internally to reconfiguration registers. This allows the Ethernet Toolkit to be run using System Console. Note that Ethernet Toolkit is not available for multi-port AN/LT designs with this Quartus release. |
Enable ECC Protection |
|
Disable | Enables ECC protection on the Ethernet Subsystem IP as well the AXI ST Bridge and the SAL NIOS sub-IPs, if enabled. Enabling this option can improve data integrity in memory blocks. |
Enable System PLL for F-Tile |
|
On | When enabled, the 830.07MHz F-Tile system PLL module is instantiated inside the Ethernet Subsystem IP. As F-Tile system PLL is a shared module, only one per Tile is allowed. |
SYSPLL_RATE_GUI |
|
1:830.078125 | Selects the System PLL rate. The rate is divided by 2 to generate the core clock o_p<x>_clk_pll. In general: RS (544,514) and Low Latency FEC modes require a System Clock of 830.078125 or higher. Other 25G, 40G, 50G, and 100G modes require a System Clock of 805.6640625 or higher. 10G modes requires a System Clock of 805.6640625 or higher, including 10G PTP. if Custom is selected, you must enter the System PLL rate into SYSPLL_CUSTOM_GUI. Available only when EN_SYS_PLL is 0. |
SYSPLL_CUSTOM_GUI |
|
830.078125 | Selects the System PLL rate when SYSPLL_RATE_GUI = Custom. The rate is divided by 2 to generate the core clock o_p<x>_clk_pll. |
Port_<port_number:1-16>Port_<n>_configuration
Note: The selected port profile allows for the individual configuration of up to 16 ports.
|
|||
PORT<n>_ENABLE |
|
1 | Set this parameter to 1 to enable individual port. |
Port_PORT<n>_PROFILE |
|
10GbE | Select the speed rate profile for each port. For E-tile, 100G CAUI-4 variant can only be selected on ports 0,4,8,12. |
PORT<n>_SUB_PROFILE |
|
MAC+ PCS | Select the Ethernet Protocol layer sub-profile for the port. |
PORT<n>_RSFEC |
|
False | Set this parameter to True to include additional hard logic to perform Reed-Solomon Forward Error Correction (RS-FEC). This feature is not supported for 10GbE profile. |
PORT<n>_PTP |
|
False | Set this parameter to True to add IEEE 1588 PTP Timestamp offload functions to the core. The core can generate 1-step or 2-step TX timestamps and RX timestamps. |
Dynamic Reconfiguration |
|
Disable | Enables dynamic reconfiguration for port. Only available for selected profiles:
The F-Tile FGT supports the following dynamic reconfiguration modes:
The F-Tile FHT supports the following dynamic reconfiguration modes:
|
100G Partial Reconfiguration DR Extension Subsystem |
|
Disable | This parameter is only applicable for E-Tile. Enables Dynamic Reconfiguration Subsystem with Partial Reconfiguration support where the same 100G interface ports are used for the 25G profile as well. Supported only for E-tile DR base profile: 1x100G MAC + PCS+ RSFEC. |
Parameter | Range | Default Setting | Parameter Description |
---|---|---|---|
IP Configuration
Note: Each enabled port is assigned its own individual port configuration tab
|
|||
P<n> IP P<n> PMA_Adaptation | |||
Port <n> Configuration | |||
P<n> General Options | |||
ENABLE AN/LT |
|
Off | Turn on this parameter to enable the IP core to support Auto-negotiation and Link Training (AN/LT). |
Enable Native PHY Debug Master Endpoint |
|
On | If this parameter is turned on, the underlying Transceiver Native PHY IP includes an embedded Native PHY Debug Master Endpoint that connects internally to the Avalon memory-mapped slave interface for dynamic reconfiguration. The Native PHY Debug Master Endpoint can access the reconfiguration registers of the transceiver. This connection allows the System Console to run the Transceiver Toolkit. Note that Transceiver Toolkit is not available for multi-port ANLT designs with this Quartus release. |
ENABLE SYNCE |
|
Off | Turn on this parameter to enable the IP core to support SyncE operation. |
P<n> PTP Options
Note: Only available when PTP is enabled for the port.
|
|||
Enable TX PTP Packet Classifier |
|
False | Set this parameter to True to include PTP Packet Classifier in transmit direction, where PTP sideband signals are generated based on PTP packet decoding. |
PTP Accuracy Mode |
|
Basic Mode | When selected, specifies the PTP timestamp accuracy for selected Ethernet variant. For 10GbE/25GbE variant:
|
P<n> AN/LT Options | |||
P<n> Auto-Negotiation (AN)
Note: Only available when AN/LT is enabled for the port.
|
|||
Enable Auto-Negotiation on reset |
|
On | If this parameter is turned on, the IP core is configured after reset to implement auto-negotiation as defined in Clause 73 of IEEE Std 802.3–2015. If this parameter is turned off, the IP core does not perform the auto-negotiation after reset. |
Link Fail Inhibit Time | 100-4000ms | 504ms | Specify the time before link status is set to FAIL or OK. A link fails if the time duration specified by this parameter expires before link status is set to OK. |
Advertise CR Technology Ability |
|
On | If this parameter is turned on, the IP core advertises CR capability by default. If this parameter is turned off, the IP core advertises KR capability by default. |
Request RSFEC |
|
On | Turn on this parameter to request RSFEC from remote link partner during auto-negotiation. |
Auto-Negotiation Master |
|
PLane 0 | Select the master channel for auto-negotiation. Available for 100GbE variant. |
Advertise both 10G and 25G during AN |
|
Off | Turn on this parameter to advertise both 10 and 25 Gbps data rate during auto-negotiation. When this parameter is turned off, the IP core advertises only the data rate specified in port profile. This parameter is not available for 100GbE variant. |
Advertise PAUSE ability |
|
On | If this parameter is turned on, the IP core indicates on the Ethernet link that it supports symmetric pauses as defined in Annex 28B of Section 2 of IEEE Std 802.3–2015. |
Advertise PAUSE ASM_DIR ability |
|
On | If this parameter is turned on, the IP core indicates on the Ethernet link that it supports asymmetric pauses as defined in Annex 28B of Section 2 of IEEE Std 802.3–2015. |
P<n> Link Training
Note: Only available when AN/LT is enabled for the port.
|
|||
Enable Link Training on reset |
|
On | If this parameter is turned on, the IP core is configured after reset to perform link training, which configures the remote link partner TX PMD for the lowest Bit Error Rate (BER). |
Enable Link Training for VSR recipe |
|
Off | If this parameter is turned on, the IP core uses the VSR recipe during Link Training. Use during internal loopback or with very short connections. |
P<n> PMA Options Configuration | |||
Enable HOTPLUG |
|
Off | If this parameter is turned on, the IP core enables the autonomous logic to detect a valid signal on the serial interface and tune the link. The hotplug module supports 10GE, 25GE, and 100GE NRZ rates for LR and VSR recipes. If PAM4 is enabled, the module always loads the VSR recipe. If you are not using your own adaptation recipe for PAM4 designs, Intel recommends enabling the Hotplug module. For AN/LT-enabled channels, the Hotplug module starts after the AN/LT engine enters "Data Mode". The hotplug module overwrites the recipe of the AN/LT module with either the VSR or LR recipe. If AN/LT fails, the hotplug module never starts. Hotplug is not supported for CPRI rates. |
Enable iCAL and pCAL recipe at power on. |
|
Off | Available when AN/LT is disabled on NRZ ports. Not available on PAM4 ports. If this parameter is turned on, the IP core loads the PMA Configuration 0 prior to running initial calibration. Continuous calibration runs on every power-on or IP cold reset. |
Enable custom rate |
|
Off | If this parameter is turned on, the IP core enables the Custom Rate Interface. |
Include deterministic latency measurement interface |
|
Off | If this parameter is turned on, the IP core enables the Deterministic Latency Interface. |
PHY Reference Frequency (MHz) | 156.25MHz | 156.25MHz | Select the expected transceiver reference clock frequency. |
P<n>Configuration Tab | |||
P<n>MAC Options Configuration | |||
P<n>Basic Configuration | |||
TX Maximum Frame Size | 65-65535 | 1518 | Maximum packet size (in bytes) the IP core can transmit on the Ethernet link without reporting an oversized packet in the TX statistics counters. |
RX Maximum Frame Size | 65-65535 | 1518 | Maximum packet size (in bytes) the IP core can transmit on the Ethernet link without reporting an oversized packet in the RX statistics counters. |
Enforce Maximum Frame Size |
|
Off | Specify whether the IP core can receive an oversized packet or truncates these packets. |
Choose Link Fault Generation Mode |
|
Bidirectional | Specify the IP core response to link fault events. Bidirectional link fault handling complies with the Ethernet specification. Unidirectional link fault handling implements IEEE 802.3 Clause 66: in response to local faults, the IP core transmits Remote Fault ordered sets in interpacket gaps but does not respond to incoming Remote Fault ordered sets. The OFF option is provided for backward compatibility. |
Stop TX Traffic when link partner sends PAUSE |
|
No | Select how the IP core responds to PAUSE frames from the Ethernet link. This parameter has no effect if flow control is disabled. If you disable flow control, the IP core neither responds to incoming PAUSE and PFC frames nor generates outgoing PAUSE and PFC frames. If this parameter has the value of No, you can use the i_tx_pause signal on the TX client interface to force the TX MAC to stop TX traffic. |
Bytes to remove from RX frames |
|
Remove CRC bytes | Select bytes from incoming RX frames to be removed by the RX MAC before passing the bytes to the RX MAC Client. If the PAD and CRC bytes are not needed downstream, the remove option can reduce the need for downstream packet processing logic. |
Forward RX Pause Requests |
|
Off | Select whether the RX MAC forwards incoming PAUSE and PFC frames on the RX client interface or drops them after internal processing.
Note: This parameter has no effect if flow control is disabled.
|
Use Source Address Insertion |
|
Off | If the parameter is turned on, the IP core overwrites the outgoing packet source address with the value from TXMAC_SADDR registers. If the parameter is turned off, the IP core does not overwrite the source address. |
Enable TX VLAN Detection |
|
On | If the parameter is turned on, the IP core identifies VLAN or Stacked VLAN frames in TX statistics as VLAN or SVLAN frames. If the parameter is turned off, the IP core treats these frames as regular control frames. |
Enable RX VLAN Detection |
|
On | If the parameter is turned on, the IP core identifies VLAN or Stacked VLAN frames in RX statistics as VLAN or SVLAN frames. If the parameter is turned off, the IP core treats these frames as regular control frames. |
P<n>Specialized Configuration | |||
Enable Preamble Passthrough |
|
Off | If turned on, the IP core is in RX and TX preamble pass-through mode. In RX preamble pass-through mode, the IP core passes the preamble and SFD to the client instead of stripping them out of the Ethernet packet. In TX preamble pass-through mode, the client specifies the preamble to be sent in the Ethernet frame. |
Enable strict preamble check |
|
Off | If turned on, the IP core rejects RX packets whose preamble is not the standard Ethernet preamble (0x55_55_55_55_55_55). |
Enable strict SFD check |
|
Off | If turned on, the IP core rejects RX packets whose SFD byte is not the standard Ethernet SFD (0xD5). |
Average Inter-packet gap |
|
12 | Specifies the average minimum inter-packetgap (IPG) the IP core maintains on the TX Ethernet link. The default value of 12 complies with the Ethernet standard. The remaining values support increased throughput. |
Additional IPG removed as per AM period | Integer | 0 | Specifies the number of inter- packets gaps the IP core removes per alignment marker period, in addition to the default number required for protocol compliance. |
AXI Configuration | |||
AXI Streaming Configuration | |||
Ready Latency Configuration | |||
PORT<n>_READY_LATENCY | 0-16 | 0 | AXI-ST Client Interface Ready Latency. |
Packet Parity Configuration | |||
PORT<n>_PKT_SEG_PARITY_EN |
|
Off | Enables the Packet Segment Parity feature on the port. |
For parameters in the Ethernet Subsystem – IP Configuration tab, refer to the PMA Adaptation topic in the E-Tile Transceiver PHY User Guide.
Parameter | Range | Default Setting | Parameter Description |
---|---|---|---|
F-Tile IP Configuration
Note: Each enabled port is assigned its own individual port configuration tab
|
|||
Port<n>configuration | |||
P <n> IP | |||
P <n> General Options | |||
Client Interface |
|
MAC segmented | Selects which Ethernet internal protocol layers are provided to the client interface |
FEC Mode |
|
IEEE 802.3 RS(528,514) (CL 91) | When FEC is enabled in the main configuration tab, this option selects the FEC mode for the port. |
Enable debug endpoint for transceiver toolkit |
|
Disable | When enabled, an embedded Native Phy Debug Endpoint connects internally to the AVMM slave interface for the use of transceiver toolkit. |
Enable asynchronous adapter clocks | Disable | Disable | Allows you to drive p<n>_app_ss_st_rx_clk and p<n>_app_ss_st_tx_clk from different sources. |
Enable dedicated CDR clock output |
|
Disable | Enables CDR clock output. When channel number is more than one, the CDR clock output is connected to channel 0 of the port. This option is only applicable if Channel 0 is within FGT Quad3 or FGT Quad2 (i.e ports 8 o2 12) |
Include 40GE |
|
Disable | Used with Dynamic Reconfiguration. When enabled, 40GE is supported for FGT PMAs with the 100GE-4 Reconfiguration Group with the MAC segmented Client Interface. |
Include 32bit soft CWBIN counters |
|
Disable | When enabled, the port includes 32bit soft counters for RSFEC corrected cwbin counters. |
Port<n> DR configuration
Note: Only enabled when Dynamic Reconfiguration is selected per port. Refer to the F-Tile Ethernet Multirate Intel FPGA IP User Guide for further information on the Dynamic Reconfiguration parameters.
|
|||
Number of Secondary profiles | 1 through 32 | 1 | Selects the number of secondary profiles for this DR port |
P<n> Startup Profile Options | |||
Startup profile |
|
Per Base Profile | Selects the startup profile for each Reconfigurable Group |
Startup profile- Port<3:0> | Profile-0 (Base Profile) to Profile-<number of secondary profiles in Reconfigurable Group> | Per Base Profile | Selects the startup profile for Port |
P<n> Base_Profile(Profile #0)
Note: MAC Option parameters on this tab are described in P<n> Basic and P<n> Specialized sections
|
|||
Ethernet Mode | Base Profile | Base Profile | — |
P<n> Profile [Number of Profiles per port]
Note: MAC Option parameters on this tab are described in P<n> Basic and P<n> Specialized sections
|
|||
Ethernet Mode | 400G-4 - 4x10GE-1 | Base Profile | Selects Ethernet mode for this profile |
FEC mode | None - IEEE 802.3 RS(544,514) (CL134) | None | Selects the FEC mode for this profile |
Associated Port Number | Port 0 - ALL | Port 0 | Select the associated port number. When ALL is selected, this is equivalent to all ports of the Reconfigurable Group being used. |
MAC settings same as Profile 0 |
|
Disable | When enabled, the MAC settings from Profile0 are copied to current profile |
Enable FHT pre-encoder |
|
Disable | When enabled, the Pre-encoder for the FHT PMA is enabled. |
P<n> PTP Options
Note: Only available when PTP is enabled for the port.
|
|||
Enable TX PTP Classifier | false, true | false | Set this parameter to True to include PTP Packet Classifier in transmit direction, where PTP sideband signals are generated based on PTP packet decoding.
Note: F-Tile Dynamic Reconfiguration does not support this feature.
|
Timestamp accuracy mode | Basic, Advanced | Basic | When selected, specifies the PTP timestamp accuracy for selected Ethernet variant.
For 10GbE/25GbE/50GbE variant:
For 100GbE/200GbE/400GbE variant:
Not applicable for 40GbE variant |
Timestamp fingerprint width | 8-32 | 8 | Defines the timestamp fingerprint bit width |
P<n> Auto-Negotiation and Link Training Options | |||
P<n> ANLT Options
Note: Only available when AN/LT is enabled for the port
|
|||
Enable Link Training on reset |
|
On | If this parameter is turned on, the IP core is configured after reset to perform link training, which configures the remote link partner TX PMD for the lowest Bit Error Rate (BER). |
Enable Auto-Negotiation on reset |
|
On | If this parameter is turned on, the IP core is configured after reset to implement auto-negotiation as defined in Clause 73 of IEEE Std 802.3–2015. If this parameter is turned off, the IP core does not perform the auto-negotiation after reset. |
KR or CR mode |
|
CR mode | Selects KR or CR mode for ANLT |
Link Fail Inhibit Time | 100-4000ms | 504ms | Specify the time before link status is set to FAIL or OK. A link fails if the time duration specified by this parameter expires before link status is set to OK. |
AN channel location 0 | 0-7 | 0 | Auto negotiation lane for port |
P<n>MAC Options | |||
P<n>Basic | |||
TX Maximum Frame Size | 65-65535 | 1518 | Maximum packet size (in bytes) the IP core can transmit on the Ethernet link without reporting an oversized packet in the TX statistics counters. |
RX Maximum Frame Size | 65-65535 | 1518 | Maximum packet size (in bytes) the IP core can transmit on the Ethernet link without reporting an oversized packet in the RX statistics counters. |
Enforce Maximum Frame Size |
|
Off | Specify whether the IP core can receive an oversized packet or truncates these packets. |
Link Fault Generation Mode |
|
Bidirectional | Specify the IP core response to link fault events. Bidirectional link fault handling complies with the Ethernet specification. Unidirectional link fault handling implements IEEE 802.3 Clause 66: in response to local faults, the IP core transmits Remote Fault ordered sets in interpacket gaps but does not respond to incoming Remote Fault ordered sets. The OFF option is provided for backward compatibility. |
Stop TX Traffic when link partner sends PAUSE |
|
No | Select how the IP core responds to PAUSE frames from the Ethernet link. This parameter has no effect if flow control is disabled. If you disable flow control, the IP core neither responds to incoming PAUSE and PFC frames nor generates outgoing PAUSE and PFC frames. If this parameter has the value of No, you can use the i_tx_pause signal on the TX client interface to force the TX MAC to stop TX traffic. |
Enable SFE/PFC Queue Buffering |
|
Off | If the parameter is turned on, the Priority Flow Control (PFC) feature is enabled.
Note: F-Tile supports queue buffering only for Ethernet rates of 10/25/40/50/100G and in AXI-ST single packet mode.
|
Bytes to remove from RX frames |
|
Remove CRC bytes | Select bytes from incoming RX frames to be removed by the RX MAC before passing the bytes to the RX MAC Client. If the PAD and CRC bytes are not needed downstream, the remove option can reduce the need for downstream packet processing logic. |
Forward RX Pause Requests |
|
Off | Select whether the RX MAC forwards incoming PAUSE and PFC frames on the RX client interface or drops them after internal processing.
Note: This parameter has no effect if flow control is disabled.
|
Use Source Address Insertion |
|
Off | If the parameter is turned on, the IP core overwrites the outgoing packet source address with the value from TXMAC_SADDR registers. If the parameter is turned off, the IP core does not overwrite the source address. |
Enable TX VLAN Detection |
|
On | If the parameter is turned on, the IP core identifies VLAN or Stacked VLAN frames in TX statistics as VLAN or SVLAN frames. If the parameter is turned off, the IP core treats these frames as regular control frames. |
Enable RX VLAN Detection |
|
On | If the parameter is turned on, the IP core identifies VLAN or Stacked VLAN frames in RX statistics as VLAN or SVLAN frames. If the parameter is turned off, the IP core treats these frames as regular control frames. |
P<n>Specialized Configuration | |||
Enable Preamble Passthrough |
|
Off | If turned on, the IP core is in RX and TX preamble pass-through mode. In RX preamble pass- through mode, the IP core passes the preamble and SFD to the client instead of stripping them out of the Ethernet packet. In TX preamble pass-through mode, the client specifies the preamble to be sent in the Ethernet frame. |
Enable strict preamble check |
|
Off | If turned on, the IP core rejects RX packets whose preamble is not the standard Ethernet preamble (0x55_55_55_55_55_55).
Note: F-Tile does not support preamble passthrough mode when DR is enabled for the Ethernet profiles 40G and 50G with AXI-ST single packet interface.
|
Enable strict SFD check |
|
Off | If turned on, the IP core rejects RX packets whose SFD byte is not the standard Ethernet SFD (0xD5). |
Average Inter-packet gap |
|
12 | Specifies the average minimum inter-packetgap (IPG) the IP core maintains on the TX Ethernet link. The default value of 12 complies with the Ethernet standard. The remaining values support increased throughput. |
Additional IPG removed as per AM period | Integer | 0 | Specifies the number of inter- packets gaps the IP core removes per alignment marker period, in addition to the default number required for protocol compliance. |
AXI Configuration | |||
AXI Streaming Configuration | |||
Ready latency Configuration | |||
PORT<n>_READY_LATENCY | 0-16 | 0 | AXI-ST Client Interface Ready Latency. |
Packet Parity Configuration | |||
PORT<n>_PKT_SEG_PARITY_EN |
|
Off | Enables Packet Segment Parity feature on port. |
AXI4 Lite Configuration | |||
AXI Lite Clock Frequency | 100-250 MHz | 100 MHz | AXI4 Lite clock frequency. |
P<n> PFC
Note: Only available when SFC/PFC Queue Buffering is enabled for the port
|
|||
P<n> PFC Options | |||
Number of Queues | 1-8 | 8 | Selects the number of PFC priority queues enabled for the port. |
P<n>TX Queue Configuration | |||
Queue [0-7] Size |
|
512 | Selects the size of each PFC TX priority queue. |
P<n>RX Queue Configuration | |||
Queue [0-7] Size |
|
512 | Selects the size of each PFC RX priority queue. |