From: Kichan Kwon Date: Tue, 3 Sep 2019 01:58:25 +0000 (+0900) Subject: Change the category of API reference X-Git-Tag: submit/tizen/20190919.020747~12 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=7d4bec5f746aa96fd4bef47af35f523ba120f920;p=platform%2Fcore%2Fapi%2Fbatterymonitor.git Change the category of API reference - System - Battery - Battery Monitor - This doc header file also define System - Battery category Change-Id: I3f1198241b123792d00228857856042f5966b12c Signed-off-by: Kichan Kwon --- diff --git a/doc/battery_doc.h b/doc/battery_doc.h new file mode 100755 index 0000000..a8a0740 --- /dev/null +++ b/doc/battery_doc.h @@ -0,0 +1,73 @@ +/* + * Copyright (c) 2019 Samsung Electronics Co., Ltd All Rights Reserved + * + * 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. + */ + +#ifndef __TIZEN_SYSTEM_BATTERY_DOC_H__ +#define __TIZEN_SYSTEM_BATTERY_DOC_H__ + +/** + * @ingroup CAPI_SYSTEM_FRAMEWORK + * @defgroup CAPI_SYSTEM_BATTERY_MODULE Battery + * + * @brief The Battery API provides functions to get status of battery. + * + */ + +/** + * @ingroup CAPI_SYSTEM_BATTERY_MODULE + * @defgroup CAPI_SYSTEM_BATTERY_BATTERY_MONITOR_MODULE Battery Monitor + * + * @brief The API's provide per resource battery consumption by the application. + * + * @section CAPI_SYSTEM_BATTERY_BATTERY_MONITOR_MODULE_HEADER Required Header + * \#include + * + * @section CAPI_SYSTEM_BATTERY_BATTERY_MONITOR_MODULE_OVERVIEW Overview + * Battery consumption by a device does not only comprises power consumed by CPU, + * but it also includes power consumed by other components like - WiFi, Bt, Display, Mobile radio etc. + * The user is normally unaware of power consumed by these components & hence when battery drains out, + * user treats it as abnormal behaviour of device. + * + * Under these circumstances, user takes immediate action like killing all power hungry applications, + * use minimal display brightness, enable night mode in day time, shutting down some sensors, disabling + * background data for applications to restrict power usage & in the worst case - uninstall the application. + * + * User's decision making at such time is greatly influenced by the accuracy of battery consumption estimation + * and statistics provided to him. + * + * With this battery-monitor framework, power consumed by each & every application is determined along with the + * power consumed by individual resources which are used by the application at the time of running. + * + * The API's provide the following functionality: + * - battery consumption in percent for specific resource from available data. + * - battery consumption in percent for all resources used by app_id. + * - battery consumption in percent by an app-id for a specific resource. + * - total battery usage in percent by an app-id for certain time duration. + * - battery consumption in percent usage by a resource for certain time duration. + * + * @section CAPI_SYSTEM_BATTERY_BATTERY_MONITOR_MODULE_FEATURE Related Features + * The API's defined are related with the following features:\n + * - http://tizen.org/feature/battery\n + * + * It is recommended to design applications with regard to features, for reliability.\n + * + * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n + * + * More details on using features in your application can be found in the Feature List. + * + */ + +#endif /* __TIZEN_SYSTEM_BATTERY_DOC_H__ */ + diff --git a/doc/battery_monitor_doc.h b/doc/battery_monitor_doc.h deleted file mode 100755 index a237c30..0000000 --- a/doc/battery_monitor_doc.h +++ /dev/null @@ -1,65 +0,0 @@ -/* - * Copyright (c) 2019 Samsung Electronics Co., Ltd All Rights Reserved - * - * 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. - */ - -#ifndef __TIZEN_SERVICE_BATTERY_MONITOR_DOC_H__ -#define __TIZEN_SERVICE_BATTERY_MONITOR_DOC_H__ - -/** - * @ingroup CAPI_SERVICE_FRAMEWORK - * @defgroup CAPI_SERVICE_BATTERY_MONITOR_MODULE Battery Monitor - * - * @brief The API's provide per resource battery consumption by the application. - * - * @section CAPI_SERVICE_BATTERY_MONITOR_MODULE_HEADER Required Header - * \#include - * - * @section CAPI_SERVICE_BATTERY_MONITOR_MODULE_OVERVIEW Overview - * Battery consumption by a device does not only comprises power consumed by CPU, - * but it also includes power consumed by other components like - WiFi, Bt, Display, Mobile radio etc. - * The user is normally unaware of power consumed by these components & hence when battery drains out, - * user treats it as abnormal behaviour of device. - * - * Under these circumstances, user takes immediate action like killing all power hungry applications, - * use minimal display brightness, enable night mode in day time, shutting down some sensors, disabling - * background data for applications to restrict power usage & in the worst case - uninstall the application. - * - * User's decision making at such time is greatly influenced by the accuracy of battery consumption estimation - * and statistics provided to him. - * - * With this battery-monitor framework, power consumed by each & every application is determined along with the - * power consumed by individual resources which are used by the application at the time of running. - * - * The API's provide the following functionality: - * - battery consumption in percent for specific resource from available data. - * - battery consumption in percent for all resources used by app_id. - * - battery consumption in percent by an app-id for a specific resource. - * - total battery usage in percent by an app-id for certain time duration. - * - battery consumption in percent usage by a resource for certain time duration. - * - * @section CAPI_SERVICE_BATTERY_MONITOR_MODULE_FEATURE Related Features - * The API's defined are related with the following features:\n - * - http://tizen.org/feature/battery\n - * - * It is recommended to design applications with regard to features, for reliability.\n - * - * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n - * - * More details on using features in your application can be found in the Feature List. - * - */ - -#endif /* __TIZEN_SERVICE_BATTERY_MONITOR_DOC_H__ */ - diff --git a/include/battery_monitor.h b/include/battery_monitor.h index 8ff32c6..fca285c 100644 --- a/include/battery_monitor.h +++ b/include/battery_monitor.h @@ -15,8 +15,8 @@ * */ -#ifndef __TIZEN_SERVICE_BATTERY_MONITOR_H__ -#define __TIZEN_SERVICE_BATTERY_MONITOR_H__ +#ifndef __TIZEN_SYSTEM_BATTERY_MONITOR_H__ +#define __TIZEN_SYSTEM_BATTERY_MONITOR_H__ #include @@ -242,4 +242,4 @@ int battery_monitor_get_total_usage_by_resource_id(battery_monitor_resource_id_e } #endif -#endif /* __TIZEN_SERVICE_BATTERY_MONITOR_H__ */ +#endif /* __TIZEN_SYSTEM_BATTERY_MONITOR_H__ */ diff --git a/include/battery_monitor_dbg.h b/include/battery_monitor_dbg.h index 21ecc0a..a988d9c 100644 --- a/include/battery_monitor_dbg.h +++ b/include/battery_monitor_dbg.h @@ -15,8 +15,8 @@ * */ -#ifndef __TIZEN_SERVICE_BATTERY_MONITOR_DBG_H__ -#define __TIZEN_SERVICE_BATTERY_MONITOR_DBG_H__ +#ifndef __TIZEN_SYSTEM_BATTERY_MONITOR_DBG_H__ +#define __TIZEN_SYSTEM_BATTERY_MONITOR_DBG_H__ #include #include @@ -54,4 +54,4 @@ extern "C" { } #endif -#endif /* __TIZEN_SERVICE_BATTERY_MONITOR_DBG_H__ */ +#endif /* __TIZEN_SYSTEM_BATTERY_MONITOR_DBG_H__ */ diff --git a/include/battery_monitor_internal.h b/include/battery_monitor_internal.h index d8020cf..910b311 100644 --- a/include/battery_monitor_internal.h +++ b/include/battery_monitor_internal.h @@ -15,8 +15,8 @@ * */ -#ifndef __TIZEN_SERVICE_BATTERY_MONITOR_INTERNAL_H__ -#define __TIZEN_SERVICE_BATTERY_MONITOR_INTERNAL_H__ +#ifndef __TIZEN_SYSTEM_BATTERY_MONITOR_INTERNAL_H__ +#define __TIZEN_SYSTEM_BATTERY_MONITOR_INTERNAL_H__ #ifdef __cplusplus @@ -43,4 +43,4 @@ struct battery_monitor_total_consumption_s { } #endif -#endif /* __TIZEN_SERVICE_BATTERY_MONITOR_INTERNAL_H__ */ +#endif /* __TIZEN_SYSTEM_BATTERY_MONITOR_INTERNAL_H__ */ diff --git a/include/battery_monitor_util.h b/include/battery_monitor_util.h index 3161edc..e12b039 100644 --- a/include/battery_monitor_util.h +++ b/include/battery_monitor_util.h @@ -15,8 +15,8 @@ * */ -#ifndef __TIZEN_SERVICE_BATTERY_MONITOR_UTIL_H__ -#define __TIZEN_SERVICE_BATTERY_MONITOR_UTIL_H__ +#ifndef __TIZEN_SYSTEM_BATTERY_MONITOR_UTIL_H__ +#define __TIZEN_SYSTEM_BATTERY_MONITOR_UTIL_H__ #include #include @@ -146,4 +146,4 @@ void unmarshal_serialized_data(GVariant *handle, battery_monitor_h data_handle); } #endif -#endif /* __TIZEN_SERVICE_BATTERY_MONITOR_UTIL_H__ */ +#endif /* __TIZEN_SYSTEM_BATTERY_MONITOR_UTIL_H__ */