2.13. Virtual Hardware

AN 955: Programmer’s Configuration Debugger Tool

Download PDF

ID 691274

Date 9/29/2025

Version

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

1.1. Launching the Debugger Tool

2. Debugging Tool Components

2.1. Parsing Programming Files

2.1.1. Reading Programming File Information

2.1.2. Parsing Program Files Command Option

2.1.3. Programming File Formats

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

2.2.1. Reading Device Information from SDM-Based Devices

2.2.2. Reading Device Information from Legacy Devices

2.3. Debugging QSPI Flash

2.3.1. Performing QSPI Flash Debugging

2.4. QSPI Controller Settings and SFDP Values

2.4.1. Reading the QSPI Controller Settings and SFDP Values

2.4.1.1. QSPI Flash Debugging Use Cases

2.5. Debugging Remote System Update

2.5.1. Performing Remote System Update Debugging

2.6. Voltage Sensor Monitoring

2.6.1. Reading Voltage Measurement

2.7. Temperature Sensor Monitoring

2.7.1. Reading Temperature Measurement

2.8. Hard Processor System (HPS) Cold Reset

2.8.1. Performing Hard Processor System (HPS) Cold Reset

2.9. Debug Log

2.9.1. Getting the Debug Log

2.10. SDM Mailbox Command

2.10.1. Sending SDM Mailbox Command

2.10.2. Command Options for Sending SDM Mailbox Command

2.11. VR Diagnostic

2.11.1. Performing VR Diagnostic

2.12. VR Telemetry

2.12.1. Performing VR Telemetry

2.13. Virtual Hardware

2.13.1. Virtual Hardware Expected Behavior

2.13.2. Accessing Virtual Hardware

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

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

2.13. Virtual Hardware

Virtual hardware provides an introductory platform for new users to learn the basics of working with FPGAs and gain hands-on experience in a simulated environment. This allows to explore FPGA interactions and behaviours during debugging programming and configuration process using debugger tool, all before accessing a physical device.

The virtual device emulates the Agilex™ 5 device (OPN A5EA008BB23BE4S) with a 128 Mb flash memory, offering a practical and straightforward platform for foundational learning.

By connecting to the debugger tool, users can access the following essential features that facilitate an easy and comprehensive introduction to FPGA technology.

Parse programming file for the virtual device
Obtain virtual device information
Access QSPI flash memory attached to the virtual device
Perform RSU operations
Read voltage sensor
Read temperature sensor
Send basic SDM mailbox commands, as listed below:
- GET_IDCODE
- GET_CHIPID
- GET_USERCODE
- GET_VOLTAGE
- GET_TEMPERATURE
- CONFIG_STATUS
- QSPI_OPEN
- QSPI_SET_CS
- QSPI_READ
- QSPI_WRITE
- QSPI_ERASE
- QSPI_CLOSE
- RSU_IMAGE_UPDATE
- RSU_STATUS