1 Intel Stratix10 Remote System Update (RSU) device attributes 2 3What: /sys/devices/platform/stratix10-rsu.0/current_image 4Date: August 2019 5KernelVersion: 5.4 6Contact: Richard Gong <richard.gong@linux.intel.com> 7Description: 8 (RO) the address in flash of currently running image. 9 10What: /sys/devices/platform/stratix10-rsu.0/fail_image 11Date: August 2019 12KernelVersion: 5.4 13Contact: Richard Gong <richard.gong@linux.intel.com> 14Description: 15 (RO) the address in flash of failed image. 16 17What: /sys/devices/platform/stratix10-rsu.0/state 18Date: August 2019 19KernelVersion: 5.4 20Contact: Richard Gong <richard.gong@linux.intel.com> 21Description: 22 (RO) the state of RSU system. 23 The state field has two parts: major error code in 24 upper 16 bits and minor error code in lower 16 bits. 25 26 b[15:0] 27 Currently used only when major error is 0xF006 28 (CPU watchdog timeout), in which case the minor 29 error code is the value reported by CPU to 30 firmware through the RSU notify command before 31 the watchdog timeout occurs. 32 33 b[31:16] 34 0xF001 bitstream error 35 0xF002 hardware access failure 36 0xF003 bitstream corruption 37 0xF004 internal error 38 0xF005 device error 39 0xF006 CPU watchdog timeout 40 0xF007 internal unknown error 41 42What: /sys/devices/platform/stratix10-rsu.0/version 43Date: August 2019 44KernelVersion: 5.4 45Contact: Richard Gong <richard.gong@linux.intel.com> 46Description: 47 (RO) the version number of RSU firmware. 19.3 or late 48 version includes information about the firmware which 49 reported the error. 50 51 pre 19.3: 52 b[31:0] 53 0x0 version number 54 55 19.3 or late: 56 b[15:0] 57 0x1 version number 58 b[31:16] 59 0x0 no error 60 0x0DCF Decision CMF error 61 0x0ACF Application CMF error 62 63What: /sys/devices/platform/stratix10-rsu.0/error_location 64Date: August 2019 65KernelVersion: 5.4 66Contact: Richard Gong <richard.gong@linux.intel.com> 67Description: 68 (RO) the error offset inside the image that failed. 69 70What: /sys/devices/platform/stratix10-rsu.0/error_details 71Date: August 2019 72KernelVersion: 5.4 73Contact: Richard Gong <richard.gong@linux.intel.com> 74Description: 75 (RO) error code. 76 77What: /sys/devices/platform/stratix10-rsu.0/retry_counter 78Date: August 2019 79KernelVersion: 5.4 80Contact: Richard Gong <richard.gong@linux.intel.com> 81Description: 82 (RO) the current image's retry counter, which is used by 83 user to know how many times the images is still allowed 84 to reload itself before giving up and starting RSU 85 fail-over flow. 86 87What: /sys/devices/platform/stratix10-rsu.0/reboot_image 88Date: August 2019 89KernelVersion: 5.4 90Contact: Richard Gong <richard.gong@linux.intel.com> 91Description: 92 (WO) the address in flash of image to be loaded on next 93 reboot command. 94 95What: /sys/devices/platform/stratix10-rsu.0/notify 96Date: August 2019 97KernelVersion: 5.4 98Contact: Richard Gong <richard.gong@linux.intel.com> 99Description: 100 (WO) client to notify firmware with different actions. 101 102 b[15:0] 103 inform firmware the current software execution 104 stage. 105 106 == =========================================== 107 0 the first stage bootloader didn't run or 108 didn't reach the point of launching second 109 stage bootloader. 110 1 failed in second bootloader or didn't get 111 to the point of launching the operating 112 system. 113 2 both first and second stage bootloader ran 114 and the operating system launch was 115 attempted. 116 == =========================================== 117 118 b[16] 119 == =========================================== 120 1 firmware to reset current image retry 121 counter. 122 0 no action. 123 == =========================================== 124 125 b[17] 126 == =========================================== 127 1 firmware to clear RSU log 128 0 no action. 129 == =========================================== 130 131 b[18] 132 this is negative logic 133 134 == =========================================== 135 1 no action 136 0 firmware record the notify code defined 137 in b[15:0]. 138 == =========================================== 139 140What: /sys/devices/platform/stratix10-rsu.0/dcmf0 141Date: June 2020 142KernelVersion: 5.8 143Contact: Richard Gong <richard.gong@linux.intel.com> 144Description: 145 (RO) Decision firmware copy 0 version information. 146 147What: /sys/devices/platform/stratix10-rsu.0/dcmf1 148Date: June 2020 149KernelVersion: 5.8 150Contact: Richard Gong <richard.gong@linux.intel.com> 151Description: 152 (RO) Decision firmware copy 1 version information. 153 154What: /sys/devices/platform/stratix10-rsu.0/dcmf2 155Date: June 2020 156KernelVersion: 5.8 157Contact: Richard Gong <richard.gong@linux.intel.com> 158Description: 159 (RO) Decision firmware copy 2 version information. 160 161What: /sys/devices/platform/stratix10-rsu.0/dcmf3 162Date: June 2020 163KernelVersion: 5.8 164Contact: Richard Gong <richard.gong@linux.intel.com> 165Description: 166 (RO) Decision firmware copy 3 version information. 167 168What: /sys/devices/platform/stratix10-rsu.0/max_retry 169Date: June 2020 170KernelVersion: 5.8 171Contact: Richard Gong <richard.gong@linux.intel.com> 172Description: 173 (RO) max retry parameter is stored in the firmware 174 decision IO section, as a byte located at offset 0x18c. 175