Intel® Agilex™ Hard Processor System Remote System Update User Guide

ID 683184
Date 7/13/2022
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

5.4.2. Intel® RSU Driver

The Intel® RSU driver exports the RSU services using the sysfs interface. The source code is located in the drivers/firmware/stratix10-rsu.c file.

The default kernel configuration defines CONFIG_INTEL_STRATIX10_RSU=m which means it is configured as a loadable module which needs to be loaded with insmod. For information about how to use this driver, refer to the Exercising the RSU Client section, located in the LIBRSU Reference Information appendix.

The driver offers its services through the following sysfs files located in the /sys/devices/platform/stratix10-rsu.0 folder. This path is a configurable parameter for LIBRSU. For more information, refer to the Configuration File section, located in the LIBRSU Reference Information appendix.

Table 10.  SysFS Entries for Intel® RSU Driver
File R/W Description
current_image RO Location of currently running image in SDM QSPI flash.
fail_image RO Location of failed image in SDM QSPI flash.
error_details RO Opaque error code, with no meaning to users.
error_location RO Location of error within the image that failed.
state RO State of the RSU system.
version RO Version of the RSU system.
notify WO Used to notify SDM of the HPS software execution stage, also for clearing the error status, and resetting the retry counter.
retry_counter RO Current value of the retry_counter, indicating how many times the current image retries to be loaded. A value of zero means this is the first time.
reboot_image WO Address of image to be loaded on next reboot command.
dcmf0 RO Decision firmware copy 0 version information
dcmf1 RO Decision firmware copy 1 version information
dcmf2 RO Decision firmware copy 2 version information
dcmf3 RO Decision firmware copy 3 version information
dcmf0_status RO Decision firmware copy 0 status. A value of zero means the copy is fine, anything else means the copy is corrupted.
dcmf1_status RO Decision firmware copy 1 status. A value of zero means the copy is fine, anything else means the copy is corrupted.
dcmf2_status RO Decision firmware copy 2 status. A value of zero means the copy is fine, anything else means the copy is corrupted.
dcmf3_status RO Decision firmware copy 3 status. A value of zero means the copy is fine, anything else means the copy is corrupted.
max_retry RO Value of max_retry option, read from decision firmware data section in flash.
For more information, refer to the RSU Status and Error Codes and Decision Firmware Version Information sections.
Note: This information is provided as reference only, as using the RSU driver directly is not recommended or supported. Instead, use the LIBRSU or RSU client directly to perform the RSU tasks.
Note: Linux* is a rapidly changing community project. The information from this section is valid for Linux kernel version 5.4.114-lts, and may change again in the future.