3a2f2756c5
Array BIST test doesn't need an IFS test image to operate unlike the SCAN test. Consequently current_batch and image_version files are not applicable for Array BIST IFS device instance, clarify this in the ABI doc. Also given that multiple tests are supported, take the opportunity to generalize descriptions wherever applicable. Signed-off-by: Jithu Joseph <jithu.joseph@intel.com> Reviewed-by: Tony Luck <tony.luck@intel.com> Link: https://lore.kernel.org/r/20230322003359.213046-10-jithu.joseph@intel.com Reviewed-by: Hans de Goede <hdegoede@redhat.com> Signed-off-by: Hans de Goede <hdegoede@redhat.com>
2.1 KiB
Device instance to test mapping intel_ifs_0 -> Scan Test intel_ifs_1 -> Array BIST test
What: /sys/devices/virtual/misc/intel_ifs_/run_test Date: Nov 16 2022 KernelVersion: 6.2 Contact: "Jithu Joseph" jithu.joseph@intel.com Description: Write <cpu#> to trigger IFS test for one online core. Note that the test is per core. The cpu# can be for any thread on the core. Running on one thread completes the test for the core containing that thread. Example: to test the core containing cpu5: echo 5 > /sys/devices/virtual/misc/intel_ifs_/run_test Devices: all
What: /sys/devices/virtual/misc/intel_ifs_/status Date: Nov 16 2022 KernelVersion: 6.2 Contact: "Jithu Joseph" jithu.joseph@intel.com Description: The status of the last test. It can be one of "pass", "fail" or "untested". Devices: all
What: /sys/devices/virtual/misc/intel_ifs_/details Date: Nov 16 2022 KernelVersion: 6.2 Contact: "Jithu Joseph" jithu.joseph@intel.com Description: Additional information regarding the last test. The details file reports the hex value of the STATUS MSR for this test. Note that the error_code field may contain driver defined software code not defined in the Intel SDM. Devices: all
What: /sys/devices/virtual/misc/intel_ifs_/image_version Date: Nov 16 2022 KernelVersion: 6.2 Contact: "Jithu Joseph" jithu.joseph@intel.com Description: Version (hexadecimal) of loaded IFS test image. If no test image is loaded reports "none". Only present for device instances where a test image is applicable. Devices: intel_ifs_0
What: /sys/devices/virtual/misc/intel_ifs_/current_batch Date: Nov 16 2022 KernelVersion: 6.2 Contact: "Jithu Joseph" jithu.joseph@intel.com Description: Write a number less than or equal to 0xff to load an IFS test image. The number written treated as the 2 digit suffix in the following file name: /lib/firmware/intel/ifs_/ff-mm-ss-02x.scan Reading the file will provide the suffix of the currently loaded IFS test image. This file is present only for device instances where a test image is applicable. Devices: intel_ifs_0