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