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
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.2.1. Reading Device Information from SDM-Based Devices

To read device information:
  1. Click Hardware Setup to select the hardware setup to use for debugging.
  2. Click Load Device and select a device from the drop-down list if more than one device exists in the hardware setup.
  3. Click Device Info for device information reading.
    Note: The Device Info tab is disabled if the selected device is not supported.
  4. Click Read Device Info to read device information from the selected device.
    • Device Info
      • Device Name
      • JTAG ID
      • Chip ID returns the right-most word (least significant word) first, then followed by the left-most word (most significant word). For example, Chip ID 0x09BC714B192E3671, begins with 0x192E3671 which is the least significant word and then followed by 0x09BC714B which is the most significant word.
      • Click List of OPN to display all the possible OPNs with the same JTAG ID.
    • Configuration Status:
      • State provides the most recent device configuration states.
      • Clock Source
      • VID indicates VID enablement status.
    • Pin Signals
      • Most recent device configuration states.
      • MSEL value latched by the device at power-up.
    • Soft Function Status provides the value for each soft function, even if you have not assigned the function to an SDM pin.
      Note: Refer to the Soft Function Description table for more details on soft function description.
    • Configuration Error
      • Error Message provides the corresponding error messages when an error occurs.
      • Debug Suggestion provides the corresponding actions that can be taken to resolve the error.
      • Major Error Code provides the major error code for the most recent configuration related error.
      • Major Error Type provides the corresponding error type for the major error code.
      • Minor Error Code provides the minor error code for the most recent configuration related error.
      • Minor Error Type provides the corresponding error type for the minor error code.
      • Error Location provides an approximate location of error occurrence in the bitstream. The error location status is helpful when an error occurs in the debugger tool.
      • Error Detail provides more information as to where the error has occurred. The error detail status is helpful in conjunction with the error location.
  5. Click Clear when you want to reset the page.
Figure 4. Device Information for SDM-Based Devices
Table 2.  Soft Function Description
Soft Function Description
CONF_DONE The function status goes high, indicating all configuration data is received.
CVP_DONE The function status goes high, indicating the device has received the complete bitstream during configuration via protocol (CvP) core image configuration.
INIT_DONE

The function status goes high, indicating the device enters the user mode upon completion of configuration.
SEU_ERROR

The function status goes high, indicating an SEU error message inside the SEU error queue.
HPS_COLDRESET The function status goes high, indicating that HPS is in cold reset.
HPS_WARMRESET The function status goes high, indicating that HPS is in warm reset.
POR_WAIT The function status goes high, indicating the device is waiting for a power cycle.
PROVISION_CMF The function status goes high, indicating the device is running in provision firmware.
CMF_TRANSITION_DISABLED The function status goes high, indicating the device reconfiguration is disabled. You must power cycle the device to recover.
Level Two Title