README.md
1# Lite Battery Manager<a name="EN-US_TOPIC_0000001174637973"></a>
2
3- [Introduction](#section11660541593)
4- [Directory Structure](#section19472752217)
5- [Usage](#section146636391856)
6 - [Available APIs](#section481251394)
7 - [Usage Guidelines](#section12620311012)
8
9- [Repositories Involved](#section63151229062)
10
11## Introduction<a name="section11660541593"></a>
12
13The lite battery manager provides the following functionalities:
14
151. Obtaining battery information
162. Obtaining the battery charging status and the battery state of charge \(SoC\)
173. Monitoring the battery state of health \(SoH\)
184. Controlling the battery charging indicator
19
20**Figure 1** Lite battery manager architecture<a name="fig106301571239"></a>
21
22
23
24
25## Directory Structure<a name="section19472752217"></a>
26
27```
28base/powermgr/battery_lite
29├── frameworks # Frameworks
30│ ├── include # Header files
31│ └── src # Source files
32├── interfaces # APIs
33│ ├── innerkits # Internal APIs
34│ └── kits # External APIs
35├── services # Services
36│ ├── include # Header files
37│ └── src # Source files
38```
39
40## Usage<a name="section146636391856"></a>
41
42### Available APIs<a name="section481251394"></a>
43
44The following table lists the JavaScript APIs provided by the lite battery manager.
45
46<a name="table45171237103112"></a>
47
48<table><thead align="left"><tr id="row12572123793117"><th class="cellrowborder" valign="top" width="38.71%" id="mcps1.1.3.1.1"><p id="p19572937163116"><a name="p19572937163116"></a><a name="p19572937163116"></a><strong id="b1783175664017"><a name="b1783175664017"></a><a name="b1783175664017"></a>API</strong></p>
49</th>
50<th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.3.1.2"><p id="p157213711313"><a name="p157213711313"></a><a name="p157213711313"></a><strong id="b62896374115"><a name="b62896374115"></a><a name="b62896374115"></a>Description</strong></p>
51</th>
52</tr>
53</thead>
54<tbody><tr id="row14574143723119"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p169098161437"><a name="p169098161437"></a><a name="p169098161437"></a>int32_t GetBatSoc()</p>
55</td>
56<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p105741337153115"><a name="p105741337153115"></a><a name="p105741337153115"></a>Obtains the battery SoC.</p>
57</td>
58</tr>
59<tr id="row19195203919318"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p46911925104319"><a name="p46911925104319"></a><a name="p46911925104319"></a>BatteryChargeState GetChargingStatus()</p>
60</td>
61<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p1619618397312"><a name="p1619618397312"></a><a name="p1619618397312"></a>Obtains the current battery charging status.</p>
62</td>
63</tr>
64<tr id="row9397121153216"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p1339731103216"><a name="p1339731103216"></a><a name="p1339731103216"></a>BatteryHealthState GetHealthStatus()</p>
65</td>
66<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p113972183214"><a name="p113972183214"></a><a name="p113972183214"></a>Obtains the battery SoH.</p>
67</td>
68</tr>
69<tr id="row1721311920324"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p321412915320"><a name="p321412915320"></a><a name="p321412915320"></a>BatteryPluggedType GetPluggedType()</p>
70</td>
71<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p32141298323"><a name="p32141298323"></a><a name="p32141298323"></a>Obtains the charger type.</p>
72</td>
73</tr>
74<tr id="row269082112447"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p16690202119449"><a name="p16690202119449"></a><a name="p16690202119449"></a>int32_t GetBatVoltage()</p>
75</td>
76<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p1869014214445"><a name="p1869014214445"></a><a name="p1869014214445"></a>Obtains the battery voltage.</p>
77</td>
78</tr>
79<tr id="row3654173318447"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p11654173374412"><a name="p11654173374412"></a><a name="p11654173374412"></a>bool IsBatPresent()</p>
80</td>
81<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p13654123354416"><a name="p13654123354416"></a><a name="p13654123354416"></a>Checks whether the battery is present.</p>
82</td>
83</tr>
84<tr id="row12187141584413"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p718841504418"><a name="p718841504418"></a><a name="p718841504418"></a>char* GetBatTechnology()</p>
85</td>
86<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p181881615194414"><a name="p181881615194414"></a><a name="p181881615194414"></a>Obtains the battery model.</p>
87</td>
88</tr>
89<tr id="row18381310134520"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p18838610114516"><a name="p18838610114516"></a><a name="p18838610114516"></a>int32_t GetBatTemperature()</p>
90</td>
91<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p13838121064515"><a name="p13838121064515"></a><a name="p13838121064515"></a>Obtains the battery temperature.</p>
92</td>
93</tr>
94</tbody>
95</table>
96
97
98### Usage Guidelines<a name="section12620311012"></a>
99
100The lite battery manager provides APIs for obtaining the battery SoC, battery charging status, and battery SoH.
101
102The sample code is as follows:
103
104```
105int32_t capacity = GetBatSoc();
106BatteryChargeState chargState = GetChargingStatus();
107```
108
109## Repositories Involved<a name="section63151229062"></a>
110
111[Power management subsystem](https://gitee.com/openharmony/docs/blob/master/en/readme/power-management.md)
112
113[powermgr_power_manager](https://gitee.com/openharmony/powermgr_power_manager)
114
115[powermgr_display_manager](https://gitee.com/openharmony/powermgr_display_manager)
116
117[powermgr_battery_manager](https://gitee.com/openharmony/powermgr_battery_manager)
118
119[powermgr_thermal_manager](https://gitee.com/openharmony/powermgr_thermal_manager)
120
121[powermgr_battery_statistics](https://gitee.com/openharmony/powermgr_battery_statistics)
122
123**powermgr_battery_lite**
124
125[powermgr_powermgr_lite](https://gitee.com/openharmony/powermgr_powermgr_lite)
126
README_zh.md
1# 轻量级电池管理组件<a name="ZH-CN_TOPIC_0000001174637973"></a>
2
3- [简介](#section11660541593)
4- [目录](#section19472752217)
5- [说明](#section146636391856)
6 - [接口说明](#section481251394)
7 - [使用说明](#section12620311012)
8
9- [相关仓](#section63151229062)
10
11## 简介<a name="section11660541593"></a>
12
13电池服务组件提供如下功能:
14
151. 电池信息查询。
162. 充放电状态查询。
173. 电池健康状态监测。
184. 充电指示灯控制。
19
20**图 1** 轻量级电池管理组件架构图<a name="fig106301571239"></a>
21
22
23
24
25## 目录<a name="section19472752217"></a>
26
27```
28base/powermgr/battery_lite
29├── frameworks # Framework层
30│ ├── include # Framework层头文件
31│ └── src # Framework层源文件
32├── interfaces # 接口层
33│ ├── innerkits # 内部接口层
34│ └── kits # 外部接口层
35└── services # 服务层
36 ├── include # 服务层头文件
37 └── src # 服务层源文件
38```
39
40## 说明<a name="section146636391856"></a>
41
42### 接口说明<a name="section481251394"></a>
43
44轻量电池管理组件对外提供的接口,如下表:
45
46<a name="table45171237103112"></a>
47<table><thead align="left"><tr id="row12572123793117"><th class="cellrowborder" valign="top" width="38.71%" id="mcps1.1.3.1.1"><p id="p19572937163116"><a name="p19572937163116"></a><a name="p19572937163116"></a><strong id="b18552135014316"><a name="b18552135014316"></a><a name="b18552135014316"></a>接口名</strong></p>
48</th>
49<th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.3.1.2"><p id="p157213711313"><a name="p157213711313"></a><a name="p157213711313"></a><strong id="b193891558123118"><a name="b193891558123118"></a><a name="b193891558123118"></a>描述</strong></p>
50</th>
51</tr>
52</thead>
53<tbody><tr id="row14574143723119"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p169098161437"><a name="p169098161437"></a><a name="p169098161437"></a>int32_t GetBatSoc()</p>
54</td>
55<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p105741337153115"><a name="p105741337153115"></a><a name="p105741337153115"></a>获取电池剩余电量(SOC)。</p>
56</td>
57</tr>
58<tr id="row19195203919318"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p46911925104319"><a name="p46911925104319"></a><a name="p46911925104319"></a>BatteryChargeState GetChargingStatus()</p>
59</td>
60<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p1619618397312"><a name="p1619618397312"></a><a name="p1619618397312"></a>获取当前充电状态。</p>
61</td>
62</tr>
63<tr id="row9397121153216"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p1339731103216"><a name="p1339731103216"></a><a name="p1339731103216"></a>BatteryHealthState GetHealthStatus()</p>
64</td>
65<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p113972183214"><a name="p113972183214"></a><a name="p113972183214"></a>获取电池健康状态。</p>
66</td>
67</tr>
68<tr id="row1721311920324"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p321412915320"><a name="p321412915320"></a><a name="p321412915320"></a>BatteryPluggedType GetPluggedType()</p>
69</td>
70<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p32141298323"><a name="p32141298323"></a><a name="p32141298323"></a>获取当前连接的充电器类型。</p>
71</td>
72</tr>
73<tr id="row269082112447"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p16690202119449"><a name="p16690202119449"></a><a name="p16690202119449"></a>int32_t GetBatVoltage()</p>
74</td>
75<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p1869014214445"><a name="p1869014214445"></a><a name="p1869014214445"></a>获取电池电压。</p>
76</td>
77</tr>
78<tr id="row3654173318447"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p11654173374412"><a name="p11654173374412"></a><a name="p11654173374412"></a>bool IsBatPresent()</p>
79</td>
80<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p13654123354416"><a name="p13654123354416"></a><a name="p13654123354416"></a>检查电池是否在位。</p>
81</td>
82</tr>
83<tr id="row12187141584413"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p718841504418"><a name="p718841504418"></a><a name="p718841504418"></a>char* GetBatTechnology()</p>
84</td>
85<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p181881615194414"><a name="p181881615194414"></a><a name="p181881615194414"></a>获取电池类型。</p>
86</td>
87</tr>
88<tr id="row18381310134520"><td class="cellrowborder" valign="top" width="38.71%" headers="mcps1.1.3.1.1 "><p id="p18838610114516"><a name="p18838610114516"></a><a name="p18838610114516"></a>int32_t GetBatTemperature()</p>
89</td>
90<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.3.1.2 "><p id="p13838121064515"><a name="p13838121064515"></a><a name="p13838121064515"></a>获取电池温度。</p>
91</td>
92</tr>
93</tbody>
94</table>
95
96### 使用说明<a name="section12620311012"></a>
97
98电池管理组件提供了获取电池剩余电量、充电状态、电池健康状态等接口。
99
100代码示例如下:
101
102```
103int32_t capacity = GetBatSoc();
104BatteryChargeState chargState = GetChargingStatus();
105```
106
107## 相关仓<a name="section63151229062"></a>
108
109[电源管理子系统](https://gitee.com/openharmony/docs/blob/master/zh-cn/readme/%E7%94%B5%E6%BA%90%E7%AE%A1%E7%90%86%E5%AD%90%E7%B3%BB%E7%BB%9F.md)
110
111[powermgr_power_manager](https://gitee.com/openharmony/powermgr_power_manager)
112
113[powermgr_display_manager](https://gitee.com/openharmony/powermgr_display_manager)
114
115[powermgr_battery_manager](https://gitee.com/openharmony/powermgr_battery_manager)
116
117[powermgr_thermal_manager](https://gitee.com/openharmony/powermgr_thermal_manager)
118
119[powermgr_battery_statistics](https://gitee.com/openharmony/powermgr_battery_statistics)
120
121**powermgr_battery_lite**
122
123[powermgr_powermgr_lite](https://gitee.com/openharmony/powermgr_powermgr_lite)
124