Documentation/translations/zh_CN/cpu-freq/core.rst

   1 .. SPDX-License-Identifier: GPL-2.0
   2 .. include:: ../disclaimer-zh_CN.rst
   3
   4 :Original: :doc:`../../../cpu-freq/core`
   5 :Translator: Yanteng Si <siyanteng@loongson.cn>
   6
   7 .. _cn_core.rst:
   8
   9
  10 ====================================
  11 CPUFreq核心和CPUFreq通知器的通用说明
  12 ====================================
  13
  14 作者:
  15         - Dominik Brodowski  <linux@brodo.de>
  16         - David Kimdon <dwhedon@debian.org>
  17         - Rafael J. Wysocki <rafael.j.wysocki@intel.com>
  18         - Viresh Kumar <viresh.kumar@linaro.org>
  19
  20 .. 目录:
  21
  22    1.  CPUFreq核心和接口
  23    2.  CPUFreq通知器
  24    3.  含有Operating Performance Point (OPP)的CPUFreq表的生成
  25
  26 1. CPUFreq核心和接口
  27 ======================
  28
  29 cpufreq核心代码位于drivers/cpufreq/cpufreq.c中。这些cpufreq代码为CPUFreq架构的驱
  30 动程序（那些操作硬件切换频率的代码）以及 "通知器 "提供了一个标准化的接口。
  31 这些是设备驱动程序或需要了解策略变化的其它内核部分（如 ACPI 热量管理）或所有频率更改（除
  32 计时代码外），甚至需要强制确定速度限制的通知器（如 ARM 架构上的 LCD 驱动程序）。
  33 此外， 内核 "常数" loops_per_jiffy会根据频率变化而更新。
  34
  35 cpufreq策略的引用计数由 cpufreq_cpu_get 和 cpufreq_cpu_put 来完成，以确保 cpufreq 驱
  36 动程序被正确地注册到核心中，并且驱动程序在 cpufreq_put_cpu 被调用之前不会被卸载。这也保证
  37 了每个CPU核的cpufreq 策略在使用期间不会被释放。
  38
  39 2. CPUFreq 通知器
  40 ====================
  41
  42 CPUFreq通知器符合标准的内核通知器接口。
  43 关于通知器的细节请参阅 linux/include/linux/notifier.h。
  44
  45 这里有两个不同的CPUfreq通知器 - 策略通知器和转换通知器。
  46
  47
  48 2.1 CPUFreq策略通知器
  49 ----------------------------
  50
  51 当创建或移除策略时，这些都会被通知。
  52
  53 阶段是在通知器的第二个参数中指定的。当第一次创建策略时，阶段是CPUFREQ_CREATE_POLICY，当
  54 策略被移除时，阶段是CPUFREQ_REMOVE_POLICY。
  55
  56 第三个参数 ``void *pointer`` 指向一个结构体cpufreq_policy，其包括min，max(新策略的下限和
  57 上限（单位为kHz）)这几个值。
  58
  59
  60 2.2 CPUFreq转换通知器
  61 --------------------------------
  62
  63 当CPUfreq驱动切换CPU核心频率时，策略中的每个在线CPU都会收到两次通知，这些变化没有任何外部干
  64 预。
  65
  66 第二个参数指定阶段 - CPUFREQ_PRECHANGE or CPUFREQ_POSTCHANGE.
  67
  68 第三个参数是一个包含如下值的结构体cpufreq_freqs：
  69
  70 =====   ====================
  71 cpu     受影响cpu的编号
  72 old     旧频率
  73 new     新频率
  74 flags   cpufreq驱动的标志
  75 =====   ====================
  76
  77 3. 含有Operating Performance Point (OPP)的CPUFreq表的生成
  78 ==================================================================
  79 关于OPP的细节请参阅 Documentation/power/opp.rst
  80
  81 dev_pm_opp_init_cpufreq_table -
  82         这个功能提供了一个随时可用的转换程序，用来将OPP层关于可用频率的内部信息翻译成一种容易提供给
  83         cpufreq的格式。
  84
  85         .. Warning::
  86
  87                 不要在中断上下文中使用此函数。
  88
  89         例如::
  90
  91          soc_pm_init()
  92          {
  93                 /* Do things */
  94                 r = dev_pm_opp_init_cpufreq_table(dev, &freq_table);
  95                 if (!r)
  96                         policy->freq_table = freq_table;
  97                 /* Do other things */
  98          }
  99
 100         .. note::
 101
 102                 该函数只有在CONFIG_PM_OPP之外还启用了CONFIG_CPU_FREQ时才可用。
 103
 104 dev_pm_opp_free_cpufreq_table
 105         释放dev_pm_opp_init_cpufreq_table分配的表。