1# 唤醒源定制开发指导 2 3## 概述 4 5### 简介 6 7OpenHarmony支持多种唤醒源，如电源键、键盘、鼠标等，并提供了定制开启和关闭的方式。当设备进入休眠状态后，用户可以通过按电源键、按键盘、鼠标事件、轻触屏幕等，来点亮屏幕并唤醒设备。但不同的产品可能支持不同的外设，比如无手写笔、无皮套等。为此，OpenHarmony提供唤醒源的定制方式，产品可以根据具体的设计规格来定制此特性。 8 9### 约束与限制 10 11配置策略： 12产品定制的配置路径，需要根据[配置策略](https://gitee.com/openharmony/customization_config_policy)决定。本开发指导中的定制路径以`/vendor`进行举例，请开发者根据具体的产品配置策略，修改定制路径。 13 14## 开发指导 15 16### 搭建环境 17 18设备要求： 19 20标准系统开发板，如DAYU200/Hi3516DV300开源套件。 21 22环境要求： 23 24Linux调测环境，相关要求和配置可参考《[快速入门](../quick-start/quickstart-overview.md)》。 25 26### 开发步骤 27 28本文以[DAYU200](https://gitee.com/openharmony/vendor_hihope/tree/master/rk3568)为例介绍唤醒源的定制方法。 29 301. 在产品目录`/vendor/hihope/rk3568`下创建power_manager文件夹。 31 322. 参考[唤醒源文件夹](https://gitee.com/openharmony/powermgr_power_manager/tree/master/services/native/profile)创建目标文件夹，并安装到`/vendor/hihope/rk3568/power_manager`目录下，文件格式如下： 33 34 ```text 35 profile 36 ├── BUILD.gn 37 ├── power_wakeup.json 38 ``` 39 403. 编写定制的power_wakeup.json，包含定制后的唤醒源如下： 41 42 ```json 43 { 44 "powerkey": { 45 "enable": true 46 }, 47 "keyborad": { 48 "enable": true 49 }, 50 "mouse": { 51 "enable": true 52 }, 53 "touchscreen": { 54 "enable": true, 55 "click": 2 56 }, 57 "touchpad": { 58 "enable": true 59 }, 60 "pen": { 61 "enable": true 62 }, 63 "lid": { 64 "enable": true 65 }, 66 "switch": { 67 "enable": true 68 }, 69 "tp_touch": { 70 "enable": true 71 } 72 } 73 ``` 74 75 **表1** 唤醒源说明 76 77 | 休眠源 | 描述 | 78 | -------- | -------- | 79 | powerkey | 电源键唤醒 | 80 | keyborad | 键盘唤醒 | 81 | mouse | 鼠标唤醒 | 82 | touchscreen | 触摸屏幕唤醒 | 83 | touchpad | 触摸板唤醒 | 84 | pen | 手写笔唤醒 | 85 | lid | 皮套唤醒 | 86 | switch | 盖子唤醒 | 87 | tp_touch | 触屏唤醒 | 88 89 **表2** 唤醒源配置说明 90 91 | 配置项 | 类型 | 描述 | 92 | -------- | -------- | -------- | 93 | enable | bool | 是否开启唤醒监听 | 94 | click | int | 点击次数 | 95 96 974. 参考[唤醒源的配置文件夹中的BUILD.gn](https://gitee.com/openharmony/powermgr_power_manager/blob/master/services/native/profile/BUILD.gn)编写BUILD.gn文件，将power_wakeup.json打包到`/vendor/etc/power_config`目录下，配置如下： 98 99 ```shell 100 import("//build/ohos.gni") #引用build/ohos.gni 101 102 ohos_prebuilt_etc("wakeup_config") { 103 source = "power_wakeup.json" 104 relative_install_dir = "power_config" 105 install_images = [ chipset_base_dir ] #安装到vendor目录下的必要配置 106 part_name = "product_rk3568" #part_name为product_rk3568，以实现后续编译 107 } 108 ``` 109 1105. 将编译目标添加到`/vendor/hihope/rk3568`目录下[ohos.build](https://gitee.com/openharmony/vendor_hihope/blob/master/rk3568/ohos.build)的"module_list"中，例如： 111 112 ```json 113 { 114 "parts": { 115 "product_rk3568": { 116 "module_list": [ 117 "//vendor/hihope/rk3568/default_app_config:default_app_config", 118 "//vendor/hihope/rk3568/image_conf:custom_image_conf", 119 "//vendor/hihope/rk3568/preinstall-config:preinstall-config", 120 "//vendor/hihope/rk3568/resourceschedule:resourceschedule", 121 "//vendor/hihope/rk3568/etc:product_etc_conf", 122 "//vendor/hihope/rk3568/power_manager/profile:wakeup_config" //添加wakeup_config的编译 123 ] 124 } 125 }, 126 "subsystem": "product_hihope" 127 } 128 ``` 129 “//vendor/hihope/rk3568/power_manager/”为文件夹路径，“profile”为创建的文件夹名字，“wakeup_config”为编译目标。 130 1316. 参考《[快速入门](../quick-start/quickstart-overview.md)》编译定制版本，编译命令如下： 132 133 ```shell 134 ./build.sh --product-name rk3568 --ccache 135 ``` 136 1377. 将定制版本烧录到DAYU200开发板中。 138 139### 调测验证 140 141> **说明**： 142> 143> 双击亮屏当前暂不支持，即"touchscreen"中的"enable"当前仅支持为false。能力将会在后续版本提供。 144 1451. 以新的唤醒源配置文件为例，更改之后： 146 ```json 147 { 148 "powerkey": { 149 "enable": true 150 }, 151 "keyborad": { 152 "enable": true 153 }, 154 "mouse": { 155 "enable": true 156 }, 157 "touchscreen": { 158 "enable": false, 159 "click": 2 160 }, 161 "touchpad": { 162 "enable": false 163 }, 164 "pen": { 165 "enable": false 166 }, 167 "lid": { 168 "enable": false 169 }, 170 "switch": { 171 "enable": false 172 }, 173 "tp_touch": { 174 "enable": false 175 } 176 } 177 ``` 178 1792. 开机后，点击电源键使设备进入休眠状态，再次点击电源键。 180 181 设备屏幕点亮，设备被唤醒。 182 1833. 点击电源键使设备进入休眠状态，按下键盘。 184 185 设备屏幕点亮，设备被唤醒。 186 1874. 点击电源键使设备进入休眠状态，滑动鼠标。 188 189 设备屏幕点亮，设备被唤醒。