sysfs-devices-platform-stratix10-rsu

  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.