Agilex™ 7 SEU Mitigation User Guide

Download PDF
ID 683128
Date 10/10/2025
Public
Document Table of Contents
Document Table of Contents x
1. Agilex™ 7 SEU Mitigation Overview 2. Agilex™ 7 CRAM Error Mitigation 3. Secure Device Manager ECC and SmartVID Errors Detection 4. Agilex™ 7 SEU Mitigation Implementation Guides 5. IP and Software References 6. Agilex™ 7 SEU Mitigation User Guide Archives 7. Document Revision History for the Agilex™ 7 SEU Mitigation User Guide
1. Agilex™ 7 SEU Mitigation Overview x
1.1. SEU Mitigation Techniques 1.2. Configuration RAM 1.3. Memory Blocks 1.4. Secure Device Manager ECC and SmartVID 1.5. Triple Modular Redundancy 1.6. Failure Rates
2. Agilex™ 7 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.3. Scrubbing x
2.3.1. Internal Scrubbing 2.3.2. Priority 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 and SmartVID Errors Detection x
3.1. SDM ECC Error Message Bits 3.2. SmartVID Error Message Bits 3.3. SDM ECC and SmartVID Error Signals Behavior
4. Agilex™ 7 SEU Mitigation Implementation Guides x
4.1. Setting the SEU_ERROR Pin 4.2. Setting Up the SEU Mitigation Features 4.3. Enabling Priority Scrubbing 4.4. Assigning Regions for Hierarchy Tagging 4.5. Sensitivity Map Header 4.6. Using the Fault Injection Debugger 4.7. Fault Injection and Read EMQ via HPS
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. Injecting Errors to Random Locations 4.6.6. Injecting Errors to Specific Locations 4.6.7. Injecting Double Adjacent Errors 4.6.8. Injecting SDM ECC Errors 4.6.9. 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 Error to Predefined Safe Locations: Mailbox Command
4.6.7. Injecting Double Adjacent Errors x
4.6.7.1. Injecting Double Adjacent Errors: Command-Line Interface 4.6.7.2. Injecting Double Adjacent Errors: GUI with Tcl Console
4.6.8. Injecting SDM ECC Errors x
4.6.8.1. Injecting SDM ECC Errors: Command-Line Interface 4.6.8.2. Injecting SDM ECC Errors: GUI
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™ 7 SEU Mitigation Overview
2. Agilex™ 7 CRAM Error Mitigation
3. Secure Device Manager ECC and SmartVID Errors Detection
4. Agilex™ 7 SEU Mitigation Implementation Guides
5. IP and Software References
6. Agilex™ 7 SEU Mitigation User Guide Archives
7. Document Revision History for the Agilex™ 7 SEU Mitigation User Guide

4.7. Fault Injection and Read EMQ via HPS

This section provides the steps to perform fault injection via HPS Linux or Fault Injection Debugger tool and retrieve the Error Message Queue (EMQ) content from the HPS interrupt message in the HPS Linux.
Note: Before you begin, use the Golden System Reference Design (GSRD) design and ensure that it can boot up successfully.
  1. Download the Agilex™ 7 Golden Hardware Reference Design (GHRD) Quartus project.
  2. To turn on the SEU setting:

    Turn on Enable error detection check, Allow SEU fault injection, and Enable internal scrubbing setting in the Device and Pin Options dialog box in the Quartus® Prime software. Recompile the design and obtain the .sof file with the SEU setting enabled.

  3. To add FSBL into .sof file, run the quartus_pfg command with the following syntax in the command-line. 
    quartus_pfg -c <input_hps>.sof  <update>.sof -o hps_path=<u-boot-spl-dtb>.hex
  4. Program the <update>.sof file by using Quartus Programmer or Fault Injection Debugger tool.
  5. Inject the error at the predefined location using one of the following methods:
    • Using the Fault Injection Debugger tool with JTAG connection: Send the INSERT_SAFE_SEU_ERROR [0x41] mailbox command to initiate the fault injection.
    • Using HPS Linux: Run the following command in the HPS Linux console to perform the fault injection.
      echo C > /sys/kernel/debug/edac/cram-seu/altr-trigger
  6. Observe the the SEU interrupt message in HPS UART print out.
    For example: 
    EDAC Altera: SEU CE: Count =0x1, SecAddr=0x30000, ErrData=0x300740C9
  7. Decode the response by referring to Error Message Bit description.
    For example:
    SecAddr = 0x30000 refers to the SEU error at sector 0x3, ErrData = 0x300740C9 refers to the corrected single bit error at bit position 0x3A, frame 0xC9.
Related Information
Level Two Title