1# 唤醒后系统动作定制开发指导
2
3## 概述
4
5### 简介
6
7OpenHarmony支持系统睡眠时唤醒执行动作，如在睡眠中低电量情况下唤醒使系统关机。当设备进入睡眠状态后，可以根据用户配置的策略唤醒并执行对应动作。但不同产品可支持的场景可能不同，比如不支持低电量唤醒。为此，OpenHarmony提供唤醒后动作的定制方式，产品可以根据具体的设计规格来定制此特性。
8
9### 约束与限制
10
11约束：
12唤醒后动作特性需要适配：
13
14- 满足唤醒条件（如电量低于阈值）时触发电源键事件;
15- 唤醒原因（如低电量唤醒）保存到内核节点。
16
17配置策略：
18产品定制的配置路径，需要根据[配置策略](https://gitee.com/openharmony/customization_config_policy)决定。本开发指导中的定制路径以`/vendor`进行举例，请开发者根据具体的产品配置策略，修改定制路径。
19
20## 开发指导
21
22### 搭建环境
23
24设备要求：
25
26标准系统开发板，如DAYU200/Hi3516DV300开源套件。
27
28环境要求：
29
30Linux调测环境，相关要求和配置可参考《[快速入门](../quick-start/quickstart-overview.md)》
31
32### 开发步骤
33
34本文以[DAYU200](https://gitee.com/openharmony/vendor_hihope/tree/master/rk3568)为例介绍唤醒源的定制方法。
35
361. 在产品目录`/vendor/hihope/rk3568`下创建power_manager文件夹。
37
382. 参考[唤醒源文件夹](https://gitee.com/openharmony/powermgr_power_manager/tree/master/services/native/profile)创建目标文件夹，并安装到`/vendor/hihope/rk3568/power_manager`目录下，文件格式如下：
39
40    ```text
41    profile
42    ├── BUILD.gn
43    ├── power_wakeup_action.json
44    ```
45
463. 编写定制的power_wakeup_action.json，包含定制后的唤醒原因和动作如下：
47
48    ```json
49    {
50        "53": {
51            "scene": "LowCapacity",
52            "action": 2,
53            "description": "(such as)53 is a uniquely wakeup reason by reading node through HDI interface(GetWakeupReason)"
54        }
55    }
56    ```
57
58    **表1** 唤醒源说明
59
60    | 唤醒源 | 描述 |
61    | -------- | -------- |
62    | 53 | 低电量唤醒 |
63
64    唤醒源配置来源于实际场景，如读取节点或其他获得，description用来描述具体来源
65
66    **表2** 唤醒场景说明
67
68    | 唤醒场景 | 描述 |
69    | -------- | -------- |
70    | LowCapacity | 低电量 |
71
72    **表3** action说明
73
74    | action | 取值 | 描述 |
75    | -------- | -------- | -------- |
76    | ACTION_NONE | 0 | 无动作 |
77    | ACTION_HIBERNATE | 1 | 进入休眠 |
78    | ACTION_SHUTDOWN | 2 | 关机 |
79
804. 参考[唤醒源的配置文件夹中的BUILD.gn](https://gitee.com/openharmony/powermgr_power_manager/blob/master/services/native/profile/BUILD.gn)编写BUILD.gn文件，将power_wakeup_action.json打包到`/vendor/etc/power_wakeup_action`目录下，配置如下：
81
82    ```shell
83    import("//build/ohos.gni")               #引用build/ohos.gni
84
85    ohos_prebuilt_etc("wakeup_action_config") {
86        source = "power_wakeup_action.json"
87        relative_install_dir = "power_config"
88        install_images = [ chipset_base_dir ] #安装到vendor目录下的必要配置
89        part_name = "product_rk3568"          #part_name为product_rk3568，以实现后续编译
90    }
91    ```
92
935. 将编译目标添加到`/vendor/hihope/rk3568`目录下[ohos.build](https://gitee.com/openharmony/vendor_hihope/blob/master/rk3568/ohos.build)的"module_list"中，例如：
94
95    ```json
96    {
97        "parts": {
98            "product_rk3568": {
99                "module_list": [
100                    "//vendor/hihope/rk3568/default_app_config:default_app_config",
101                    "//vendor/hihope/rk3568/image_conf:custom_image_conf",
102                    "//vendor/hihope/rk3568/preinstall-config:preinstall-config",
103                    "//vendor/hihope/rk3568/resourceschedule:resourceschedule",
104                    "//vendor/hihope/rk3568/etc:product_etc_conf",
105                    "//vendor/hihope/rk3568/power_manager/profile:wakeup_action_config" //添加wakeup_action_config的编译
106                ]
107            }
108        },
109        "subsystem": "product_hihope"
110    }
111    ```
112    “//vendor/hihope/rk3568/power_manager/”为文件夹路径，“profile”为创建的文件夹名字，“wakeup_action_config”为编译目标。
113
1146. 参考《[快速入门](../quick-start/quickstart-overview.md)》编译定制版本，编译命令如下：
115
116    ```shell
117    ./build.sh --product-name rk3568 --ccache
118    ```
119
1207. 将定制版本烧录到DAYU200开发板中。
121
122### 调测验证
123
1241. 以新的唤醒源配置文件为例，更改之后：
125    ```json
126    {
127        "53": {
128            "scene": "LowCapacity",
129            "action": 2,
130            "description": "(such as)53 is a uniquely wakeup reason by reading node through HDI interface(GetWakeupReason)"
131        }
132    }
133    ```
134
1352. 修改[powermgr.gni](https://gitee.com/openharmony/powermgr_power_manager/blob/master/powermgr.gni)，使能power_manager_feature_wakeup_action特性。
136    ```
137    power_manager_feature_wakeup_action = true
138    ```
139
1403. 参考[battery_config.json](https://gitee.com/openharmony/powermgr_battery_manager/blob/master/services/native/profile/battery_config.json)中添加如下配置
141    ```json
142    "charge_scene": {
143        "low_battery_thers": {
144          "set": {
145            "path": "xxx"
146          }
147        }
148    }
149    ```
150    其中path为保存低电量阈值的节点路径。
151
1524. 修改[batterymgr.gni](https://gitee.com/openharmony/powermgr_battery_manager/blob/master/batterymgr.gni)，使能battery_manager_feature_set_low_capacity_threshold特性。
153    ```
154    battery_manager_feature_set_low_capacity_threshold = true
155    ```
1565. 在[power_config.json](https://gitee.com/openharmony/drivers_peripheral/blob/master/power/interfaces/hdi_service/profile/power_config.json)中添加如下部分
157    ```json
158    {
159        "scene" :{
160            "wakeuo_cause": {
161                "get": {
162                    "path": "yyy"
163                }
164            }
165        }
166    }
167    ```
168    其中get为保存低电量唤醒原因的节点路径。
169
1705. 修改[power.gni](https://gitee.com/openharmony/drivers_peripheral/blob/master/power/power.gni)，打开drivers_peripheral_power_wakeup_cause_path特性。
171    ```
172    drivers_peripheral_power_wakeup_cause_path = true
173    ```
1746. 在[hdf_peripheral.cfg](https://gitee.com/openharmony/drivers_peripheral/blob/master/base/hdf_peripheral.cfg)的pre-init修改节点权限为system。
175    ```
176    "chown system system xxx",
177    "chown system system yyy",
178    ```
1797. 使系统在睡眠中电量下降至阈值。
180
181    设备关机。