GTS Ethernet Hard IP User Guide: Agilex™ 5 FPGAs and SoCs

ID 817676
Date 8/04/2025
Public
Document Table of Contents

10.5.3. Run the Hardware Test

Follow these steps to test the hardware design example on the System Console:
  1. The GTS Ethernet Hard IP Dynamically Reconfigurable Mode Design Example runs the external loopback test by default, with the loopback_mode parameter set to 0.
    1. External Loopback: Before performing any hardware test, attach the QSFP28 loopback module according to the QSF pinout assignments of the respective design example.
    2. Internal Loopback: To perform an internal loopback test in hardware, set the loopback_mode parameter to 1 in the parameter.tcl file located in <design_example_dir>/hardware_test_design/hwtest/src/.
  2. The jtag_port_id parameter is set to 0 by default. To change the JTAG port ID to point to the correct Agilex™ 5 FPGA Master, modify the jtag_port_id parameter in the parameter.tcl file located in <design_example_dir>/hardware_test_design/hwtest/src/.
  3. Open Tools > System Debugging Tools > System Console or type the command:
    system-console &
  4. In the TCl Console window, type cd hwtest to change directory to <design_example_dir>/hardware_test_design/hwtest
  5. Type source main_10G.tcl to list the available JTAG masters:
  6. Verify that the output of the TCL script matches the output from a sample test run, shown below:
    % source main.tcl
    -----------------------------------------------------------------------
    JTAG Port ID       = 0
    Power Up Variant   = 10G_nofec
    Start of DR test: 
    Applying reset through ISSP
    Wait for DR Ready....
    Running External Loopback Test
    Run test on startup profile (10G_nofec): 
    
    -------- Printing PHY status ---------
    --------------------------------------
    
     RX PHY Register Access: Checking Clock Frequencies (KHz) 
    
          TXCLK 		:161130  (KHZ) 
          RXCLK 		:161140  (KHZ) 
    
     TX PLL Lock Status        0x00000001 
     Rx Frequency Lock Status  0x00000001
     RX PCS Ready              0x1
     TX Lanes Stable           0x1
     Deskewed Status           0x0
     Link Fault Status         0x00000000
     Rx Frame Error            0x00000000
     Rx AM LOCK Condition        0x00000000 
    
    --- Initialize PKT ROM Read address ----
    --------- Sending packets... ---------
     =========================================================================
                            STATISTICS FOR BASE 0x50000 (Rx)                   
     ==========================================================================
    Fragmented Frames                : 0 
    Jabbered Frames                  : 0 
    Any Size with FCS Err Frame      : 0 
    Right Size with FCS Err Fra      : 0 
    Multicast data  Err Frames       : 0 
    Broadcast data Err  Frames       : 0 
    Unicast data Err  Frames         : 0 
    Multicast control  Err Frame     : 0 
    Broadcast control Err  Frame     : 0 
    Unicast control Err  Frames      : 0 
    Pause control Err  Frames        : 0 
    64 Byte Frames                   : 0 
    65 - 127 Byte Frames             : 16 
    128 - 255 Byte Frames            : 0 
    256 - 511 Byte Frames            : 0 
    512 - 1023 Byte Frames           : 0 
    1024 - 1518 Byte Frames          : 0 
    1519 - MAX Byte Frames           : 0 
    > MAX Byte Frames                : 0 
    Rx Frame Starts                  : 16 
    Multicast data  OK  Frame        : 16 
    Broadcast data OK   Frame        : 0 
    Unicast data OK   Frames         : 0 
    Multicast Control Frames         : 0 
    Broadcast Control Frames         : 0 
    Unicast Control Frames           : 0 
    Pause Control Frames             : 0 
    Data and padding octets          : 800 
    Frame octets                     : 1088 
     =======================================================================
                            STATISTICS FOR BASE 0x50000 (Tx)                 
     ========================================================================
    Fragmented Frames                : 0 
    Jabbered Frames                  : 0 
    Any Size with FCS Err Frame      : 0 
    Right Size with FCS Err Fra      : 0 
    Multicast data  Err Frames       : 0 
    Broadcast data Err  Frames       : 0 
    Unicast data Err  Frames         : 0 
    Multicast control  Err Frame     : 0 
    Broadcast control Err  Frame     : 0 
    Unicast control Err  Frames      : 0 
    Pause control Err  Frames        : 0 
    64 Byte Frames                   : 0 
    65 - 127 Byte Frames             : 16 
    128 - 255 Byte Frames            : 0 
    256 - 511 Byte Frames            : 0 
    512 - 1023 Byte Frames           : 0 
    1024 - 1518 Byte Frames          : 0 
    1519 - MAX Byte Frames           : 0 
    > MAX Byte Frames                : 0 
    Tx Frame Starts                  : 16 
    Multicast data  OK  Frame        : 16 
    Broadcast data OK   Frame        : 0 
    Unicast data OK   Frames         : 0 
    Multicast Control Frames         : 0 
    Broadcast Control Frames         : 0 
    Unicast Control Frames           : 0 
    Pause Control Frames             : 0 
    Data and padding octets          : 800 
    Frame octets                     : 1088 
    --------------------------------------
    Info: RX and TX packet counts match 
    --------------------------------------
    Startup Traffic test passed! 
    
    Assert EIO reset
    Wait reset ack (assert) -----
    Reset acknowledged
    Value from issp reset probe is 0x0 
    
    --------------------------------------------------------
    Setup DR reconfiguration: 10G_nofec -> 10G_fec
    Configuring DR Profile 10G_fec....
    Trigger DR interrupt
    Wait for DR interrupt Ack....
    DR Request acknowledged
    
    Wait for DR reconfig to be done....
    DR reconfig done, check for  DR errors
    NO DR Errors found
    
    Deassert EIO reset
    Wait reset ack (deassert) -----
    Reset acknowledged
    Value from issp reset probe is 0xff 
    
    Run traffic test (10G_fec): 
    
    -------- Printing PHY status ---------
    --------------------------------------
    
     RX PHY Register Access: Checking Clock Frequencies (KHz) 
    
          TXCLK 		:161140  (KHZ) 
          RXCLK 		:161130  (KHZ) 
    
    
     TX PLL Lock Status          0x00000001 
    
     Rx Frequency Lock Status    0x00000001
     RX PCS Ready                0x1
    
     TX Lanes Stable             0x1 
    
     Deskewed Status             0x0 
     Link Fault Status           0x00000000
     Rx Frame Error              0x00000000
     Rx AM LOCK Condition        0x1 
    
    --- Initialize PKT ROM Read address ----
    --------- Sending packets... ---------
     ============================================================================
                            STATISTICS FOR BASE 0x50000 (Rx)                     
     ============================================================================
    Fragmented Frames                : 0 
    Jabbered Frames                  : 0 
    Any Size with FCS Err Frame      : 0 
    Right Size with FCS Err Fra      : 0 
    Multicast data  Err Frames       : 0 
    Broadcast data Err  Frames       : 0 
    Unicast data Err  Frames         : 0 
    Multicast control  Err Frame     : 0 
    Broadcast control Err  Frame     : 0 
    Unicast control Err  Frames      : 0 
    Pause control Err  Frames        : 0 
    64 Byte Frames                   : 0 
    65 - 127 Byte Frames             : 16 
    128 - 255 Byte Frames            : 0 
    256 - 511 Byte Frames            : 0 
    512 - 1023 Byte Frames           : 0 
    1024 - 1518 Byte Frames          : 0 
    1519 - MAX Byte Frames           : 0 
    > MAX Byte Frames                : 0 
    Rx Frame Starts                  : 16 
    Multicast data  OK  Frame        : 16 
    Broadcast data OK   Frame        : 0 
    Unicast data OK   Frames         : 0 
    Multicast Control Frames         : 0 
    Broadcast Control Frames         : 0 
    Unicast Control Frames           : 0 
    Pause Control Frames             : 0 
    Data and padding octets          : 800 
    Frame octets                     : 1088 
     ===============================================================================
                            STATISTICS FOR BASE 0x50000 (Tx)                        
     ===============================================================================
    Fragmented Frames                : 0 
    Jabbered Frames                  : 0 
    Any Size with FCS Err Frame      : 0 
    Right Size with FCS Err Fra      : 0 
    Multicast data  Err Frames       : 0 
    Broadcast data Err  Frames       : 0 
    Unicast data Err  Frames         : 0 
    Multicast control  Err Frame     : 0 
    Broadcast control Err  Frame     : 0 
    Unicast control Err  Frames      : 0 
    Pause control Err  Frames        : 0 
    64 Byte Frames                   : 0 
    65 - 127 Byte Frames             : 16 
    128 - 255 Byte Frames            : 0 
    256 - 511 Byte Frames            : 0 
    512 - 1023 Byte Frames           : 0 
    1024 - 1518 Byte Frames          : 0 
    1519 - MAX Byte Frames           : 0 
    > MAX Byte Frames                : 0 
    Tx Frame Starts                  : 16 
    Multicast data  OK  Frame        : 16 
    Broadcast data OK   Frame        : 0 
    Unicast data OK   Frames         : 0 
    Multicast Control Frames         : 0 
    Broadcast Control Frames         : 0 
    Unicast Control Frames           : 0 
    Pause Control Frames             : 0 
    Data and padding octets          : 800 
    Frame octets                     : 1088 
    --------------------------------------
    Info: RX and TX packet counts match 
    --------------------------------------
    Traffic test passed! 
     
    Assert EIO reset
    Wait reset ack (assert) -----
    Reset acknowledged
    Value from issp reset probe is 0x0 
    
    -----------------------------------------------------------
    Setup DR reconfiguration: 10G_fec -> 10G_nofec
    Configuring DR Profile 10G_nofec....
    Trigger DR interrupt
    Wait for DR interrupt Ack....
    DR Request acknowledged
    
    Wait for DR reconfig to be done....
    DR reconfig done, check for  DR errors
    NO DR Errors found
    
    Deassert EIO reset
    Wait reset ack (deassert) -----
    Reset acknowledged
    Value from issp reset probe is 0xff 
    
    Run traffic test (10G_nofec): 
    
    -------- Printing PHY status ---------
    --------------------------------------
    
     RX PHY Register Access: Checking Clock Frequencies (KHz)
          TXCLK 		:161130  (KHZ
          RXCLK 		:161130  (KHZ
    
     TX PLL Lock Status          0x00000001 
    
     Rx Frequency Lock Status    0x00000001
     RX PCS Ready                0x1
     TX Lanes Stable             0x1
     Deskewed Status             0x0 
     Link Fault Status           0x00000000
     Rx Frame Error              0x00000000
     Rx AM LOCK Condition        0x00000000 
    
    --- Initialize PKT ROM Read address ----
    --------- Sending packets... ---------
    --------------------------------------
     ================================================================================
                            STATISTICS FOR BASE 0x50000 (RX)                         
     ================================================================================
    Fragmented Frames                : 0 
    Jabbered Frames                  : 0 
    Any Size with FCS Err Frame      : 0 
    Right Size with FCS Err Fra      : 0 
    Multicast data  Err Frames       : 0 
    Broadcast data Err  Frames       : 0 
    Unicast data Err  Frames         : 0 
    Multicast control  Err Frame     : 0 
    Broadcast control Err  Frame     : 0 
    Unicast control Err  Frames      : 0 
    Pause control Err  Frames        : 0 
    64 Byte Frames                   : 0 
    65 - 127 Byte Frames             : 16 
    128 - 255 Byte Frames            : 0 
    256 - 511 Byte Frames            : 0 
    512 - 1023 Byte Frames           : 0 
    1024 - 1518 Byte Frames          : 0 
    1519 - MAX Byte Frames           : 0 
    > MAX Byte Frames                : 0 
    Rx Frame Starts                  : 16 
    Multicast data  OK  Frame        : 16 
    Broadcast data OK   Frame        : 0 
    Unicast data OK   Frames         : 0 
    Multicast Control Frames         : 0 
    Broadcast Control Frames         : 0 
    Unicast Control Frames           : 0 
    Pause Control Frames             : 0 
    Data and padding octets          : 800 
    Frame octets                     : 1088 
     ===========================================================================
                            STATISTICS FOR BASE 0x50000 (TX)                     
     ============================================================================
    Fragmented Frames                : 0 
    Jabbered Frames                  : 0 
    Any Size with FCS Err Frame      : 0 
    Right Size with FCS Err Fra      : 0 
    Multicast data  Err Frames       : 0 
    Broadcast data Err  Frames       : 0 
    Unicast data Err  Frames         : 0 
    Multicast control  Err Frame     : 0 
    Broadcast control Err  Frame     : 0 
    Unicast control Err  Frames      : 0 
    Pause control Err  Frames        : 0 
    64 Byte Frames                   : 0 
    65 - 127 Byte Frames             : 16 
    128 - 255 Byte Frames            : 0 
    256 - 511 Byte Frames            : 0 
    512 - 1023 Byte Frames           : 0 
    1024 - 1518 Byte Frames          : 0 
    1519 - MAX Byte Frames           : 0 
    > MAX Byte Frames                : 0 
    Tx Frame Starts                  : 16 
    Multicast data  OK  Frame        : 16 
    Broadcast data OK   Frame        : 0 
    Unicast data OK   Frames         : 0 
    Multicast Control Frames         : 0 
    Broadcast Control Frames         : 0 
    Unicast Control Frames           : 0 
    Pause Control Frames             : 0 
    Data and padding octets          : 800 
    Frame octets                     : 1088 
    --------------------------------------
    Info: RX and TX packet counts match 
    --------------------------------------
    Traffic test passed! 
     
    Closed JTAG Master Service
    End of dr_test: 
    DR Test Passed