Knowledge Base Article
Why the Error Injection using Linux debugfs interface causes SError and kernel panic on Agilex® 5 Ethernet ECC?
Description
Due to a problem in the EDAC (Error Detection and Correction) driver, Error Injection using the Linux debugfs interface on Agilex® 5 Ethernet ECC can cause a fatal SError and kernel panic.
The error injection command below logs a correctable error (CE), then panics:
echo c > /sys/kernel/debug/edac/emac2-tx-ecc/altr_trigger
Example symptomatic prints:
- SError Interrupt on CPU..., far: 0xbe000411
- Kernel panic - not syncing: Asynchronous SError Interrupt
The same path can also affect other Port-A-only ECC blocks that use the INTTEST register (for example emac*, usb1*, and ocram uncorrectable inject).
This issue is impacting Agilex® 5 SoC FPGA devices and Quartus® Prime software of version 26.1.1 (Images that include the ES-406 unconditional INTTEST Port B write) until the fix below is present.
Resolution
To workaround this issue for 26.1.1 release, apply the patch by following the instructions below:
1. git clone the repo altera-fpga/linux-socfpga: Linux development repository for socfpga
2. git checkout socfpga-6.18.20-lts
3. run: git format-patch to get the patch
Make sure the commit is included in the patch: ES-14714: EDAC/altera: skip INTTEST Port B write when unused · altera-fpga/linux-socfpga@7726132
e.g Using commit ID for - ES-14714: EDAC/altera: skip INTTEST Port B write when unused
git format-patch -1 772613293c40ce9051798847682c262e59b37243
4. Use “git am” to apply the patch onto your source code.