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

3. Document Revision History for AN 955: Programmer’s Configuration Debugger Tool

Document Version Changes
2025.09.29 Added support for Virtual Hardware, to match support available in Quartus® Prime Design Suite version 25.3.
2025.04.07 Updated to match support available in Quartus® Prime Design Suite version 25.1:
  • Added the following to the list of supported devices
    • Agilex™ 3
    • Agilex™ 9
2025.01.23 Added support for the following components, to match support available in Quartus® Prime Design Suite version 24.3.1:
  • VR Diagnostic
  • VR Telemetry
2024.04.01 Updated to match support available in Quartus® Prime Design Suite version 24.1.
  • Added Agilex™ 5 to list of supported devices.
  • Replaced screenshot and added step to select Chip Select pin to the following sections:
    • Performing QSPI Flash Debugging
    • Reading the QSPI Controller Settings and SFDP Values
    • Performing Remote System Update Debugging
2023.12.04 Updated the Reading Device Information from SDM-Based Devices section to match GUI.
2023.10.02 Updated to match support available in Quartus® Prime Design Suite version 23.3.
  • In the Reading Device Information from SDM-Based Devices section:
    • Updated step 4 to add Debug Suggestion.
    • Updated the Device Information for SDM-Based Devices figure.
  • In the Performing Remote System Update Debugging section.
    • Updated step 10 to add Error Message and Debug Suggestion.
    • Updated the Remote System Update figure.
  • Renamed Hardware Processor System (HPS) Cold Reset to Hard Processor System (HPS) Cold Reset.
  • Renamed Performing Hardware Processor System (HPS) Cold Reset to Performing Hard Processor System (HPS) Cold Reset.
  • In the Performing Hard Processor System (HPS) Cold Reset section:
    • Added step 4 to select HPS Cold Reset.
    • Updated the Hard Processor System (HPS) Cold Reset figure.
2023.06.26 Updated to match support available in Quartus® Prime Design Suite version 23.2.
  • Added new section: QSPI Controller Settings and SFDP Values
  • Updated content to support QSPI debugging in the following sections:
    • Debugging Tool Components
    • Debugging QSPI Flash
2023.04.10
  • Updated to match support available in Quartus® Prime Design Suite version 23.1.
    • Added Hardware Processor System (HPS) Cold Reset, and Debug Log information:
      • Updated Debugging Tool Components topic.
      • Updated Programming File Info figure.
      • Updated Device Information for SDM-Based Devices figure.
      • Updated Voltage Sensor Measurement figure.
      • Updated Temperature Sensor Measurement figure.
      • Added a new topic: Hardware Processor System (HPS) Cold Reset and Performing Hardware Processor System (HPS) Cold Reset.
      • Added a new topic: Debug Log and Getting the Debug Log.
      • Changed Sending SDM Mailbox Command topic name to SDM Mailbox Command.
      • Added a note in SDM Mailbox Command topic.
      • Added a new topic: Sending SDM Mailbox Command.
  • Updated product family name to " Intel Agilex® 7".
2022.09.26 Updated to match support available in Quartus® Prime Design Suite version 22.3.
  • Removed the Updated for Quartus® Prime Design Suite version number on front cover.
  • Updated step 4 in Reading Device Information from SDM-Based Devices to elaborate on Chip ID and to expand Configuration Pin Signals.
  • Re-organized content in chapter: Debugging Tools Components
    • Moved Parsing Programming Files to be the first sub-section for the chapter.
    • Added the following sections: JIC File Information, RPD File Information, POF File Information, Getting Voltage Measurement, Reading Voltage Measurement, Getting Temperature Measurement, Reading Temperature Measurement, and Sending SDM Mailbox Command.
2022.05.23 Updated to match support available in Quartus® Prime Design Suite version 22.1.
  • Added supported legacy devices to Programmer’s Configuration Debugger Tool.
  • Added information and instructions for legacy device support to Getting Device Information.
2021.11.04 Initial release.
Level Two Title