高通Perflock

高通的Perflock是Qualcomm公司开发的一项技术，用于优化设备性能和功耗管理。Perflock是一种锁定机制，允许操作系统或应用程序在需要时对处理器的性能状态进行控制，从而确保在关键任务或高性能需求的情况下，处理器能够维持在高性能状态。

主要功能和特点

1. 性能锁定：Perflock允许应用程序或系统服务锁定CPU的频率或性能状态，以满足高性能需求。例如，在运行高性能游戏或进行繁重的计算任务时，可以使用Perflock确保CPU保持在高频率下运行。

2. 功耗管理：在不需要高性能时，Perflock可以解除锁定，允许处理器降低频率，从而节省电量并降低功耗。

3. 灵活性：开发者可以通过API接口使用Perflock，根据具体需求动态调整处理器的性能状态。

4. 兼容性：Perflock主要应用于搭载Qualcomm处理器的设备，如智能手机和平板电脑。

应用场景

• 游戏：在运行大型3D游戏时，使用Perflock可以确保游戏流畅运行，不会因为处理器降频而影响用户体验。
• 多媒体处理：在视频编辑或其他多媒体处理应用中，Perflock可以提高处理速度和效率。
• 系统任务：系统更新或备份等任务需要长时间高性能运行时，Perflock可以提供必要的性能支持。

如何使用高通perflock

Perflock的API封装在libqti-perfd-client.so库里面(源码在android/vendor/qcom/proprietary/commonsys-intf/android-perf/mp-ctl/client.cpp)，主要包含三个方法：

• int perf_lock_acq(int handle, int duration, int list[], int numArgs)
• int perf_lock_rel(int handle)
• int perf_hint(int hint, const char *pkg, int duration, int type)

Perflock的使用

可以通过perf_lock_acq和perf_lock_rel来提频操作。

handle参数

调用perf_lock_acq或perf_hint会返回一个handle，该Handle可以存起来后面继续使用。

第一次调用perf_lock_acq或perf_hint方法时，handle为0，perflock会创建一个新的handle

示例：

mHandle = (m_pPerfLockOps->perfLockAcquire(mHandle,
                                           timer,
                                           m_pPerflockInfo->perfLockParams,
                                           m_pPerflockInfo->perfLockParamsCount));

duration

表示要让Perf engine LOCK住多久，单位是ms。

如果设置为0，则表示无限时间。

list[] 和 numArgs

list[]是要传递给Perf Engine的参数，每2个参数为一组[resource, value]，numArgs为参数个数。

list[] 和 numArgs示例：

{ // PERF_LOCK_OPEN_CAMERA
    perfLockParamsOpenCamera,
    sizeof(perfLockParamsOpenCamera) / sizeof(INT32)
},

perfLockParamsOpenCamera定义为:

static INT32 perfLockParamsOpenCamera[] =
{
    // Disable power collapse and set CPU clocks to turbo
    MPCTLV3_ALL_CPUS_PWR_CLPS_DIS,          0x1,
    MPCTLV3_SCHED_BOOST,                    0x1,
    MPCTLV3_MAX_FREQ_CLUSTER_BIG_CORE_0,    0xFFF,
    MPCTLV3_MIN_FREQ_CLUSTER_BIG_CORE_0,    0xFFF,
    MPCTLV3_MAX_FREQ_CLUSTER_LITTLE_CORE_0, 0xFFF,
    MPCTLV3_MIN_FREQ_CLUSTER_LITTLE_CORE_0, 0xFFF,
    MPCTLV3_MIN_FREQ_CLUSTER_PLUS_CORE_0,   0xFFF,
    MPCTLV3_MAX_FREQ_CLUSTER_PLUS_CORE_0,   0xFFF
};

可以看出来Open Camera时是

• 关闭power collapse
• 使能SCHED_BOOST
• 大核、小核、超大核都切成turbo模式

perf_lock_rel

释放持有的perfLock，具体是哪个perflock由参数handle决定。

如果perf_lock_acq有设置duration，则不需要调用perf_lock_rel。

示例
在一个Native进程中使用PerfLock来调出两个核。

Makefile

LOCAL_SHARED_LIBRARIES := liblog libcutils libdl libqti-perfd-client
LOCAL_C_INCLUDES := device/qcom/common/power

源代码

#include <dlfcn.h>
#include “performance.h”
static void *qcopt_handle;
static int (*perf_lock_acq)(int handle, int duration, int list[], int numArgs);
static int (*perf_lock_rel)(int handle);
static int perf_lock_handle;
char opt_lib_path[PATH_MAX] = {0};
if (property_get("ro.vendor.extension_library", opt_lib_path, NULL) != 0) {
    if((qcopt_handle = dlopen(opt_lib_path, RTLD_NOW)) == NULL) {
        error_out();
    } else {
        perf_lock_acq = (int(*)(int, int, int*,int))dlsym(qcopt_handle, "perf_lock_acq");
        perf_lock_rel = (int(*)(int))dlsym(qcopt_handle, "perf_lock_rel");
    }
}
int perf_lock_opts[1] = {CPUS_ONLINE_MIN_2};
perf_lock_handle = perf_lock_acq(perf_lock_handle, 0, perf_lock_opts, 1);
// Critical section requiring PerfLock
perf_lock_rel(perf_lock_handle);

具体可参考代码：vendor/qcom/proprietary/android-perf/tests/ModuleTests/mp-ctl/perflock_native_test.cpp

PowerHint的使用

使用PowerHint需要先在powerhint.xml里面定义一个HintID，然后再调用perf_hint让其生效。

PowerHint XML位置: vendor/qcom/opensource/power/config/bengal/powerhint.xml，系统中，该文件存放在/vendor/etc/powerhint.xml"

其他XML文件位置定义如下：

#define PERF_MAPPING_XML "/vendor/etc/perf/perfmapping.xml"
#define PERF_BOOSTS_CONFIGS_XML "/vendor/etc/perf/perfboostsconfig.xml"
#define POWER_CONFIGS_XML "/vendor/etc/powerhint.xml"
#define COMMONRESOURCE_CONFIGS_XML "/vendor/etc/perf/commonresourceconfigs.xml"
#define TARGETRESOURCE_CONFIGS_XML "/vendor/etc/perf/targetresourceconfigs.xml"

语法：

int perf_hint(int hint, const char *pkg, int duration, int type)

• hint- 识别每个Hit的ID。
• Pkg- 谁触发这个Hint。
• Duration- Duration of the hint perflock.
• Type- To differentiate between similar action, like horizontal scroll/vertical scroll，一般可以传-1。

常用Resource ID

OpenCamera过程中，将所有CPU都拉满

static INT32 perfLockParamsOpenCamera[] =
{
    // Disable power collapse and set CPU clocks to turbo
    MPCTLV3_ALL_CPUS_PWR_CLPS_DIS,          0x1,
    MPCTLV3_SCHED_BOOST,                    0x1,
    MPCTLV3_MAX_FREQ_CLUSTER_BIG_CORE_0,    0xFFF,
    MPCTLV3_MIN_FREQ_CLUSTER_BIG_CORE_0,    0xFFF,
    MPCTLV3_MAX_FREQ_CLUSTER_LITTLE_CORE_0, 0xFFF,
    MPCTLV3_MIN_FREQ_CLUSTER_LITTLE_CORE_0, 0xFFF,
    MPCTLV3_MIN_FREQ_CLUSTER_PLUS_CORE_0,   0xFFF,
    MPCTLV3_MAX_FREQ_CLUSTER_PLUS_CORE_0,   0xFFF
};

PerfLock in Camera

CamX

CamX中有一个类：CamxPerfLockManager，封装了对perflock的使用，代码路径为：vendor/qcom/proprietary/camx/src/osutils/camxperf.cpp

CHI

CHI也有一个类：PerfLockManager，封装了对perflock的使用，代码路径为：vendor/qcom/proprietary/chi-cdk/core/chiutils/chxperf.cpp

Perflock 调试

Log

adb root 
adb remount(disable verity if needed) 
adb shell "echo vendor.debug.trace.perf=1 >> /system/build.prop" 
adb reboot

然后从Log里面能看到如下打印:

07-10 16:07:27.575 13212 13212 E ANDR-PERF-MPCTL: perf_lock_acq: client_pid=1007, client_tid=1095, inupt handle=0, duration=80 ms, 
num_args=18, list=0x43000000 0x19 0x40800000 0x3E8 0x40800100 0x3E8 0x40800200 0x3E8 0x40C00000 0x2 0x43400000 0x1F40 0x40C74000 0xFF
0x40408000 0x63 0x41000000 0x3 
07-10 16:07:27.575 13212 13212 E ANDR-PERF-MPCTL: perf_lock_acq: output handle=1
07-10 16:07:27.576 13212 13212 E ANDR-PERF-MPCTL: perf_lock_acq: client_pid=1007, client_tid=1095, inupt handle=0, duration=0 ms, num_args=18, 
list=0x43000000 0x11 0x40800000 0x3E8 0x40800100 0x3E8 0x40800200 0x3E8 0x40C00000 0x2 0x43400000 0x1F40 0x40C74000 0xFF 0x40408000 0x63 
0x41000000 0x3 
07-10 16:07:27.576 13212 13212 E ANDR-PERF-MPCTL: perf_lock_acq: output handle=2
07-10 16:07:27.649 13212 13213 E ANDR-PERF-MPCTL: perf_lock_rel: input handle=2
07-10 16:07:27.660 13212 13213 E ANDR-PERF-MPCTL: perf_lock_rel: input handle=1

如果需要更多Log，可以打开QC_DEBUG:

在vendor/qcom/proprietary/android-perf/mp-ctl/, 在makefile中打开 QC_DEBUG flag

Dump

可以执行

dumpsys vendor.perfservice

来dump 处于active状态的 request list。

实验验证CPU/GPU/DDR最高频

关闭perflock和thermal

adb shell su -c setenforce 0
adb shell stop thermal-engine
adb shell stop perf-hal-1-0
adb shell stop perfd

perf-hal的版本要注意不一定是1.0，具体的perf hal版本可以参考：vendor/qcom/proprietary/android-perf/perf-hal/xxxx.rc

关闭 low power model

adb shell "echo Y > /sys/module/lpm_levels/parameters/sleep_disabled“

online 所有 cpus

adb shell "echo 4 > /sys/devices/system/cpu/cpu0/core_ctl/min_cpus“
adb shell "echo 4 > /sys/devices/system/cpu/cpu0/core_ctl/max_cpus“
adb shell "echo 4 > /sys/devices/system/cpu/cpu4/core_ctl/min_cpus"
adb shell "echo 4 > /sys/devices/system/cpu/cpu4/core_ctl/max_cpus"
adb shell "echo 1 > /sys/devices/system/cpu/cpu0/online"
adb shell "echo 1 > /sys/devices/system/cpu/cpu1/online"
adb shell "echo 1 > /sys/devices/system/cpu/cpu2/online"
adb shell "echo 1 > /sys/devices/system/cpu/cpu3/online"
adb shell "echo 1 > /sys/devices/system/cpu/cpu4/online"
adb shell "echo 1 > /sys/devices/system/cpu/cpu5/online"
adb shell "echo 1 > /sys/devices/system/cpu/cpu6/online"
adb shell "echo 1 > /sys/devices/system/cpu/cpu7/online"

cpufreq performance

adb shell "echo performance > /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor"

gpu performance

adb shell stop mpdecision
adb shell "echo 0 > /sys/class/kgsl/kgsl-3d0/min_pwrlevel"
adb shell "echo 0 > /sys/class/kgsl/kgsl-3d0/max_pwrlevel"
adb shell "echo 1 > /sys/class/kgsl/kgsl-3d0/force_rail_on"
adb shell "echo 1 > /sys/class/kgsl/kgsl-3d0/force_clk_on"
adb shell "echo 1 > /sys/class/kgsl/kgsl-3d0/force_bus_on"
adb shell "echo 10000000 > /sys/class/kgsl/kgsl-3d0/idle_timer"
adb shell "echo performance > /sys/class/kgsl/kgsl-3d0/devfreq/governor"

ddr performance

adb shell "echo performance >/sys/class/devfreq/*/governor”

总结

Perflock通过在需要时锁定和控制处理器的性能状态，帮助设备在高性能和低功耗之间找到平衡，提升用户体验和设备效率。这项技术对于需要高性能的应用尤其重要，但也需要谨慎使用，以避免不必要的功耗增加。