AN 955: Programmer’s Configuration Debugger Tool

Download PDF
ID 691274
Date 4/07/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 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.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
1. Programmer’s Configuration Debugger Tool
2. Debugging Tool Components
3. Document Revision History for AN 955: Programmer’s Configuration Debugger Tool

2.11. VR Diagnostic

The debugger tool supports the Power Management Firmware (PMF) Voltage Regulator (VR) diagnostic flow, which includes the following tests:
  • DIAG_OV_FAULT_LIMIT_TEST
  • DIAG_OV_WARN_LIMIT_TEST
  • DIAG_UV_WARN_LIMIT_TEST
  • DIAG_UV_FAULT_LIMIT_TEST
  • DIAG_VOUT_MAX_TEST
  • DIAG_VADC_XCHECK_POR_TEST
  • DIAG_VADC_XCHECK_BUMP_TEST
  • DIAG_VADC_XCHECK_MIN_MAX_TEST

Before running the VR diagnostic test, you must first follow these steps:

  1. Go to Device and Pin Options > Power Management & VID > More Options... and then check the Diagnostic Boot checkbox. Click OK.
  2. Compile the design to create the .sof file with the VR diagnostic feature enabled.
  3. Program the .sof file onto the device to run the diagnostic test.

The diagnostic boot feature performs additional checks of the configuration and operation of the voltage regulator. This feature adds to the configuration time and should be enabled during the board bring-up operations.

Note: This feature is only supported on Agilex™ 5 devices with SmartVID standard power devices.

Section Content
Performing VR Diagnostic

Level Two Title