| 1 |
.. SPDX-License-Identifier: GPL-2.0 |
| 2 |
.. include:: ../disclaimer-zh_TW.rst |
| 3 |
|
| 4 |
:Original: Documentation/cpu-freq/core.rst |
| 5 |
|
| 6 |
:翻譯: |
| 7 |
|
| 8 |
司延騰 Yanteng Si <[email protected]> |
| 9 |
|
| 10 |
:校譯: |
| 11 |
|
| 12 |
唐藝舟 Tang Yizhou <[email protected]> |
| 13 |
|
| 14 |
==================================== |
| 15 |
CPUFreq核心和CPUFreq通知器的通用說明 |
| 16 |
==================================== |
| 17 |
|
| 18 |
作者: |
| 19 |
- Dominik Brodowski <[email protected]> |
| 20 |
- David Kimdon <[email protected]> |
| 21 |
- Rafael J. Wysocki <[email protected]> |
| 22 |
- Viresh Kumar <[email protected]> |
| 23 |
|
| 24 |
.. 目錄: |
| 25 |
|
| 26 |
1. CPUFreq核心和接口 |
| 27 |
2. CPUFreq通知器 |
| 28 |
3. 含有Operating Performance Point (OPP)的CPUFreq表的生成 |
| 29 |
|
| 30 |
1. CPUFreq核心和接口 |
| 31 |
====================== |
| 32 |
|
| 33 |
cpufreq核心代碼位於drivers/cpufreq/cpufreq.c中。這些cpufreq代碼爲CPUFreq架構的驅 |
| 34 |
動程序(那些執行硬件頻率切換的代碼)以及 "通知器" 提供了一個標準化的接口。 |
| 35 |
包括設備驅動程序;需要了解策略變化(如 ACPI 熱量管理),或所有頻率變化(如計時代碼), |
| 36 |
甚至需要強制限制爲指定頻率(如 ARM 架構上的 LCD 驅動程序)的其它內核組件。 |
| 37 |
此外,內核 "常數" loops_per_jiffy 會根據頻率變化而更新。 |
| 38 |
|
| 39 |
cpufreq策略的引用計數由 cpufreq_cpu_get 和 cpufreq_cpu_put 來完成,以確保 cpufreq 驅 |
| 40 |
動程序被正確地註冊到核心中,並且驅動程序在 cpufreq_put_cpu 被調用之前不會被卸載。這也保證 |
| 41 |
了每個CPU核的cpufreq 策略在使用期間不會被釋放。 |
| 42 |
|
| 43 |
2. CPUFreq 通知器 |
| 44 |
==================== |
| 45 |
|
| 46 |
CPUFreq通知器遵循標準的內核通知器接口。 |
| 47 |
關於通知器的細節請參閱 linux/include/linux/notifier.h。 |
| 48 |
|
| 49 |
這裏有兩個不同的CPUfreq通知器 - 策略通知器和轉換通知器。 |
| 50 |
|
| 51 |
|
| 52 |
2.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 |
|
| 64 |
2.2 CPUFreq轉換通知器 |
| 65 |
-------------------------------- |
| 66 |
|
| 67 |
當CPUfreq驅動切換CPU核心頻率時,策略中的每個在線CPU都會收到兩次通知,這些變化沒有任何外部幹 |
| 68 |
預。 |
| 69 |
|
| 70 |
第二個參數指定階段 - CPUFREQ_PRECHANGE or CPUFREQ_POSTCHANGE. |
| 71 |
|
| 72 |
第三個參數是一個包含如下值的結構體cpufreq_freqs: |
| 73 |
|
| 74 |
====== =============================== |
| 75 |
policy 指向struct cpufreq_policy的指針 |
| 76 |
old 舊頻率 |
| 77 |
new 新頻率 |
| 78 |
flags cpufreq驅動的標誌 |
| 79 |
====== =============================== |
| 80 |
|
| 81 |
3. 含有Operating Performance Point (OPP)的CPUFreq表的生成 |
| 82 |
================================================================== |
| 83 |
關於OPP的細節請參閱 Documentation/power/opp.rst |
| 84 |
|
| 85 |
dev_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 |
|
| 108 |
dev_pm_opp_free_cpufreq_table |
| 109 |
釋放dev_pm_opp_init_cpufreq_table分配的表。 |
| 110 |
|