S0ix自测工具发布说明
感谢使用S0ix自测工具。该工具专为Linux操作系统设计,可用于对英特尔®客户端平台进行S2idle路径CPU Package C-state和S0ix故障的初步调试,同时支持基本的运行时PC10状态检查。
当Linux用户的系统无法通过S2idle进入PC10或S0ix时,他们可以使用此脚本获取初步调试信息或潜在阻碍因素,然后再在Bugzilla中报告错误。此脚本将存档调试过程日志,这对未来的高级调试将很有帮助。
该工具的设计遵循以下文档中介绍的基本调试流程: 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
如何使用此工具?
要检查S2idle路径Package C-state或S0ix,请使用
./s0ix-selftest-tool.sh -s
通常用户只需等待不到3分钟即可获得调试结果或信息。
要在屏幕开启时检查运行时PC10,请使用
./s0ix-selftest-tool.sh -r on
要在屏幕关闭时检查运行时PC10,请使用
./s0ix-selftest-tool.sh -r off
附加说明:
-
用户需要以root账户运行此工具
-
如果用户在运行脚本时看到"awk: line 10: function gensub never defined"消息,请安装gawk
-
如果用户在运行脚本时看到"sudo: xxd: command not found"消息,请尝试安装vim-common包
-
此工具将使用两个二进制文件:turbostat和powertop
-
使用此工具需要acpidump工具(可通过安装acpica-tools获取)
-
使用此工具前,请从BIOS设置中禁用安全启动选项,否则可能会导致操作权限问题
-
如果用户的系统无法进入S2idle,则此工具将无法提供帮助。所有s0ix调试都基于S2idle正常进入和退出,如果有任何驱动程序或固件问题阻碍了S2idle功能本身,请先修复该问题
-
如果用户有改进此脚本的好主意,非常欢迎向我们发送补丁,谢谢!