1.. SPDX-License-Identifier: GPL-2.0 2 3.. include:: ../disclaimer-zh_TW.rst 4 5:Original: :doc:`../../../cpu-freq/core` 6:Translator: Yanteng Si <siyanteng@loongson.cn> 7 Hu Haowen <src.res@email.cn> 8 9.. _tw_core.rst: 10 11 12==================================== 13CPUFreq核心和CPUFreq通知器的通用說明 14==================================== 15 16作者: 17 - Dominik Brodowski <linux@brodo.de> 18 - David Kimdon <dwhedon@debian.org> 19 - Rafael J. Wysocki <rafael.j.wysocki@intel.com> 20 - Viresh Kumar <viresh.kumar@linaro.org> 21 22.. 目錄: 23 24 1. CPUFreq核心和接口 25 2. CPUFreq通知器 26 3. 含有Operating Performance Point (OPP)的CPUFreq表的生成 27 281. CPUFreq核心和接口 29====================== 30 31cpufreq核心代碼位於drivers/cpufreq/cpufreq.c中。這些cpufreq代碼爲CPUFreq架構的驅 32動程序（那些操作硬體切換頻率的代碼）以及 "通知器 "提供了一個標準化的接口。 33這些是設備驅動程序或需要了解策略變化的其它內核部分（如 ACPI 熱量管理）或所有頻率更改（除 34計時代碼外），甚至需要強制確定速度限制的通知器（如 ARM 架構上的 LCD 驅動程序）。 35此外， 內核 "常數" loops_per_jiffy會根據頻率變化而更新。 36 37cpufreq策略的引用計數由 cpufreq_cpu_get 和 cpufreq_cpu_put 來完成，以確保 cpufreq 驅 38動程序被正確地註冊到核心中，並且驅動程序在 cpufreq_put_cpu 被調用之前不會被卸載。這也保證 39了每個CPU核的cpufreq 策略在使用期間不會被釋放。 40 412. CPUFreq 通知器 42==================== 43 44CPUFreq通知器符合標準的內核通知器接口。 45關於通知器的細節請參閱 linux/include/linux/notifier.h。 46 47這裡有兩個不同的CPUfreq通知器 - 策略通知器和轉換通知器。 48 49 502.1 CPUFreq策略通知器 51---------------------------- 52 53當創建或移除策略時，這些都會被通知。 54 55階段是在通知器的第二個參數中指定的。當第一次創建策略時，階段是CPUFREQ_CREATE_POLICY，當 56策略被移除時，階段是CPUFREQ_REMOVE_POLICY。 57 58第三個參數 ``void *pointer`` 指向一個結構體cpufreq_policy，其包括min，max(新策略的下限和 59上限（單位爲kHz）)這幾個值。 60 61 622.2 CPUFreq轉換通知器 63-------------------------------- 64 65當CPUfreq驅動切換CPU核心頻率時，策略中的每個在線CPU都會收到兩次通知，這些變化沒有任何外部干 66預。 67 68第二個參數指定階段 - CPUFREQ_PRECHANGE or CPUFREQ_POSTCHANGE. 69 70第三個參數是一個包含如下值的結構體cpufreq_freqs： 71 72===== ==================== 73cpu 受影響cpu的編號 74old 舊頻率 75new 新頻率 76flags cpufreq驅動的標誌 77===== ==================== 78 793. 含有Operating Performance Point (OPP)的CPUFreq表的生成 80================================================================== 81關於OPP的細節請參閱 Documentation/power/opp.rst 82 83dev_pm_opp_init_cpufreq_table - 84 這個功能提供了一個隨時可用的轉換程序，用來將OPP層關於可用頻率的內部信息翻譯成一種容易提供給 85 cpufreq的格式。 86 87 .. Warning:: 88 89 不要在中斷上下文中使用此函數。 90 91 例如:: 92 93 soc_pm_init() 94 { 95 /* Do things */ 96 r = dev_pm_opp_init_cpufreq_table(dev, &freq_table); 97 if (!r) 98 policy->freq_table = freq_table; 99 /* Do other things */ 100 } 101 102 .. note:: 103 104 該函數只有在CONFIG_PM_OPP之外還啓用了CONFIG_CPU_FREQ時才可用。 105 106dev_pm_opp_free_cpufreq_table 107 釋放dev_pm_opp_init_cpufreq_table分配的表。 108 109