SEU Mitigation User Guide: Agilex™ 3 FPGAs and SoCs

Download PDF
ID 846231
Date 4/07/2025
Public
Document Table of Contents
Document Table of Contents x
1. Agilex™ 3 SEU Mitigation Overview 2. Agilex™ 3 CRAM Error Mitigation 3. Secure Device Manager ECC Error Detection 4. Agilex™ 3 SEU Mitigation Implementation Guides 5. IP and Software References 6. Document Revision History for the SEU Mitigation User Guide: Agilex™ 3 FPGAs and SoCs
1. Agilex™ 3 SEU Mitigation Overview x
1.1. SEU Mitigation Techniques 1.2. Configuration RAM 1.3. Memory Blocks 1.4. Secure Device Manager ECC Error 1.5. Triple Modular Redundancy 1.6. Failure Rates
2. Agilex™ 3 CRAM Error Mitigation x
2.1. CRAM Error Detection and Correction 2.2. Error Message Queue 2.3. Scrubbing 2.4. SEU Sensitivity Processing 2.5. Design Hierarchy Sensitivity Classification 2.6. Evaluation of System Response to Upsets 2.7. Retrieving SEU Statistics using Mailbox Command
2.2. Error Message Queue x
2.2.1. SEU_ERROR Pin Behavior 2.2.2. Retrieving the Error Message Queue Contents Through Mailbox Command 2.2.3. Retrieving the Error Message Queue Content Using the HPS SDM Mailbox 2.2.4. Error Message Queue Bit Description
2.3. Scrubbing x
2.3.1. Internal Scrubbing 2.3.2. External Scrubbing
2.4. SEU Sensitivity Processing x
2.4.1. Advanced SEU Detection IP
2.4.1. Advanced SEU Detection IP x
2.4.1.1. Release Information for Advanced SEU Detection IP 2.4.1.2. On-Chip Lookup Sensitivity Processing 2.4.1.3. Off-Chip Lookup Sensitivity Processing 2.4.1.4. Sensitivity Map Header Lookup
2.5. Design Hierarchy Sensitivity Classification x
2.5.1. Hierarchy Tagging
2.6. Evaluation of System Response to Upsets x
2.6.1. Fault Injection Debugger
3. Secure Device Manager ECC Error Detection x
3.1. SDM ECC Error Message Bits 3.2. SDM ECC Error Signals Behavior
4. Agilex™ 3 SEU Mitigation Implementation Guides x
4.1. Setting the SEU_ERROR Pin 4.2. Setting Up the SEU Mitigation Features 4.3. Performing External Scrubbing 4.4. Assigning Regions for Hierarchy Tagging 4.5. Sensitivity Map Header 4.6. Using the Fault Injection Debugger
4.5. Sensitivity Map Header x
4.5.1. Programming the .smh File into Memory 4.5.2. Looking up the Sensitivity Map Header
4.5.2. Looking up the Sensitivity Map Header x
4.5.2.1. Sensitivity Map Header Revision 4 File Format Reference
4.6. Using the Fault Injection Debugger x
4.6.1. Launching and Setting Up the Fault Injection Debugger 4.6.2. Configuring Your Device using a Software Object File (.sof) 4.6.3. Constraining Regions for Fault Injection 4.6.4. Injecting Errors to Predefined Safe Locations 4.6.5. Blowing Fuse Bit to Enable Injecting All Error Types 4.6.6. Injecting Errors to Random Locations 4.6.7. Injecting Errors to Specific Locations 4.6.8. Injecting Double Adjacent Errors 4.6.9. Injecting SDM ECC Errors 4.6.10. Analyzing SEU or SDM ECC Errors Using Signal Tap
4.6.4. Injecting Errors to Predefined Safe Locations x
4.6.4.1. Listing the Predefined Safe Locations: Command-Line Interface 4.6.4.2. Injecting Errors to Predefined Safe Locations: Command-Line Interface 4.6.4.3. Injecting Errors to Predefined Safe Locations: GUI with Tcl Console 4.6.4.4. Injecting Error to Predefined Safe Locations: Mailbox Command
4.6.8. Injecting Double Adjacent Errors x
4.6.8.1. Injecting Double Adjacent Errors: Command-Line Interface 4.6.8.2. Injecting Double Adjacent Errors: GUI with Tcl Console
4.6.9. Injecting SDM ECC Errors x
4.6.9.1. Injecting SDM ECC Errors: Command-Line Interface Examples of the quartus_fid Command 4.6.9.2. Injecting SDM ECC Errors: GUI with Tcl Console 4.6.9.3. Injecting SDM ECC Errors: Fault Injection Debugger 4.6.9.4. Injecting SDM ECC Errors: Mailbox Command
5. IP and Software References x
5.1. Advanced SEU Detection IP References 5.2. Fault Injection Debugger Software References
5.1. Advanced SEU Detection IP References x
5.1.1. Advanced SEU Detection IP Parameter Settings 5.1.2. Advanced SEU Detection IP Ports
5.2. Fault Injection Debugger Software References x
5.2.1. Fault Injection Debugger GUI Tool 5.2.2. Fault Injection Debugger Command-Line Interface
1. Agilex™ 3 SEU Mitigation Overview
2. Agilex™ 3 CRAM Error Mitigation
3. Secure Device Manager ECC Error Detection
4. Agilex™ 3 SEU Mitigation Implementation Guides
5. IP and Software References
6. Document Revision History for the SEU Mitigation User Guide: Agilex™ 3 FPGAs and SoCs

4.6.9.1. Injecting SDM ECC Errors: Command-Line Interface

In the command-line interface, run the quartus_fid command with the following syntax: 
quartus_fid -–cable=<cable_num> --index=@<device_num>=<sof_file> --number=<n> --ecc="@<device_num>=<sector_index> <RAM_ID>"

To list values for <sector_index> and RAM_ID, run: 

quartus_fid -c 1 -i "@1=<sof_file>" --ecc_list

The listed valid sector index and RAM_ID are in decimal. Convert the sector to hexadecimal format, when you use it in the mailbox command. For example, sector 10 is 0xA.

Figure 20. Example of Listed valid sector_index and RAM_ID for ECC Error

Examples of the quartus_fid Command 

  • quartus_fid --cable=1 --index=@1=test.sof --number=1 --ecc="@1=0x07 0x0"
  • quartus_fid -c 1 -i "@1=test.sof" -n 1 -e "@1=0x7 0x0"
Related Information
Level Two Title