mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-27 12:57:53 +00:00
f949cb7590
The content of zh_TW was too outdated comparing to the original files.
Consequently carry out improvements in order to both keep track of sources
and fix several grammatical mistakes in traditional Chinese.
This is a thorough rewrite of the previous patch:
https://lore.kernel.org/linux-doc/20230807120006.6361-1-src.res.211@gmail.com/
in order to get rid of text damage and merging errors, created based on
linux-next (date: Oct. 9, 2023).
Signed-off-by: Hu Haowen <src.res.211@gmail.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/20231011051212.17580-1-src.res.211@gmail.com
110 lines
3.5 KiB
ReStructuredText
110 lines
3.5 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
||
.. include:: ../disclaimer-zh_TW.rst
|
||
|
||
:Original: Documentation/cpu-freq/core.rst
|
||
|
||
:翻譯:
|
||
|
||
司延騰 Yanteng Si <siyanteng@loongson.cn>
|
||
|
||
:校譯:
|
||
|
||
唐藝舟 Tang Yizhou <tangyeechou@gmail.com>
|
||
|
||
====================================
|
||
CPUFreq核心和CPUFreq通知器的通用說明
|
||
====================================
|
||
|
||
作者:
|
||
- Dominik Brodowski <linux@brodo.de>
|
||
- David Kimdon <dwhedon@debian.org>
|
||
- Rafael J. Wysocki <rafael.j.wysocki@intel.com>
|
||
- Viresh Kumar <viresh.kumar@linaro.org>
|
||
|
||
.. 目錄:
|
||
|
||
1. CPUFreq核心和接口
|
||
2. CPUFreq通知器
|
||
3. 含有Operating Performance Point (OPP)的CPUFreq表的生成
|
||
|
||
1. CPUFreq核心和接口
|
||
======================
|
||
|
||
cpufreq核心代碼位於drivers/cpufreq/cpufreq.c中。這些cpufreq代碼爲CPUFreq架構的驅
|
||
動程序（那些執行硬件頻率切換的代碼）以及 "通知器" 提供了一個標準化的接口。
|
||
包括設備驅動程序；需要了解策略變化（如 ACPI 熱量管理），或所有頻率變化（如計時代碼），
|
||
甚至需要強制限制爲指定頻率（如 ARM 架構上的 LCD 驅動程序）的其它內核組件。
|
||
此外，內核 "常數" loops_per_jiffy 會根據頻率變化而更新。
|
||
|
||
cpufreq策略的引用計數由 cpufreq_cpu_get 和 cpufreq_cpu_put 來完成，以確保 cpufreq 驅
|
||
動程序被正確地註冊到核心中，並且驅動程序在 cpufreq_put_cpu 被調用之前不會被卸載。這也保證
|
||
了每個CPU核的cpufreq 策略在使用期間不會被釋放。
|
||
|
||
2. CPUFreq 通知器
|
||
====================
|
||
|
||
CPUFreq通知器遵循標準的內核通知器接口。
|
||
關於通知器的細節請參閱 linux/include/linux/notifier.h。
|
||
|
||
這裏有兩個不同的CPUfreq通知器 - 策略通知器和轉換通知器。
|
||
|
||
|
||
2.1 CPUFreq策略通知器
|
||
----------------------------
|
||
|
||
當創建或移除策略時，這些都會被通知。
|
||
|
||
階段是在通知器的第二個參數中指定的。當第一次創建策略時，階段是CPUFREQ_CREATE_POLICY，當
|
||
策略被移除時，階段是CPUFREQ_REMOVE_POLICY。
|
||
|
||
第三個參數 ``void *pointer`` 指向一個結構體cpufreq_policy，其包括min，max(新策略的下限和
|
||
上限（單位爲kHz）)這幾個值。
|
||
|
||
|
||
2.2 CPUFreq轉換通知器
|
||
--------------------------------
|
||
|
||
當CPUfreq驅動切換CPU核心頻率時，策略中的每個在線CPU都會收到兩次通知，這些變化沒有任何外部幹
|
||
預。
|
||
|
||
第二個參數指定階段 - CPUFREQ_PRECHANGE or CPUFREQ_POSTCHANGE.
|
||
|
||
第三個參數是一個包含如下值的結構體cpufreq_freqs：
|
||
|
||
====== ===============================
|
||
policy 指向struct cpufreq_policy的指針
|
||
old 舊頻率
|
||
new 新頻率
|
||
flags cpufreq驅動的標誌
|
||
====== ===============================
|
||
|
||
3. 含有Operating Performance Point (OPP)的CPUFreq表的生成
|
||
==================================================================
|
||
關於OPP的細節請參閱 Documentation/power/opp.rst
|
||
|
||
dev_pm_opp_init_cpufreq_table -
|
||
這個函數提供了一個隨時可用的轉換例程，用來將OPP層關於可用頻率的內部信息翻譯成一種
|
||
cpufreq易於處理的格式。
|
||
|
||
.. Warning::
|
||
|
||
不要在中斷上下文中使用此函數。
|
||
|
||
例如::
|
||
|
||
soc_pm_init()
|
||
{
|
||
/* Do things */
|
||
r = dev_pm_opp_init_cpufreq_table(dev, &freq_table);
|
||
if (!r)
|
||
policy->freq_table = freq_table;
|
||
/* Do other things */
|
||
}
|
||
|
||
.. note::
|
||
|
||
該函數只有在CONFIG_PM_OPP之外還啓用了CONFIG_CPU_FREQ時纔可用。
|
||
|
||
dev_pm_opp_free_cpufreq_table
|
||
釋放dev_pm_opp_init_cpufreq_table分配的表。
|
||
|