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本文以[DAYU200](https://gitee.com/openharmony/vendor_hihope/tree/master/rk3568)为例介绍电池温度保护机制的定制方法。
28
291. 在产品目录[（/vendor/hihope/rk3568）](https://gitee.com/openharmony/vendor_hihope/tree/master/rk3568)下创建battery文件夹。
30
312. 参考[默认电池温度保护配置文件夹](https://gitee.com/openharmony/powermgr_battery_manager/tree/master/services/native/profile)创建目标文件夹，并安装到`//vendor/hihope/rk3568/battery`目录下，文件格式如下：
32
33    ```text
34    profile
35    ├── BUILD.gn
36    ├── battery_config.json
37    ```
38
393. 参考[默认电池温度保护的配置文件夹中的battery_config.json](https://gitee.com/openharmony/powermgr_battery_manager/blob/master/services/native/profile/battery_config.json)编写定制的battery_config.json，包含定制后的电池温度保护配置如下：
40
41    ```json
42    {
43        "temperature": {
44        "high": 500,
45        "low": -400
46        }
47    }
48    ```
49
50    **表1** 温度保护参数说明
51    | 温度保护机制阈值 | 温度（摄氏度）|
52    | -------- | -------- |
53    | high | 600 |
54    | low | -500 |
55
56
574. 参考[默认电池温度保护的配置文件夹中的BUILD.gn](https://gitee.com/openharmony/powermgr_battery_manager/blob/master/services/native/profile/BUILD.gn)编写BUILD.gn文件，将battery_config.json打包到`//vendor/etc/battery`目录下，配置如下：
58
59    ```shell
60    import("//build/ohos.gni")                #引用build/ohos.gni
61
62    ohos_prebuilt_etc("battery_config") {
63        source = "battery_config.json"
64        relative_install_dir = "battery"
65        install_images = [ chipset_base_dir ] #安装到vendor目录下的必要配置
66        part_name = "product_rk3568"          #part_name为product_rk3568，以实现后续编译
67    }
68    ```
69
705. 将编译目标添加到`/vendor/hihope/rk3568`目录下[ohos.build](https://gitee.com/openharmony/vendor_hihope/blob/master/rk3568/ohos.build)的"module_list"中，例如：
71
72    ```json
73    {
74    "parts": {
75        "product_rk3568": {
76        "module_list": [
77            "//vendor/hihope/rk3568/default_app_config:default_app_config",
78            "//vendor/hihope/rk3568/image_conf:custom_image_conf",
79            "//vendor/hihope/rk3568/preinstall-config:preinstall-config",
80            "//vendor/hihope/rk3568/resourceschedule:resourceschedule",
81            "//vendor/hihope/rk3568/etc:product_etc_conf",
82            "//vendor/hihope/rk3568/battery/profile:battery_config" #添加battery_config的编译
83        ]
84        }
85    },
86    "subsystem": "product_hihope"
87    }
88    ```
89    “//vendor/hihope/rk3568/battery/”为文件夹路径，“profile”为创建的文件夹名字，“battery_config”为编译目标。
90
916. 参考《[快速入门](../quick-start/quickstart-overview.md)》编译定制版本，编译命令如下：
92
93    ```shell
94    ./build.sh --product-name rk3568 --ccache
95    ```
96
977. 将定制版本烧录到DAYU200开发板中。
98
99### 调测验证
100
1011. 开机后，进入shell命令行。
102    ```
103    hdc shell
104    ```
105
1062. 进入电源温度的节点路径（以当前DAYU开发版路径为例）。
107    ```
108    cd /data/service/el0/battery/battery
109    ```
110
1113. 以默认的电源温度保护配置数据为例，修改电池温度的模拟节点数值。
112
113    ```
114    echo 700 > temp
115    ```
1164. 上报电池信息改变，触发温度保护。
117    ```
118    hidumper -s 3302 -a -r
119    ```
120    设备进入关机状态
121
1225. 重新开机进入shell命令行,进入电源温度的节点路径。
123    ```
124    echo -600 > temp
125    ```
1266. 上报电池信息改变，触发温度保护。
127    ```
128    hidumper -s 3302 -a -r
129    ```
130    设备进入关机状态
131
1327. 以新的电源温度保护配置数据为例，更改之后：
133
134    ```json
135    {
136        "temperature": {
137        "high": 500,
138        "low": -400
139        }
140    }
141    ```
142
1438. 修改电池温度的模拟节点数值。
144    ```
145    echo 550 > temp
146    ```
147
1489. 上报电池信息改变，触发温度保护。
149    ```
150    hidumper -s 3302 -a -r
151    ```
152    设备进入关机状态
153
15410. 重新开机进入shell命令行,进入电源温度的节点路径。
155    ```
156    echo -450 > temp
157    ```
158
15911. 上报电池信息改变，触发温度保护。
160    ```
161    hidumper -s 3302 -a -r
162    ```
163    设备进入关机状态
164
165## 参考
166开发过程中可参考的配置文件路径：[系统默认电源温度保护范围配置源码路径](https://gitee.com/openharmony/powermgr_battery_manager/tree/master/services/native/profile/)
167
168默认配置：
169```json
170{
171    "temperature": {
172    "high": 600,
173    "low": -500
174    }
175}
176```
177打包路径：/system/etc/battery
178
179