18c2ecf20Sopenharmony_ci	Intel Stratix10 Remote System Update (RSU) device attributes
28c2ecf20Sopenharmony_ci
38c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/current_image
48c2ecf20Sopenharmony_ciDate:		August 2019
58c2ecf20Sopenharmony_ciKernelVersion:	5.4
68c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
78c2ecf20Sopenharmony_ciDescription:
88c2ecf20Sopenharmony_ci		(RO) the address in flash of currently running image.
98c2ecf20Sopenharmony_ci
108c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/fail_image
118c2ecf20Sopenharmony_ciDate:		August 2019
128c2ecf20Sopenharmony_ciKernelVersion:	5.4
138c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
148c2ecf20Sopenharmony_ciDescription:
158c2ecf20Sopenharmony_ci		(RO) the address in flash of failed image.
168c2ecf20Sopenharmony_ci
178c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/state
188c2ecf20Sopenharmony_ciDate:		August 2019
198c2ecf20Sopenharmony_ciKernelVersion:	5.4
208c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
218c2ecf20Sopenharmony_ciDescription:
228c2ecf20Sopenharmony_ci		(RO) the state of RSU system.
238c2ecf20Sopenharmony_ci		The state field has two parts: major error code in
248c2ecf20Sopenharmony_ci		upper 16 bits and minor error code in lower 16 bits.
258c2ecf20Sopenharmony_ci
268c2ecf20Sopenharmony_ci		b[15:0]
278c2ecf20Sopenharmony_ci			Currently used only when major error is 0xF006
288c2ecf20Sopenharmony_ci			(CPU watchdog timeout), in which case the minor
298c2ecf20Sopenharmony_ci			error code is the value reported by CPU to
308c2ecf20Sopenharmony_ci			firmware through the RSU notify command before
318c2ecf20Sopenharmony_ci			the watchdog timeout occurs.
328c2ecf20Sopenharmony_ci
338c2ecf20Sopenharmony_ci		b[31:16]
348c2ecf20Sopenharmony_ci			0xF001	bitstream error
358c2ecf20Sopenharmony_ci			0xF002	hardware access failure
368c2ecf20Sopenharmony_ci			0xF003	bitstream corruption
378c2ecf20Sopenharmony_ci			0xF004	internal error
388c2ecf20Sopenharmony_ci			0xF005	device error
398c2ecf20Sopenharmony_ci			0xF006	CPU watchdog timeout
408c2ecf20Sopenharmony_ci			0xF007	internal unknown error
418c2ecf20Sopenharmony_ci
428c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/version
438c2ecf20Sopenharmony_ciDate:		August 2019
448c2ecf20Sopenharmony_ciKernelVersion:	5.4
458c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
468c2ecf20Sopenharmony_ciDescription:
478c2ecf20Sopenharmony_ci		(RO) the version number of RSU firmware. 19.3 or late
488c2ecf20Sopenharmony_ci		version includes information about the firmware which
498c2ecf20Sopenharmony_ci		reported the error.
508c2ecf20Sopenharmony_ci
518c2ecf20Sopenharmony_ci		pre 19.3:
528c2ecf20Sopenharmony_ci			b[31:0]
538c2ecf20Sopenharmony_ci				0x0	version number
548c2ecf20Sopenharmony_ci
558c2ecf20Sopenharmony_ci		19.3 or late:
568c2ecf20Sopenharmony_ci			b[15:0]
578c2ecf20Sopenharmony_ci				0x1	version number
588c2ecf20Sopenharmony_ci			b[31:16]
598c2ecf20Sopenharmony_ci				0x0	no error
608c2ecf20Sopenharmony_ci				0x0DCF	Decision CMF error
618c2ecf20Sopenharmony_ci				0x0ACF	Application CMF error
628c2ecf20Sopenharmony_ci
638c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/error_location
648c2ecf20Sopenharmony_ciDate:		August 2019
658c2ecf20Sopenharmony_ciKernelVersion:	5.4
668c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
678c2ecf20Sopenharmony_ciDescription:
688c2ecf20Sopenharmony_ci		(RO) the error offset inside the image that failed.
698c2ecf20Sopenharmony_ci
708c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/error_details
718c2ecf20Sopenharmony_ciDate:		August 2019
728c2ecf20Sopenharmony_ciKernelVersion:	5.4
738c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
748c2ecf20Sopenharmony_ciDescription:
758c2ecf20Sopenharmony_ci		(RO) error code.
768c2ecf20Sopenharmony_ci
778c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/retry_counter
788c2ecf20Sopenharmony_ciDate:		August 2019
798c2ecf20Sopenharmony_ciKernelVersion:	5.4
808c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
818c2ecf20Sopenharmony_ciDescription:
828c2ecf20Sopenharmony_ci		(RO) the current image's retry counter, which is used by
838c2ecf20Sopenharmony_ci		user to know how many times the images is still allowed
848c2ecf20Sopenharmony_ci		to reload itself before giving up and starting RSU
858c2ecf20Sopenharmony_ci		fail-over flow.
868c2ecf20Sopenharmony_ci
878c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/reboot_image
888c2ecf20Sopenharmony_ciDate:		August 2019
898c2ecf20Sopenharmony_ciKernelVersion:	5.4
908c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
918c2ecf20Sopenharmony_ciDescription:
928c2ecf20Sopenharmony_ci		(WO) the address in flash of image to be loaded on next
938c2ecf20Sopenharmony_ci		reboot command.
948c2ecf20Sopenharmony_ci
958c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/notify
968c2ecf20Sopenharmony_ciDate:		August 2019
978c2ecf20Sopenharmony_ciKernelVersion:	5.4
988c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
998c2ecf20Sopenharmony_ciDescription:
1008c2ecf20Sopenharmony_ci		(WO) client to notify firmware with different actions.
1018c2ecf20Sopenharmony_ci
1028c2ecf20Sopenharmony_ci		b[15:0]
1038c2ecf20Sopenharmony_ci			inform firmware the current software execution
1048c2ecf20Sopenharmony_ci			stage.
1058c2ecf20Sopenharmony_ci
1068c2ecf20Sopenharmony_ci			==	===========================================
1078c2ecf20Sopenharmony_ci			0	the first stage bootloader didn't run or
1088c2ecf20Sopenharmony_ci				didn't reach the point of launching second
1098c2ecf20Sopenharmony_ci				stage bootloader.
1108c2ecf20Sopenharmony_ci			1	failed in second bootloader or didn't get
1118c2ecf20Sopenharmony_ci				to the point of launching the operating
1128c2ecf20Sopenharmony_ci				system.
1138c2ecf20Sopenharmony_ci			2	both first and second stage bootloader ran
1148c2ecf20Sopenharmony_ci				and the operating system launch was
1158c2ecf20Sopenharmony_ci				attempted.
1168c2ecf20Sopenharmony_ci			==	===========================================
1178c2ecf20Sopenharmony_ci
1188c2ecf20Sopenharmony_ci		b[16]
1198c2ecf20Sopenharmony_ci			==	===========================================
1208c2ecf20Sopenharmony_ci			1	firmware to reset current image retry
1218c2ecf20Sopenharmony_ci				counter.
1228c2ecf20Sopenharmony_ci			0	no action.
1238c2ecf20Sopenharmony_ci			==	===========================================
1248c2ecf20Sopenharmony_ci
1258c2ecf20Sopenharmony_ci		b[17]
1268c2ecf20Sopenharmony_ci			==	===========================================
1278c2ecf20Sopenharmony_ci			1	firmware to clear RSU log
1288c2ecf20Sopenharmony_ci			0	no action.
1298c2ecf20Sopenharmony_ci			==	===========================================
1308c2ecf20Sopenharmony_ci
1318c2ecf20Sopenharmony_ci		b[18]
1328c2ecf20Sopenharmony_ci			this is negative logic
1338c2ecf20Sopenharmony_ci
1348c2ecf20Sopenharmony_ci			==	===========================================
1358c2ecf20Sopenharmony_ci			1	no action
1368c2ecf20Sopenharmony_ci			0	firmware record the notify code defined
1378c2ecf20Sopenharmony_ci				in b[15:0].
1388c2ecf20Sopenharmony_ci			==	===========================================
1398c2ecf20Sopenharmony_ci
1408c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/dcmf0
1418c2ecf20Sopenharmony_ciDate:		June 2020
1428c2ecf20Sopenharmony_ciKernelVersion:	5.8
1438c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
1448c2ecf20Sopenharmony_ciDescription:
1458c2ecf20Sopenharmony_ci		(RO) Decision firmware copy 0 version information.
1468c2ecf20Sopenharmony_ci
1478c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/dcmf1
1488c2ecf20Sopenharmony_ciDate:		June 2020
1498c2ecf20Sopenharmony_ciKernelVersion:	5.8
1508c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
1518c2ecf20Sopenharmony_ciDescription:
1528c2ecf20Sopenharmony_ci		(RO) Decision firmware copy 1 version information.
1538c2ecf20Sopenharmony_ci
1548c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/dcmf2
1558c2ecf20Sopenharmony_ciDate:		June 2020
1568c2ecf20Sopenharmony_ciKernelVersion:	5.8
1578c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
1588c2ecf20Sopenharmony_ciDescription:
1598c2ecf20Sopenharmony_ci		(RO) Decision firmware copy 2 version information.
1608c2ecf20Sopenharmony_ci
1618c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/dcmf3
1628c2ecf20Sopenharmony_ciDate:		June 2020
1638c2ecf20Sopenharmony_ciKernelVersion:	5.8
1648c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
1658c2ecf20Sopenharmony_ciDescription:
1668c2ecf20Sopenharmony_ci		(RO) Decision firmware copy 3 version information.
1678c2ecf20Sopenharmony_ci
1688c2ecf20Sopenharmony_ciWhat:		/sys/devices/platform/stratix10-rsu.0/max_retry
1698c2ecf20Sopenharmony_ciDate:		June 2020
1708c2ecf20Sopenharmony_ciKernelVersion:	5.8
1718c2ecf20Sopenharmony_ciContact:	Richard Gong <richard.gong@linux.intel.com>
1728c2ecf20Sopenharmony_ciDescription:
1738c2ecf20Sopenharmony_ci		(RO) max retry parameter is stored in the firmware
1748c2ecf20Sopenharmony_ci		decision IO section, as a byte located at offset 0x18c.
175