1ffd1f19dSYanteng Si.. SPDX-License-Identifier: GPL-2.0 2ffd1f19dSYanteng Si 3ffd1f19dSYanteng Si.. include:: ../disclaimer-zh_CN.rst 4ffd1f19dSYanteng Si 58137a49eSYanteng Si:Original: Documentation/cpu-freq/cpufreq-stats.rst 68137a49eSYanteng Si 78137a49eSYanteng Si:翻译: 88137a49eSYanteng Si 98137a49eSYanteng Si 司延腾 Yanteng Si <siyanteng@loongson.cn> 10ffd1f19dSYanteng Si 11*d733ac93STang Yizhou:校译: 12*d733ac93STang Yizhou 13*d733ac93STang Yizhou 唐艺舟 Tang Yizhou <tangyeechou@gmail.com> 14ffd1f19dSYanteng Si 15ffd1f19dSYanteng Si========================================== 16ffd1f19dSYanteng Sisysfs CPUFreq Stats的一般说明 17ffd1f19dSYanteng Si========================================== 18ffd1f19dSYanteng Si 19*d733ac93STang Yizhou为使用者准备的信息 20ffd1f19dSYanteng Si 21ffd1f19dSYanteng Si 22ffd1f19dSYanteng Si作者: Venkatesh Pallipadi <venkatesh.pallipadi@intel.com> 23ffd1f19dSYanteng Si 24ffd1f19dSYanteng Si.. Contents 25ffd1f19dSYanteng Si 26ffd1f19dSYanteng Si 1. 简介 27ffd1f19dSYanteng Si 2. 提供的统计数据(举例说明) 28ffd1f19dSYanteng Si 3. 配置cpufreq-stats 29ffd1f19dSYanteng Si 30ffd1f19dSYanteng Si 31ffd1f19dSYanteng Si1. 简介 32ffd1f19dSYanteng Si=============== 33ffd1f19dSYanteng Si 34*d733ac93STang Yizhoucpufreq-stats是一种为每个CPU提供CPU频率统计的驱动。 35*d733ac93STang Yizhou这些统计数据以/sysfs中一系列只读接口的形式呈现。cpufreq-stats接口（若已配置）将为每个CPU生成 36*d733ac93STang Yizhou/sysfs（<sysfs root>/devices/system/cpu/cpuX/cpufreq/stats/）中cpufreq目录下的stats目录。 37*d733ac93STang Yizhou各项统计数据将在stats目录下形成对应的只读文件。 38ffd1f19dSYanteng Si 39*d733ac93STang Yizhou此驱动是以独立于任何可能运行在你所用CPU上的特定cpufreq_driver的方式设计的。因此，它将能和任何 40*d733ac93STang Yizhoucpufreq_driver协同工作。 41ffd1f19dSYanteng Si 42ffd1f19dSYanteng Si 43*d733ac93STang Yizhou2. 已提供的统计数据(有例子) 44ffd1f19dSYanteng Si===================================== 45ffd1f19dSYanteng Si 46ffd1f19dSYanteng Sicpufreq stats提供了以下统计数据（在下面详细解释）。 47ffd1f19dSYanteng Si 48ffd1f19dSYanteng Si- time_in_state 49ffd1f19dSYanteng Si- total_trans 50ffd1f19dSYanteng Si- trans_table 51ffd1f19dSYanteng Si 52*d733ac93STang Yizhou所有统计数据来自以下时间范围：从统计驱动被加载的时间（或统计数据被重置的时间）开始，到某一统计数据被读取的时间为止。 53*d733ac93STang Yizhou显然，统计驱动不会保存它被加载之前的任何频率转换信息。 54ffd1f19dSYanteng Si 55ffd1f19dSYanteng Si:: 56ffd1f19dSYanteng Si 57ffd1f19dSYanteng Si <mysystem>:/sys/devices/system/cpu/cpu0/cpufreq/stats # ls -l 58ffd1f19dSYanteng Si total 0 59ffd1f19dSYanteng Si drwxr-xr-x 2 root root 0 May 14 16:06 . 60ffd1f19dSYanteng Si drwxr-xr-x 3 root root 0 May 14 15:58 .. 61ffd1f19dSYanteng Si --w------- 1 root root 4096 May 14 16:06 reset 62ffd1f19dSYanteng Si -r--r--r-- 1 root root 4096 May 14 16:06 time_in_state 63ffd1f19dSYanteng Si -r--r--r-- 1 root root 4096 May 14 16:06 total_trans 64ffd1f19dSYanteng Si -r--r--r-- 1 root root 4096 May 14 16:06 trans_table 65ffd1f19dSYanteng Si 66ffd1f19dSYanteng Si- **reset** 67ffd1f19dSYanteng Si 68*d733ac93STang Yizhou只写属性，可用于重置统计计数器。这对于评估不同调节器的系统行为非常有用，且无需重启。 69ffd1f19dSYanteng Si 70ffd1f19dSYanteng Si 71ffd1f19dSYanteng Si- **time_in_state** 72ffd1f19dSYanteng Si 73*d733ac93STang Yizhou此文件给出了在本CPU支持的每个频率上分别花费的时间。cat输出的每一行都是一个"<frequency> 74*d733ac93STang Yizhou<time>"对，表示这个CPU在<frequency>上花费了<time>个usertime单位的时间。输出的每一行对应 75*d733ac93STang Yizhou一个CPU支持的频率。这里usertime单位是10mS（类似于/proc导出的其它时间）。 76ffd1f19dSYanteng Si 77ffd1f19dSYanteng Si:: 78ffd1f19dSYanteng Si 79ffd1f19dSYanteng Si <mysystem>:/sys/devices/system/cpu/cpu0/cpufreq/stats # cat time_in_state 80ffd1f19dSYanteng Si 3600000 2089 81ffd1f19dSYanteng Si 3400000 136 82ffd1f19dSYanteng Si 3200000 34 83ffd1f19dSYanteng Si 3000000 67 84ffd1f19dSYanteng Si 2800000 172488 85ffd1f19dSYanteng Si 86ffd1f19dSYanteng Si 87ffd1f19dSYanteng Si- **total_trans** 88ffd1f19dSYanteng Si 89*d733ac93STang Yizhou此文件给出了这个CPU频率转换的总次数。cat的输出是一个计数值，它就是频率转换的总次数。 90ffd1f19dSYanteng Si 91ffd1f19dSYanteng Si:: 92ffd1f19dSYanteng Si 93ffd1f19dSYanteng Si <mysystem>:/sys/devices/system/cpu/cpu0/cpufreq/stats # cat total_trans 94ffd1f19dSYanteng Si 20 95ffd1f19dSYanteng Si 96ffd1f19dSYanteng Si- **trans_table** 97ffd1f19dSYanteng Si 98*d733ac93STang Yizhou本文件提供所有CPU频率转换的细粒度信息。这里的cat输出是一个二维矩阵，其中一个条目<i, j>（第 99ffd1f19dSYanteng Sii行，第j列）代表从Freq_i到Freq_j的转换次数。Freq_i行和Freq_j列遵循驱动最初提供给cpufreq 100*d733ac93STang Yizhou核心的频率表的排列顺序，因此可以已排序（升序或降序）或未排序。这里的输出也包含了实际 101*d733ac93STang Yizhou频率值，分别按行和按列显示，以便更好地阅读。 102ffd1f19dSYanteng Si 103ffd1f19dSYanteng Si如果转换表大于PAGE_SIZE，读取时将返回一个-EFBIG错误。 104ffd1f19dSYanteng Si 105ffd1f19dSYanteng Si:: 106ffd1f19dSYanteng Si 107ffd1f19dSYanteng Si <mysystem>:/sys/devices/system/cpu/cpu0/cpufreq/stats # cat trans_table 108ffd1f19dSYanteng Si From : To 109ffd1f19dSYanteng Si : 3600000 3400000 3200000 3000000 2800000 110ffd1f19dSYanteng Si 3600000: 0 5 0 0 0 111ffd1f19dSYanteng Si 3400000: 4 0 2 0 0 112ffd1f19dSYanteng Si 3200000: 0 1 0 2 0 113ffd1f19dSYanteng Si 3000000: 0 0 1 0 3 114ffd1f19dSYanteng Si 2800000: 0 0 0 2 0 115ffd1f19dSYanteng Si 116ffd1f19dSYanteng Si3. 配置cpufreq-stats 117ffd1f19dSYanteng Si============================ 118ffd1f19dSYanteng Si 119*d733ac93STang Yizhou按以下方式在你的内核中配置cpufreq-stats:: 120ffd1f19dSYanteng Si 121ffd1f19dSYanteng Si Config Main Menu 122ffd1f19dSYanteng Si Power management options (ACPI, APM) ---> 123ffd1f19dSYanteng Si CPU Frequency scaling ---> 124ffd1f19dSYanteng Si [*] CPU Frequency scaling 125ffd1f19dSYanteng Si [*] CPU frequency translation statistics 126ffd1f19dSYanteng Si 127ffd1f19dSYanteng Si 128*d733ac93STang Yizhou"CPU Frequency scaling" (CONFIG_CPU_FREQ) 应该被启用，以支持配置cpufreq-stats。 129ffd1f19dSYanteng Si 130ffd1f19dSYanteng Si"CPU frequency translation statistics" (CONFIG_CPU_FREQ_STAT)提供了包括 131ffd1f19dSYanteng Sitime_in_state、total_trans和trans_table的统计数据。 132ffd1f19dSYanteng Si 133ffd1f19dSYanteng Si一旦启用了这个选项，并且你的CPU支持cpufrequency，你就可以在/sysfs中看到CPU频率统计。 134