cpu-freq/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 ====================================
  15 CPUFreq核心和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
  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