feat: add c-api of battery info module

Signed-off-by: z30053694 <zhangchen190@huawei.com>
Change-Id: Id7af7ce9818f3bd7f831e10a7f600448b2987f2d

fix: formatted

Signed-off-by: z30053694 <zhangchen190@huawei.com>
Change-Id: Ifcb1d125ed455ed9a81a4a107c0d9d60ce676731

fix: changed @since to version 13 and fix typos

Signed-off-by: z30053694 <zhangchen190@huawei.com>
Change-Id: I2d6edf8ed5c0fa9bfb0b177ee7f1665c9121c2c9

fix: changed version to 13 and fix typos

Signed-off-by: z30053694 <zhangchen190@huawei.com>
Change-Id: I1546a6df07010199b20a790740364f0747a47c94

fix: added comment

Signed-off-by: z30053694 <zhangchen190@huawei.com>
Change-Id: I26f987cdd7dc69daf1c8cb27782e984fd1d3f8d6

fix: typos

Signed-off-by: z30053694 <zhangchen190@huawei.com>
Change-Id: I9b667f4de5b6bf8262ed7987d696ea5b5e4881a7

BasicServicesKit/BUILD.gn

@@ -78,6 +78,20 @@ ohos_ndk_library("libcommonevent_ndk") {
   ]
 }
 
+ohos_ndk_headers("ohbattery_info_header") {
+  dest_dir = "$ndk_headers_out_dir/BasicServicesKit/"
+  sources = [ "./ohbattery_info.h" ]
+}
+
+ohos_ndk_library("libohbattery_info_ndk") {
+  output_name = "ohbattery_info"
+  output_extension = "so"
+  ndk_description_file = "./ohbattery_info.ndk.json"
+  min_compact_version = "13"
+  system_capability = "SystemCapability.PowerManager.BatteryManager.Core"
+  system_capability_headers = [ "BasicServicesKit/ohbattery_info.h" ]
+}
+
 ohos_ndk_headers("time_service_ndk_header") {
   dest_dir = "$ndk_headers_out_dir/BasicServicesKit/"
   sources = [ "./time_service.h" ]

BasicServicesKit/ohbattery_info.h

@@ -0,0 +1,124 @@
+/*
+ * Copyright (c) 2024 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @addtogroup OH_BatteryInfo
+ * @{
+ *
+ * @brief Provides the definition of the C interface for the BatteryInfo module.
+ *
+ * @syscap SystemCapability.PowerManager.BatteryManager.Core
+ * @since 13
+ * @version 1.0
+ */
+/**
+ * @file ohbattery_info.h
+ *
+ * @brief Declares the APIs to get informations about the current battery capacity and the power source type,
+ *        defines strings that identify corresponding common events.
+ *
+ * @library libohbattery_info.so
+ * @kit BasicServicesKit
+ * @syscap SystemCapability.PowerManager.BatteryManager.Core
+ * @since 13
+ * @version 1.0
+ */
+#ifndef OHBATTERY_INFO_HEADER
+#define OHBATTERY_INFO_HEADER
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif /* __cplusplus */
+
+/**
+ * @brief A string that identifies the common event sent after battery capacity changes.
+ * @since 13
+ * @version 1.0
+ */
+static const char* COMMON_EVENT_KEY_CAPACITY = "soc";
+/**
+ * @brief A string that identifies the common event sent after charge state changes.
+ * @since 13
+ * @version 1.0
+ */
+static const char* COMMON_EVENT_KEY_CHARGE_STATE = "chargeState";
+/**
+ * @brief A string that identifies the common event sent after plugged type changes.
+ * @since 13
+ * @version 1.0
+ */
+static const char* COMMON_EVENT_KEY_PLUGGED_TYPE = "pluggedType";
+
+/**
+ * @brief Defines plugged types.
+ *
+ * @since 13
+ * @version 1.0
+ */
+typedef enum {
+    /**
+     * Power source is unplugged.
+     */
+    PLUGGED_TYPE_NONE,
+
+    /**
+     * Power source is an AC charger.
+     */
+    PLUGGED_TYPE_AC,
+
+    /**
+     * Power source is a USB DC charger.
+     */
+    PLUGGED_TYPE_USB,
+
+    /**
+     * Power source is wireless charger.
+     */
+    PLUGGED_TYPE_WIRELESS,
+
+    /**
+     * The bottom of the enum.
+     */
+    PLUGGED_TYPE_BUTT
+} BatteryInfo_BatteryPluggedType;
+
+/**
+ * @brief This API returns the current battery capacity.
+ *
+ * @return Returns number between 0 and 100.
+ * @syscap SystemCapability.PowerManager.BatteryManager.Core
+ * @since 13
+ */
+int32_t OH_BatteryInfo_GetCapacity();
+
+/**
+ * @brief This API returns the current plugged type.
+ *
+ * @return {@link BatteryInfo_BatteryPluggedType#PLUGGED_TYPE_NONE} if the power source is unplugged.
+ *         {@link PLUGGED_TYPE_AC} if the power source is an AC charger.
+ *         {@link PLUGGED_TYPE_USB} if the power source is an USB DC charger.
+ *         {@link PLUGGED_TYPE_WIRELESS} if the power source is wireless charger.
+ *         {@link PLUGGED_TYPE_BUTT} if the type is unknown.
+ * @syscap SystemCapability.PowerManager.BatteryManager.Core
+ * @since 13
+ */
+BatteryInfo_BatteryPluggedType OH_BatteryInfo_GetPluggedType();
+#ifdef __cplusplus
+}
+#endif /* __cplusplus */
+#endif /* OHBATTERY_INFO_HEADER */
+/** @} */

BasicServicesKit/ohbattery_info.ndk.json

@@ -0,0 +1,8 @@
+[
+    {   "first_introduced": "13",
+        "name":"OH_BatteryInfo_GetCapacity"
+    },
+    {   "first_introduced": "13",
+        "name":"OH_BatteryInfo_GetPluggedType"
+    }
+]