xref: /linux/Documentation/ABI/testing/sysfs-platform-intel-ifs (revision bb29b957eaaa15be33243550d9ee576c2d601669)
1Device instance to test mapping
2intel_ifs_0  ->  Scan Test
3intel_ifs_1  ->  Array BIST test
4
5What:		/sys/devices/virtual/misc/intel_ifs_<N>/run_test
6Date:		Nov 16 2022
7KernelVersion:	6.2
8Contact:	"Jithu Joseph" <jithu.joseph@intel.com>
9Description:	Write <cpu#> to trigger IFS test for one online core.
10		Note that the test is per core. The cpu# can be
11		for any thread on the core. Running on one thread
12		completes the test for the core containing that thread.
13		Example: to test the core containing cpu5::
14
15		  echo 5 > /sys/devices/virtual/misc/intel_ifs_<N>/run_test
16
17Devices:	all
18
19What:		/sys/devices/virtual/misc/intel_ifs_<N>/status
20Date:		Nov 16 2022
21KernelVersion:	6.2
22Contact:	"Jithu Joseph" <jithu.joseph@intel.com>
23Description:	The status of the last test. It can be one of "pass", "fail"
24		or "untested".
25Devices:	all
26
27What:		/sys/devices/virtual/misc/intel_ifs_<N>/details
28Date:		Nov 16 2022
29KernelVersion:	6.2
30Contact:	"Jithu Joseph" <jithu.joseph@intel.com>
31Description:	Additional information regarding the last test. The details file reports
32		the hex value of the STATUS MSR for this test. Note that the error_code field
33		may contain driver defined software code not defined in the Intel SDM.
34Devices:	all
35
36What:		/sys/devices/virtual/misc/intel_ifs_<N>/image_version
37Date:		Nov 16 2022
38KernelVersion:	6.2
39Contact:	"Jithu Joseph" <jithu.joseph@intel.com>
40Description:	Version (hexadecimal) of loaded IFS test image. If no test image
41		is loaded reports "none". Only present for device instances where a test image
42		is applicable.
43Devices:	intel_ifs_0
44
45What:		/sys/devices/virtual/misc/intel_ifs_<N>/current_batch
46Date:		Nov 16 2022
47KernelVersion:	6.2
48Contact:	"Jithu Joseph" <jithu.joseph@intel.com>
49Description:	Write a number less than or equal to 0xff to load an IFS test image.
50		The number written treated as the 2 digit suffix in the following file name:
51		/lib/firmware/intel/ifs_<N>/ff-mm-ss-02x.scan
52		Reading the file will provide the suffix of the currently loaded IFS test image.
53		This file is present only for device instances where a test image is applicable.
54Devices:	intel_ifs_0
55