Hi Jiaxun
Do you mind if I add the following?
+:校译:
+
+ Jiaxun Yang <jiaxun.yang@xxxxxxxxxxx>
Jiaxun Yang <jiaxun.yang@xxxxxxxxxxx> 于2021年3月26日周五 上午11:13写道：
>
>
>
> On Wed, Mar 24, 2021, at 11:07 PM, Yanteng Si wrote:
> > This patch translates Documention/cpu-freq/core.rst into Chinese.
> >
> > Signed-off-by: Yanteng Si <siyanteng@xxxxxxxxxxx>
> > ---
> > .../translations/zh_CN/cpu-freq/core.rst | 105 ++++++++++++++++++
> > 1 file changed, 105 insertions(+)
> > create mode 100644 Documentation/translations/zh_CN/cpu-freq/core.rst
> >
> > diff --git a/Documentation/translations/zh_CN/cpu-freq/core.rst
> > b/Documentation/translations/zh_CN/cpu-freq/core.rst
> > new file mode 100644
> > index 000000000000..1571087c2581
> > --- /dev/null
> > +++ b/Documentation/translations/zh_CN/cpu-freq/core.rst
> > @@ -0,0 +1,105 @@
> > +.. SPDX-License-Identifier: GPL-2.0
> > +.. include:: ../disclaimer-zh_CN.rst
> > +
> > +:Original: :doc:`../../../cpu-freq/core`
> > +:Translator: Yanteng Si <siyanteng@xxxxxxxxxxx>
> > +
> > +.. _cn_core.rst:
> > +
> > +
> > +====================================
> > +CPUFreq核心和CPUFreq通知器的一般说明
> > +====================================
>
> 一般 -> 通用？
>
> > +
> > +作者:
> > + - Dominik Brodowski <linux@xxxxxxxx>
> > + - David Kimdon <dwhedon@xxxxxxxxxx>
> > + - Rafael J. Wysocki <rafael.j.wysocki@xxxxxxxxx>
> > + - Viresh Kumar <viresh.kumar@xxxxxxxxxx>
> > +
> > +.. 目录:
> > +
> > + 1. CPUFreq核心和接口
> > + 2. CPUFreq通知器
> > + 3. 含有Operating Performance Point (OPP)的CPUFreq表的生成
> > +
> > +1. CPUFreq核心和接口
> > +======================
> > +
> > +cpufreq核心代码位于drivers/cpufreq/cpufreq.c中。这些cpufreq代码为CPUFreq架构的驱
> > +动程序（那些进行实际频率转换的代码）以及 "通知器 "提供了一个标准化的接口。
>
> 那些操作硬件切换频率的代码 will help with understanding.
>
>
> > +这些是设备驱动程序或需要了解策略变化的其它内核部分（如 ACPI 等热模块）或所有频率更改（除
> Add sbject "通知器"
> 热模块 seems bogus, 热量管理？
>
> > +计时代码外），甚至需要强制确定速度限制（如 ARM 架构上的 LCD 驱动程序）。
> > +此外， 内核 "常数" loops_per_jiffy会根据频率变化而更新。
> > +
> > +cpufreq策略的引用计数由 cpufreq_cpu_get 和 cpufreq_cpu_put 来完成，以确保 cpufreq 驱
> > +动程序被正确地注册到核心中，并且在 cpufreq_put_cpu 被调用之前不会被卸载。这也保证了各自的
> > +cpufreq 策略在使用时不会被释放。
>
> It makes me "Parser error" when reading.....
>
> > +
> > +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：
> > +
> > +===== ====================
> > +cpu 受影响cpu的编号
> > +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分配的表。
> > --
> > 2.25.1
> >
> >
>
> --
> - Jiaxun
Thanks
Yanteng
