0001 .. SPDX-License-Identifier: GPL-2.0
0002 .. include:: ../disclaimer-zh_CN.rst
0003
0004 :Original: Documentation/cpu-freq/core.rst
0005
0006 :翻译:
0007
0008 司延腾 Yanteng Si <siyanteng@loongson.cn>
0009
0010 :校译:
0011
0012 唐艺舟 Tang Yizhou <tangyeechou@gmail.com>
0013
0014 ====================================
0015 CPUFreq核心和CPUFreq通知器的通用说明
0016 ====================================
0017
0018 作者:
0019 - Dominik Brodowski <linux@brodo.de>
0020 - David Kimdon <dwhedon@debian.org>
0021 - Rafael J. Wysocki <rafael.j.wysocki@intel.com>
0022 - Viresh Kumar <viresh.kumar@linaro.org>
0023
0024 .. 目录:
0025
0026 1. CPUFreq核心和接口
0027 2. CPUFreq通知器
0028 3. 含有Operating Performance Point (OPP)的CPUFreq表的生成
0029
0030 1. CPUFreq核心和接口
0031 ======================
0032
0033 cpufreq核心代码位于drivers/cpufreq/cpufreq.c中。这些cpufreq代码为CPUFreq架构的驱
0034 动程序（那些执行硬件频率切换的代码）以及 "通知器" 提供了一个标准化的接口。
0035 包括设备驱动程序；需要了解策略变化（如 ACPI 热量管理），或所有频率变化（如计时代码），
0036 甚至需要强制限制为指定频率（如 ARM 架构上的 LCD 驱动程序）的其它内核组件。
0037 此外，内核 "常数" loops_per_jiffy 会根据频率变化而更新。
0038
0039 cpufreq策略的引用计数由 cpufreq_cpu_get 和 cpufreq_cpu_put 来完成，以确保 cpufreq 驱
0040 动程序被正确地注册到核心中，并且驱动程序在 cpufreq_put_cpu 被调用之前不会被卸载。这也保证
0041 了每个CPU核的cpufreq 策略在使用期间不会被释放。
0042
0043 2. CPUFreq 通知器
0044 ====================
0045
0046 CPUFreq通知器遵循标准的内核通知器接口。
0047 关于通知器的细节请参阅 linux/include/linux/notifier.h。
0048
0049 这里有两个不同的CPUfreq通知器 - 策略通知器和转换通知器。
0050
0051
0052 2.1 CPUFreq策略通知器
0053 ----------------------------
0054
0055 当创建或移除策略时，这些都会被通知。
0056
0057 阶段是在通知器的第二个参数中指定的。当第一次创建策略时，阶段是CPUFREQ_CREATE_POLICY，当
0058 策略被移除时，阶段是CPUFREQ_REMOVE_POLICY。
0059
0060 第三个参数 ``void *pointer`` 指向一个结构体cpufreq_policy，其包括min，max(新策略的下限和
0061 上限（单位为kHz）)这几个值。
0062
0063
0064 2.2 CPUFreq转换通知器
0065 --------------------------------
0066
0067 当CPUfreq驱动切换CPU核心频率时，策略中的每个在线CPU都会收到两次通知，这些变化没有任何外部干
0068 预。
0069
0070 第二个参数指定阶段 - CPUFREQ_PRECHANGE or CPUFREQ_POSTCHANGE.
0071
0072 第三个参数是一个包含如下值的结构体cpufreq_freqs：
0073
0074 ====== ===============================
0075 policy 指向struct cpufreq_policy的指针
0076 old 旧频率
0077 new 新频率
0078 flags cpufreq驱动的标志
0079 ====== ===============================
0080
0081 3. 含有Operating Performance Point (OPP)的CPUFreq表的生成
0082 ==================================================================
0083 关于OPP的细节请参阅 Documentation/power/opp.rst
0084
0085 dev_pm_opp_init_cpufreq_table -
0086 这个函数提供了一个随时可用的转换例程，用来将OPP层关于可用频率的内部信息翻译成一种
0087 cpufreq易于处理的格式。
0088
0089 .. Warning::
0090
0091 不要在中断上下文中使用此函数。
0092
0093 例如::
0094
0095 soc_pm_init()
0096 {
0097 /* Do things */
0098 r = dev_pm_opp_init_cpufreq_table(dev, &freq_table);
0099 if (!r)
0100 policy->freq_table = freq_table;
0101 /* Do other things */
0102 }
0103
0104 .. note::
0105
0106 该函数只有在CONFIG_PM_OPP之外还启用了CONFIG_CPU_FREQ时才可用。
0107
0108 dev_pm_opp_free_cpufreq_table
0109 释放dev_pm_opp_init_cpufreq_table分配的表。
