0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 .. include:: ../disclaimer-zh_TW.rst
0004
0005 :Original: :doc:`../../../cpu-freq/core`
0006 :Translator: Yanteng Si <siyanteng@loongson.cn>
0007 Hu Haowen <src.res@email.cn>
0008
0009 .. _tw_core.rst:
0010
0011
0012 ====================================
0013 CPUFreq核心和CPUFreq通知器的通用說明
0014 ====================================
0015
0016 作者:
0017 - Dominik Brodowski <linux@brodo.de>
0018 - David Kimdon <dwhedon@debian.org>
0019 - Rafael J. Wysocki <rafael.j.wysocki@intel.com>
0020 - Viresh Kumar <viresh.kumar@linaro.org>
0021
0022 .. 目錄:
0023
0024 1. CPUFreq核心和接口
0025 2. CPUFreq通知器
0026 3. 含有Operating Performance Point (OPP)的CPUFreq表的生成
0027
0028 1. CPUFreq核心和接口
0029 ======================
0030
0031 cpufreq核心代碼位於drivers/cpufreq/cpufreq.c中。這些cpufreq代碼爲CPUFreq架構的驅
0032 動程序（那些操作硬體切換頻率的代碼）以及 "通知器 "提供了一個標準化的接口。
0033 這些是設備驅動程序或需要了解策略變化的其它內核部分（如 ACPI 熱量管理）或所有頻率更改（除
0034 計時代碼外），甚至需要強制確定速度限制的通知器（如 ARM 架構上的 LCD 驅動程序）。
0035 此外， 內核 "常數" loops_per_jiffy會根據頻率變化而更新。
0036
0037 cpufreq策略的引用計數由 cpufreq_cpu_get 和 cpufreq_cpu_put 來完成，以確保 cpufreq 驅
0038 動程序被正確地註冊到核心中，並且驅動程序在 cpufreq_put_cpu 被調用之前不會被卸載。這也保證
0039 了每個CPU核的cpufreq 策略在使用期間不會被釋放。
0040
0041 2. CPUFreq 通知器
0042 ====================
0043
0044 CPUFreq通知器符合標準的內核通知器接口。
0045 關於通知器的細節請參閱 linux/include/linux/notifier.h。
0046
0047 這裡有兩個不同的CPUfreq通知器 - 策略通知器和轉換通知器。
0048
0049
0050 2.1 CPUFreq策略通知器
0051 ----------------------------
0052
0053 當創建或移除策略時，這些都會被通知。
0054
0055 階段是在通知器的第二個參數中指定的。當第一次創建策略時，階段是CPUFREQ_CREATE_POLICY，當
0056 策略被移除時，階段是CPUFREQ_REMOVE_POLICY。
0057
0058 第三個參數 ``void *pointer`` 指向一個結構體cpufreq_policy，其包括min，max(新策略的下限和
0059 上限（單位爲kHz）)這幾個值。
0060
0061
0062 2.2 CPUFreq轉換通知器
0063 --------------------------------
0064
0065 當CPUfreq驅動切換CPU核心頻率時，策略中的每個在線CPU都會收到兩次通知，這些變化沒有任何外部干
0066 預。
0067
0068 第二個參數指定階段 - CPUFREQ_PRECHANGE or CPUFREQ_POSTCHANGE.
0069
0070 第三個參數是一個包含如下值的結構體cpufreq_freqs：
0071
0072 ===== ====================
0073 cpu 受影響cpu的編號
0074 old 舊頻率
0075 new 新頻率
0076 flags cpufreq驅動的標誌
0077 ===== ====================
0078
0079 3. 含有Operating Performance Point (OPP)的CPUFreq表的生成
0080 ==================================================================
0081 關於OPP的細節請參閱 Documentation/power/opp.rst
0082
0083 dev_pm_opp_init_cpufreq_table -
0084 這個功能提供了一個隨時可用的轉換程序，用來將OPP層關於可用頻率的內部信息翻譯成一種容易提供給
0085 cpufreq的格式。
0086
0087 .. Warning::
0088
0089 不要在中斷上下文中使用此函數。
0090
0091 例如::
0092
0093 soc_pm_init()
0094 {
0095 /* Do things */
0096 r = dev_pm_opp_init_cpufreq_table(dev, &freq_table);
0097 if (!r)
0098 policy->freq_table = freq_table;
0099 /* Do other things */
0100 }
0101
0102 .. note::
0103
0104 該函數只有在CONFIG_PM_OPP之外還啓用了CONFIG_CPU_FREQ時才可用。
0105
0106 dev_pm_opp_free_cpufreq_table
0107 釋放dev_pm_opp_init_cpufreq_table分配的表。
0108
