https://github.com/intel/S0ixSelftestTool

S0ix Selftest Tool is designed to do the initial debugging for the S2idle path CPU Package C-state and S0ix failures in Linux OS for Intel® Client platforms, it also supports the basic runtime PC10 status check.
https://github.com/intel/S0ixSelftestTool

Last synced: 3 months ago
JSON representation

S0ix Selftest Tool is designed to do the initial debugging for the S2idle path CPU Package C-state and S0ix failures in Linux OS for Intel® Client platforms, it also supports the basic runtime PC10 status check.

• Host: GitHub
• URL: https://github.com/intel/S0ixSelftestTool
• Owner: intel
• Created: 2021-08-19T07:43:12.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2024-06-14T06:15:26.000Z (5 months ago)
• Last Synced: 2024-08-09T00:28:30.287Z (3 months ago)
• Language: Shell
• Homepage:
• Size: 184 KB
• Stars: 115
• Watchers: 8
• Forks: 16
• Open Issues: 6
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 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://web.archive.org/web/20230614200816/https://01.org/blogs/qwang59/2018/how-achieve-s0ix-states-linux

https://web.archive.org/web/20230614200306/https://01.org/blogs/qwang59/2020/linux-s0ix-troubleshooting

How to use this tool?

To check S2idle Path Package C-state or S0ix, using  

`./s0ix-selftest-tool.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-selftest-tool.sh -r on`

To check runtime PC10 with screen off, using  

`./s0ix-selftest-tool.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. If the users see "sudo: xxd: command not found" message during running the script,

please try to install a vim-common package

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

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

6. Before using this tool please disable secure boot option from BIOS setup,

which may cause Operation permision issue

7. 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 functionality, please fix it first.

8. If the users have good idea to improve this script, you are very welcome to send

us the patches, thanks!