1G/2.5G/5G/10G Multirate Ethernet PHY IP User Guide: Agilex™ 3 and Agilex™ 5 FPGAs and SoCs

ID 813667
Date 10/24/2025
Public
Document Table of Contents

7.1. Troubleshooting Checklist

Table 32.  Troubleshooting Checklist
Issue Troubleshooting Checklist
The ethernet link fails to come up

Follow these troubleshooting steps to resolve the issue:

  • Review the IP configuration in the parameter editor to ensure it matches the requirements.
  • Perform external loopback test.
  • Perform serial internal loopback test.
  • The following status signals should go high once the RX reset is successfully completed:
    • MGBASE variant: rx_ready, tx_ready, led_link, and o_rx_block_lock.
    • NBASE variant: o_rx_pcs_ready and o_tx_lanes_stable.
  • Confirm that all required reset inputs are properly driven as described in the Reset Sequence.
  • Confirm that all specified clock inputs are correct as described in the Clocking.
Ethernet link is unstable

Follow these troubleshooting steps to resolve the issue:

  • Review the IP configuration in the parameter editor to ensure it matches the requirements.
  • Perform external loopback test.
  • Perform serial internal loopback test.
  • Check that the PMA analog settings in the parameter editor are configured according to the specified link profile.
  • Verify that tx_clkout and rx_clkout are as expected for MGBASE and NBASE design variants.
Ethernet link high-bit error rate

Follow these troubleshooting steps to resolve the issue:

  • Review the IP configuration in the parameter editor to ensure it matches the requirements.
  • Perform external loopback test.
  • Perform serial internal loopback test.
  • Check that the PMA analog settings in the parameter editor are configured according to the specified link profile.
Missing ethernet packets at the receiver side.

Follow these troubleshooting steps to resolve the issue:

  • Review the IP configuration in the parameter editor to ensure it matches the requirements.
  • Verify that the reference clock value provided in hardware matches the value specified in the 1G/2.5G/5G/10G Multirate Ethernet PHY IP. For clocking requirements specific to variants, refer to Clocking.
  • Perform serial internal loopback test.
  • Check that the PMA analog settings in the parameter editor are configured according to the specified link profile.
The IP is not responding to the data flow Follow these troubleshooting steps to resolve the issue:
  • Review the IP configuration in the parameter editor to ensure it matches the requirements.
  • Monitor the Avalon® memory-mapped interface and Avalon® streaming interface control and status signals.