Lines Matching refs:OPP
11 操作性能值（OPP）库
19 2. OPP链表初始注册
20 3. OPP搜索函数
21 4. OPP可用性控制函数
22 5. OPP数据检索函数
28 1.1 何为操作性能值（OPP）？
43 我们能将它们表示为3个OPP，如下述{Hz, uV}元组（译注：频率的单位是赫兹，电压的单位是
53 OPP库提供了一组辅助函数来组织和查询OPP信息。该库位于drivers/opp/目录下，其头文件
54 位于include/linux/pm_opp.h中。OPP库可以通过开启CONFIG_PM_OPP来启用。某些SoC，
55 如德州仪器的OMAP框架允许在不需要cpufreq的情况下可选地在某一OPP下启动。
57 OPP库的典型用法如下::
59 （用户） -> 注册一个默认的OPP集合 -> （库）
60 （SoC框架） -> 在必要的情况下，对某些OPP进行修改 -> OPP layer
63 OPP层期望每个域由一个唯一的设备指针来表示。SoC框架在OPP层为每个设备注册了一组初始
64 OPP。这个链表的长度被期望是一个最优化的小数字，通常每个设备大约5个。初始链表包含了
65 一个OPP集合，这个集合被期望能在系统中安全使能。
67 关于OPP可用性的说明
70 随着系统的运行，SoC框架可能会基于各种外部因素选择让某些OPP在每个设备上可用或不可用，
71 示例：温度管理或其它异常场景中，SoC框架可能会选择禁用一个较高频率的OPP以安全地继续
72 运行，直到该OPP被重新启用（如果可能）。
74 OPP库在它的实现中达成了这个概念。以下操作函数只能对可用的OPP使用：
78 dev_pm_opp_find_freq_exact是用来查找OPP指针的，该指针可被用在dev_pm_opp_enable/
79 disable函数，使一个OPP在被需要时变为可用。
81 警告：如果对一个设备调用dev_pm_opp_enable/disable函数，OPP库的用户应该使用
82 dev_pm_opp_get_opp_count来刷新OPP的可用性计数。触发这些的具体机制，或者对有依赖的
83 子系统（比如cpufreq）的通知机制，都是由使用OPP库的SoC特定框架酌情处理的。在这些操作
86 2. OPP链表初始注册
88 SoC的实现会迭代调用dev_pm_opp_add函数来增加每个设备的OPP。预期SoC框架将以最优的
89 方式注册OPP条目 - 典型的数字范围小于5。通过注册OPP生成的OPP链表，在整个设备运行过程
90 中由OPP库维护。SoC框架随后可以使用dev_pm_opp_enable / disable函数动态地
91 控制OPP的可用性。
94 为设备指针所指向的特定域添加一个新的OPP。OPP是用频率和电压定义的。一旦完成
95 添加，OPP被认为是可用的，可以用dev_pm_opp_enable/disable函数来控制其可用性。
96 OPP库内部用dev_pm_opp结构体存储并管理这些信息。这个函数可以被SoC框架根据SoC
117 3. OPP搜索函数
119 cpufreq等高层框架对频率进行操作，为了将频率映射到相应的OPP，OPP库提供了便利的函数
120 来搜索OPP库内部管理的OPP链表。这些搜索函数如果找到匹配的OPP，将返回指向该OPP的指针，
124 这些函数的调用者应在使用完OPP后调用dev_pm_opp_put()。否则，OPP的内存将永远不会
128 根据 *精确的* 频率和可用性来搜索OPP。这个函数对默认不可用的OPP特别有用。
130 dev_pm_opp_enable之前找到OPP::
143 这是唯一一个可以搜索不可用OPP的函数。
146 搜索一个 *最多* 提供指定频率的可用OPP。这个函数在搜索较小的匹配或按频率
147 递减的顺序操作OPP信息时很有用。
148 例子：要找的一个设备的最高OPP::
155 搜索一个 *最少* 提供指定频率的可用OPP。这个函数在搜索较大的匹配或按频率
156 递增的顺序操作OPP信息时很有用。
157 例1：找到一个设备最小的OPP::
178 4. OPP可用性控制函数
180 在OPP库中注册的默认OPP链表也许无法满足所有可能的场景。OPP库提供了一套函数来修改
181 OPP链表中的某个OPP的可用性。这使得SoC框架能够精细地动态控制哪一组OPP是可用于操作
182 的。设计这些函数的目的是在诸如考虑温度时 *暂时地* 删除某个OPP（例如，在温度下降
183 之前不要使用某OPP）。
189 使一个OPP可用于操作。
190 例子：假设1GHz的OPP只有在SoC温度低于某个阈值时才可用。SoC框架的实现可能
205 使一个OPP不可用于操作。
206 例子：假设1GHz的OPP只有在SoC温度高于某个阈值时才可用。SoC框架的实现可能
220 5. OPP数据检索函数
222 由于OPP库对OPP信息进行了抽象化处理，因此需要一组函数来从dev_pm_opp结构体中提取
223 信息。一旦使用搜索函数检索到一个OPP指针，以下函数就可以被SoC框架用来检索OPP层
227 检索OPP指针描述的电压。
228 例子: 当cpufreq切换到到不同频率时，SoC框架需要用稳压器框架将OPP描述
243 检索OPP指针描述的频率。
244 例子：比方说，SoC框架使用了几个辅助函数，通过这些函数，我们可以将OPP
269 检索某个设备可用的OPP数量。
293 通常，一个SoC包含多个可变电压域。每个域由一个设备指针描述。和OPP之间的关系可以
306 OPP库维护着一个内部链表，SoC框架使用上文描述的各个函数来填充和访问。然而，描述
307 真实OPP和域的结构体是OPP库自身的内部组成，以允许合适的抽象在不同系统中得到复用。
310 OPP库的内部数据结构，用于表示一个OPP。除了频率、电压、可用性信息外，
311 它还包含OPP库运行所需的内部统计信息。指向这个结构体的指针被提供给
312 用户（比如SoC框架）使用，在与OPP层的交互中作为OPP的标识符。
316 dev_pm_opp_add填充，但OPP的可用性由dev_pm_opp_enable/disable函数
320 这用于向OPP层标识一个域。设备的性质和它的实现是由OPP库的用户决定的，