Documentation/ABI/testing/sysfs-devices-platform-stratix10-rsu

   1         Intel Stratix10 Remote System Update (RSU) device attributes
   2
   3 What:           /sys/devices/platform/stratix10-rsu.0/current_image
   4 Date:           August 2019
   5 KernelVersion:  5.4
   6 Contact:        Richard Gong <richard.gong@linux.intel.com>
   7 Description:
   8                 (RO) the address in flash of currently running image.
   9
  10 What:           /sys/devices/platform/stratix10-rsu.0/fail_image
  11 Date:           August 2019
  12 KernelVersion:  5.4
  13 Contact:        Richard Gong <richard.gong@linux.intel.com>
  14 Description:
  15                 (RO) the address in flash of failed image.
  16
  17 What:           /sys/devices/platform/stratix10-rsu.0/state
  18 Date:           August 2019
  19 KernelVersion:  5.4
  20 Contact:        Richard Gong <richard.gong@linux.intel.com>
  21 Description:
  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
  42 What:           /sys/devices/platform/stratix10-rsu.0/version
  43 Date:           August 2019
  44 KernelVersion:  5.4
  45 Contact:        Richard Gong <richard.gong@linux.intel.com>
  46 Description:
  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
  63 What:           /sys/devices/platform/stratix10-rsu.0/error_location
  64 Date:           August 2019
  65 KernelVersion:  5.4
  66 Contact:        Richard Gong <richard.gong@linux.intel.com>
  67 Description:
  68                 (RO) the error offset inside the image that failed.
  69
  70 What:           /sys/devices/platform/stratix10-rsu.0/error_details
  71 Date:           August 2019
  72 KernelVersion:  5.4
  73 Contact:        Richard Gong <richard.gong@linux.intel.com>
  74 Description:
  75                 (RO) error code.
  76
  77 What:           /sys/devices/platform/stratix10-rsu.0/retry_counter
  78 Date:           August 2019
  79 KernelVersion:  5.4
  80 Contact:        Richard Gong <richard.gong@linux.intel.com>
  81 Description:
  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
  87 What:           /sys/devices/platform/stratix10-rsu.0/reboot_image
  88 Date:           August 2019
  89 KernelVersion:  5.4
  90 Contact:        Richard Gong <richard.gong@linux.intel.com>
  91 Description:
  92                 (WO) the address in flash of image to be loaded on next
  93                 reboot command.
  94
  95 What:           /sys/devices/platform/stratix10-rsu.0/notify
  96 Date:           August 2019
  97 KernelVersion:  5.4
  98 Contact:        Richard Gong <richard.gong@linux.intel.com>
  99 Description:
 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
 140 What:           /sys/devices/platform/stratix10-rsu.0/dcmf0
 141 Date:           June 2020
 142 KernelVersion:  5.8
 143 Contact:        Richard Gong <richard.gong@linux.intel.com>
 144 Description:
 145                 (RO) Decision firmware copy 0 version information.
 146
 147 What:           /sys/devices/platform/stratix10-rsu.0/dcmf1
 148 Date:           June 2020
 149 KernelVersion:  5.8
 150 Contact:        Richard Gong <richard.gong@linux.intel.com>
 151 Description:
 152                 (RO) Decision firmware copy 1 version information.
 153
 154 What:           /sys/devices/platform/stratix10-rsu.0/dcmf2
 155 Date:           June 2020
 156 KernelVersion:  5.8
 157 Contact:        Richard Gong <richard.gong@linux.intel.com>
 158 Description:
 159                 (RO) Decision firmware copy 2 version information.
 160
 161 What:           /sys/devices/platform/stratix10-rsu.0/dcmf3
 162 Date:           June 2020
 163 KernelVersion:  5.8
 164 Contact:        Richard Gong <richard.gong@linux.intel.com>
 165 Description:
 166                 (RO) Decision firmware copy 3 version information.
 167
 168 What:           /sys/devices/platform/stratix10-rsu.0/max_retry
 169 Date:           June 2020
 170 KernelVersion:  5.8
 171 Contact:        Richard Gong <richard.gong@linux.intel.com>
 172 Description:
 173                 (RO) max retry parameter is stored in the firmware
 174                 decision IO section, as a byte located at offset 0x18c.