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）](https://gitee.com/openharmony/vendor_hihope/tree/master/rk3568)下创建battery文件夹。 31 322. 参考[默认电量等级配置文件夹](https://gitee.com/openharmony/powermgr_battery_manager/tree/master/services/native/profile)创建目标文件夹，并安装到`//vendor/hihope/rk3568/battery`目录下，文件格式如下： 33 34 ```text 35 profile 36 ├── BUILD.gn 37 ├── battery_config.json 38 ``` 39 403. 参考[默认电量等级的配置文件夹中的battery_config.json](https://gitee.com/openharmony/powermgr_battery_manager/blob/master/services/native/profile/battery_config.json)编写定制的battery_config.json，包含定制后的电量等级配置如下： 41 42 ```json 43 { 44 "soc": { 45 "shutdown": 5, 46 "critical": 10, 47 "warning": 15, 48 "low": 30, 49 "normal": 60, 50 "high": 90, 51 "full": 100 52 } 53 } 54 ``` 55 56 **表1** 电量等级配置说明 57 58 | 电量等级 | 电量 | 说明 | 59 | -------- | -------- | -------- | 60 | shutdown | 5 | 关机电量 | 61 | critical | 10 | 极低电量 | 62 | warning | 15 | 告警电量 | 63 | low | 30 | 低电量 | 64 | normal | 60 | 正常电量 | 65 | high | 90 | 高电量 | 66 | full | 100 | 满电量 | 67 68 694. 参考[默认电量等级的配置文件夹中的BUILD.gn](https://gitee.com/openharmony/powermgr_battery_manager/blob/master/services/native/profile/BUILD.gn)编写BUILD.gn文件，将battery_config.json打包到`//vendor/etc/battery`目录下，配置如下： 70 71 ```shell 72 import("//build/ohos.gni") #引用build/ohos.gni 73 74 ohos_prebuilt_etc("battery_config") { 75 source = "battery_config.json" 76 relative_install_dir = "battery" 77 install_images = [ chipset_base_dir ] #安装到vendor目录下的必要配置 78 part_name = "product_rk3568" #part_name为product_rk3568，以实现后续编译 79 } 80 ``` 81 825. 将编译目标添加到`/vendor/hihope/rk3568`目录下[ohos.build](https://gitee.com/openharmony/vendor_hihope/blob/master/rk3568/ohos.build)的"module_list"中，例如： 83 84 ```json 85 { 86 "parts": { 87 "product_rk3568": { 88 "module_list": [ 89 "//vendor/hihope/rk3568/default_app_config:default_app_config", 90 "//vendor/hihope/rk3568/image_conf:custom_image_conf", 91 "//vendor/hihope/rk3568/preinstall-config:preinstall-config", 92 "//vendor/hihope/rk3568/resourceschedule:resourceschedule", 93 "//vendor/hihope/rk3568/etc:product_etc_conf", 94 "//vendor/hihope/rk3568/battery/profile:battery_config" #添加battery_config的编译 95 ] 96 } 97 }, 98 "subsystem": "product_hihope" 99 } 100 ``` 101 “//vendor/hihope/rk3568/battery/”为文件夹路径，“profile”为创建的文件夹名字，“battery_config”为编译目标。 102 1036. 参考《[快速入门](../quick-start/quickstart-overview.md)》编译定制版本，编译命令如下： 104 105 ```shell 106 ./build.sh --product-name rk3568 --ccache 107 ``` 108 1097. 将定制版本烧录到DAYU200开发板中。 110 111### 调测验证 112 1131. 开机后，进入shell命令行： 114 ``` 115 hdc shell 116 ``` 117 1182. 进入电池电量的节点路径（以当前DAYU开发版路径为例）。 119 ``` 120 cd /data/service/el0/battery/battery/ 121 ``` 122 1233. 默认充电类型的映射配置数据为例，修改充电状态，模拟电池信息上报，观察发送是否发送对应充电类型广播。 124 125 1. 修改电量信息。 126 ``` 127 echo 100 > capacity 128 ``` 129 2. 上报电量信息改变，获取当前电量等级。 130 ``` 131 hidumper -s 3302 -a -i 132 ``` 133 3. 成功获取电量等级如下: 134 135 ``` 136 -------------------------------[ability]------------------------------- 137 138 139 ----------------------------------BatteryService--------------------------------- 140 Current time: 2017-08-05 17:22:48.589 141 142 ······(省略其他，只显示batteryLevel的配置) 143 144 batteryLevel: 1 145 146 ······ 147 ``` 148 149 4. 修改电量信息。 150 ``` 151 echo 90 > capacity 152 ``` 153 5. 上报电量信息改变，获取当前电量等级。 154 ``` 155 hidumper -s 3302 -a -i 156 ``` 157 6. 成功获取电量等级如下: 158 159 ``` 160 -------------------------------[ability]------------------------------- 161 162 163 ----------------------------------BatteryService--------------------------------- 164 Current time: 2017-08-05 17:24:29.716 165 166 ······(省略其他，只显示batteryLevel的配置) 167 168 batteryLevel: 2 169 170 ······ 171 ``` 172 173 7. 修改电量信息。 174 ``` 175 echo 60 > capacity 176 ``` 177 8. 上报电量信息改变，获取当前电量等级。 178 ``` 179 hidumper -s 3302 -a -i 180 ``` 181 9. 成功获取电量等级如下: 182 183 ``` 184 -------------------------------[ability]------------------------------- 185 186 187 ----------------------------------BatteryService--------------------------------- 188 Current time: 2017-08-05 17:25:09.837 189 190 ······(省略其他，只显示batteryLevel的配置) 191 192 batteryLevel: 3 193 194 ······ 195 ``` 196 197 10. 修改电量信息。 198 ``` 199 echo 30 > capacity 200 ``` 201 11. 上报电量信息改变，获取当前电量等级。 202 ``` 203 hidumper -s 3302 -a -i 204 ``` 205 12. 成功获取电量等级如下: 206 207 ``` 208 -------------------------------[ability]------------------------------- 209 210 211 ----------------------------------BatteryService--------------------------------- 212 Current time: 2017-08-05 17:26:20.495 213 214 ······(省略其他，只显示batteryLevel的配置) 215 216 batteryLevel: 4 217 218 ······ 219 ``` 220 221 13. 修改电量信息。 222 ``` 223 echo 15 > capacity 224 ``` 225 14. 上报电量信息改变，获取当前电量等级。 226 ``` 227 hidumper -s 3302 -a -i 228 ``` 229 15. 成功获取电量等级如下: 230 231 ``` 232 -------------------------------[ability]------------------------------- 233 234 235 ----------------------------------BatteryService--------------------------------- 236 Current time: 2017-08-05 17:27:05.312 237 238 ······(省略其他，只显示batteryLevel的配置) 239 240 batteryLevel: 5 241 242 ······ 243 ``` 244 245 16. 修改电量信息。 246 ``` 247 echo 10 > capacity 248 ``` 249 17. 上报电量信息改变，获取当前电量等级。 250 ``` 251 hidumper -s 3302 -a -i 252 ``` 253 18. 成功获取电量等级如下: 254 255 ``` 256 -------------------------------[ability]------------------------------- 257 258 259 ----------------------------------BatteryService--------------------------------- 260 Current time: 2017-08-05 17:27:56.270 261 262 ······(省略其他，只显示batteryLevel的配置) 263 264 batteryLevel: 6 265 266 ······ 267 ``` 268 269 19. 修改电量信息。 270 ``` 271 echo 5 > capacity 272 ``` 273 20. 上报电量信息改变，获取当前电量等级。 274 ``` 275 hidumper -s 3302 -a -i 276 ``` 277 21. 成功获取电量等级如下: 278 279 ``` 280 -------------------------------[ability]------------------------------- 281 282 283 ----------------------------------BatteryService--------------------------------- 284 Current time: 2017-08-05 17:28:38.066 285 286 ······(省略其他，只显示batteryLevel的配置) 287 288 batteryLevel: 7 289 290 ······ 291 ``` 292 293## 参考 294开发过程中可参考的配置文件路径：[电量等级配置源码路径](https://gitee.com/openharmony/powermgr_battery_manager/tree/master/services/native/profile/) 295 296默认配置： 297 298```json 299{ 300 "soc": { 301 "shutdown": 1, 302 "critical": 5, 303 "warning": 10, 304 "low": 20, 305 "normal": 90, 306 "high": 99, 307 "full": 100 308 } 309} 310``` 311 312打包路径：/system/etc/battery 313