sysfs-devices-platform-stratix10-rsu 4.9 KB

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