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