diff options
author | HyungKyu Song <hk76.song@samsung.com> | 2013-02-16 00:10:16 +0900 |
---|---|---|
committer | HyungKyu Song <hk76.song@samsung.com> | 2013-02-16 00:10:16 +0900 |
commit | 2bff1219492ef00b64df3a6f867f95d8efcc3ccf (patch) | |
tree | cbebe3a37642393b300e551ccb343febbb62b358 | |
parent | f7d3bd8b3884553bbe42d6ece32974d3e26281ee (diff) | |
download | audio-io-tizen_2.0.tar.gz audio-io-tizen_2.0.tar.bz2 audio-io-tizen_2.0.zip |
-rw-r--r-- | AUTHORS | 3 | ||||
-rwxr-xr-x | CMakeLists.txt | 105 | ||||
-rw-r--r-- | LICENSE.APLv2 | 206 | ||||
-rw-r--r-- | NOTICE | 3 | ||||
-rw-r--r-- | capi-media-audio-io.manifest | 5 | ||||
-rw-r--r-- | capi-media-audio-io.pc.in | 15 | ||||
-rw-r--r-- | include/audio_io.h | 504 | ||||
-rw-r--r-- | include/audio_io_private.h | 53 | ||||
-rw-r--r-- | packaging/capi-media-audio-io.spec | 56 | ||||
-rw-r--r-- | src/audio_io.c | 590 | ||||
-rw-r--r-- | test/CMakeLists.txt | 18 | ||||
-rwxr-xr-x | test/audio_io_test.c | 32 |
12 files changed, 1590 insertions, 0 deletions
@@ -0,0 +1,3 @@ +Kangho Hur <kanho.hur@samsung.com> +Seungkeun Lee <sngn.lee@samsung.com> +Seungbae Shin <seungbae.shin at samsung.com> diff --git a/CMakeLists.txt b/CMakeLists.txt new file mode 100755 index 0000000..b018af6 --- /dev/null +++ b/CMakeLists.txt @@ -0,0 +1,105 @@ + +CMAKE_MINIMUM_REQUIRED(VERSION 2.6) +SET(fw_name "capi-media-audio-io") + +PROJECT(${fw_name}) + +SET(CMAKE_INSTALL_PREFIX /usr) +SET(PREFIX ${CMAKE_INSTALL_PREFIX}) + +SET(INC_DIR include) +INCLUDE_DIRECTORIES(${INC_DIR}) + +SET(dependents "dlog mm-sound capi-base-common capi-media-sound-manager") +SET(pc_dependents "capi-base-common capi-media-sound-manager") + +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}) + +SET_TARGET_PROPERTIES(${fw_name} + PROPERTIES + VERSION ${FULLVER} + SOVERSION ${MAJORVER} + CLEAN_DIRECT_OUTPUT 1 +) + +TARGET_LINK_LIBRARIES(${fw_name} ${${fw_name}_LDFLAGS}) + +SET_TARGET_PROPERTIES(${fw_name} + PROPERTIES + VERSION ${FULLVER} + SOVERSION ${MAJORVER} + CLEAN_DIRECT_OUTPUT 1 +) + +INSTALL(TARGETS ${fw_name} DESTINATION lib) +INSTALL( + DIRECTORY ${INC_DIR}/ DESTINATION include/media + FILES_MATCHING + PATTERN "*_private.h" EXCLUDE + PATTERN "${INC_DIR}/*.h" + ) + +SET(PC_NAME ${fw_name}) +SET(PC_REQUIRED ${pc_dependents}) +SET(PC_LDFLAGS -l${fw_name}) +SET(PC_CFLAGS -I\${includedir}/media) + +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) + diff --git a/LICENSE.APLv2 b/LICENSE.APLv2 new file mode 100644 index 0000000..f94008a --- /dev/null +++ b/LICENSE.APLv2 @@ -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. + + + @@ -0,0 +1,3 @@ +Copyright (c) Samsung Electronics Co., Ltd. All rights reserved. +Except as noted, this software is licensed under Apache License, Version 2. +Please, see the LICENSE file for Apache License terms and conditions. diff --git a/capi-media-audio-io.manifest b/capi-media-audio-io.manifest new file mode 100644 index 0000000..a76fdba --- /dev/null +++ b/capi-media-audio-io.manifest @@ -0,0 +1,5 @@ +<manifest> + <request> + <domain name="_" /> + </request> +</manifest> diff --git a/capi-media-audio-io.pc.in b/capi-media-audio-io.pc.in new file mode 100644 index 0000000..5d02f8d --- /dev/null +++ b/capi-media-audio-io.pc.in @@ -0,0 +1,15 @@ + +# Package Information for pkg-config + +prefix=@PREFIX@ +exec_prefix=/usr +libdir=/usr/lib +includedir=/usr/include/media + +Name: @PC_NAME@ +Description: @PACKAGE_DESCRIPTION@ +Version: @VERSION@ +Requires: @PC_REQUIRED@ +Libs: -L${libdir} @PC_LDFLAGS@ +Cflags: -I${includedir} + diff --git a/include/audio_io.h b/include/audio_io.h new file mode 100644 index 0000000..b8c415c --- /dev/null +++ b/include/audio_io.h @@ -0,0 +1,504 @@ +/* +* 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_MEDIA_AUDIO_IO_H__ +#define __TIZEN_MEDIA_AUDIO_IO_H__ + +#include <tizen.h> +#include <sound_manager.h> + +#ifdef __cplusplus +extern "C" +{ +#endif + +#define AUDIO_IO_ERROR_CLASS TIZEN_ERROR_MULTIMEDIA_CLASS | 0x40 + +/** + * @file audio_io.h + * @brief This file contains the Audio Input and Output API. + */ + +/** + * @addtogroup CAPI_MEDIA_AUDIO_IN_MODULE + * @{ +*/ + +/** + * @brief Audio input handle type. + */ +typedef struct audio_in_s *audio_in_h; + +/** + * @} +*/ + +/** + * @addtogroup CAPI_MEDIA_AUDIO_OUT_MODULE + * @{ + */ + +/** + * @brief Audio output handle type. + */ +typedef struct audio_out_s *audio_out_h; + + /** + * @} + */ + +/** + * @addtogroup CAPI_MEDIA_AUDIO_IO_MODULE + * @{ + */ + +/** + * @brief Enumerations of audio sample type with bit depth + */ +typedef enum +{ + AUDIO_SAMPLE_TYPE_U8 = 0x70, /**< Unsigned 8-bit audio samples */ + AUDIO_SAMPLE_TYPE_S16_LE, /**< Signed 16-bit audio samples */ +} audio_sample_type_e; + +/** + * @brief Enumerations of audio channel + */ +typedef enum { + AUDIO_CHANNEL_MONO = 0x80, /**< 1 channel, mono */ + AUDIO_CHANNEL_STEREO, /**< 2 channel, stereo */ +} audio_channel_e; + +/** + * @brief Enumerations of audio input and output error code + */ +typedef enum{ + AUDIO_IO_ERROR_NONE = TIZEN_ERROR_NONE, /**<Successful */ + AUDIO_IO_ERROR_OUT_OF_MEMORY = TIZEN_ERROR_OUT_OF_MEMORY, /**< Out of memory */ + AUDIO_IO_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER, /**< Invalid parameter */ + AUDIO_IO_ERROR_INVALID_OPERATION = TIZEN_ERROR_INVALID_OPERATION, /**< Invalid operation */ + AUDIO_IO_ERROR_DEVICE_NOT_OPENED = AUDIO_IO_ERROR_CLASS | 0x01, /**< Device open error */ + AUDIO_IO_ERROR_DEVICE_NOT_CLOSED = AUDIO_IO_ERROR_CLASS | 0x02, /**< Device close error */ + AUDIO_IO_ERROR_INVALID_BUFFER = AUDIO_IO_ERROR_CLASS | 0x03, /**< Invalid buffer pointer */ + AUDIO_IO_ERROR_SOUND_POLICY = AUDIO_IO_ERROR_CLASS | 0x04, /**< Sound policy error */ +} audio_io_error_e; + +/** + * @brief Enumerations of audio io interrupted type + */ +typedef enum +{ + AUDIO_IO_INTERRUPTED_COMPLETED = 0, /**< Interrupt completed*/ + AUDIO_IO_INTERRUPTED_BY_MEDIA, /**< Interrupted by non-resumable media application*/ + AUDIO_IO_INTERRUPTED_BY_CALL, /**< Interrupted by incoming call*/ + AUDIO_IO_INTERRUPTED_BY_EARJACK_UNPLUG, /**< Interrupted by unplugging headphone*/ + AUDIO_IO_INTERRUPTED_BY_RESOURCE_CONFLICT, /**< Interrupted by resource conflict*/ + AUDIO_IO_INTERRUPTED_BY_ALARM, /**< Interrupted by alarm*/ + AUDIO_IO_INTERRUPTED_BY_EMERGENCY, /**< Interrupted by emergency*/ + AUDIO_IO_INTERRUPTED_BY_RESUMABLE_MEDIA, /**< Interrupted by resumable media application*/ +} audio_io_interrupted_code_e; + +/** + * @brief Called when the audio input or output is interrupted. + * @param[in] error_code The interrupted error code + * @param[in] user_data The user data passed from the callback registration function + * @see audio_in_set_interrupted_cb() + * @see audio_out_set_interrupted_cb() + * @see audio_in_unset_interrupted_cb() + * @see audio_out_unset_interrupted_cb() + */ +typedef void (*audio_io_interrupted_cb)(audio_io_interrupted_code_e code, void *user_data); + +/** + * @} +*/ + +/** + * @addtogroup CAPI_MEDIA_AUDIO_IN_MODULE + * @{ +*/ + + +// +//AUDIO INPUT +// + + +/** + * @brief Creates an audio device instance and returns an input handle to record PCM (pulse-code modulation) data + * @details This function is used for audio input initialization. + * + * @remarks @a input must be release audio_in_destroy() by you. + * + * @param[in] sample_rate The audio sample rate in 8000[Hz] ~ 48000[Hz] + * @param[in] channel The audio channel type, mono, or stereo + * @param[in] type The type of audio sample (8- or 16-bit) + * @param[out] input An audio input handle will be created, if successful + * + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #AUDIO_IO_ERROR_OUT_OF_MEMORY Out of memory + * @retval #AUDIO_IO_ERROR_DEVICE_NOT_OPENED Device not opened + * @retval #AUDIO_IO_ERROR_SOUND_POLICY Sound policy error + * @see audio_in_destroy() + */ +int audio_in_create(int sample_rate, audio_channel_e channel, audio_sample_type_e type , audio_in_h *input); + + + +/** + * @brief Releases the audio input handle and all its resources associated with an audio stream + * + * @param[in] input The handle to the audio input to destroy + * + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #AUDIO_IO_ERROR_DEVICE_NOT_CLOSED Device not closed + * @see audio_in_create() + */ +int audio_in_destroy(audio_in_h input); + + + +/** + * @brief Prepare reading audio in by starting buffering the audio data from the device + * @param[in] input The handle to the audio input + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @see audio_in_unprepare() + */ +int audio_in_prepare(audio_in_h input); + + + +/** + * @brief Unprepare reading audio in by stopping buffering the audio data from the device + * @param[in] input The handle to the audio input + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @see audio_in_prepare() + */ +int audio_in_unprepare(audio_in_h input); + + + +/** + * @brief Reads audio data from the audio input buffer + * + * @param[in] input The handle to the audio input + * @param[out] buffer The PCM buffer address + * @param[in] length The length of PCM data buffer (in bytes) + * + * @return Number of read bytes on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #AUDIO_IO_ERROR_INVALID_BUFFER Invalid buffer pointer + * @retval #AUDIO_IO_ERROR_SOUND_POLICY Sound policy error + * @retval #AUDIO_IO_ERROR_INVALID_OPERATION Invalid operation + * @pre audio_in_start_recording() +*/ +int audio_in_read(audio_in_h input, void *buffer, unsigned int length); + + + +/** + * @brief Gets the size to be allocated for audio input buffer + * @param[in] input The handle to the audio input + * @param[out] size The buffer size (in bytes). \n The maximum size is 1 MB. + * + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @see audio_in_read() +*/ +int audio_in_get_buffer_size(audio_in_h input, int *size); + + + +/** + * @brief Gets the sample rate of the audio input data stream + * + * @param[in] input The handle to the audio input + * @param[out] sample_rate The audio sample rate in Hertz (8000 ~ 48000) + * + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter +*/ +int audio_in_get_sample_rate(audio_in_h input, int *sample_rate); + + + +/** + * @brief Gets the channel type of audio input data stream + * + * @details The audio channel type defines whether the audio is mono or stereo. + * + * @param[in] input The handle to the audio input + * @param[out] channel The audio channel type + * + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter +*/ +int audio_in_get_channel(audio_in_h input, audio_channel_e *channel); + + + +/** + * @brief Gets the sample audio format (8-bit or 16-bit) of audio input data stream + * + * @param[in] input The handle to the audio input + * @param[out] type The audio sample type + * + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter +*/ +int audio_in_get_sample_type(audio_in_h input, audio_sample_type_e *type); + + +/** + * @brief Registers a callback function to be invoked when the audio input handle is interrupted or interrupt completed. + * @param[in] input The handle to the audio input + * @param[in] callback The callback function to register + * @param[in] user_data The user data to be passed to the callback function + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #AUDIO_IO_ERROR_INVALID_OPERATION Invalid operation + * @post audio_io_interrupted_cb() will be invoked + * @see audio_in_unset_interrupted_cb() + * @see audio_io_interrupted_cb() + */ +int audio_in_set_interrupted_cb(audio_in_h input, audio_io_interrupted_cb callback, void *user_data); + +/** + * @brief Unregisters the callback function. + * @param[in] output The handle to the audio output + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #AUDIO_IO_ERROR_INVALID_OPERATION Invalid operation + * @see audio_in_set_interrupted_cb() + */ +int audio_in_unset_interrupted_cb(audio_in_h input); + + + +// +// AUDIO OUTPUT +// + +/** + * @} +*/ + +/** + * @addtogroup CAPI_MEDIA_AUDIO_OUT_MODULE + * @{ + */ + +/** + * @brief Creates an audio device instance and returns an output handle to play PCM (pulse-code modulation) data + * @details This function is used for audio output initialization. + * @remarks @a output must be released audio_out_destroy() by you. + * + * @param[in] sample_rate The audio sample rate in 8000[Hz] ~ 48000[Hz] + * @param[in] channel The audio channel type, mono, or stereo + * @param[in] type The type of audio sample (8- or 16-bit) + * @param[in] sound_type The type of sound (#sound_type_e) + * @param[out] output An audio output handle will be created, if successful + * + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #AUDIO_IO_ERROR_OUT_OF_MEMORY Out of memory + * @retval #AUDIO_IO_ERROR_DEVICE_NOT_OPENED Device not opened + * @retval #AUDIO_IO_ERROR_SOUND_POLICY Sound policy error + * + * @see audio_out_destroy() +*/ +int audio_out_create(int sample_rate, audio_channel_e channel, audio_sample_type_e type, sound_type_e sound_type, audio_out_h *output); + + + +/** + * @brief Releases the audio output handle, along with all its resources + * + * @param[in] output The handle to the audio output to destroy + * + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #AUDIO_IO_ERROR_OUT_OF_MEMORY Out of memory + * @retval #AUDIO_IO_ERROR_DEVICE_NOT_CLOSED Device not closed + * + * @see audio_out_create() +*/ +int audio_out_destroy(audio_out_h output); + +/** + * @brief Prepare playing audio out, this must be called before audio_out_write() + * @param[in] input The handle to the audio output + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @see audio_out_unprepare() + */ +int audio_out_prepare(audio_out_h output); + + + +/** + * @brief Unprepare playing audio out. + * @param[in] input The handle to the audio output + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @see audio_out_prepare() + */ +int audio_out_unprepare(audio_out_h output); + + + + +/** + * @brief Starts writing the audio data to the device + * + * @param[in] output The handle to the audio output + * @param[in,out] buffer The PCM buffer address + * @param[in] length The length of PCM buffer (in bytes) + * + * @return Written data size on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #AUDIO_IO_ERROR_INVALID_BUFFER Invalid buffer pointer + * @retval #AUDIO_IO_ERROR_SOUND_POLICY Sound policy error +*/ +int audio_out_write(audio_out_h output, void *buffer, unsigned int length); + + + +/** + * @brief Gets the size to be allocated for audio output buffer + * @param[in] output The handle to the audio output + * @param[out] size The suggested buffer size (in bytes). \n The maximum size is 1 MB. + * + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @see audio_out_write() + * +*/ +int audio_out_get_buffer_size(audio_out_h output, int *size); + + + +/** + * @brief Gets the sample rate of audio output data stream + * + * @param[in] output The handle to the audio output + * @param[out] sample_rate The audio sample rate in Hertz (8000 ~ 48000) + * + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter +*/ +int audio_out_get_sample_rate(audio_out_h output, int *sample_rate); + + + +/** + * @brief Gets the channel type of audio output data stream + * + * @details The audio channel type defines whether the audio is mono or stereo. + * + * @param[in] output The handle to the audio output + * @param[out] channel The audio channel type + * + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter +*/ +int audio_out_get_channel(audio_out_h output, audio_channel_e *channel); + + + +/** + * @brief Gets the sample audio format (8-bit or 16-bit) of audio output data stream + * + * @param[in] output The handle to the audio output + * @param[out] type The audio sample type + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter +*/ +int audio_out_get_sample_type(audio_out_h output, audio_sample_type_e *type); + + + +/** + * @brief Gets the sound type supported by the audio output device + * @param[in] output The handle to the audio output + * @param[out] type The sound type + * + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter +*/ +int audio_out_get_sound_type(audio_out_h output, sound_type_e *type); + + +/** + * @brief Registers a callback function to be invoked when the audio out handle is interrupted or interrupt completed. + * @param[in] output The handle to the audio output + * @param[in] callback The callback function to register + * @param[in] user_data The user data to be passed to the callback function + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #AUDIO_IO_ERROR_INVALID_OPERATION Invalid operation + * @post audio_io_interrupted_cb() will be invoked + * @see audio_out_unset_interrupted_cb() + * @see audio_io_interrupted_cb() + */ +int audio_out_set_interrupted_cb(audio_out_h output, audio_io_interrupted_cb callback, void *user_data); + +/** + * @brief Unregisters the callback function. + * @param[in] output The handle to the audio output + * @return 0 on success, otherwise a negative error value. + * @retval #AUDIO_IO_ERROR_NONE Successful + * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #AUDIO_IO_ERROR_INVALID_OPERATION Invalid operation + * @see audio_out_set_interrupted_cb() + */ +int audio_out_unset_interrupted_cb(audio_out_h output); + + + +/** + * @} +*/ + +#ifdef __cplusplus +} +#endif + +#endif /* __TIZEN_MEDIA_AUDIO_IO_H__ */ diff --git a/include/audio_io_private.h b/include/audio_io_private.h new file mode 100644 index 0000000..d124cea --- /dev/null +++ b/include/audio_io_private.h @@ -0,0 +1,53 @@ +/* +* 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_MEDIA_AUDIO_IO_PRIVATE_H__ +#define __TIZEN_MEDIA_AUDIO_IO_PRIVATE_H__ +#include <audio_io.h> +#include <sound_manager.h> +#include <mm_sound.h> + +#ifdef __cplusplus +extern "C" { +#endif + + +typedef struct _audio_in_s{ + MMSoundPcmHandle_t mm_handle; + int _buffer_size; + int _sample_rate; + audio_channel_e _channel; + audio_sample_type_e _type; + audio_io_interrupted_cb user_cb; + void* user_data; +} audio_in_s; + +typedef struct _audio_out_s{ + MMSoundPcmHandle_t mm_handle; + int _buffer_size; + int _sample_rate; + audio_channel_e _channel; + audio_sample_type_e _type; + sound_type_e _sound_type; + audio_io_interrupted_cb user_cb; + void* user_data; +} audio_out_s; + +#ifdef __cplusplus +} +#endif + +#endif //__TIZEN_MEDIA_AUDIO_IO_PRIVATE_H__ diff --git a/packaging/capi-media-audio-io.spec b/packaging/capi-media-audio-io.spec new file mode 100644 index 0000000..6452546 --- /dev/null +++ b/packaging/capi-media-audio-io.spec @@ -0,0 +1,56 @@ +Name: capi-media-audio-io +Summary: An Audio Input & Audio Output library in Tizen Native API +Version: 0.1.1 +Release: 3 +Group: TO_BE/FILLED_IN +License: TO BE FILLED IN +Source0: %{name}-%{version}.tar.gz +BuildRequires: cmake +BuildRequires: pkgconfig(dlog) +BuildRequires: pkgconfig(mm-sound) +BuildRequires: pkgconfig(capi-media-sound-manager) +BuildRequires: pkgconfig(capi-base-common) +Requires(post): /sbin/ldconfig +Requires(postun): /sbin/ldconfig + +%description +An Audio Input & Audio Output library in Tizen Native API + +%package devel +Summary: An Audio Input & Audio Output library in Tizen Native API (Development) +Group: TO_BE/FILLED_IN +Requires: %{name} = %{version}-%{release} + +%description devel +An Audio Input & Audio Output library in Tizen Native API (DEV) + +%prep +%setup -q + + +%build +MAJORVER=`echo %{version} | awk 'BEGIN {FS="."}{print $1}'` +cmake . -DCMAKE_INSTALL_PREFIX=/usr -DFULLVER=%{version} -DMAJORVER=${MAJORVER} + + +make %{?jobs:-j%jobs} + +%install +rm -rf %{buildroot} +%make_install + +%post -p /sbin/ldconfig + +%postun -p /sbin/ldconfig + + +%files +%{_libdir}/libcapi-media-audio-io.so.* +%manifest capi-media-audio-io.manifest + +%files devel +%{_includedir}/media/audio_io.h +%{_libdir}/pkgconfig/*.pc +%{_libdir}/libcapi-media-audio-io.so + + diff --git a/src/audio_io.c b/src/audio_io.c new file mode 100644 index 0000000..46cc472 --- /dev/null +++ b/src/audio_io.c @@ -0,0 +1,590 @@ +/* +* 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. +*/ + +#include <stdio.h> +#include <stdlib.h> +#include <string.h> +#include <mm.h> +#include <glib.h> +#include <audio_io_private.h> +#include <dlog.h> + +#ifdef LOG_TAG +#undef LOG_TAG +#endif +#define LOG_TAG "TIZEN_N_AUDIO_IO" + +/* +* Internal Macros +*/ +#define AUDIO_IO_CHECK_CONDITION(condition,error,msg) \ + if(condition) {} else \ + { LOGE("[%s] %s(0x%08x)",__FUNCTION__, msg,error); return error;}; \ + +#define AUDIO_IO_NULL_ARG_CHECK(arg) \ + AUDIO_IO_CHECK_CONDITION(arg != NULL, AUDIO_IO_ERROR_INVALID_PARAMETER, "AUDIO_IO_ERROR_INVALID_PARAMETER" ) + +/* +* Internal Implementation +*/ +static int __convert_error_code(int code, char *func_name) +{ + int ret = AUDIO_IO_ERROR_NONE; + char* msg = "AUDIO_IO_ERROR_NONE"; + + switch(code) + { + case MM_ERROR_NONE: + ret = AUDIO_IO_ERROR_NONE; + msg = "AUDIO_IO_ERROR_NONE"; + break; + case MM_ERROR_INVALID_ARGUMENT: + case MM_ERROR_SOUND_DEVICE_INVALID_SAMPLERATE: + case MM_ERROR_SOUND_DEVICE_INVALID_CHANNEL: + case MM_ERROR_SOUND_DEVICE_INVALID_FORMAT: + ret = AUDIO_IO_ERROR_INVALID_PARAMETER; + msg = "AUDIO_IO_ERROR_INVALID_PARAMETER"; + break; + case MM_ERROR_SOUND_DEVICE_NOT_OPENED: + ret = AUDIO_IO_ERROR_DEVICE_NOT_OPENED; + msg = "AUDIO_IO_ERROR_DEVICE_NOT_OPENED"; + break; + case MM_ERROR_SOUND_INTERNAL: + ret = AUDIO_IO_ERROR_DEVICE_NOT_CLOSED; + msg = "AUDIO_IO_ERROR_DEVICE_NOT_CLOSED"; + break; + case MM_ERROR_SOUND_INVALID_POINTER: + ret = AUDIO_IO_ERROR_INVALID_BUFFER; + msg = "AUDIO_IO_ERROR_INVALID_BUFFER"; + break; + case MM_ERROR_POLICY_BLOCKED: + case MM_ERROR_POLICY_INTERRUPTED: + case MM_ERROR_POLICY_INTERNAL: + case MM_ERROR_POLICY_DUPLICATED: + ret = AUDIO_IO_ERROR_SOUND_POLICY; + msg = "AUDIO_IO_ERROR_SOUND_POLICY"; + break; + } + LOGE("[%s] %s(0x%08x) : core fw error(0x%x)",func_name,msg, ret, code); + return ret; +} + +static int __check_parameter(int sample_rate, audio_channel_e channel, audio_sample_type_e type) +{ + if(sample_rate<8000 || sample_rate > 48000) { + LOGE("[%s] AUDIO_IO_ERROR_INVALID_PARAMETER(0x%08x) : Invalid sample rate (8000~48000Hz) : %d",__FUNCTION__, AUDIO_IO_ERROR_INVALID_PARAMETER,sample_rate); + return AUDIO_IO_ERROR_INVALID_PARAMETER; + } + if (channel < AUDIO_CHANNEL_MONO || channel > AUDIO_CHANNEL_STEREO) { + LOGE("[%s] AUDIO_IO_ERROR_INVALID_PARAMETER(0x%08x) : Invalid audio channel : %d",__FUNCTION__, AUDIO_IO_ERROR_INVALID_PARAMETER,channel); + return AUDIO_IO_ERROR_INVALID_PARAMETER; + } + if (type < AUDIO_SAMPLE_TYPE_U8 || type > AUDIO_SAMPLE_TYPE_S16_LE) { + LOGE("[%s] AUDIO_IO_ERROR_INVALID_PARAMETER(0x%08x) : Invalid sample typel : %d",__FUNCTION__, AUDIO_IO_ERROR_INVALID_PARAMETER,type); + return AUDIO_IO_ERROR_INVALID_PARAMETER; + } + return AUDIO_IO_ERROR_NONE; +} + + +static audio_io_interrupted_code_e __translate_interrupted_code (int code) +{ + audio_io_interrupted_code_e e = AUDIO_IO_INTERRUPTED_COMPLETED; + + switch(code) + { + case MM_MSG_CODE_INTERRUPTED_BY_ALARM_END: + case MM_MSG_CODE_INTERRUPTED_BY_EMERGENCY_END: + e = AUDIO_IO_INTERRUPTED_COMPLETED; + break; + + case MM_MSG_CODE_INTERRUPTED_BY_MEDIA: + case MM_MSG_CODE_INTERRUPTED_BY_OTHER_PLAYER_APP: + e = AUDIO_IO_INTERRUPTED_BY_MEDIA; + break; + + case MM_MSG_CODE_INTERRUPTED_BY_CALL_START: + e = AUDIO_IO_INTERRUPTED_BY_CALL; + break; + + case MM_MSG_CODE_INTERRUPTED_BY_EARJACK_UNPLUG: + e = AUDIO_IO_INTERRUPTED_BY_EARJACK_UNPLUG; + break; + + case MM_MSG_CODE_INTERRUPTED_BY_RESOURCE_CONFLICT: + e = AUDIO_IO_INTERRUPTED_BY_RESOURCE_CONFLICT; + break; + + case MM_MSG_CODE_INTERRUPTED_BY_ALARM_START: + e = AUDIO_IO_INTERRUPTED_BY_ALARM; + break; + + case MM_MSG_CODE_INTERRUPTED_BY_EMERGENCY_START: + e = AUDIO_IO_INTERRUPTED_BY_EMERGENCY; + break; + + case MM_MSG_CODE_INTERRUPTED_BY_RESUMABLE_MEDIA: + e = AUDIO_IO_INTERRUPTED_BY_RESUMABLE_MEDIA; + break; + } + + return e; +} + +static int __mm_sound_pcm_capture_msg_cb (int message, void *param, void *user_param) +{ + audio_io_interrupted_code_e e = AUDIO_IO_INTERRUPTED_COMPLETED; + audio_in_s *handle = (audio_in_s *) user_param; + MMMessageParamType *msg = (MMMessageParamType*)param; + + LOGI("[%s] Got message type : 0x%x with code : %d" ,__FUNCTION__, message, msg->code); + + if (handle->user_cb == NULL) { + LOGI("[%s] No interrupt callback is set. Skip this" ,__FUNCTION__); + return 0; + } + + if (message == MM_MESSAGE_SOUND_PCM_INTERRUPTED) { + e = __translate_interrupted_code (msg->code); + } else if (message == MM_MESSAGE_SOUND_PCM_CAPTURE_RESTRICTED) { + /* TODO : handling restricted code is needed */ + /* e = _translate_restricted_code (msg->code); */ + } + + handle->user_cb (e, handle->user_data); + + return 0; +} + +static int __mm_sound_pcm_playback_msg_cb (int message, void *param, void *user_param) +{ + audio_io_interrupted_code_e e = AUDIO_IO_INTERRUPTED_COMPLETED; + audio_out_s *handle = (audio_out_s *) user_param; + MMMessageParamType *msg = (MMMessageParamType*)param; + + LOGI("[%s] Got message type : 0x%x with code : %d" ,__FUNCTION__, message, msg->code); + + if (handle->user_cb == NULL) { + LOGI("[%s] No interrupt callback is set. Skip this" ,__FUNCTION__); + return 0; + } + + if (message == MM_MESSAGE_SOUND_PCM_INTERRUPTED) { + e = __translate_interrupted_code (msg->code); + } + + handle->user_cb (e, handle->user_data); + + return 0; +} + + +/* +* Public Implementation +*/ + +/* Audio In */ +int audio_in_create(int sample_rate, audio_channel_e channel, audio_sample_type_e type , audio_in_h* input) +{ + int ret = 0; + audio_in_s *handle = NULL; + + /* input condition check */ + AUDIO_IO_NULL_ARG_CHECK(input); + if(__check_parameter(sample_rate, channel, type) != AUDIO_IO_ERROR_NONE) + return AUDIO_IO_ERROR_INVALID_PARAMETER; + + /* Create Handle */ + handle = (audio_in_s*)malloc( sizeof(audio_in_s)); + if (handle != NULL) { + memset(handle, 0, sizeof(audio_in_s)); + } else { + LOGE("[%s] ERROR : AUDIO_IO_ERROR_OUT_OF_MEMORY(0x%08x)" ,__FUNCTION__, AUDIO_IO_ERROR_OUT_OF_MEMORY ); + return AUDIO_IO_ERROR_OUT_OF_MEMORY; + } + + ret = mm_sound_pcm_capture_open( &handle->mm_handle,sample_rate, channel, type); + if( ret < 0) { + free (handle); + return __convert_error_code(ret, (char*)__FUNCTION__); + } + LOGI("[%s] mm_sound_pcm_capture_open() success",__FUNCTION__); + + /* Fill information */ + *input = (audio_in_h)handle; + handle->_buffer_size= ret; + handle->_sample_rate= sample_rate; + handle->_channel= channel; + handle->_type= type; + + /* Set message interrupt callback */ + ret = mm_sound_pcm_set_message_callback(handle->mm_handle, __mm_sound_pcm_capture_msg_cb, handle); + if( ret < 0) { + return __convert_error_code(ret, (char*)__FUNCTION__); + } + LOGI("[%s] mm_sound_pcm_set_message_callback() success",__FUNCTION__); + + return AUDIO_IO_ERROR_NONE; +} + +int audio_in_destroy(audio_in_h input) +{ + AUDIO_IO_NULL_ARG_CHECK(input); + audio_in_s *handle = (audio_in_s *) input; + + int ret = mm_sound_pcm_capture_close(handle->mm_handle); + if (ret != MM_ERROR_NONE) { + return __convert_error_code(ret, (char*)__FUNCTION__); + } + free(handle); + + LOGI("[%s] mm_sound_pcm_capture_close() success",__FUNCTION__); + return AUDIO_IO_ERROR_NONE; +} + +int audio_in_prepare(audio_in_h input) +{ + AUDIO_IO_NULL_ARG_CHECK(input); + audio_in_s *handle = (audio_in_s *) input; + + int ret = mm_sound_pcm_capture_start(handle->mm_handle); + if (ret != MM_ERROR_NONE) { + return __convert_error_code(ret, (char*)__FUNCTION__); + } + + LOGI("[%s] mm_sound_pcm_capture_start() success",__FUNCTION__); + return AUDIO_IO_ERROR_NONE; +} + +int audio_in_unprepare(audio_in_h input) +{ + AUDIO_IO_NULL_ARG_CHECK(input); + audio_in_s *handle = (audio_in_s *) input; + + int ret = mm_sound_pcm_capture_stop(handle->mm_handle); + if (ret != MM_ERROR_NONE) { + return __convert_error_code(ret, (char*)__FUNCTION__); + } + + LOGI("[%s] mm_sound_pcm_capture_stop() success",__FUNCTION__); + return AUDIO_IO_ERROR_NONE; +} + +int audio_in_read(audio_in_h input, void *buffer, unsigned int length ) +{ + AUDIO_IO_NULL_ARG_CHECK(input); + AUDIO_IO_NULL_ARG_CHECK(buffer); + audio_in_s *handle = (audio_in_s *) input; + int ret = 0; + int result = 0; + + ret = mm_sound_pcm_capture_read(handle->mm_handle, (void*) buffer, length); + if (ret > 0) { + LOGI("[%s] (%d/%d) bytes read" ,__FUNCTION__, ret, length); + return ret; + } + + switch(ret) + { + case MM_ERROR_SOUND_INVALID_STATE: + result = AUDIO_IO_ERROR_INVALID_OPERATION; + LOGE("[%s] (0x%08x) : Not recording started yet.",(char*)__FUNCTION__, AUDIO_IO_ERROR_INVALID_OPERATION); + break; + default: + result = __convert_error_code(ret, (char*)__FUNCTION__); + break; + } + return result; +} + +int audio_in_get_buffer_size(audio_in_h input, int *size) +{ + AUDIO_IO_NULL_ARG_CHECK(input); + AUDIO_IO_NULL_ARG_CHECK(size); + audio_in_s *handle = (audio_in_s *) input; + + *size = handle->_buffer_size; + + LOGI("[%s] buffer size = %d",__FUNCTION__, *size); + return AUDIO_IO_ERROR_NONE; +} + +int audio_in_get_sample_rate(audio_in_h input, int *sample_rate) +{ + AUDIO_IO_NULL_ARG_CHECK(input); + AUDIO_IO_NULL_ARG_CHECK(sample_rate); + audio_in_s *handle = (audio_in_s *) input; + + *sample_rate = handle->_sample_rate; + + LOGI("[%s] sample rate = %d",__FUNCTION__, *sample_rate); + return AUDIO_IO_ERROR_NONE; +} + + +int audio_in_get_channel(audio_in_h input, audio_channel_e *channel) +{ + AUDIO_IO_NULL_ARG_CHECK(input); + AUDIO_IO_NULL_ARG_CHECK(channel); + audio_in_s *handle = (audio_in_s *) input; + + *channel = handle->_channel; + + LOGI("[%s] channel = %d",__FUNCTION__, *channel); + return AUDIO_IO_ERROR_NONE; +} + +int audio_in_get_sample_type(audio_in_h input, audio_sample_type_e *type) +{ + AUDIO_IO_NULL_ARG_CHECK(input); + AUDIO_IO_NULL_ARG_CHECK(type); + audio_in_s *handle = (audio_in_s *) input; + + *type = handle->_type; + + LOGI("[%s] sample type = %d",__FUNCTION__, *type); + return AUDIO_IO_ERROR_NONE; +} + +int audio_in_set_interrupted_cb(audio_in_h input, audio_io_interrupted_cb callback, void *user_data) +{ + AUDIO_IO_NULL_ARG_CHECK(input); + AUDIO_IO_NULL_ARG_CHECK(callback); + audio_in_s *handle = (audio_in_s *) input; + + handle->user_cb = callback; + handle->user_data = user_data; + + LOGI("[%s] current interrupted cb (%p) / data (%p)",__FUNCTION__, handle->user_cb, handle->user_data); + return AUDIO_IO_ERROR_NONE; +} + +int audio_in_unset_interrupted_cb(audio_in_h input) +{ + AUDIO_IO_NULL_ARG_CHECK(input); + audio_in_s * handle = (audio_in_s *) input; + + handle->user_cb = NULL; + handle->user_data = NULL; + + LOGI("[%s] current interrupted cb (%p) / data (%p)",__FUNCTION__, handle->user_cb, handle->user_data); + return AUDIO_IO_ERROR_NONE; +} + +/* Audio Out */ +int audio_out_create(int sample_rate, audio_channel_e channel, audio_sample_type_e type, sound_type_e sound_type, audio_out_h* output) +{ + audio_out_s *handle = NULL; + int ret = 0; + + /* input condition check */ + AUDIO_IO_NULL_ARG_CHECK(output); + if(__check_parameter(sample_rate, channel, type)!=AUDIO_IO_ERROR_NONE) + return AUDIO_IO_ERROR_INVALID_PARAMETER; + if(sound_type < SOUND_TYPE_SYSTEM || sound_type > SOUND_TYPE_CALL) { + LOGE("[%s] ERROR : AUDIO_IO_ERROR_INVALID_PARAMETER(0x%08x) : Invalid sample sound type : %d" ,__FUNCTION__,AUDIO_IO_ERROR_INVALID_PARAMETER,sound_type ); + return AUDIO_IO_ERROR_INVALID_PARAMETER; + } + + /* Create Handle */ + handle = (audio_out_s*)malloc( sizeof(audio_out_s)); + if (handle != NULL) { + memset(handle, 0 , sizeof(audio_out_s)); + } else { + LOGE("[%s] ERROR : AUDIO_IO_ERROR_OUT_OF_MEMORY(0x%08x)" ,__FUNCTION__,AUDIO_IO_ERROR_OUT_OF_MEMORY ); + return AUDIO_IO_ERROR_OUT_OF_MEMORY; + } + ret = mm_sound_pcm_play_open(&handle->mm_handle,sample_rate, channel, type, sound_type); + if( ret < 0) { + free (handle); + return __convert_error_code(ret, (char*)__FUNCTION__); + } + LOGI("[%s] mm_sound_pcm_play_open() success",__FUNCTION__); + + /* Fill information */ + *output = (audio_out_h)handle; + handle->_buffer_size = ret; + handle->_sample_rate = sample_rate; + handle->_channel = channel; + handle->_type = type; + handle->_sound_type = sound_type; + + /* Set message interrupt callback */ + ret = mm_sound_pcm_set_message_callback(handle->mm_handle, __mm_sound_pcm_playback_msg_cb, handle); + if( ret < 0) { + return __convert_error_code(ret, (char*)__FUNCTION__); + } + LOGI("[%s] mm_sound_pcm_set_message_callback() success",__FUNCTION__); + + return AUDIO_IO_ERROR_NONE; +} + +int audio_out_destroy(audio_out_h output) +{ + AUDIO_IO_NULL_ARG_CHECK(output); + audio_out_s *handle = (audio_out_s *) output; + + int ret = mm_sound_pcm_play_close(handle->mm_handle); + if (ret != MM_ERROR_NONE) { + return __convert_error_code(ret, (char*)__FUNCTION__); + } + free(handle); + + LOGI("[%s] mm_sound_pcm_play_close() success",__FUNCTION__); + return AUDIO_IO_ERROR_NONE; +} + +int audio_out_prepare(audio_out_h output) +{ + AUDIO_IO_NULL_ARG_CHECK(output); + audio_out_s *handle = (audio_out_s *) output; + + int ret = mm_sound_pcm_play_start(handle->mm_handle); + if (ret != MM_ERROR_NONE) { + return __convert_error_code(ret, (char*)__FUNCTION__); + } + + LOGI("[%s] mm_sound_pcm_play_start() success",__FUNCTION__); + return AUDIO_IO_ERROR_NONE; +} + +int audio_out_unprepare(audio_out_h output) +{ + AUDIO_IO_NULL_ARG_CHECK(output); + audio_out_s *handle = (audio_out_s *) output; + + int ret = mm_sound_pcm_play_stop(handle->mm_handle); + if (ret != MM_ERROR_NONE) { + return __convert_error_code(ret, (char*)__FUNCTION__); + } + + LOGI("[%s] mm_sound_pcm_play_stop() success",__FUNCTION__); + return AUDIO_IO_ERROR_NONE; +} + +int audio_out_write(audio_out_h output, void* buffer, unsigned int length) +{ + AUDIO_IO_NULL_ARG_CHECK(output); + AUDIO_IO_NULL_ARG_CHECK(buffer); + audio_out_s *handle = (audio_out_s *) output; + + int ret = mm_sound_pcm_play_write(handle->mm_handle, (void*) buffer, length); + if (ret > 0) { + LOGI("[%s] (%d/%d) bytes written" ,__FUNCTION__, ret, length); + return ret; + } + switch(ret) + { + case MM_ERROR_SOUND_INVALID_STATE: + ret = AUDIO_IO_ERROR_INVALID_OPERATION; + LOGE("[%s] (0x%08x) : Not playing started yet.",(char*)__FUNCTION__, AUDIO_IO_ERROR_INVALID_OPERATION); + break; + default: + ret = __convert_error_code(ret, (char*)__FUNCTION__); + break; + } + return ret; +} + + +int audio_out_get_buffer_size(audio_out_h output, int *size) +{ + AUDIO_IO_NULL_ARG_CHECK(output); + AUDIO_IO_NULL_ARG_CHECK(size); + audio_out_s *handle = (audio_out_s *) output; + + *size = handle->_buffer_size; + + LOGI("[%s] buffer size = %d",__FUNCTION__, *size); + return AUDIO_IO_ERROR_NONE; +} + + +int audio_out_get_sample_rate(audio_out_h output, int *sample_rate) +{ + AUDIO_IO_NULL_ARG_CHECK(output); + AUDIO_IO_NULL_ARG_CHECK(sample_rate); + audio_out_s *handle = (audio_out_s *) output; + + *sample_rate = handle->_sample_rate; + + LOGI("[%s] sample rate = %d",__FUNCTION__, *sample_rate); + return AUDIO_IO_ERROR_NONE; +} + + +int audio_out_get_channel(audio_out_h output, audio_channel_e *channel) +{ + AUDIO_IO_NULL_ARG_CHECK(output); + AUDIO_IO_NULL_ARG_CHECK(channel); + audio_out_s *handle = (audio_out_s *) output; + + *channel = handle->_channel; + + LOGI("[%s] channel = %d",__FUNCTION__, *channel); + return AUDIO_IO_ERROR_NONE; +} + + +int audio_out_get_sample_type(audio_out_h output, audio_sample_type_e *type) +{ + AUDIO_IO_NULL_ARG_CHECK(output); + AUDIO_IO_NULL_ARG_CHECK(type); + audio_out_s *handle = (audio_out_s *) output; + + *type = handle->_type; + + LOGI("[%s] sample type = %d",__FUNCTION__, *type); + return AUDIO_IO_ERROR_NONE; +} + + +int audio_out_get_sound_type(audio_out_h output, sound_type_e *type) +{ + AUDIO_IO_NULL_ARG_CHECK(output); + AUDIO_IO_NULL_ARG_CHECK(type); + audio_out_s *handle = (audio_out_s *) output; + + *type = handle->_sound_type; + + LOGI("[%s] sound type = %d",__FUNCTION__, *type); + return AUDIO_IO_ERROR_NONE; +} + +int audio_out_set_interrupted_cb(audio_out_h output, audio_io_interrupted_cb callback, void *user_data) +{ + AUDIO_IO_NULL_ARG_CHECK(output); + AUDIO_IO_NULL_ARG_CHECK(callback); + audio_out_s *handle = (audio_out_s *) output; + + handle->user_cb = callback; + handle->user_data = user_data; + + LOGI("[%s] current interrupted cb (%p) / data (%p)",__FUNCTION__, handle->user_cb, handle->user_data); + return AUDIO_IO_ERROR_NONE; +} + +int audio_out_unset_interrupted_cb(audio_out_h output) +{ + AUDIO_IO_NULL_ARG_CHECK(output); + audio_out_s *handle = (audio_out_s *) output; + + handle->user_cb = NULL; + handle->user_data = NULL; + + LOGI("[%s] current interrupted cb (%p) / data (%p)",__FUNCTION__, handle->user_cb, handle->user_data); + return AUDIO_IO_ERROR_NONE; +} diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt new file mode 100644 index 0000000..795370d --- /dev/null +++ b/test/CMakeLists.txt @@ -0,0 +1,18 @@ + +SET(fw_test "${fw_name}-test") + +INCLUDE(FindPkgConfig) +FOREACH(flag ${${fw_test}_CFLAGS}) + SET(EXTRA_CFLAGS "${EXTRA_CFLAGS} ${flag}") +ENDFOREACH(flag) + +SET(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${EXTRA_CFLAGS} -Wall -Werror") + +aux_source_directory(. sources) +FOREACH(src ${sources}) + GET_FILENAME_COMPONENT(src_name ${src} NAME_WE) + MESSAGE("${src_name}") + ADD_EXECUTABLE(${src_name} ${src}) + TARGET_LINK_LIBRARIES(${src_name} ${fw_name} ${${fw_test}_LDFLAGS}) +ENDFOREACH() + diff --git a/test/audio_io_test.c b/test/audio_io_test.c new file mode 100755 index 0000000..2647c16 --- /dev/null +++ b/test/audio_io_test.c @@ -0,0 +1,32 @@ +/* +* 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. +*/ + +#include <stdio.h> +#include <stdlib.h> +#include <string.h> +#include <audio_io.h> + +int audio_io_test() +{ + return 1; +} + +int main(int argc, char ** argv) +{ + audio_io_test(); + return 0; +} + |