Release Notes for S0ix Selftest Tool

Thanks for using S0ix Selftest Tool. This tool is designed for Linux OS, it can be used to do the initial debugging for the S2idle path CPU Pacakge C-state and S0ix failures for Intel® Client platforms, it also supports the basic runtime PC10 status check.

When linux users' system fails to enter PC10 or S0ix via S2idle, can use this script to get the initial debugging infomation or potenial blockers before reporting the bugs in the Bugzilla. This script will archive the debugging process logs, which will be helpful for the future advanced debugging.

This tool's design follows the basic debugging process introduced in the documents below: https://01.org/blogs/qwang59/2018/how-achieve-s0ix-states-linux https://01.org/blogs/qwang59/2020/linux-s0ix-troubleshooting

How to use this tool? After git clone https://github.com/intel-sandbox/linux-s0ix-self-test-tool.git please do below before running: chmod +x s0ix-self-test.sh chmod +x turbostat

To check S2idle Path Package C-state or S0ix, using ./s0ix-self-test.sh -s Usually the users only need to wait for less than 3 minutes to get the debugging results or messages.

To check runtime PC10 with screen on, using ./s0ix-self-test.sh -r on

To check runtime PC10 with screen off, using ./s0ix-self-test.sh -r off

Additional Notes:

1. The Users need to run this tool as root account

2. If the users see "awk: line 10: function gensub never defined" message during running the script, please install gawk

3. There are two binaries will be used in this tool: turbostat and powertop

4. The acpidump tool(can be accessed by installing acpica-tools) is needed for using this tool

5. If the users' system fails to entry S2idle, then this tool will not help. All the s0ix debugging is based on S2idle entry and exit works normally, if there is any driver or fw issue blocks S2idle itself funcitonality, please fix it first.

6. If the users have good idea to improve this script, you are very welcome to send us the patches, thanks!