| Intel Stratix10 Remote System Update (RSU) device attributes | |
| What: /sys/devices/platform/stratix10-rsu.0/current_image | |
| Date: August 2019 | |
| KernelVersion: 5.4 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (RO) the address in flash of currently running image. | |
| What: /sys/devices/platform/stratix10-rsu.0/fail_image | |
| Date: August 2019 | |
| KernelVersion: 5.4 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (RO) the address in flash of failed image. | |
| What: /sys/devices/platform/stratix10-rsu.0/state | |
| Date: August 2019 | |
| KernelVersion: 5.4 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (RO) the state of RSU system. | |
| The state field has two parts: major error code in | |
| upper 16 bits and minor error code in lower 16 bits. | |
| b[15:0] | |
| Currently used only when major error is 0xF006 | |
| (CPU watchdog timeout), in which case the minor | |
| error code is the value reported by CPU to | |
| firmware through the RSU notify command before | |
| the watchdog timeout occurs. | |
| b[31:16] | |
| 0xF001 bitstream error | |
| 0xF002 hardware access failure | |
| 0xF003 bitstream corruption | |
| 0xF004 internal error | |
| 0xF005 device error | |
| 0xF006 CPU watchdog timeout | |
| 0xF007 internal unknown error | |
| What: /sys/devices/platform/stratix10-rsu.0/version | |
| Date: August 2019 | |
| KernelVersion: 5.4 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (RO) the version number of RSU firmware. 19.3 or late | |
| version includes information about the firmware which | |
| reported the error. | |
| pre 19.3: | |
| b[31:0] | |
| 0x0 version number | |
| 19.3 or late: | |
| b[15:0] | |
| 0x1 version number | |
| b[31:16] | |
| 0x0 no error | |
| 0x0DCF Decision CMF error | |
| 0x0ACF Application CMF error | |
| What: /sys/devices/platform/stratix10-rsu.0/error_location | |
| Date: August 2019 | |
| KernelVersion: 5.4 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (RO) the error offset inside the image that failed. | |
| What: /sys/devices/platform/stratix10-rsu.0/error_details | |
| Date: August 2019 | |
| KernelVersion: 5.4 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (RO) error code. | |
| What: /sys/devices/platform/stratix10-rsu.0/retry_counter | |
| Date: August 2019 | |
| KernelVersion: 5.4 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (RO) the current image's retry counter, which is used by | |
| user to know how many times the images is still allowed | |
| to reload itself before giving up and starting RSU | |
| fail-over flow. | |
| What: /sys/devices/platform/stratix10-rsu.0/reboot_image | |
| Date: August 2019 | |
| KernelVersion: 5.4 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (WO) the address in flash of image to be loaded on next | |
| reboot command. | |
| What: /sys/devices/platform/stratix10-rsu.0/notify | |
| Date: August 2019 | |
| KernelVersion: 5.4 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (WO) client to notify firmware with different actions. | |
| b[15:0] | |
| inform firmware the current software execution | |
| stage. | |
| == =========================================== | |
| 0 the first stage bootloader didn't run or | |
| didn't reach the point of launching second | |
| stage bootloader. | |
| 1 failed in second bootloader or didn't get | |
| to the point of launching the operating | |
| system. | |
| 2 both first and second stage bootloader ran | |
| and the operating system launch was | |
| attempted. | |
| == =========================================== | |
| b[16] | |
| == =========================================== | |
| 1 firmware to reset current image retry | |
| counter. | |
| 0 no action. | |
| == =========================================== | |
| b[17] | |
| == =========================================== | |
| 1 firmware to clear RSU log | |
| 0 no action. | |
| == =========================================== | |
| b[18] | |
| this is negative logic | |
| == =========================================== | |
| 1 no action | |
| 0 firmware record the notify code defined | |
| in b[15:0]. | |
| == =========================================== | |
| What: /sys/devices/platform/stratix10-rsu.0/dcmf0 | |
| Date: June 2020 | |
| KernelVersion: 5.8 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (RO) Decision firmware copy 0 version information. | |
| What: /sys/devices/platform/stratix10-rsu.0/dcmf1 | |
| Date: June 2020 | |
| KernelVersion: 5.8 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (RO) Decision firmware copy 1 version information. | |
| What: /sys/devices/platform/stratix10-rsu.0/dcmf2 | |
| Date: June 2020 | |
| KernelVersion: 5.8 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (RO) Decision firmware copy 2 version information. | |
| What: /sys/devices/platform/stratix10-rsu.0/dcmf3 | |
| Date: June 2020 | |
| KernelVersion: 5.8 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (RO) Decision firmware copy 3 version information. | |
| What: /sys/devices/platform/stratix10-rsu.0/max_retry | |
| Date: June 2020 | |
| KernelVersion: 5.8 | |
| Contact: Richard Gong <richard.gong@linux.intel.com> | |
| Description: | |
| (RO) max retry parameter is stored in the firmware | |
| decision IO section, as a byte located at offset 0x18c. | |
| What: /sys/devices/platform/stratix10-rsu.0/size0 | |
| Date: May 2026 | |
| KernelVersion: 7.1 | |
| Contact: Tze Yee Ng <tze.yee.ng@altera.com> | |
| Description: | |
| (RO) Flash size in bytes for QSPI device 0 (32-bit hex, one | |
| line). EIO if unavailable. | |
| What: /sys/devices/platform/stratix10-rsu.0/size1 | |
| Date: May 2026 | |
| KernelVersion: 7.1 | |
| Contact: Tze Yee Ng <tze.yee.ng@altera.com> | |
| Description: | |
| (RO) Like size0 for device 1. | |
| What: /sys/devices/platform/stratix10-rsu.0/size2 | |
| Date: May 2026 | |
| KernelVersion: 7.1 | |
| Contact: Tze Yee Ng <tze.yee.ng@altera.com> | |
| Description: | |
| (RO) Like size0 for device 2. | |
| What: /sys/devices/platform/stratix10-rsu.0/size3 | |
| Date: May 2026 | |
| KernelVersion: 7.1 | |
| Contact: Tze Yee Ng <tze.yee.ng@altera.com> | |
| Description: | |
| (RO) Like size0 for device 3. | |
| What: /sys/devices/platform/stratix10-rsu.0/erase_size0 | |
| Date: May 2026 | |
| KernelVersion: 7.1 | |
| Contact: Tze Yee Ng <tze.yee.ng@altera.com> | |
| Description: | |
| (RO) Erase size in bytes for QSPI device 0 (32-bit hex, one | |
| line). EIO if unavailable. | |
| What: /sys/devices/platform/stratix10-rsu.0/erase_size1 | |
| Date: May 2026 | |
| KernelVersion: 7.1 | |
| Contact: Tze Yee Ng <tze.yee.ng@altera.com> | |
| Description: | |
| (RO) Like erase_size0 for device 1. | |
| What: /sys/devices/platform/stratix10-rsu.0/erase_size2 | |
| Date: May 2026 | |
| KernelVersion: 7.1 | |
| Contact: Tze Yee Ng <tze.yee.ng@altera.com> | |
| Description: | |
| (RO) Like erase_size0 for device 2. | |
| What: /sys/devices/platform/stratix10-rsu.0/erase_size3 | |
| Date: May 2026 | |
| KernelVersion: 7.1 | |
| Contact: Tze Yee Ng <tze.yee.ng@altera.com> | |
| Description: | |
| (RO) Like erase_size0 for device 3. |