OpenHarmony子系统开发 - 电源管理（二）

OpenHarmony子系统开发 - 电源管理（二）

三、唤醒源定制开发指导

概述

简介

OpenHarmony支持多种唤醒源，如电源键、键盘、鼠标等，并提供了定制开启和关闭的方式。当设备进入休眠状态后，用户可以通过按电源键、按键盘、鼠标事件、轻触屏幕等，来点亮屏幕并唤醒设备。但不同的产品可能支持不同的外设，比如无手写笔、无皮套等。为此，OpenHarmony提供唤醒源的定制方式，产品可以根据具体的设计规格来定制此特性。

约束与限制

配置策略： 产品定制的配置路径，需要根据配置策略决定。本开发指导中的定制路径以/vendor进行举例，请开发者根据具体的产品配置策略，修改定制路径。

开发指导

搭建环境

设备要求：

标准系统开发板，如DAYU200/Hi3516DV300开源套件。

环境要求：

Linux调测环境，相关要求和配置可参考《快速入门》

开发步骤

本文以DAYU200为例介绍唤醒源的定制方法。

1. 在产品目录/vendor/hihope/rk3568下创建power_manager文件夹。

2. 参考唤醒源文件夹创建目标文件夹，并安装到/vendor/hihope/rk3568/power_manager目录下，文件格式如下：

   profile
   ├── BUILD.gn
   ├── power_wakeup.json
   

3. 编写定制的power_wakeup.json，包含定制后的唤醒源如下：

   {
       "powerkey": {
           "enable": true
       },
       "keyborad": {
           "enable": true
       },
       "mouse": {
           "enable": true
       },
       "touchscreen": {
           "enable": true,
           "click": 2
       },
       "touchpad": {
           "enable": true
       },
       "pen": {
           "enable": true
       },
       "lid": {
           "enable": true
       },
       "switch": {
           "enable": true
       },
       "tp_touch": {
           "enable": true
       }
   }
   

   表1 唤醒源说明

   休眠源	描述
   powerkey	电源键唤醒
   keyborad	键盘唤醒
   mouse	鼠标唤醒
   touchscreen	触摸屏幕唤醒
   touchpad	触摸板唤醒
   pen	手写笔唤醒
   lid	皮套唤醒
   switch	盖子唤醒
   tp_touch	触屏唤醒

   表2 唤醒源配置说明

   配置项	类型	描述
   enable	bool	是否开启唤醒监听
   click	int	点击次数

4. 参考唤醒源的配置文件夹中的BUILD.gn编写BUILD.gn文件，将power_wakeup.json打包到/vendor/etc/power_config目录下，配置如下：

   import("//build/ohos.gni")               #引用build/ohos.gni
   
   ohos_prebuilt_etc("wakeup_config") {
       source = "power_wakeup.json"
       relative_install_dir = "power_config"
       install_images = [ chipset_base_dir ] #安装到vendor目录下的必要配置
       part_name = "product_rk3568"          #part_name为product_rk3568，以实现后续编译
   }
   

5. 将编译目标添加到/vendor/hihope/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/power_manager/profile:wakeup_config" //添加wakeup_config的编译
               ]
           }
       },
       "subsystem": "product_hihope"
   }
   

   “//vendor/hihope/rk3568/power_manager/”为文件夹路径，“profile”为创建的文件夹名字，“wakeup_config”为编译目标。

6. 参考《快速入门》编译定制版本，编译命令如下：

   ./build.sh --product-name rk3568 --ccache
   

7. 将定制版本烧录到DAYU200开发板中。

调测验证

说明：

双击亮屏当前暂不支持，即"touchscreen"中的"enable"当前仅支持为false。能力将会在后续版本提供。

1. 以新的唤醒源配置文件为例，更改之后：

   {
       "powerkey": {
           "enable": true
       },
       "keyborad": {
           "enable": true
       },
       "mouse": {
           "enable": true
       },
       "touchscreen": {
           "enable": false,
           "click": 2
       },
       "touchpad": {
           "enable": false
       },
       "pen": {
           "enable": false
       },
       "lid": {
           "enable": false
       },
       "switch": {
           "enable": false
       },
       "tp_touch": {
           "enable": false
       }
   }
   

2. 开机后，点击电源键使设备进入休眠状态，再次点击电源键。

   设备屏幕点亮，设备被唤醒。

3. 点击电源键使设备进入休眠状态，按下键盘。

   设备屏幕点亮，设备被唤醒。

4. 点击电源键使设备进入休眠状态，滑动鼠标。

   设备屏幕点亮，设备被唤醒。

四、关机振动定制开发指导

概述

简介

OpenHarmony提供了定制电源服务振动提示的能力，产品定制开发者可根据产品设计规格来定制。在该模式下可通过修改配置文件在手机关机出现弹窗的同时触发振动效果，且当前暂时仅支持在关机弹窗场景下使用。

基本概念

约束与限制

该功能依赖于设备硬件，设备需要有振动马达器件。

开发指导

搭建环境

设备要求：

标准系统开发板，如DAYU200开源套件，外接振动马达器件。

环境要求：

Linux调测环境，相关要求和配置可参考《快速入门》。

开发步骤

本文以power_manager项目开发关机弹窗振动为例。

1. 在power_manager项目中，编写定制的"power_vibrator.json"，例如:

   {
   "shutdown_diag": {
       "enable": true,
       "type": "haptic.long_press.heavy"
       }
   }
   

   • shutdown_diag: 振动场景字符串名称，不可修改。

   • enable: 振动使能开关，配置true则触发振动，false则不触发，默认为false。

   • type: 振动的波形名称，当前模式下的名称默认如上。

2. 参考《快速入门》编译定制版本，编译命令如下：

   ./build.sh --product-name rk3568 --ccache
   

3. 将定制版本烧录到DAYU200开发板中。

调测验证

长按power键，浮现关机弹窗的同时手机触发振动效果。

参考

关机弹窗振动默认配置

五、唤醒后系统动作定制开发指导

概述

简介

OpenHarmony支持系统睡眠时唤醒执行动作，如在睡眠中低电量情况下唤醒使系统关机。当设备进入睡眠状态后，可以根据用户配置的策略唤醒并执行对应动作。但不同产品可支持的场景可能不同，比如不支持低电量唤醒。为此，OpenHarmony提供唤醒后动作的定制方式，产品可以根据具体的设计规格来定制此特性。

约束与限制

约束： 唤醒后动作特性需要适配：

• 满足唤醒条件（如电量低于阈值）时触发电源键事件;
• 唤醒原因（如低电量唤醒）保存到内核节点。

配置策略： 产品定制的配置路径，需要根据配置策略决定。本开发指导中的定制路径以/vendor进行举例，请开发者根据具体的产品配置策略，修改定制路径。

开发指导

搭建环境

设备要求：

标准系统开发板，如DAYU200/Hi3516DV300开源套件。

环境要求：

Linux调测环境，相关要求和配置可参考《快速入门》

开发步骤

本文以DAYU200为例介绍唤醒源的定制方法。

1. 在产品目录/vendor/hihope/rk3568下创建power_manager文件夹。

2. 参考唤醒源文件夹创建目标文件夹，并安装到/vendor/hihope/rk3568/power_manager目录下，文件格式如下：

   profile
   ├── BUILD.gn
   ├── power_wakeup_action.json
   

3. 编写定制的power_wakeup_action.json，包含定制后的唤醒原因和动作如下：

   {
       "53": {
           "scene": "LowCapacity",
           "action": 2,
           "description": "(such as)53 is a uniquely wakeup reason by reading node through HDI interface(GetWakeupReason)"
       }
   }
   

   表1 唤醒源说明

   唤醒源	描述
   53	低电量唤醒

   唤醒源配置来源于实际场景，如读取节点或其他获得，description用来描述具体来源

   表2 唤醒场景说明

   唤醒场景	描述
   LowCapacity	低电量

   表3 action说明

   action	取值	描述
   ACTION_NONE	0	无动作
   ACTION_HIBERNATE	1	进入休眠
   ACTION_SHUTDOWN	2	关机

4. 参考唤醒源的配置文件夹中的BUILD.gn编写BUILD.gn文件，将power_wakeup_action.json打包到/vendor/etc/power_wakeup_action目录下，配置如下：

   import("//build/ohos.gni")               #引用build/ohos.gni
   
   ohos_prebuilt_etc("wakeup_action_config") {
       source = "power_wakeup_action.json"
       relative_install_dir = "power_config"
       install_images = [ chipset_base_dir ] #安装到vendor目录下的必要配置
       part_name = "product_rk3568"          #part_name为product_rk3568，以实现后续编译
   }
   

5. 将编译目标添加到/vendor/hihope/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/power_manager/profile:wakeup_action_config" //添加wakeup_action_config的编译
               ]
           }
       },
       "subsystem": "product_hihope"
   }
   

   “//vendor/hihope/rk3568/power_manager/”为文件夹路径，“profile”为创建的文件夹名字，“wakeup_action_config”为编译目标。

6. 参考《快速入门》编译定制版本，编译命令如下：

   ./build.sh --product-name rk3568 --ccache
   

7. 将定制版本烧录到DAYU200开发板中。

调测验证

1. 以新的唤醒源配置文件为例，更改之后：

   {
       "53": {
           "scene": "LowCapacity",
           "action": 2,
           "description": "(such as)53 is a uniquely wakeup reason by reading node through HDI interface(GetWakeupReason)"
       }
   }
   

2. 修改powermgr.gni，使能power_manager_feature_wakeup_action特性。

   power_manager_feature_wakeup_action = true
   

3. 参考battery_config.json中添加如下配置

   "charge_scene": {
       "low_battery_thers": {
         "set": {
           "path": "xxx"
         }
       }
   }
   

   其中path为保存低电量阈值的节点路径。

4. 修改batterymgr.gni，使能battery_manager_feature_set_low_capacity_threshold特性。

   battery_manager_feature_set_low_capacity_threshold = true
   

5. 在power_config.json中添加如下部分

   {
       "scene" :{
           "wakeuo_cause": {
               "get": {
                   "path": "yyy"
               }
           }
       }
   }
   

   其中get为保存低电量唤醒原因的节点路径。

6. 修改power.gni，打开drivers_peripheral_power_wakeup_cause_path特性。

   drivers_peripheral_power_wakeup_cause_path = true
   

7. 在hdf_peripheral.cfg的pre-init修改节点权限为system。

   "chown system system xxx",
   "chown system system yyy",
   

8. 使系统在睡眠中电量下降至阈值。

   设备关机。