R-Tile Avalon® Streaming Intel® FPGA IP for PCI Express* User Guide

ID 683501
Date 4/10/2024
Document Table of Contents

6.6.1. Overview

The R-Tile Debug Toolkit (DTK) is a System Console-based tool for R-Tile that provides real-time control, monitoring and debugging of the PCIe links.

The R-Tile Debug Toolkit allows you to perform the following actions on a per port basis:
  • Monitor the IP configuration and the link status.
  • Monitor the PCIe Configuration space.
  • Monitor different counters for errors and event conditions.
  • Perform Time margin (horizontal) and Voltage margin (vertical) and compare margin values against recommended masks for each channel.
Note: If implementing temperature monitoring, the Application logic must prevent a temperature readout to the R-Tile temperature sensing diode (TSD) while the Debug Toolkit GUI is open. Refer to the Agilex™ 7 F-Series and I-Series Power Management User Guide for additional information.
Overview of the R-Tile Debug Toolkit below describes the 3 main components that are active when you are using the Debug Toolkit:
  • Host: The link partner component connected to R-Tile through a PCIe link.
  • Agilex™ 7 I-Series FPGA: This component includes the R-Tile PCIe IP under debug.
  • Debug PC Station: An additional computer system with the Quartus® Prime Pro Edition software installed which is running the Debug Toolkit and is connected to the Agilex™ 7 I-Series FPGA through a JTAG connection.
Figure 63. Overview of the R-Tile Debug Toolkit

When you enable the R-Tile Debug Toolkit, the intel_rtile_pcie_ast module of the generated IP includes the Debug Toolkit modules and related logic as shown in Debug Toolkit Arbitration.

The Debug PC Station that is running the System Console tool connects to the Debug Toolkit via a Native PHY Debug Master Endpoint (NPDME). This connection is made using JTAG through an Intel FPGA Download Cable.

When you enable the R-Tile Debug Toolkit in the IP Parameter Editor, the Hard IP Reconfiguration Interface will be enabled. A multiplexer is implemented to allow a dynamic switching between the Application logic and the Debug Toolkit. The Application logic has the default access. Upon launching the Debug Toolkit in the System Console tool, the arbitration selection happens automatically. While the DTK is open in the System Console, Application logic will not be able to drive signals on the Hard IP Reconfiguration Interface. Once the Debug Toolkit window in the System Console is closed, the Application logic can once again drive the Hard IP Reconfiguration Interface.

To make sure there are no transactions in progress, the Debug Toolkit can be launched successfully only if there is no pending Read or Write transaction made by the Application logic on the Hard IP Reconfiguration Interface.

Note: The System Console message window will show an error message indicating there is an ongoing request, and the Debug Toolkit cannot be launched.
Figure 64. Debug Toolkit Arbitration