OpenHarmony子系统开发 - 热管理（四）
六、热策略定制开发指导
概述
简介
OpenHarmony默认提供了热策略的特性。设备上发热的器件种类繁多，因此需要结合热等级和热场景，针对各类发热器件定制统一的管控策略。但是不同热等级下的管控动作在不同的产品上规格是不同的，产品希望根据产品的设计规格来定制此特性。OpenHarmony提供了热策略的定制方式，产品定制开发者可根据产品的设计规格来定制这些特性。同时，出于安全性考虑，提供了热策略配置文件加解密的功能支持（可选）。
约束与限制
产品定制的配置路径，需要根据配置策略决定。本开发指导中的定制路径以/vendor进行举例，请开发者根据具体的产品配置策略，修改定制路径。
开发指导
搭建环境
设备要求：
标准系统开发板，如DAYU200/Hi3516DV300开源套件。
环境要求：
Linux调测环境，相关要求和配置可参考《快速入门》。
开发步骤
本文以DAYU200为例介绍热策略的定制方法。
-
在产品目录（/vendor/hihope/rk3568）下创建thermal文件夹。
-
参考默认热策略的配置文件夹创建目标文件夹，并安装到
//vendor/hihope/rk3568/thermal，文件格式如下：profile ├── BUILD.gn ├── thermal_service_config.xml -
参考默认热策略的配置文件夹中的thermal_service_config.xml编写定制的thermal_service_config.xml。包含热策略配置说明及定制后的热策略配置如下，以其中两个热等级为例：
表1 config配置说明
配置项名称 配置项描述 配置项类型 配置项范围 name 定义热策略对应的传感器集合名称 string 对应热等级文档中定义的传感器集合名称 level 定义热策略对应的热等级 int 对应热等级文档中传感器集合下定义的热等级 表2 配置项说明
配置项名称 配置项描述 配置项类型 配置项范围 scene 使用场景 string 对应热场景文档中定义的使用场景 charge 是否在充电 int 0（不在充电），1（正在充电） screen 是否亮屏 int 0（灭屏），1（亮屏） 表3 节点配置说明
节点名称 节点值类型 节点值范围 节点描述 lcd double 0.00~1.00 屏幕亮度的百分比（用浮点数表示） cpu_big int 根据产品定义 CPU大核频率 cpu_med int 根据产品定义 CPU中核频率 cpu_lit int 根据产品定义 CPU小核频率 process_ctrl enum 1：KILL_FG_PROCESS_APP
2：KILL_BG_PROCESS_APP
3：KILL_ALL_PROCESS_APP进程控制 gpu int 根据产品定义 GPU频率 thermallevel int 对应config节点中的level 热等级 current_sc int 根据产品定义 快充电流 current_buck int 根据产品定义 慢充电流 voltage_sc int 根据产品定义 快充电压 voltage_buck int 根据产品定义 慢充电压 volume double 0.00~1.00 音量百分比（用浮点数表示） <policy><config name="base_safe" level="1"><lcd>1.00</lcd><lcd scene="cam">0.99</lcd><lcd scene="call">0.98</lcd><lcd scene="game">0.95</lcd><cpu_big>1992000</cpu_big><cpu_med>1991500</cpu_med><cpu_lit>1991200</cpu_lit><process_ctrl>3</process_ctrl><cpu_big scene="cam" charge="1">1991800</cpu_big><cpu_big scene="cam" charge="0">1991600</cpu_big><gpu screen="0">524288</gpu><gpu screen="1">512000</gpu><thermallevel>1</thermallevel><current_sc>1800</current_sc><current_sc scene="cam">1200</current_sc><current_buck>1200</current_buck><voltage_sc>4000</voltage_sc><voltage_buck>3000</voltage_buck><volume>1.0</volume></config> <policy><config name="base_safe" level="2"><lcd>0.90</lcd><lcd scene="cam">0.89</lcd><lcd scene="call">0.88</lcd><lcd scene="game">0.87</lcd><cpu_big>1991000</cpu_big><cpu_med>1990500</cpu_med><cpu_lit>1990200</cpu_lit><process_ctrl>2</process_ctrl><cpu_big scene="cam" charge="1">1990800</cpu_big><cpu_big scene="cam" charge="0">1990600</cpu_big><gpu screen="0">499712</gpu><gpu screen="1">487424</gpu><thermallevel>2</thermallevel><current_sc>1500</current_sc><current_sc scene="cam">1000</current_sc><current_buck>1000</current_buck><voltage_sc>3000</voltage_sc><voltage_buck>2000</voltage_buck><volume>0.8</volume></config> </policy> -
（可选）对热策略配置文件进行本地加密，同时配置解密方法。
-
开发者自行选择合适的加密工具对本地将编写好的thermal_service_config.xml进行加密。
-
开发者需要编写动态库libthermal_manager_ext.z.so并安装在文件系统中，动态库中包含解密接口getDecryptConfig的实现，程序将调用动态库中实现了的getDecryptConfig（在base/powermgr/thermal_manager/services/native/src/thermal_policy/thermal_srv_config_parser.cpp中）对配置文件进行解密，解密过程如下所示：
bool ThermalSrvConfigParser::DecryptConfig(const std::string& path, std::string& result) {// 请开发者自行实现动态库libthermal_manager_ext.z.sovoid *handler = dlopen(THERMAL_CONFIG_LIBRARY_PATH, RTLD_LAZY);if (handler == nullptr) {THERMAL_HILOGE(COMP_SVC, "dlopen failed, reason : %{public}s", dlerror());return false;}// 请开发者根据所使用的工具自行实现解密接口getDecryptConfigFunc getDecryptConfig = reinterpret_cast<Func>(dlsym(handler, GET_THERMAL_EXT_CONGIH_FUNC)); if (getDecryptConfig == nullptr) {THERMAL_HILOGE(COMP_SVC, "find function %{public}s failed, reason : %{public}s",GET_THERMAL_EXT_CONGIH_FUNC, dlerror());dlclose(handler);return false;}// 调用解密接口进行解密，将解密结果以字符串的形式存储在result中int32_t ret = getDecryptConfig(THERMAL_SERVICE_CONFIG_INDEX, result);if (ret != 0) {THERMAL_HILOGE(COMP_SVC, "decrypt config failed, ret:%{public}d", ret);dlclose(handler);return false;}dlclose(handler);return true; }
-
-
参考默认热策略配置文件夹中的BUILD.gn编写BUILD.gn文件，将thermal_service_config.xml打包到
/vendor/etc/thermal_config目录下：import("//build/ohos.gni") # 引用build/ohos.gniohos_prebuilt_etc("thermal_service_config") {source = "thermal_service_config.xml"relative_install_dir = "thermal_config"install_images = [ chipset_base_dir ] # 安装到vendor目录下的必要配置part_name = "product_rk3568" # part_name暂定为product_rk3568，以实现后续编译，产品定制根据需要自行修改 } -
将编译目标添加到ohos.build的"module_list"中，例如：
{"parts": {"product_rk3568": {"module_list": ["//vendor/hihope/rk3568/default_app_config:default_app_config","//vendor/hihope/rk3568/image_conf:custom_image_conf","//vendor/hihope/rk3568/preinstall-config:preinstall-config","//vendor/hihope/rk3568/resourceschedule:resourceschedule","//vendor/hihope/rk3568/etc:product_etc_conf","//vendor/hihope/rk3568/thermal/profile:thermal_service_config", // 添加thermal_service_config的编译]}},"subsystem": "product_hihope" }“//vendor/hihope/rk3568/thermal/”为文件夹路径，“profile”为创建的文件夹名字，“thermal_service_config”为编译目标。
-
参考《快速入门》编译定制版本，编译命令如下：
./build.sh --product-name rk3568 --ccache -
将定制版本烧录到DAYU200开发板中。
调测验证
-
开机后，进入shell命令行：
hdc shell -
获取当前热策略信息。
hidumper -s 3303 -a -p查看定制后的热策略结果如下：
-------------------------------[ability]-----------------------------------------------------------------ThermalService--------------------------------- name: base_safe level: 1 actionName: lcd actionValue: 1.00 isProp: 0 actionName: lcd actionValue: 0.99 scene: cam isProp: 1 actionName: lcd actionValue: 0.98 scene: call isProp: 1 actionName: lcd actionValue: 0.95 scene: game isProp: 1 actionName: cpu_big actionValue: 1992000 isProp: 0 actionName: cpu_med actionValue: 1991500 isProp: 0 actionName: cpu_lit actionValue: 1991200 isProp: 0 actionName: process_ctrl actionValue: 3 isProp: 0 actionName: cpu_big actionValue: 1991800 charge: 1 scene: cam isProp: 1 actionName: cpu_big actionValue: 1991600 charge: 0 scene: cam isProp: 1 actionName: gpu actionValue: 524288 screen: 0 isProp: 1 actionName: gpu actionValue: 512000 screen: 1 isProp: 1 actionName: thermallevel actionValue: 1 isProp: 0 actionName: current_sc actionValue: 1800 isProp: 0 actionName: current_sc actionValue: 1200 scene: cam isProp: 1 actionName: current_buck actionValue: 1200 isProp: 0 actionName: voltage_sc actionValue: 4000 isProp: 0 actionName: voltage_buck actionValue: 3000 isProp: 0 actionName: volume actionValue: 1.0 isProp: 0 actionName: boost actionValue: 1 isProp: 0level: 2 actionName: lcd actionValue: 0.90 isProp: 0 actionName: lcd actionValue: 0.89 scene: cam isProp: 1 actionName: lcd actionValue: 0.88 scene: call isProp: 1 actionName: lcd actionValue: 0.87 scene: game isProp: 1 actionName: cpu_big actionValue: 1991000 isProp: 0 actionName: cpu_med actionValue: 1990500 isProp: 0 actionName: cpu_lit actionValue: 1990200 isProp: 0 actionName: process_ctrl actionValue: 2 isProp: 0 actionName: cpu_big actionValue: 1990800 charge: 1 scene: cam isProp: 1 actionName: cpu_big actionValue: 1990600 charge: 0 scene: cam isProp: 1 actionName: gpu actionValue: 499712 screen: 0 isProp: 1 actionName: gpu actionValue: 487424 screen: 1 isProp: 1 actionName: thermallevel actionValue: 2 isProp: 0 actionName: current_sc actionValue: 1500 isProp: 0 actionName: current_sc actionValue: 1000 scene: cam isProp: 1 actionName: current_buck actionValue: 1000 isProp: 0 actionName: voltage_sc actionValue: 3000 isProp: 0 actionName: voltage_buck actionValue: 2000 isProp: 0 actionName: volume actionValue: 0.8 isProp: 0 actionName: boost actionValue: 1 isProp: 0
参考
开发过程中可参考的配置文件路径：默认热策略源码路径
打包路径：/vendor/etc/thermal_config/hdf
