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