# boost\_cpu

Source: [https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_boost_cpu.html](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_boost_cpu.html)

将所有可用 CPU 的虚拟利用率增加一定的百分比，具体值由输入参数指定。此负载用于计算 CPU 频率，负载越大，CPU 频率越高。此 API 调用的持续时间为 2 s。这有助于在预计 CPU 负载会突然增加时为应用程序提供瞬时提升（更高的 CPU 频率）。例如，在 CPU 任务繁重的游戏中的场景切换。

    boost_cpu()Copy to clipboard

## 使用指导

当应用程序预计负载即将增加并会导致应用程序误期（例如 vsync）时，需要使用此 API。由于此 API 调用的持续时间为 2 s，如果应用程序需要延长提速持续时间，则需要再次调用该标注。理想情况是底层 CPU DCVS 软件在负载突增后立即锁定所需的负载要求。这样，便无需重复调用此 API，只需使底层 CPU DCVS 提前做好准备，以便应对即将发生的负载突增情况。对于客制化的低功耗用例，可使用负值降低利用率。

注释： 此 API 在 10 秒内只能调用 3 次。

注释： boost\_cpu API 仅供 OEM 使用。不支持第三方使用。

## 参数

| 参数 | API 类型 | 数据类型 | 说明 |
| --- | --- | --- | --- |
| boost\_val | Java | int | 将 CPU 利用率增加 boost\_val%。这是 CPU 利用率的增量。<br><br><br>有效范围为 -50% 至 400%（负值会降低任务利用率）。 |
| boost\_val | 原生 | int32 | 将 CPU 利用率增加 boost\_val%。这是 CPU 利用率的增量。<br><br><br>有效范围为 -50% 至 400%（负值会降低任务利用率）。 |
|  |  |  |  |

## 返回结果

| API 类型 | 返回结果 | 说明 |
| --- | --- | --- |
| Java | int | <ul class="ul"><br>                <li class="li">0 - 成功</li><br><br>                <li class="li">-1 – 提速请求失败</li><br><br>              <li class="li">-2 - 建立会话失败；确认在此 API 之前调用了 API set_pkg 名称</li><br><br>              <li class="li">-3 - 请求提速失败；在 10 秒内超过了允许的提速次数 (3)</li><br><br>              </ul> |
| 原生 | int8 | <ul class="ul"><br>                <li class="li">0 - 成功</li><br><br>                <li class="li">-1 – 提速请求失败</li><br><br>              <li class="li">-2 - 建立会话失败；确认在此 API 之前调用了 API set_pkg 名称</li><br><br>              <li class="li">-3 - 请求提速失败；在 10 秒内超过了允许的提速次数 (3)</li><br><br>              </ul> |
|  |  |  |

**上一级主题：** [QAPE API](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_api.html)

## boost\_val 示例

Source: [https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_boost_cpu.html](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_boost_cpu.html)

注意：

持续提速可能更耗电，并可能影响整体电池使用时间。建议在预计 CPU 工作负载会突然增加时使用。

如果根据 CPU 的实际负载计算的利用率为 30，取决于 boost\_cpu 百分比值，则每个 CPU 的利用率都将得到适当更新。CPU 利用率的范围为 0 – 1024（1024 表示主 CPU 的最大利用率）。根据 CPU 的群集，CPU 的最大利用率可能低于 1024（例如，小核/大核群集）。根据群集中所有 CPU 报告的利用率，CPU 调节器以定义间隔调整群集的频率。

| 当前利用率（单个 CPU） | 提速值 | 目标利用率（单个 CPU） |
| --- | --- | --- |
| 30 | -50 | 15 |
| 30 | 0 | 30 |
| 30 | 50 | 45 |
| 30 | 100 | 60 |
| 30 | 150 | 75 |
| 30 | 200 | 90 |
| 30 | 250 | 105 |
| 30 | 300 | 120 |
| 30 | 350 | 135 |
| 30 | 400 | 150 |

Last Published: Jun 22, 2023

[Previous Topic
set\_pkg](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134Y/topics/qape_set_pkg.md) [Next Topic
boost\_gpu](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134Y/topics/qape_boost_gpu.md)