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