sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget /power/oppmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/zh_TW/power/oppmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/it_IT/power/oppmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/ja_JP/power/oppmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/ko_KR/power/oppmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/sp_SP/power/oppmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageChinese (Simplified)uh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhJ/var/lib/git/docbuild/linux/Documentation/translations/zh_CN/power/opp.rsthKubhnote)}(hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。h]h paragraph)}(hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。h]hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hh5Documentation/translations/zh_CN/disclaimer-zh_CN.rsthKhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh field_list)}(hhh](hfield)}(hhh](h field_name)}(hOriginalh]hOriginal}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh field_body)}(hDocumentation/power/opp.rst h]h)}(hDocumentation/power/opp.rsth]hDocumentation/power/opp.rst}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(h翻译h]h翻译}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhKubh)}(h.唐艺舟 Tang Yizhou h]h)}(h-唐艺舟 Tang Yizhou h](h唐艺舟 Tang Yizhou <}(hj hhhNhNubh reference)}(htangyeechou@gmail.comh]htangyeechou@gmail.com}(hj*hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:tangyeechou@gmail.comuh1j(hj ubh>}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhj ubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhsection)}(hhh](htitle)}(h操作性能值（OPP）库h]h操作性能值（OPP）库}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjXhhhhhK ubhenumerated_list)}(hhh]h list_item)}(h92009-2010 Nishanth Menon , 德州仪器公司 h]h)}(h82009-2010 Nishanth Menon , 德州仪器公司h](h2009-2010 Nishanth Menon <}(hjvhhhNhNubj))}(h nm@ti.comh]h nm@ti.com}(hj~hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:nm@ti.comuh1j(hjvubh>, 德州仪器公司}(hjvhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjrubah}(h]h ]h"]h$]h&]uh1jphjmhhhhhNubah}(h]h ]h"]h$]h&]enumtype upperalphaprefix(suffix)startKuh1jkhjXhhhhhKubh)}(h目录 1. 简介 2. OPP链表初始注册 3. OPP搜索函数 4. OPP可用性控制函数 5. OPP数据检索函数 6. 数据结构h]h目录 1. 简介 2. OPP链表初始注册 3. OPP搜索函数 4. OPP可用性控制函数 5. OPP数据检索函数 6. 数据结构}hjsbah}(h]h ]h"]h$]h&]hhuh1hhjXhhhhhKubjW)}(hhh](j\)}(h 1. 简介h]h 1. 简介}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjhhhhhKubjW)}(hhh](j\)}(h%1.1 何为操作性能值（OPP）？h]h%1.1 何为操作性能值（OPP）？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjhhhhhKubh)}(hX当今复杂的单片系统（SoC）由多个子模块组成，这些子模块会联合工作。在一个执行不同用例 的操作系统中，并不是SoC中的所有模块都需要一直以最高频率工作。为了促成这一点，SoC中 的子模块被分组为不同域，允许一些域以较低的电压和频率运行，而其它域则以较高的“电压/ 频率对”运行。h]hX当今复杂的单片系统（SoC）由多个子模块组成，这些子模块会联合工作。在一个执行不同用例 的操作系统中，并不是SoC中的所有模块都需要一直以最高频率工作。为了促成这一点，SoC中 的子模块被分组为不同域，允许一些域以较低的电压和频率运行，而其它域则以较高的“电压/ 频率对”运行。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hy设备按域支持的由频率电压对组成的离散的元组的集合，被称为操作性能值（组），或OPPs。h]hy设备按域支持的由频率电压对组成的离散的元组的集合，被称为操作性能值（组），或OPPs。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK$hjhhubh)}(h举例来说：h]h举例来说：}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK&hjhhubh)}(h让我们考虑一个支持下述频率、电压值的内存保护单元（MPU）设备： {300MHz，最低电压为1V}, {800MHz，最低电压为1.2V}, {1GHz，最低电压为1.3V}h]h让我们考虑一个支持下述频率、电压值的内存保护单元（MPU）设备： {300MHz，最低电压为1V}, {800MHz，最低电压为1.2V}, {1GHz，最低电压为1.3V}}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK(hjhhubh)}(h我们能将它们表示为3个OPP，如下述{Hz, uV}元组（译注：频率的单位是赫兹，电压的单位是 微伏）。h]h我们能将它们表示为3个OPP，如下述{Hz, uV}元组（译注：频率的单位是赫兹，电压的单位是 微伏）。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hjhhubh bullet_list)}(hhh](jq)}(h{300000000, 1000000}h]h)}(hj(h]h{300000000, 1000000}}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hj&ubah}(h]h ]h"]h$]h&]uh1jphj#hhhhhNubjq)}(h{800000000, 1200000}h]h)}(hj?h]h{800000000, 1200000}}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hj=ubah}(h]h ]h"]h$]h&]uh1jphj#hhhhhNubjq)}(h{1000000000, 1300000} h]h)}(h{1000000000, 1300000}h]h{1000000000, 1300000}}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjTubah}(h]h ]h"]h$]h&]uh1jphj#hhhhhNubeh}(h]h ]h"]h$]h&]bullet-uh1j!hhhK.hjhhubeh}(h]id2ah ]h"]%1.1 何为操作性能值（opp）？ah$]h&]uh1jVhjhhhhhKubjW)}(hhh](j\)}(h1.2 操作性能值库h]h1.2 操作性能值库}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hj|hhhhhK3ubh)}(hX2OPP库提供了一组辅助函数来组织和查询OPP信息。该库位于drivers/opp/目录下，其头文件 位于include/linux/pm_opp.h中。OPP库可以通过开启CONFIG_PM_OPP来启用。某些SoC， 如德州仪器的OMAP框架允许在不需要cpufreq的情况下可选地在某一OPP下启动。h]hX2OPP库提供了一组辅助函数来组织和查询OPP信息。该库位于drivers/opp/目录下，其头文件 位于include/linux/pm_opp.h中。OPP库可以通过开启CONFIG_PM_OPP来启用。某些SoC， 如德州仪器的OMAP框架允许在不需要cpufreq的情况下可选地在某一OPP下启动。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hj|hhubh)}(hOPP库的典型用法如下::h]hOPP库的典型用法如下:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hj|hhubh literal_block)}(h（用户） -> 注册一个默认的OPP集合 -> （库） （SoC框架） -> 在必要的情况下，对某些OPP进行修改 -> OPP layer -> 搜索/检索信息的查询 ->h]h（用户） -> 注册一个默认的OPP集合 -> （库） （SoC框架） -> 在必要的情况下，对某些OPP进行修改 -> OPP layer -> 搜索/检索信息的查询 ->}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhK;hj|hhubh)}(hX5OPP层期望每个域由一个唯一的设备指针来表示。SoC框架在OPP层为每个设备注册了一组初始 OPP。这个链表的长度被期望是一个最优化的小数字，通常每个设备大约5个。初始链表包含了 一个OPP集合，这个集合被期望能在系统中安全使能。h]hX5OPP层期望每个域由一个唯一的设备指针来表示。SoC框架在OPP层为每个设备注册了一组初始 OPP。这个链表的长度被期望是一个最优化的小数字，通常每个设备大约5个。初始链表包含了 一个OPP集合，这个集合被期望能在系统中安全使能。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hj|hhubjW)}(hhh](j\)}(h关于OPP可用性的说明h]h关于OPP可用性的说明}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjhhhhhKDubh)}(hX.随着系统的运行，SoC框架可能会基于各种外部因素选择让某些OPP在每个设备上可用或不可用， 示例：温度管理或其它异常场景中，SoC框架可能会选择禁用一个较高频率的OPP以安全地继续 运行，直到该OPP被重新启用（如果可能）。h]hX.随着系统的运行，SoC框架可能会基于各种外部因素选择让某些OPP在每个设备上可用或不可用， 示例：温度管理或其它异常场景中，SoC框架可能会选择禁用一个较高频率的OPP以安全地继续 运行，直到该OPP被重新启用（如果可能）。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhjhhubh)}(hOPP库在它的实现中达成了这个概念。以下操作函数只能对可用的OPP使用： dev_pm_opp_find_freq_{ceil, floor}, dev_pm_opp_get_voltage, dev_pm_opp_get_freq, dev_pm_opp_get_opp_count。h]hOPP库在它的实现中达成了这个概念。以下操作函数只能对可用的OPP使用： dev_pm_opp_find_freq_{ceil, floor}, dev_pm_opp_get_voltage, dev_pm_opp_get_freq, dev_pm_opp_get_opp_count。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhjhhubh)}(hdev_pm_opp_find_freq_exact是用来查找OPP指针的，该指针可被用在dev_pm_opp_enable/ disable函数，使一个OPP在被需要时变为可用。h]hdev_pm_opp_find_freq_exact是用来查找OPP指针的，该指针可被用在dev_pm_opp_enable/ disable函数，使一个OPP在被需要时变为可用。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKNhjhhubh)}(hXq警告：如果对一个设备调用dev_pm_opp_enable/disable函数，OPP库的用户应该使用 dev_pm_opp_get_opp_count来刷新OPP的可用性计数。触发这些的具体机制，或者对有依赖的 子系统（比如cpufreq）的通知机制，都是由使用OPP库的SoC特定框架酌情处理的。在这些操作 中，同样需要注意刷新cpufreq表。h]hXq警告：如果对一个设备调用dev_pm_opp_enable/disable函数，OPP库的用户应该使用 dev_pm_opp_get_opp_count来刷新OPP的可用性计数。触发这些的具体机制，或者对有依赖的 子系统（比如cpufreq）的通知机制，都是由使用OPP库的SoC特定框架酌情处理的。在这些操作 中，同样需要注意刷新cpufreq表。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKQhjhhubeh}(h]id4ah ]h"]关于opp可用性的说明ah$]h&]uh1jVhj|hhhhhKDubeh}(h]id3ah ]h"]1.2 操作性能值库ah$]h&]uh1jVhjhhhhhK3ubeh}(h]id1ah ]h"] 1. 简介ah$]h&]uh1jVhjXhhhhhKubjW)}(hhh](j\)}(h2. OPP链表初始注册h]h2. OPP链表初始注册}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1j[hj(hhhhhKWubh)}(hXVSoC的实现会迭代调用dev_pm_opp_add函数来增加每个设备的OPP。预期SoC框架将以最优的 方式注册OPP条目 - 典型的数字范围小于5。通过注册OPP生成的OPP链表，在整个设备运行过程 中由OPP库维护。SoC框架随后可以使用dev_pm_opp_enable / disable函数动态地 控制OPP的可用性。h]hXVSoC的实现会迭代调用dev_pm_opp_add函数来增加每个设备的OPP。预期SoC框架将以最优的 方式注册OPP条目 - 典型的数字范围小于5。通过注册OPP生成的OPP链表，在整个设备运行过程 中由OPP库维护。SoC框架随后可以使用dev_pm_opp_enable / disable函数动态地 控制OPP的可用性。}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKXhj(hhubhdefinition_list)}(hhh]hdefinition_list_item)}(hXdev_pm_opp_add 为设备指针所指向的特定域添加一个新的OPP。OPP是用频率和电压定义的。一旦完成 添加，OPP被认为是可用的，可以用dev_pm_opp_enable/disable函数来控制其可用性。 OPP库内部用dev_pm_opp结构体存储并管理这些信息。这个函数可以被SoC框架根据SoC 的使用环境的需求来定义一个最优链表。 警告： 不要在中断上下文使用这个函数。 示例:: soc_pm_init() { /* 做一些事情 */ r = dev_pm_opp_add(mpu_dev, 1000000, 900000); if (!r) { pr_err("%s: unable to register mpu opp(%d)\n", r); goto no_cpufreq; } /* 做一些和cpufreq相关的事情 */ no_cpufreq: /* 做剩余的事情 */ } h](hterm)}(hdev_pm_opp_addh]hdev_pm_opp_add}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhKshjNubh definition)}(hhh](h)}(hXp为设备指针所指向的特定域添加一个新的OPP。OPP是用频率和电压定义的。一旦完成 添加，OPP被认为是可用的，可以用dev_pm_opp_enable/disable函数来控制其可用性。 OPP库内部用dev_pm_opp结构体存储并管理这些信息。这个函数可以被SoC框架根据SoC 的使用环境的需求来定义一个最优链表。h]hXp为设备指针所指向的特定域添加一个新的OPP。OPP是用频率和电压定义的。一旦完成 添加，OPP被认为是可用的，可以用dev_pm_opp_enable/disable函数来控制其可用性。 OPP库内部用dev_pm_opp结构体存储并管理这些信息。这个函数可以被SoC框架根据SoC 的使用环境的需求来定义一个最优链表。}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK^hjdubjH)}(hhh]jM)}(h8警告： 不要在中断上下文使用这个函数。 h](jS)}(h 警告：h]h 警告：}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhKdhjxubjc)}(hhh]h)}(h-不要在中断上下文使用这个函数。h]h-不要在中断上下文使用这个函数。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKdhjubah}(h]h ]h"]h$]h&]uh1jbhjxubeh}(h]h ]h"]h$]h&]uh1jLhhhKdhjuubah}(h]h ]h"]h$]h&]uh1jGhjdubh)}(h示例::h]h示例:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhjdubj)}(hX;soc_pm_init() { /* 做一些事情 */ r = dev_pm_opp_add(mpu_dev, 1000000, 900000); if (!r) { pr_err("%s: unable to register mpu opp(%d)\n", r); goto no_cpufreq; } /* 做一些和cpufreq相关的事情 */ no_cpufreq: /* 做剩余的事情 */ }h]hX;soc_pm_init() { /* 做一些事情 */ r = dev_pm_opp_add(mpu_dev, 1000000, 900000); if (!r) { pr_err("%s: unable to register mpu opp(%d)\n", r); goto no_cpufreq; } /* 做一些和cpufreq相关的事情 */ no_cpufreq: /* 做剩余的事情 */ }}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhhjdubeh}(h]h ]h"]h$]h&]uh1jbhjNubeh}(h]h ]h"]h$]h&]uh1jLhhhKshjIubah}(h]h ]h"]h$]h&]uh1jGhj(hhhhhNubeh}(h]id5ah ]h"]2. opp链表初始注册ah$]h&]uh1jVhjXhhhhhKWubjW)}(hhh](j\)}(h3. OPP搜索函数h]h3. OPP搜索函数}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjhhhhhKvubh)}(hXncpufreq等高层框架对频率进行操作，为了将频率映射到相应的OPP，OPP库提供了便利的函数 来搜索OPP库内部管理的OPP链表。这些搜索函数如果找到匹配的OPP，将返回指向该OPP的指针， 否则返回错误。这些错误预计由标准的错误检查，如IS_ERR()来处理，并由调用者采取适当的 行动。h]hXncpufreq等高层框架对频率进行操作，为了将频率映射到相应的OPP，OPP库提供了便利的函数 来搜索OPP库内部管理的OPP链表。这些搜索函数如果找到匹配的OPP，将返回指向该OPP的指针， 否则返回错误。这些错误预计由标准的错误检查，如IS_ERR()来处理，并由调用者采取适当的 行动。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKwhjhhubh)}(h这些函数的调用者应在使用完OPP后调用dev_pm_opp_put()。否则，OPP的内存将永远不会 被释放，并导致内存泄露。h]h这些函数的调用者应在使用完OPP后调用dev_pm_opp_put()。否则，OPP的内存将永远不会 被释放，并导致内存泄露。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK|hjhhubjH)}(hhh](jM)}(hXvdev_pm_opp_find_freq_exact 根据 *精确的* 频率和可用性来搜索OPP。这个函数对默认不可用的OPP特别有用。 例子：在SoC框架检测到更高频率可用的情况下，它可以使用这个函数在调用 dev_pm_opp_enable之前找到OPP:: opp = dev_pm_opp_find_freq_exact(dev, 1000000000, false); dev_pm_opp_put(opp); /* 不要操作指针.. 只是做有效性检查.. */ if (IS_ERR(opp)) { pr_err("frequency not disabled!\n"); /* 触发合适的操作.. */ } else { dev_pm_opp_enable(dev,1000000000); } 注意： 这是唯一一个可以搜索不可用OPP的函数。 h](jS)}(hdev_pm_opp_find_freq_exacth]hdev_pm_opp_find_freq_exact}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhKhjubjc)}(hhh](h)}(h根据 *精确的* 频率和可用性来搜索OPP。这个函数对默认不可用的OPP特别有用。 例子：在SoC框架检测到更高频率可用的情况下，它可以使用这个函数在调用 dev_pm_opp_enable之前找到OPP::h](h根据 }(hj(hhhNhNubhemphasis)}(h *精确的*h]h 精确的}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1j0hj(ubh 频率和可用性来搜索OPP。这个函数对默认不可用的OPP特别有用。 例子：在SoC框架检测到更高频率可用的情况下，它可以使用这个函数在调用 dev_pm_opp_enable之前找到OPP:}(hj(hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj%ubj)}(hXopp = dev_pm_opp_find_freq_exact(dev, 1000000000, false); dev_pm_opp_put(opp); /* 不要操作指针.. 只是做有效性检查.. */ if (IS_ERR(opp)) { pr_err("frequency not disabled!\n"); /* 触发合适的操作.. */ } else { dev_pm_opp_enable(dev,1000000000); }h]hXopp = dev_pm_opp_find_freq_exact(dev, 1000000000, false); dev_pm_opp_put(opp); /* 不要操作指针.. 只是做有效性检查.. */ if (IS_ERR(opp)) { pr_err("frequency not disabled!\n"); /* 触发合适的操作.. */ } else { dev_pm_opp_enable(dev,1000000000); }}hjJsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhj%ubjH)}(hhh]jM)}(hA注意： 这是唯一一个可以搜索不可用OPP的函数。 h](jS)}(h 注意：h]h 注意：}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhKhj[ubjc)}(hhh]h)}(h6这是唯一一个可以搜索不可用OPP的函数。h]h6这是唯一一个可以搜索不可用OPP的函数。}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjmubah}(h]h ]h"]h$]h&]uh1jbhj[ubeh}(h]h ]h"]h$]h&]uh1jLhhhKhjXubah}(h]h ]h"]h$]h&]uh1jGhj%ubeh}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]uh1jLhhhKhjubjM)}(hX7dev_pm_opp_find_freq_floor 搜索一个 *最多* 提供指定频率的可用OPP。这个函数在搜索较小的匹配或按频率 递减的顺序操作OPP信息时很有用。 例子：要找的一个设备的最高OPP:: freq = ULONG_MAX; opp = dev_pm_opp_find_freq_floor(dev, &freq); dev_pm_opp_put(opp); h](jS)}(hdev_pm_opp_find_freq_floorh]hdev_pm_opp_find_freq_floor}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhKhjubjc)}(hhh](h)}(h搜索一个 *最多* 提供指定频率的可用OPP。这个函数在搜索较小的匹配或按频率 递减的顺序操作OPP信息时很有用。 例子：要找的一个设备的最高OPP::h](h 搜索一个 }(hjhhhNhNubj1)}(h*最多*h]h最多}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjubh 提供指定频率的可用OPP。这个函数在搜索较小的匹配或按频率 递减的顺序操作OPP信息时很有用。 例子：要找的一个设备的最高OPP:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubj)}(hTfreq = ULONG_MAX; opp = dev_pm_opp_find_freq_floor(dev, &freq); dev_pm_opp_put(opp);h]hTfreq = ULONG_MAX; opp = dev_pm_opp_find_freq_floor(dev, &freq); dev_pm_opp_put(opp);}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubeh}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]uh1jLhhhKhjhhubjM)}(hXdev_pm_opp_find_freq_ceil 搜索一个 *最少* 提供指定频率的可用OPP。这个函数在搜索较大的匹配或按频率 递增的顺序操作OPP信息时很有用。 例1：找到一个设备最小的OPP:: freq = 0; opp = dev_pm_opp_find_freq_ceil(dev, &freq); dev_pm_opp_put(opp); 例: 一个SoC的cpufreq_driver->target的简易实现:: soc_cpufreq_target(..) { /* 做策略检查等操作 */ /* 找到和请求最接近的频率 */ opp = dev_pm_opp_find_freq_ceil(dev, &freq); dev_pm_opp_put(opp); if (!IS_ERR(opp)) soc_switch_to_freq_voltage(freq); else /* 当不能满足请求时，要做的事 */ /* 做其它事 */ } h](jS)}(hdev_pm_opp_find_freq_ceilh]hdev_pm_opp_find_freq_ceil}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhKhjubjc)}(hhh](h)}(h搜索一个 *最少* 提供指定频率的可用OPP。这个函数在搜索较大的匹配或按频率 递增的顺序操作OPP信息时很有用。 例1：找到一个设备最小的OPP::h](h 搜索一个 }(hjhhhNhNubj1)}(h*最少*h]h最少}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjubh 提供指定频率的可用OPP。这个函数在搜索较大的匹配或按频率 递增的顺序操作OPP信息时很有用。 例1：找到一个设备最小的OPP:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubj)}(hKfreq = 0; opp = dev_pm_opp_find_freq_ceil(dev, &freq); dev_pm_opp_put(opp);h]hKfreq = 0; opp = dev_pm_opp_find_freq_ceil(dev, &freq); dev_pm_opp_put(opp);}hj sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubh)}(h8例: 一个SoC的cpufreq_driver->target的简易实现::h]h7例: 一个SoC的cpufreq_driver->target的简易实现:}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubj)}(hXlsoc_cpufreq_target(..) { /* 做策略检查等操作 */ /* 找到和请求最接近的频率 */ opp = dev_pm_opp_find_freq_ceil(dev, &freq); dev_pm_opp_put(opp); if (!IS_ERR(opp)) soc_switch_to_freq_voltage(freq); else /* 当不能满足请求时，要做的事 */ /* 做其它事 */ }h]hXlsoc_cpufreq_target(..) { /* 做策略检查等操作 */ /* 找到和请求最接近的频率 */ opp = dev_pm_opp_find_freq_ceil(dev, &freq); dev_pm_opp_put(opp); if (!IS_ERR(opp)) soc_switch_to_freq_voltage(freq); else /* 当不能满足请求时，要做的事 */ /* 做其它事 */ }}hj<sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubeh}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]uh1jLhhhKhjhhubeh}(h]h ]h"]h$]h&]uh1jGhjhhhNhNubeh}(h]id6ah ]h"]3. opp搜索函数ah$]h&]uh1jVhjXhhhhhKvubjW)}(hhh](j\)}(h4. OPP可用性控制函数h]h4. OPP可用性控制函数}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjdhhhhhKubh)}(hXx在OPP库中注册的默认OPP链表也许无法满足所有可能的场景。OPP库提供了一套函数来修改 OPP链表中的某个OPP的可用性。这使得SoC框架能够精细地动态控制哪一组OPP是可用于操作 的。设计这些函数的目的是在诸如考虑温度时 *暂时地* 删除某个OPP（例如，在温度下降 之前不要使用某OPP）。h](hX#在OPP库中注册的默认OPP链表也许无法满足所有可能的场景。OPP库提供了一套函数来修改 OPP链表中的某个OPP的可用性。这使得SoC框架能够精细地动态控制哪一组OPP是可用于操作 的。设计这些函数的目的是在诸如考虑温度时 }(hjuhhhNhNubj1)}(h *暂时地*h]h 暂时地}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjuubhJ 删除某个OPP（例如，在温度下降 之前不要使用某OPP）。}(hjuhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjdhhubjH)}(hhh](jM)}(h8警告： 不要在中断上下文使用这些函数。 h](jS)}(h 警告：h]h 警告：}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhKhjubjc)}(hhh]h)}(h-不要在中断上下文使用这些函数。h]h-不要在中断上下文使用这些函数。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]uh1jLhhhKhjubjM)}(hXdev_pm_opp_enable 使一个OPP可用于操作。 例子：假设1GHz的OPP只有在SoC温度低于某个阈值时才可用。SoC框架的实现可能 会选择做以下事情:: if (cur_temp < temp_low_thresh) { /* 若1GHz未使能，则使能 */ opp = dev_pm_opp_find_freq_exact(dev, 1000000000, false); dev_pm_opp_put(opp); /* 仅仅是错误检查 */ if (!IS_ERR(opp)) ret = dev_pm_opp_enable(dev, 1000000000); else goto try_something_else; } h](jS)}(hdev_pm_opp_enableh]hdev_pm_opp_enable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhKhjubjc)}(hhh](h)}(h使一个OPP可用于操作。 例子：假设1GHz的OPP只有在SoC温度低于某个阈值时才可用。SoC框架的实现可能 会选择做以下事情::h]h使一个OPP可用于操作。 例子：假设1GHz的OPP只有在SoC温度低于某个阈值时才可用。SoC框架的实现可能 会选择做以下事情:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubj)}(hXSif (cur_temp < temp_low_thresh) { /* 若1GHz未使能，则使能 */ opp = dev_pm_opp_find_freq_exact(dev, 1000000000, false); dev_pm_opp_put(opp); /* 仅仅是错误检查 */ if (!IS_ERR(opp)) ret = dev_pm_opp_enable(dev, 1000000000); else goto try_something_else; }h]hXSif (cur_temp < temp_low_thresh) { /* 若1GHz未使能，则使能 */ opp = dev_pm_opp_find_freq_exact(dev, 1000000000, false); dev_pm_opp_put(opp); /* 仅仅是错误检查 */ if (!IS_ERR(opp)) ret = dev_pm_opp_enable(dev, 1000000000); else goto try_something_else; }}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubeh}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]uh1jLhhhKhjhhubjM)}(hXdev_pm_opp_disable 使一个OPP不可用于操作。 例子：假设1GHz的OPP只有在SoC温度高于某个阈值时才可用。SoC框架的实现可能 会选择做以下事情:: if (cur_temp > temp_high_thresh) { /* 若1GHz已使能，则关闭 */ opp = dev_pm_opp_find_freq_exact(dev, 1000000000, true); dev_pm_opp_put(opp); /* 仅仅是错误检查 */ if (!IS_ERR(opp)) ret = dev_pm_opp_disable(dev, 1000000000); else goto try_something_else; } h](jS)}(hdev_pm_opp_disableh]hdev_pm_opp_disable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhKhjubjc)}(hhh](h)}(h使一个OPP不可用于操作。 例子：假设1GHz的OPP只有在SoC温度高于某个阈值时才可用。SoC框架的实现可能 会选择做以下事情::h]h使一个OPP不可用于操作。 例子：假设1GHz的OPP只有在SoC温度高于某个阈值时才可用。SoC框架的实现可能 会选择做以下事情:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubj)}(hXTif (cur_temp > temp_high_thresh) { /* 若1GHz已使能，则关闭 */ opp = dev_pm_opp_find_freq_exact(dev, 1000000000, true); dev_pm_opp_put(opp); /* 仅仅是错误检查 */ if (!IS_ERR(opp)) ret = dev_pm_opp_disable(dev, 1000000000); else goto try_something_else; }h]hXTif (cur_temp > temp_high_thresh) { /* 若1GHz已使能，则关闭 */ opp = dev_pm_opp_find_freq_exact(dev, 1000000000, true); dev_pm_opp_put(opp); /* 仅仅是错误检查 */ if (!IS_ERR(opp)) ret = dev_pm_opp_disable(dev, 1000000000); else goto try_something_else; }}hj'sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubeh}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]uh1jLhhhKhjhhubeh}(h]h ]h"]h$]h&]uh1jGhjdhhhhhNubeh}(h]id7ah ]h"]4. opp可用性控制函数ah$]h&]uh1jVhjXhhhhhKubjW)}(hhh](j\)}(h5. OPP数据检索函数h]h5. OPP数据检索函数}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjOhhhhhKubh)}(h由于OPP库对OPP信息进行了抽象化处理，因此需要一组函数来从dev_pm_opp结构体中提取 信息。一旦使用搜索函数检索到一个OPP指针，以下函数就可以被SoC框架用来检索OPP层 内部描述的信息。h]h由于OPP库对OPP信息进行了抽象化处理，因此需要一组函数来从dev_pm_opp结构体中提取 信息。一旦使用搜索函数检索到一个OPP指针，以下函数就可以被SoC框架用来检索OPP层 内部描述的信息。}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjOhhubjH)}(hhh](jM)}(hXdev_pm_opp_get_voltage 检索OPP指针描述的电压。 例子: 当cpufreq切换到到不同频率时，SoC框架需要用稳压器框架将OPP描述 的电压设置到提供电压的电源管理芯片中:: soc_switch_to_freq_voltage(freq) { /* 做一些事情 */ opp = dev_pm_opp_find_freq_ceil(dev, &freq); v = dev_pm_opp_get_voltage(opp); dev_pm_opp_put(opp); if (v) regulator_set_voltage(.., v); /* 做其它事 */ } h](jS)}(hdev_pm_opp_get_voltageh]hdev_pm_opp_get_voltage}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhKhjqubjc)}(hhh](h)}(h检索OPP指针描述的电压。 例子: 当cpufreq切换到到不同频率时，SoC框架需要用稳压器框架将OPP描述 的电压设置到提供电压的电源管理芯片中::h]h检索OPP指针描述的电压。 例子: 当cpufreq切换到到不同频率时，SoC框架需要用稳压器框架将OPP描述 的电压设置到提供电压的电源管理芯片中:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubj)}(hXsoc_switch_to_freq_voltage(freq) { /* 做一些事情 */ opp = dev_pm_opp_find_freq_ceil(dev, &freq); v = dev_pm_opp_get_voltage(opp); dev_pm_opp_put(opp); if (v) regulator_set_voltage(.., v); /* 做其它事 */ }h]hXsoc_switch_to_freq_voltage(freq) { /* 做一些事情 */ opp = dev_pm_opp_find_freq_ceil(dev, &freq); v = dev_pm_opp_get_voltage(opp); dev_pm_opp_put(opp); if (v) regulator_set_voltage(.., v); /* 做其它事 */ }}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubeh}(h]h ]h"]h$]h&]uh1jbhjqubeh}(h]h ]h"]h$]h&]uh1jLhhhKhjnubjM)}(hXdev_pm_opp_get_freq 检索OPP指针描述的频率。 例子：比方说，SoC框架使用了几个辅助函数，通过这些函数，我们可以将OPP 指针传入，而不是传入额外的参数，用来处理一系列数据参数:: soc_cpufreq_target(..) { /* 做一些事情.. */ max_freq = ULONG_MAX; max_opp = dev_pm_opp_find_freq_floor(dev,&max_freq); requested_opp = dev_pm_opp_find_freq_ceil(dev,&freq); if (!IS_ERR(max_opp) && !IS_ERR(requested_opp)) r = soc_test_validity(max_opp, requested_opp); dev_pm_opp_put(max_opp); dev_pm_opp_put(requested_opp); /* 做其它事 */ } soc_test_validity(..) { if(dev_pm_opp_get_voltage(max_opp) < dev_pm_opp_get_voltage(requested_opp)) return -EINVAL; if(dev_pm_opp_get_freq(max_opp) < dev_pm_opp_get_freq(requested_opp)) return -EINVAL; /* 做一些事情.. */ } h](jS)}(hdev_pm_opp_get_freqh]hdev_pm_opp_get_freq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhM hjubjc)}(hhh](h)}(h检索OPP指针描述的频率。 例子：比方说，SoC框架使用了几个辅助函数，通过这些函数，我们可以将OPP 指针传入，而不是传入额外的参数，用来处理一系列数据参数::h]h检索OPP指针描述的频率。 例子：比方说，SoC框架使用了几个辅助函数，通过这些函数，我们可以将OPP 指针传入，而不是传入额外的参数，用来处理一系列数据参数:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubj)}(hXsoc_cpufreq_target(..) { /* 做一些事情.. */ max_freq = ULONG_MAX; max_opp = dev_pm_opp_find_freq_floor(dev,&max_freq); requested_opp = dev_pm_opp_find_freq_ceil(dev,&freq); if (!IS_ERR(max_opp) && !IS_ERR(requested_opp)) r = soc_test_validity(max_opp, requested_opp); dev_pm_opp_put(max_opp); dev_pm_opp_put(requested_opp); /* 做其它事 */ } soc_test_validity(..) { if(dev_pm_opp_get_voltage(max_opp) < dev_pm_opp_get_voltage(requested_opp)) return -EINVAL; if(dev_pm_opp_get_freq(max_opp) < dev_pm_opp_get_freq(requested_opp)) return -EINVAL; /* 做一些事情.. */ }h]hXsoc_cpufreq_target(..) { /* 做一些事情.. */ max_freq = ULONG_MAX; max_opp = dev_pm_opp_find_freq_floor(dev,&max_freq); requested_opp = dev_pm_opp_find_freq_ceil(dev,&freq); if (!IS_ERR(max_opp) && !IS_ERR(requested_opp)) r = soc_test_validity(max_opp, requested_opp); dev_pm_opp_put(max_opp); dev_pm_opp_put(requested_opp); /* 做其它事 */ } soc_test_validity(..) { if(dev_pm_opp_get_voltage(max_opp) < dev_pm_opp_get_voltage(requested_opp)) return -EINVAL; if(dev_pm_opp_get_freq(max_opp) < dev_pm_opp_get_freq(requested_opp)) return -EINVAL; /* 做一些事情.. */ }}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubeh}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]uh1jLhhhM hjnhhubjM)}(hXdev_pm_opp_get_opp_count 检索某个设备可用的OPP数量。 例子：假设SoC中的一个协处理器需要知道某个表中的可用频率，主处理器可以 按如下方式发出通知:: soc_notify_coproc_available_frequencies() { /* 做一些事情 */ num_available = dev_pm_opp_get_opp_count(dev); speeds = kcalloc(num_available, sizeof(u32), GFP_KERNEL); /* 按升序填充表 */ freq = 0; while (!IS_ERR(opp = dev_pm_opp_find_freq_ceil(dev, &freq))) { speeds[i] = freq; freq++; i++; dev_pm_opp_put(opp); } soc_notify_coproc(AVAILABLE_FREQs, speeds, num_available); /* 做其它事 */ } h](jS)}(hdev_pm_opp_get_opp_counth]hdev_pm_opp_get_opp_count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhM!hjubjc)}(hhh](h)}(h检索某个设备可用的OPP数量。 例子：假设SoC中的一个协处理器需要知道某个表中的可用频率，主处理器可以 按如下方式发出通知::h]h检索某个设备可用的OPP数量。 例子：假设SoC中的一个协处理器需要知道某个表中的可用频率，主处理器可以 按如下方式发出通知:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjubj)}(hXsoc_notify_coproc_available_frequencies() { /* 做一些事情 */ num_available = dev_pm_opp_get_opp_count(dev); speeds = kcalloc(num_available, sizeof(u32), GFP_KERNEL); /* 按升序填充表 */ freq = 0; while (!IS_ERR(opp = dev_pm_opp_find_freq_ceil(dev, &freq))) { speeds[i] = freq; freq++; i++; dev_pm_opp_put(opp); } soc_notify_coproc(AVAILABLE_FREQs, speeds, num_available); /* 做其它事 */ }h]hXsoc_notify_coproc_available_frequencies() { /* 做一些事情 */ num_available = dev_pm_opp_get_opp_count(dev); speeds = kcalloc(num_available, sizeof(u32), GFP_KERNEL); /* 按升序填充表 */ freq = 0; while (!IS_ERR(opp = dev_pm_opp_find_freq_ceil(dev, &freq))) { speeds[i] = freq; freq++; i++; dev_pm_opp_put(opp); } soc_notify_coproc(AVAILABLE_FREQs, speeds, num_available); /* 做其它事 */ }}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhjubeh}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]uh1jLhhhM!hjnhhubeh}(h]h ]h"]h$]h&]uh1jGhjOhhhhhNubeh}(h]id8ah ]h"]5. opp数据检索函数ah$]h&]uh1jVhjXhhhhhKubjW)}(hhh](j\)}(h6. 数据结构h]h6. 数据结构}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1j[hj6hhhhhM$ubh)}(h通常，一个SoC包含多个可变电压域。每个域由一个设备指针描述。和OPP之间的关系可以 按以下方式描述::h]h通常，一个SoC包含多个可变电压域。每个域由一个设备指针描述。和OPP之间的关系可以 按以下方式描述:}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM%hj6hhubj)}(hSoC |- device 1 | |- opp 1 (availability, freq, voltage) | |- opp 2 .. ... ... | `- opp n .. |- device 2 ... `- device mh]hSoC |- device 1 | |- opp 1 (availability, freq, voltage) | |- opp 2 .. ... ... | `- opp n .. |- device 2 ... `- device m}hjUsbah}(h]h ]h"]h$]h&]hhuh1jhhhM(hj6hhubh)}(hOPP库维护着一个内部链表，SoC框架使用上文描述的各个函数来填充和访问。然而，描述 真实OPP和域的结构体是OPP库自身的内部组成，以允许合适的抽象在不同系统中得到复用。h]hOPP库维护着一个内部链表，SoC框架使用上文描述的各个函数来填充和访问。然而，描述 真实OPP和域的结构体是OPP库自身的内部组成，以允许合适的抽象在不同系统中得到复用。}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM2hj6hhubjH)}(hhh](jM)}(hXstruct dev_pm_opp OPP库的内部数据结构，用于表示一个OPP。除了频率、电压、可用性信息外， 它还包含OPP库运行所需的内部统计信息。指向这个结构体的指针被提供给 用户（比如SoC框架）使用，在与OPP层的交互中作为OPP的标识符。 警告： 结构体dev_pm_opp的指针不应该由用户解析或修改。一个实例的默认值由 dev_pm_opp_add填充，但OPP的可用性由dev_pm_opp_enable/disable函数 修改。 h](jS)}(hstruct dev_pm_opph]hstruct dev_pm_opp}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhM=hjtubjc)}(hhh](h)}(hXOPP库的内部数据结构，用于表示一个OPP。除了频率、电压、可用性信息外， 它还包含OPP库运行所需的内部统计信息。指向这个结构体的指针被提供给 用户（比如SoC框架）使用，在与OPP层的交互中作为OPP的标识符。h]hXOPP库的内部数据结构，用于表示一个OPP。除了频率、电压、可用性信息外， 它还包含OPP库运行所需的内部统计信息。指向这个结构体的指针被提供给 用户（比如SoC框架）使用，在与OPP层的交互中作为OPP的标识符。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM6hjubjH)}(hhh]jM)}(h警告： 结构体dev_pm_opp的指针不应该由用户解析或修改。一个实例的默认值由 dev_pm_opp_add填充，但OPP的可用性由dev_pm_opp_enable/disable函数 修改。 h](jS)}(h 警告：h]h 警告：}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhM=hjubjc)}(hhh]h)}(h结构体dev_pm_opp的指针不应该由用户解析或修改。一个实例的默认值由 dev_pm_opp_add填充，但OPP的可用性由dev_pm_opp_enable/disable函数 修改。h]h结构体dev_pm_opp的指针不应该由用户解析或修改。一个实例的默认值由 dev_pm_opp_add填充，但OPP的可用性由dev_pm_opp_enable/disable函数 修改。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM;hjubah}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]uh1jLhhhM=hjubah}(h]h ]h"]h$]h&]uh1jGhjubeh}(h]h ]h"]h$]h&]uh1jbhjtubeh}(h]h ]h"]h$]h&]uh1jLhhhM=hjqubjM)}(hstruct device 这用于向OPP层标识一个域。设备的性质和它的实现是由OPP库的用户决定的， 如SoC框架。 h](jS)}(h struct deviceh]h struct device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jRhhhMAhjubjc)}(hhh]h)}(hs这用于向OPP层标识一个域。设备的性质和它的实现是由OPP库的用户决定的， 如SoC框架。h]hs这用于向OPP层标识一个域。设备的性质和它的实现是由OPP库的用户决定的， 如SoC框架。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM@hjubah}(h]h ]h"]h$]h&]uh1jbhjubeh}(h]h ]h"]h$]h&]uh1jLhhhMAhjqhhubeh}(h]h ]h"]h$]h&]uh1jGhj6hhhNhNubh)}(hb总体来说，以一个简化的视角看，对数据结构的操作可以描述为下面各图::h]ha总体来说，以一个简化的视角看，对数据结构的操作可以描述为下面各图:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMChj6hhubj)}(hX初始化 / 修改: +-----+ /- dev_pm_opp_enable dev_pm_opp_add --> | opp | <------- | +-----+ \- dev_pm_opp_disable \-------> domain_info(device) 搜索函数: /-- dev_pm_opp_find_freq_ceil ---\ +-----+ domain_info<---- dev_pm_opp_find_freq_exact -----> | opp | \-- dev_pm_opp_find_freq_floor ---/ +-----+ 检索函数: +-----+ /- dev_pm_opp_get_voltage | opp | <--- +-----+ \- dev_pm_opp_get_freq domain_info <- dev_pm_opp_get_opp_counth]hX初始化 / 修改: +-----+ /- dev_pm_opp_enable dev_pm_opp_add --> | opp | <------- | +-----+ \- dev_pm_opp_disable \-------> domain_info(device) 搜索函数: /-- dev_pm_opp_find_freq_ceil ---\ +-----+ domain_info<---- dev_pm_opp_find_freq_exact -----> | opp | \-- dev_pm_opp_find_freq_floor ---/ +-----+ 检索函数: +-----+ /- dev_pm_opp_get_voltage | opp | <--- +-----+ \- dev_pm_opp_get_freq domain_info <- dev_pm_opp_get_opp_count}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMEhj6hhubeh}(h]id9ah ]h"]6. 数据结构ah$]h&]uh1jVhjXhhhhhM$ubeh}(h]oppah ]h"]操作性能值（opp）库ah$]h&]uh1jVhhhhhhhK ubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(j[N generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj_error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j9j6j%j"jyjvjjjjjjjaj^jLjIj3j0j1j.u nametypes}(j9j%jyjjjjajLj3j1uh}(j6jXj"jjvjjj|jjjj(j^jjIjdj0jOj.j6u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jmK sRparse_messages]hsystem_message)}(hhh]h)}(h:Enumerated list start value not ordinal-1: "C" (ordinal 3)h]h>Enumerated list start value not ordinal-1: “C” (ordinal 3)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineK uh1jhjXhhhhhKubatransform_messages] transformerN include_log].Documentation/translations/zh_CN/power/opp.rst(NNNNta decorationNhhub.