0001 Intel Stratix10 Remote System Update (RSU) device attributes
0002
0003 What: /sys/devices/platform/stratix10-rsu.0/current_image
0004 Date: August 2019
0005 KernelVersion: 5.4
0006 Contact: Richard Gong <richard.gong@linux.intel.com>
0007 Description:
0008 (RO) the address in flash of currently running image.
0009
0010 What: /sys/devices/platform/stratix10-rsu.0/fail_image
0011 Date: August 2019
0012 KernelVersion: 5.4
0013 Contact: Richard Gong <richard.gong@linux.intel.com>
0014 Description:
0015 (RO) the address in flash of failed image.
0016
0017 What: /sys/devices/platform/stratix10-rsu.0/state
0018 Date: August 2019
0019 KernelVersion: 5.4
0020 Contact: Richard Gong <richard.gong@linux.intel.com>
0021 Description:
0022 (RO) the state of RSU system.
0023 The state field has two parts: major error code in
0024 upper 16 bits and minor error code in lower 16 bits.
0025
0026 b[15:0]
0027 Currently used only when major error is 0xF006
0028 (CPU watchdog timeout), in which case the minor
0029 error code is the value reported by CPU to
0030 firmware through the RSU notify command before
0031 the watchdog timeout occurs.
0032
0033 b[31:16]
0034 0xF001 bitstream error
0035 0xF002 hardware access failure
0036 0xF003 bitstream corruption
0037 0xF004 internal error
0038 0xF005 device error
0039 0xF006 CPU watchdog timeout
0040 0xF007 internal unknown error
0041
0042 What: /sys/devices/platform/stratix10-rsu.0/version
0043 Date: August 2019
0044 KernelVersion: 5.4
0045 Contact: Richard Gong <richard.gong@linux.intel.com>
0046 Description:
0047 (RO) the version number of RSU firmware. 19.3 or late
0048 version includes information about the firmware which
0049 reported the error.
0050
0051 pre 19.3:
0052 b[31:0]
0053 0x0 version number
0054
0055 19.3 or late:
0056 b[15:0]
0057 0x1 version number
0058 b[31:16]
0059 0x0 no error
0060 0x0DCF Decision CMF error
0061 0x0ACF Application CMF error
0062
0063 What: /sys/devices/platform/stratix10-rsu.0/error_location
0064 Date: August 2019
0065 KernelVersion: 5.4
0066 Contact: Richard Gong <richard.gong@linux.intel.com>
0067 Description:
0068 (RO) the error offset inside the image that failed.
0069
0070 What: /sys/devices/platform/stratix10-rsu.0/error_details
0071 Date: August 2019
0072 KernelVersion: 5.4
0073 Contact: Richard Gong <richard.gong@linux.intel.com>
0074 Description:
0075 (RO) error code.
0076
0077 What: /sys/devices/platform/stratix10-rsu.0/retry_counter
0078 Date: August 2019
0079 KernelVersion: 5.4
0080 Contact: Richard Gong <richard.gong@linux.intel.com>
0081 Description:
0082 (RO) the current image's retry counter, which is used by
0083 user to know how many times the images is still allowed
0084 to reload itself before giving up and starting RSU
0085 fail-over flow.
0086
0087 What: /sys/devices/platform/stratix10-rsu.0/reboot_image
0088 Date: August 2019
0089 KernelVersion: 5.4
0090 Contact: Richard Gong <richard.gong@linux.intel.com>
0091 Description:
0092 (WO) the address in flash of image to be loaded on next
0093 reboot command.
0094
0095 What: /sys/devices/platform/stratix10-rsu.0/notify
0096 Date: August 2019
0097 KernelVersion: 5.4
0098 Contact: Richard Gong <richard.gong@linux.intel.com>
0099 Description:
0100 (WO) client to notify firmware with different actions.
0101
0102 b[15:0]
0103 inform firmware the current software execution
0104 stage.
0105
0106 == ===========================================
0107 0 the first stage bootloader didn't run or
0108 didn't reach the point of launching second
0109 stage bootloader.
0110 1 failed in second bootloader or didn't get
0111 to the point of launching the operating
0112 system.
0113 2 both first and second stage bootloader ran
0114 and the operating system launch was
0115 attempted.
0116 == ===========================================
0117
0118 b[16]
0119 == ===========================================
0120 1 firmware to reset current image retry
0121 counter.
0122 0 no action.
0123 == ===========================================
0124
0125 b[17]
0126 == ===========================================
0127 1 firmware to clear RSU log
0128 0 no action.
0129 == ===========================================
0130
0131 b[18]
0132 this is negative logic
0133
0134 == ===========================================
0135 1 no action
0136 0 firmware record the notify code defined
0137 in b[15:0].
0138 == ===========================================
0139
0140 What: /sys/devices/platform/stratix10-rsu.0/dcmf0
0141 Date: June 2020
0142 KernelVersion: 5.8
0143 Contact: Richard Gong <richard.gong@linux.intel.com>
0144 Description:
0145 (RO) Decision firmware copy 0 version information.
0146
0147 What: /sys/devices/platform/stratix10-rsu.0/dcmf1
0148 Date: June 2020
0149 KernelVersion: 5.8
0150 Contact: Richard Gong <richard.gong@linux.intel.com>
0151 Description:
0152 (RO) Decision firmware copy 1 version information.
0153
0154 What: /sys/devices/platform/stratix10-rsu.0/dcmf2
0155 Date: June 2020
0156 KernelVersion: 5.8
0157 Contact: Richard Gong <richard.gong@linux.intel.com>
0158 Description:
0159 (RO) Decision firmware copy 2 version information.
0160
0161 What: /sys/devices/platform/stratix10-rsu.0/dcmf3
0162 Date: June 2020
0163 KernelVersion: 5.8
0164 Contact: Richard Gong <richard.gong@linux.intel.com>
0165 Description:
0166 (RO) Decision firmware copy 3 version information.
0167
0168 What: /sys/devices/platform/stratix10-rsu.0/max_retry
0169 Date: June 2020
0170 KernelVersion: 5.8
0171 Contact: Richard Gong <richard.gong@linux.intel.com>
0172 Description:
0173 (RO) max retry parameter is stored in the firmware
0174 decision IO section, as a byte located at offset 0x18c.
