diff options
-rw-r--r-- | AUTHORS | 1 | ||||
-rwxr-xr-x | CMakeLists.txt | 90 | ||||
-rwxr-xr-x | LICENSE | 206 | ||||
-rw-r--r-- | capi-system-device.pc.in | 15 | ||||
-rw-r--r-- | debian/README | 0 | ||||
-rw-r--r-- | debian/capi-system-device-dev.install | 4 | ||||
-rw-r--r-- | debian/capi-system-device-dev.postinst | 1 | ||||
-rw-r--r-- | debian/capi-system-device.install | 1 | ||||
-rw-r--r-- | debian/capi-system-device.postinst | 1 | ||||
-rw-r--r-- | debian/changelog | 13 | ||||
-rw-r--r-- | debian/compat | 1 | ||||
-rw-r--r-- | debian/control | 22 | ||||
-rwxr-xr-x | debian/rules | 65 | ||||
-rw-r--r-- | include/device.h | 216 | ||||
-rw-r--r-- | packaging/capi-system-device.spec | 53 | ||||
-rw-r--r-- | src/device.c | 236 |
16 files changed, 925 insertions, 0 deletions
@@ -0,0 +1 @@ +Pius Lee <pius.lee@samsung.com> diff --git a/CMakeLists.txt b/CMakeLists.txt new file mode 100755 index 0000000..b1e0673 --- /dev/null +++ b/CMakeLists.txt @@ -0,0 +1,90 @@ + +CMAKE_MINIMUM_REQUIRED(VERSION 2.6) +SET(fw_name "capi-system-device") + +PROJECT(${fw_name}) + +SET(CMAKE_INSTALL_PREFIX /usr) +SET(PREFIX ${CMAKE_INSTALL_PREFIX}) + +SET(INC_DIR include) +INCLUDE_DIRECTORIES(${INC_DIR}) + +SET(dependents "devman dlog vconf") + +INCLUDE(FindPkgConfig) +pkg_check_modules(${fw_name} REQUIRED ${dependents}) +FOREACH(flag ${${fw_name}_CFLAGS}) + SET(EXTRA_CFLAGS "${EXTRA_CFLAGS} ${flag}") +ENDFOREACH(flag) + +SET(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${EXTRA_CFLAGS} -fPIC -Wall -Werror") +SET(CMAKE_C_FLAGS_DEBUG "-O0 -g") + +IF("${ARCH}" STREQUAL "arm") + ADD_DEFINITIONS("-DTARGET") +ENDIF("${ARCH}" STREQUAL "arm") + +ADD_DEFINITIONS("-DPREFIX=\"${CMAKE_INSTALL_PREFIX}\"") +ADD_DEFINITIONS("-DTIZEN_DEBUG") + +SET(CMAKE_EXE_LINKER_FLAGS "-Wl,--as-needed -Wl,--rpath=/usr/lib") + +aux_source_directory(src SOURCES) +ADD_LIBRARY(${fw_name} SHARED ${SOURCES}) + +TARGET_LINK_LIBRARIES(${fw_name} ${${fw_name}_LDFLAGS}) + +INSTALL(TARGETS ${fw_name} DESTINATION lib) +INSTALL( + DIRECTORY ${INC_DIR}/ DESTINATION include/system + FILES_MATCHING + PATTERN "*_private.h" EXCLUDE + PATTERN "${INC_DIR}/*.h" + ) + +SET(PC_NAME ${fw_name}) +SET(PC_REQUIRED ${dependents}) +SET(PC_LDFLAGS -l${fw_name}) +SET(PC_CFLAGS -I\${includedir}/system) + +CONFIGURE_FILE( + ${fw_name}.pc.in + ${CMAKE_CURRENT_SOURCE_DIR}/${fw_name}.pc + @ONLY +) +INSTALL(FILES ${CMAKE_CURRENT_SOURCE_DIR}/${fw_name}.pc DESTINATION lib/pkgconfig) + +#ADD_SUBDIRECTORY(test) + +IF(UNIX) + +ADD_CUSTOM_TARGET (distclean @echo cleaning for source distribution) +ADD_CUSTOM_COMMAND( + DEPENDS clean + COMMENT "distribution clean" + COMMAND find + ARGS . + -not -name config.cmake -and \( + -name tester.c -or + -name Testing -or + -name CMakeFiles -or + -name cmake.depends -or + -name cmake.check_depends -or + -name CMakeCache.txt -or + -name cmake.check_cache -or + -name *.cmake -or + -name Makefile -or + -name core -or + -name core.* -or + -name gmon.out -or + -name install_manifest.txt -or + -name *.pc -or + -name *~ \) + | grep -v TC | xargs rm -rf + TARGET distclean + VERBATIM +) + +ENDIF(UNIX) + @@ -0,0 +1,206 @@ +Copyright (c) 2000 - 2011 Samsung Electronics Co., Ltd. All rights reserved.
+
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ 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.
+
+
+
diff --git a/capi-system-device.pc.in b/capi-system-device.pc.in new file mode 100644 index 0000000..f758dbd --- /dev/null +++ b/capi-system-device.pc.in @@ -0,0 +1,15 @@ + +# Package Information for pkg-config + +prefix=@PREFIX@ +exec_prefix=/usr +libdir=/usr/lib +includedir=/usr/include/system + +Name: @PC_NAME@ +Description: @PACKAGE_DESCRIPTION@ +Version: @VERSION@ +Requires: @PC_REQUIRED@ +Libs: -L${libdir} @PC_LDFLAGS@ +Cflags: -I${includedir} @PC_CFLAGS@ + diff --git a/debian/README b/debian/README new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/debian/README diff --git a/debian/capi-system-device-dev.install b/debian/capi-system-device-dev.install new file mode 100644 index 0000000..761a28b --- /dev/null +++ b/debian/capi-system-device-dev.install @@ -0,0 +1,4 @@ +/usr/include/* +/usr/include/*/* +/usr/lib/pkgconfig/*.pc + diff --git a/debian/capi-system-device-dev.postinst b/debian/capi-system-device-dev.postinst new file mode 100644 index 0000000..1a24852 --- /dev/null +++ b/debian/capi-system-device-dev.postinst @@ -0,0 +1 @@ +#!/bin/sh diff --git a/debian/capi-system-device.install b/debian/capi-system-device.install new file mode 100644 index 0000000..4a755a4 --- /dev/null +++ b/debian/capi-system-device.install @@ -0,0 +1 @@ +/usr/lib/lib*.so* diff --git a/debian/capi-system-device.postinst b/debian/capi-system-device.postinst new file mode 100644 index 0000000..1a24852 --- /dev/null +++ b/debian/capi-system-device.postinst @@ -0,0 +1 @@ +#!/bin/sh diff --git a/debian/changelog b/debian/changelog new file mode 100644 index 0000000..753c8a7 --- /dev/null +++ b/debian/changelog @@ -0,0 +1,13 @@ +capi-system-device (0.1.0-5) unstable; urgency=low + + * update versioning + * Git: api/device + * Tag: capi-system-device_0.1.0-5 + + -- Pius Lee <pius.lee@samsung.com> Thu, 15 Dec 2011 13:46:58 +0900 + +capi-system-device (0.0.1-1) unstable; urgency=low + + * Initial release. + + -- Pius Lee <pius.lee@samsung.com> Wed, 07 Dec 2011 12:39:36 +0900 diff --git a/debian/compat b/debian/compat new file mode 100644 index 0000000..7ed6ff8 --- /dev/null +++ b/debian/compat @@ -0,0 +1 @@ +5 diff --git a/debian/control b/debian/control new file mode 100644 index 0000000..c0f1535 --- /dev/null +++ b/debian/control @@ -0,0 +1,22 @@ + +Source: capi-system-device +Section: libs +Priority: extra +Maintainer: pius lee <pius.lee@samsung.com> +Build-Depends: debhelper (>= 5), dlog-dev, libdevman-dev, libglib2.0-dev, capi-base-common-dev, libvconf-dev + +Package: capi-system-device +Architecture: any +Depends: ${shilbs:Depends}, ${misc:Depends} +Description: A Device library in Tizen Native API + +Package: capi-system-device-dev +Architecture: any +Depends: ${shlibs:Depends}, ${misc:Depends}, capi-system-device (= ${Source-Version}), dlog-dev, libdevman-dev, capi-base-common-dev, libvconf-dev +Description: A Device library in Tizen Native API (DEV) + +Package: capi-system-device-dbg +Architecture: any +Depends: ${shlibs:Depends}, ${misc:Depends}, capi-system-device (= ${Source-Version}) +Description: A Device library in Tizen Native API (DBG) + diff --git a/debian/rules b/debian/rules new file mode 100755 index 0000000..30e9018 --- /dev/null +++ b/debian/rules @@ -0,0 +1,65 @@ +#!/usr/bin/make -f + +CFLAGS = -Wall -g + +ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS))) + CFLAGS += -O0 +else + CFLAGS += -O2 +endif +CMAKE_ROOT_DIR ?= $(CURDIR) +CMAKE_BUILD_DIR ?= $(CURDIR)/cmake_build_tmp + +configure: configure-stamp +configure-stamp: + dh_testdir + mkdir -p $(CMAKE_BUILD_DIR) && cd $(CMAKE_BUILD_DIR) && cmake .. + touch configure-stamp + + +build: build-stamp +build-stamp: configure-stamp + dh_testdir + cd $(CMAKE_BUILD_DIR) && $(MAKE) + touch $@ + +clean: + cd $(CMAKE_ROOT_DIR) + dh_testdir + dh_testroot + rm -f build-stamp configure-stamp + rm -f `find . -name *.pc` + rm -rf $(CMAKE_BUILD_DIR) + dh_clean + +install: build + dh_testdir + dh_testroot + dh_clean -k + dh_installdirs + + cd $(CMAKE_BUILD_DIR) && $(MAKE) DESTDIR=$(CURDIR)/debian/tmp install + +binary-indep: build install + +binary-arch: build install + dh_testdir + dh_testroot + dh_installchangelogs + dh_installdocs + dh_installexamples + dh_install --sourcedir=debian/tmp + dh_installman + dh_link + dh_strip --dbg-package=capi-system-device-dbg + dh_fixperms + dh_makeshlibs + dh_installdeb + dh_shlibdeps + dh_gencontrol + dh_md5sums + dh_builddeb + +binary: binary-indep binary-arch +.PHONY: build clean binary-indep binary-arch binary install configure + diff --git a/include/device.h b/include/device.h new file mode 100644 index 0000000..a05aef1 --- /dev/null +++ b/include/device.h @@ -0,0 +1,216 @@ +/* + * Copyright (c) 2011 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_DEVICE_H__ +#define __TIZEN_SYSTEM_DEVICE_H__ + +#include <stdbool.h> +#include <tizen_error.h> + +#ifdef __cplusplus +extern "C" { +#endif + + +/** + * @addtogroup CAPI_SYSTEM_DEVICE_MODULE + * @{ + */ + +/** + * @brief Enumerations of error code for Device. + */ +typedef enum +{ + DEVICE_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */ + DEVICE_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER, /**< Invalid parameter */ + DEVICE_ERROR_OPERATION_FAILED = TIZEN_ERROR_SYSTEM_CLASS | 0x12, /**< Operation failed */ +} device_error_e; + +/** + * @} +*/ + + /** + * @addtogroup CAPI_SYSTEM_DEVICE_MODULE + * @{ + */ + +/** + * @brief Called when an battery charge percentage changed + * + * @param[out] percent The remaining battery charge percentage (0 ~ 100) + * @param[in] user_data The user data passed from the callback registration function + * + */ +typedef void (*device_battery_cb)(int percent, void *user_data); + +/** + * @brief Gets the battery charge percentage. + * @details It returns integer value from 0 to 100 that indicates remaining battery charge + * as a percentage of the maximum level. + * @remarks In order to be notified when the battery state changes, use system_info_set_changed_cb(). + * + * @param[out] percent The remaining battery charge percentage (0 ~ 100) + * + * @return 0 on success, otherwise a negative error value. + * @retval #DEVICE_ERROR_NONE Successful + * @retval #DEVICE_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #DEVICE_ERROR_OPERATION_FAILED Operation failed + * + * @see device_battery_is_full() + * @see system_info_get_value_int(SYSTEM_INFO_KEY_BATTERY_PERCENTAGE, ...) + * @see system_info_get_value_int(SYSTEM_INFO_KEY_BATTERY_CHARGE, ...) + */ +int device_battery_get_percent(int *percent); + +/** + * @brief Get charging state + * + * @param[out] charging The battery charging state. + * + * @return 0 on success, otherwise a negative error value. + * @retval #DEVICE_ERROR_NONE Successful + * @retval #DEVICE_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #DEVICE_ERROR_OPERATION_FAILED Operation failed + * + */ +int device_battery_is_charging(bool *charging); + +/** + * @brief Set callback to be observing battery charge percentage. + * + * @param[in] callback The callback function to set + * @param[in] user_data The user data to be passed to the callback function + * + * @return 0 on success, otherwise a negative error value. + * @retval #DEVICE_ERROR_NONE Successful + * @retval #DEVICE_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #DEVICE_ERROR_OPERATION_FAILED Operation failed + */ +int device_battery_set_cb(device_battery_cb callback, void* user_data); + +/** + * @brief Unset battery charge percentage callback function. + * + * @return 0 on success, otherwise a negative error value. + * @retval #DEVICE_ERROR_NONE Successful + * @retval #DEVICE_ERROR_OPERATION_FAILED Operation failed + */ +int device_battery_unset_cb(void); + +/** + * @brief Checks whether the battery is fully charged. + * @remarks In order to be notified when the battery state changes, use system_info_set_changed_cb(). + * + * @param[out] full @c true when the battery is fully charged, otherwise @c false. + * + * @return 0 on success, otherwise a negative error value. + * @retval #DEVICE_ERROR_NONE Successful + * @retval #DEVICE_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #DEVICE_ERROR_OPERATION_FAILED Operation failed + * + * @see device_battery_get_percent() + * @see system_info_set_changed_cb() + * @see system_info_get_value_int(SYSTEM_INFO_KEY_BATTERY_PERCENTAGE, ...) + * @see system_info_get_value_int(SYSTEM_INFO_KEY_BATTERY_CHARGE, ...) + */ +int device_battery_is_full(bool *full); + +/** + * @brief Gets the number of display devices. + * + * @return The number of display devices that the device provides. + * @retval #DEVICE_ERROR_NONE Successful + * @retval #DEVICE_ERROR_INVALID_PARAMETER Invalid parameter + * + * @see device_get_brightness() + * @see device_set_brightness() + * @see device_get_max_brightness() + */ +int device_get_display_numbers(int* device_number); + +/** + * @brief Gets the display brightness value. + * + * @param[in] display_index The index of the display, it be greater than or equal to 0 and less than \n + * the number of displays returned by device_get_display_numbers().\n + * The index zero is always assigned to the main display. + * @param[out] brightness The current brightness value of the display + * + * @return 0 on success, otherwise a negative error value. + * @retval #DEVICE_ERROR_NONE Successful + * @retval #DEVICE_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #DEVICE_ERROR_OPERATION_FAILED Operation failed + * + * @see device_get_display_numbers() + * @see device_set_brightness() + * @see device_get_max_brightness() + */ +int device_get_brightness(int display_index, int *brightness); + +/** + * @brief Sets the display brightness value. + * + * @param[in] display_index The index of the display, it be greater than or equal to 0 and less than \n + * the number of displays returned by device_get_display_numbers().\n + * The index zero is always assigned to the main display. + * @param[in] brightness The new brightness value to set \n + * The maximum value can be represented by device_get_max_brightness() + * + * @return 0 on success, otherwise a negative error value. + * @retval #DEVICE_ERROR_NONE Successful + * @retval #DEVICE_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #DEVICE_ERROR_OPERATION_FAILED Operation failed + * + * @see device_get_display_numbers() + * @see device_get_max_brightness() + * @see device_get_brightness() + */ +int device_set_brightness(int display_index, int brightness); + +/** + * @brief Gets the maximum brightness value that can be set. + * + * @param[in] display_index The index of the display, it be greater than or equal to 0 and less than \n + * the number of displays returned by device_get_display_numbers().\n + * The index zero is always assigned to the main display. + * @param[out] max_brightness The maximum brightness value of the display + * + * @return 0 on success, otherwise a negative error value. + * @retval #DEVICE_ERROR_NONE Successful + * @retval #DEVICE_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #DEVICE_ERROR_OPERATION_FAILED Operation failed + * + * @see device_get_display_numbers() + * @see device_set_brightness() + * @see device_get_brightness() + */ +int device_get_max_brightness(int display_index, int *max_brightness); + +/** + * @} + */ + +#ifdef __cplusplus +} +#endif + +#endif // __TIZEN_SYSTEM_DEVICE_H__ + diff --git a/packaging/capi-system-device.spec b/packaging/capi-system-device.spec new file mode 100644 index 0000000..b6645e5 --- /dev/null +++ b/packaging/capi-system-device.spec @@ -0,0 +1,53 @@ +Name: capi-system-device +Summary: A Device library in TIZEN C API +Version: 0.0.1 +Release: 1 +Group: TO_BE/FILLED_IN +License: TO BE FILLED IN +Source0: %{name}-%{version}.tar.gz +BuildRequires: cmake +BuildRequires: pkgconfig(glib-2.0) +BuildRequires: pkgconfig(devman) +BuildRequires: pkgconfig(capi-base-common) +Requires(post): /sbin/ldconfig +Requires(postun): /sbin/ldconfig + +%description + + +%package devel +Summary: A Device library in TIZEN C API (Development) +Group: TO_BE/FILLED_IN +Requires: %{name} = %{version}-%{release} + +%description devel + + + +%prep +%setup -q + + +%build +cmake . -DCMAKE_INSTALL_PREFIX=/usr + + +make %{?jobs:-j%jobs} + +%install +rm -rf %{buildroot} +%make_install + +%post -p /sbin/ldconfig + +%postun -p /sbin/ldconfig + + +%files +%{_libdir}/libcapi-system-device.so + +%files devel +%{_includedir}/system/device.h +%{_libdir}/pkgconfig/*.pc + + diff --git a/src/device.c b/src/device.c new file mode 100644 index 0000000..2dc5951 --- /dev/null +++ b/src/device.c @@ -0,0 +1,236 @@ +/* + * Copyright (c) 2011 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. + */ + + + +#define LOG_TAG "TIZEN_SYSTEM_DEVICE" + +#include <string.h> +#include <stdio.h> +#include <devman.h> +#include <device.h> +#include <errno.h> +#include <dlog.h> +#include <vconf.h> + +#define _MSG_DEVICE_ERROR_INVALID_PARAMETER "Invalid parameter" +#define _MSG_DEVICE_ERROR_OPERATION_FAILED "Operation failed" + +#define RETURN_ERR_MSG(err_code, msg) \ + do { \ + LOGE("[%s] "_MSG_##err_code"(0x%08x) : %s", __FUNCTION__, err_code, msg); \ + return err_code; \ + }while(0) + +#define RETURN_ERR(err_code) \ + do { \ + LOGE("[%s] "_MSG_##err_code"(0x%08x)", __FUNCTION__, err_code); \ + return err_code; \ + }while(0) + +static int _display[] = { + DEV_DISPLAY_0, + DEV_DISPLAY_1, +}; + +int device_get_display_numbers(int* device_number) +{ + if(device_number == NULL) + RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + + *device_number = device_get_display_count(); + if(*device_number < 0) + RETURN_ERR(DEVICE_ERROR_OPERATION_FAILED); + + return DEVICE_ERROR_NONE; +} + +int device_battery_get_percent( int* percent ) +{ + if (percent == NULL) RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + + int pct = device_get_battery_pct(); + if(pct < 0) { + RETURN_ERR(DEVICE_ERROR_OPERATION_FAILED); + }else{ + *percent = pct; + } + return DEVICE_ERROR_NONE; +} + +int device_battery_is_full( bool* full ) +{ + if (full == NULL) RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + + int f = device_get_battery_pct(); + if(f < 0) { + RETURN_ERR(DEVICE_ERROR_OPERATION_FAILED); + } + else + *full = f == 100 ? true : false; + + return DEVICE_ERROR_NONE; +} + +int device_get_brightness(int disp_idx, int* value) +{ + int val, disp, max_id; + + if(value == NULL) RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + + if(device_get_display_numbers(&max_id) < 0) + RETURN_ERR(DEVICE_ERROR_OPERATION_FAILED); + + if(disp_idx < 0 || disp_idx >= max_id) + RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + + disp = _display[disp_idx]; + + if(value == NULL) + RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + + val = device_get_display_brt(disp); + + if(val < 0) { + RETURN_ERR(DEVICE_ERROR_OPERATION_FAILED); + } + else + *value = val; + + return DEVICE_ERROR_NONE; +} + +int device_set_brightness(int disp_idx, int new_value) +{ + int max_value, val; + int disp, max_id; + + if(device_get_display_numbers(&max_id) < 0) + RETURN_ERR(DEVICE_ERROR_OPERATION_FAILED); + + if(disp_idx < 0 || disp_idx >= max_id) + RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + + disp = _display[disp_idx]; + + if(new_value < 0) + RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + + device_get_max_brightness(disp, &max_value); + + if(new_value > max_value) + RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + + val = device_set_display_brt(disp, new_value); + if(val < 0) { + RETURN_ERR(DEVICE_ERROR_OPERATION_FAILED); + } + return DEVICE_ERROR_NONE; +} + +int device_get_max_brightness(int disp_idx, int* max_value) +{ + int val, disp, max_id; + + if(device_get_display_numbers(&max_id) < 0) + RETURN_ERR(DEVICE_ERROR_OPERATION_FAILED); + + if(disp_idx < 0 || disp_idx >= max_id) + RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + + disp = _display[disp_idx]; + + if(max_value == NULL) + RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + + val = device_get_max_brt(disp); + + if(val < 0) { + RETURN_ERR(DEVICE_ERROR_OPERATION_FAILED); + } + else + *max_value = val; + + return DEVICE_ERROR_NONE; +} + +int device_battery_is_charging(bool *charging) +{ + // VCONFKEY_SYSMAN_BATTERY_CHARGE_NOW + int value, err; + + if(charging == NULL){ + RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + } + + err = vconf_get_int(VCONFKEY_SYSMAN_BATTERY_CHARGE_NOW, &value); + + if(err <0){ + RETURN_ERR(DEVICE_ERROR_OPERATION_FAILED); + } + if(value == 1){ + *charging = true; + }else if(value == 0){ + *charging = false; + }else{ + RETURN_ERR(DEVICE_ERROR_OPERATION_FAILED); + } + return DEVICE_ERROR_NONE; +} + +static device_battery_cb changed_callback = NULL; +static void* changed_callback_user_data = NULL; + +static void battery_changed_inside_cb(keynode_t* key, void* user_data) +{ + char* keyname = vconf_keynode_get_name(key); + + if(keyname != NULL && changed_callback != NULL && strcmp(keyname, VCONFKEY_SYSMAN_BATTERY_CAPACITY) == 0){ + int percent = 0; + if(vconf_get_int(VCONFKEY_SYSMAN_BATTERY_CAPACITY, &percent) == 0){ + changed_callback(percent, changed_callback_user_data); + } + } +} + +int device_battery_set_cb(device_battery_cb callback, void* user_data) +{ + // VCONFKEY_SYSMAN_BATTERY_CAPACITY + int err; + if(callback == NULL) + RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + + changed_callback = callback; + changed_callback_user_data = user_data; + + err = vconf_notify_key_changed(VCONFKEY_SYSMAN_BATTERY_CAPACITY, battery_changed_inside_cb, NULL); + if(err < 0){ + RETURN_ERR(DEVICE_ERROR_INVALID_PARAMETER); + } + + return DEVICE_ERROR_NONE; +} +int device_battery_unset_cb(void) +{ + int err = vconf_ignore_key_changed(VCONFKEY_SYSMAN_BATTERY_CAPACITY, battery_changed_inside_cb); + if(err < 0){ + RETURN_ERR(DEVICE_ERROR_OPERATION_FAILED); + } + changed_callback = NULL; + changed_callback_user_data = NULL; + + return DEVICE_ERROR_NONE; +} |