core.rst

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