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			0	the first stage bootloader didn't run or
106				didn't reach the point of launching second
107				stage bootloader.
108			1	failed in second bootloader or didn't get
109				to the point of launching the operating
110				system.
111			2	both first and second stage bootloader ran
112				and the operating system launch was
113				attempted.
114
115		b[16]
116			1	firmware to reset current image retry
117				counter.
118			0	no action.
119
120		b[17]
121			1	firmware to clear RSU log
122			0	no action.
123
124		b[18]
125			this is negative logic
126			1	no action
127			0	firmware record the notify code defined
128				in b[15:0].
129