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 Example 1. Sending an NOOP [0x0] Command Example 2. Sending a CONFIG_STATUS [0x4] Command Example 3. Sending a QSPI 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

2.10.2. Command Options for Sending SDM Mailbox Command

Table 9.  New Command Options for Sending SDM Mailbox Command
Options Type Description
cmd_code Required Option to specify the SDM mailbox command code. The input value is an 11-bit command code. The tool formats the code into a valid header.
cmd_param Optional Option to specify the SDM mailbox command parameters. The input value can be a single word or a list of words.

Example 1. Sending an NOOP [0x0] Command

Command: 
quartus_pgm -c 2 -m jtag --cmd_code=0x0
Example of response returned: 
Command:
       00001000
Response:
       00000000

Example 2. Sending a CONFIG_STATUS [0x4] Command

Command:

quartus_pgm -c 2 -m jtag --cmd_code=0x4

Example of response returned:

Command:
       00001004
Response:
       00006000
       00000000
       00150300
       C000000F
       0000000B
       00000000
       00000000

Example 3. Sending a QSPI Command

i. Executing QSPI_OPEN command (0x32):

quartus_pgm -c 2 -m jtag --cmd_code=0x32

Example of response returned:

Command:
        00001032
Response:
        00000000

ii. Executing QSPI_SET_CS command (0x34) with 1 command parameter:

quartus_pgm -c 2 -m jtag --cmd_code=0x34 –cmd_param=”0x0”

Example of response returned:

Command:
        00003034
        00000000
Response:
        00000000

iii. Executing QSPI_READ command (0x3A) with 2 command parameters:

quartus_pgm -c 2 -m jtag --cmd_code=0x3A –cmd_param=”0x0 0x5”

Example of response returned:

Command:
        0000303A
        00000000
        00000005
Response:
        00005000
        62294895
        00000030
        00000400
        00000000
        00000000

iv. Executing QSPI_CLOSE command (0x33):

quartus_pgm -c 2 -m jtag --cmd_code=0x33

Example of response returned:

Command:
        00001033
Response:
        00000000
Related Information
Level Two Title