1.. SPDX-License-Identifier: GPL-2.0 2.. include:: ../disclaimer-zh_CN.rst 3 4:Original: Documentation/cpu-freq/core.rst 5 6:翻译: 7 8 司延腾 Yanteng Si <siyanteng@loongson.cn> 9 10:校译: 11 12 唐艺舟 Tang Yizhou <tangyeechou@gmail.com> 13 14==================================== 15CPUFreq核心和CPUFreq通知器的通用说明 16==================================== 17 18作者: 19 - Dominik Brodowski <linux@brodo.de> 20 - David Kimdon <dwhedon@debian.org> 21 - Rafael J. Wysocki <rafael.j.wysocki@intel.com> 22 - Viresh Kumar <viresh.kumar@linaro.org> 23 24.. 目录: 25 26 1. CPUFreq核心和接口 27 2. CPUFreq通知器 28 3. 含有Operating Performance Point (OPP)的CPUFreq表的生成 29 301. CPUFreq核心和接口 31====================== 32 33cpufreq核心代码位于drivers/cpufreq/cpufreq.c中。这些cpufreq代码为CPUFreq架构的驱 34动程序（那些执行硬件频率切换的代码）以及 "通知器" 提供了一个标准化的接口。 35包括设备驱动程序；需要了解策略变化（如 ACPI 热量管理），或所有频率变化（如计时代码）， 36甚至需要强制限制为指定频率（如 ARM 架构上的 LCD 驱动程序）的其它内核组件。 37此外，内核 "常数" loops_per_jiffy 会根据频率变化而更新。 38 39cpufreq策略的引用计数由 cpufreq_cpu_get 和 cpufreq_cpu_put 来完成，以确保 cpufreq 驱 40动程序被正确地注册到核心中，并且驱动程序在 cpufreq_put_cpu 被调用之前不会被卸载。这也保证 41了每个CPU核的cpufreq 策略在使用期间不会被释放。 42 432. CPUFreq 通知器 44==================== 45 46CPUFreq通知器遵循标准的内核通知器接口。 47关于通知器的细节请参阅 linux/include/linux/notifier.h。 48 49这里有两个不同的CPUfreq通知器 - 策略通知器和转换通知器。 50 51 522.1 CPUFreq策略通知器 53---------------------------- 54 55当创建或移除策略时，这些都会被通知。 56 57阶段是在通知器的第二个参数中指定的。当第一次创建策略时，阶段是CPUFREQ_CREATE_POLICY，当 58策略被移除时，阶段是CPUFREQ_REMOVE_POLICY。 59 60第三个参数 ``void *pointer`` 指向一个结构体cpufreq_policy，其包括min，max(新策略的下限和 61上限（单位为kHz）)这几个值。 62 63 642.2 CPUFreq转换通知器 65-------------------------------- 66 67当CPUfreq驱动切换CPU核心频率时，策略中的每个在线CPU都会收到两次通知，这些变化没有任何外部干 68预。 69 70第二个参数指定阶段 - CPUFREQ_PRECHANGE or CPUFREQ_POSTCHANGE. 71 72第三个参数是一个包含如下值的结构体cpufreq_freqs： 73 74====== =============================== 75policy 指向struct cpufreq_policy的指针 76old 旧频率 77new 新频率 78flags cpufreq驱动的标志 79====== =============================== 80 813. 含有Operating Performance Point (OPP)的CPUFreq表的生成 82================================================================== 83关于OPP的细节请参阅 Documentation/power/opp.rst 84 85dev_pm_opp_init_cpufreq_table - 86 这个函数提供了一个随时可用的转换例程，用来将OPP层关于可用频率的内部信息翻译成一种 87 cpufreq易于处理的格式。 88 89 .. Warning:: 90 91 不要在中断上下文中使用此函数。 92 93 例如:: 94 95 soc_pm_init() 96 { 97 /* Do things */ 98 r = dev_pm_opp_init_cpufreq_table(dev, &freq_table); 99 if (!r) 100 policy->freq_table = freq_table; 101 /* Do other things */ 102 } 103 104 .. note:: 105 106 该函数只有在CONFIG_PM_OPP之外还启用了CONFIG_CPU_FREQ时才可用。 107 108dev_pm_opp_free_cpufreq_table 109 释放dev_pm_opp_init_cpufreq_table分配的表。 110