AN 955: Programmer’s Configuration Debugger Tool

Download PDF
ID 691274
Date 9/29/2025
Public
Document Table of Contents
Document Table of Contents x
1. Programmer’s Configuration Debugger Tool 2. Debugging Tool Components 3. Document Revision History for AN 955: Programmer’s Configuration Debugger Tool
1. Programmer’s Configuration Debugger Tool x
1.1. Launching the Debugger Tool
2. Debugging Tool Components x
2.1. Parsing Programming Files 2.2. Getting Device Information 2.3. Debugging QSPI Flash 2.4. QSPI Controller Settings and SFDP Values 2.5. Debugging Remote System Update 2.6. Voltage Sensor Monitoring 2.7. Temperature Sensor Monitoring 2.8. Hard Processor System (HPS) Cold Reset 2.9. Debug Log 2.10. SDM Mailbox Command 2.11. VR Diagnostic 2.12. VR Telemetry 2.13. Virtual Hardware
2.1. Parsing Programming Files x
2.1.1. Reading Programming File Information 2.1.2. Parsing Program Files Command Option 2.1.3. Programming File Formats
2.1.3. Programming File Formats x
2.1.3.1. SOF File Information 2.1.3.2. RBF File Information 2.1.3.3. PMSF File Information 2.1.3.4. JIC File Information 2.1.3.5. RPD File Information 2.1.3.6. POF File Information
2.2. Getting Device Information x
2.2.1. Reading Device Information from SDM-Based Devices 2.2.2. Reading Device Information from Legacy Devices
2.3. Debugging QSPI Flash x
2.3.1. Performing QSPI Flash Debugging
2.4. QSPI Controller Settings and SFDP Values x
2.4.1. Reading the QSPI Controller Settings and SFDP Values
2.4.1. Reading the QSPI Controller Settings and SFDP Values x
2.4.1.1. QSPI Flash Debugging Use Cases
2.5. Debugging Remote System Update x
2.5.1. Performing Remote System Update Debugging
2.6. Voltage Sensor Monitoring x
2.6.1. Reading Voltage Measurement
2.7. Temperature Sensor Monitoring x
2.7.1. Reading Temperature Measurement
2.8. Hard Processor System (HPS) Cold Reset x
2.8.1. Performing Hard Processor System (HPS) Cold Reset
2.9. Debug Log x
2.9.1. Getting the Debug Log
2.10. SDM Mailbox Command x
2.10.1. Sending SDM Mailbox Command 2.10.2. Command Options for Sending SDM Mailbox Command
2.11. VR Diagnostic x
2.11.1. Performing VR Diagnostic
2.12. VR Telemetry x
2.12.1. Performing VR Telemetry
2.13. Virtual Hardware x
2.13.1. Virtual Hardware Expected Behavior 2.13.2. Accessing Virtual Hardware
2.13.2. Accessing Virtual Hardware x
2.13.2.1. Reading Programming File Information from Virtual Hardware 2.13.2.2. Reading Device Information from Virtual Hardware 2.13.2.3. Accessing Flash Memory Attached to Virtual Hardware 2.13.2.4. Performing RSU with Virtual Hardware 2.13.2.5. Reading Voltage Sensor Measurement from Virtual Hardware 2.13.2.6. Reading Temperature Sensor Measurement from Virtual Hardware 2.13.2.7. Sending SDM Mailbox Commands with Virtual Hardware
1. Programmer’s Configuration Debugger Tool
2. Debugging Tool Components
3. Document Revision History for AN 955: Programmer’s Configuration Debugger Tool

1. Programmer’s Configuration Debugger Tool

This application note describes the configuration debugger tool for debugging programming and configuration issues on secure device manager (SDM) based devices and legacy devices. This tool is supported in Quartus® Prime Pro Edition Programmer version 21.3 onwards.
Table 1.  Supported Devices by Architecture Type
Architecture Type Device Families
SDM-based Agilex™ FPGA portfolio:
  • Agilex™ 3
  • Agilex™ 5
  • Agilex™ 7
  • Agilex™ 9
Stratix® 10
eASIC™ N5X
Control block-based Stratix® V
Arria® V (including SoC devices)
Cyclone® V (including SoC devices
Arria® 10 (including SoC devices)

Section Content
Launching the Debugger Tool

Level Two Title