Agilex™ 7 Hard Processor System Technical Reference Manual

ID 683567
Date 10/31/2025
Public
Document Table of Contents

3.5.15.5. Program Trace

Each processor has an independent program trace monitor (PTM) that provides real-time instruction flow trace. The PTM is compatible with a number of third-party debugging tools.

The PTM provides trace data in a highly compressed format. The trace data includes tags for specific points in the program execution flow, called waypoints. Waypoints are specific events or changes in the program flow.

The PTM recognizes and tags the waypoints listed in the Waypoints Supported by the PTM table.

Table 38.  Waypoints Supported by the PTM
Type Additional Waypoint Information
Indirect branches Target address and condition code
Direct branches Condition code
Instruction barrier instructions
Exceptions Location where the exception occurred
Changes in processor instruction set state
Changes in processor security state
Context ID changes
Entry to and return from debug state when Halting debug mode is enabled

The PTM optionally provides additional information for waypoints, including the following:

  • Processor cycle count between waypoints
  • Global timestamp values
  • Target addresses for direct branches