AN 955: Programmer’s Configuration Debugger Tool

Download PDF
ID 691274
Date 4/01/2024
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 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.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 Read Flash Register in Advance Mode Change Command Mode from QPI Mode (4-4-4) to SPI Mode (1-1-1) Change Command Mode from QPI Mode (4-4-4) to Dual I/O Mode (2-2-2)
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
1. Programmer’s Configuration Debugger Tool
2. Debugging Tool Components
3. Document Revision History for AN 955: Programmer’s Configuration Debugger Tool

2.4.1.1. QSPI Flash Debugging Use Cases

Examples of QSPI flash debugging use cases for Agilex™ 7 devices with Micron Flash MT25QU02G.

Read Flash Register in Advance Mode

  1. On the QSPI Flash tab, select the Advance Mode checkbox to enable advance mode. The advance mode fields are made visible on the interface.
  2. Specify the number of bytes, OPCODE, address mode, and dummy clock cycles, then click Read Registers to retrieve the flash register value.

    The SFDP signature 0x50444653 is displayed in the Session Log.

Change Command Mode from QPI Mode (4-4-4) to SPI Mode (1-1-1)

  1. On the QSPI Controller and SFDP tab, click Activate to activate a QSPI debug session.
  2. Click Read to retrieve the current settings for the QSPI controller. The Command Mode parameter shows (4-4-4).
  3. In the Mailbox Client window, enter Parameter List with 0xF5, and click Send. This switches the command mode to SPI mode.
    Note: Refer to SDM Mailbox Command for more details about the Mailbox Client window.
  4. Click the QSPI Controller and SFDP tab. Under the Update Controller Settings, set Command Mode as (1-1-1). Click Submit. Your controller mode is changed to SPI mode (1-1-1).
  5. Click Read and verify that the Command Mode shows (1-1-1).
  6. Click Deactivate to end the session.

Change Command Mode from QPI Mode (4-4-4) to Dual I/O Mode (2-2-2)

This procedure requires changing the command mode for the QSPI device and the QSPI controller.

  1. On the QSPI Controller and SFDP tab, click Activate to activate a QSPI debug session.
  2. Verify the current command mode. On the QSPI Flash tab, select Number of Bytes as 1 and enter OPCODE with 0x65, and click Read Registers.

    The register shall return value of 0x7F indicating the QSPI device is in QPI mode.

  3. In the Mailbox Client window, enter Command Code with 0x36, enter Parameter List with 0x61 0x1 0xBF, and click Send. This changes the enhanced volatile configuration register (1 byte) to 0xBF.
    Note: Refer to SDM Mailbox Command for more details about the Mailbox Client window.
  4. On the QSPI Flash tab, select Number of Bytes as 1, enter OPCODE as 0x65, and click Read Registers. The register shall return value of 0x00.

    At this point the command mode is out of sync. The QSPI device is configured with dual I/O mode but the controller remains in QPI mode.

  5. On the QSPI Controller and SFDP tab, select Command Mode as (2-2-2) and click Configure. The QSPI controller is now in dual I/O mode.
  6. Click Read and verify that the Command Mode shows (2-2-2).
  7. On the QSPI Flash tab, select Number of Bytes as 1, enter OPCODE as 0x65, and click Read Registers. The register shall return value of 0xBF indicating the QSPI device's command mode has been changed to dual I/O mode.
  8. Click Deactivate to end the session.
Level Two Title