From 76a71fb5034708f52db3a268ae71efe16f2eb2cd Mon Sep 17 00:00:00 2001 From: Wootak Jung Date: Tue, 29 Aug 2023 14:47:11 +0900 Subject: [PATCH] Fix api header errors from the script include/bluetooth.h:56: ERROR: Return value #BT_ERROR_NOT_SUPPORTED used in incorrect order. Correct return value order: ERROR_NONE ERROR_NOT_SUPPORTED ERROR_PERMISSION_DENIED ERROR_INVALID_PARAMETER Other errors include/bluetooth.h:474: Note: Please consider changing tabs in comments to spaces. Tabs may cause aligned comments to be shown incorrectly, depending on the editor's tab width setting. include/bluetooth.h:619: ERROR: The description of the 'randomizer' parameter in line 619 is the same as for 'hash' in line 618. include/bluetooth.h:635: ERROR: Since at least one privilege is needed, one of the errors should be ..._ERROR_PERMISSION_DENIED ... Change-Id: Ic4b7c0debe86b366fcb20af6f3667df1ce22c804 Signed-off-by: Wootak Jung --- include/bluetooth.h | 3245 +++++++++++++++++++++++----------------------- include/bluetooth_type.h | 3 +- 2 files changed, 1629 insertions(+), 1619 deletions(-) diff --git a/include/bluetooth.h b/include/bluetooth.h index 76782b8..ba5cec2 100644 --- a/include/bluetooth.h +++ b/include/bluetooth.h @@ -51,11 +51,11 @@ extern "C" * You must free all resources of the Bluetooth service by calling bt_deinitialize() if Bluetooth service is no longer needed. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * - * @see bt_deinitialize() + * @see bt_deinitialize() */ int bt_initialize(void); @@ -68,10 +68,10 @@ int bt_initialize(void); * @remarks This function must be called if Bluetooth API is no longer needed. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre Bluetooth API must be initialized with bt_initialize(). * @@ -88,10 +88,10 @@ int bt_deinitialize(void); * * @param[in] uuid The UUID * @param[out] name The specification name defined at www.bluetooth.com - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_get_uuid() */ @@ -105,10 +105,10 @@ int bt_get_uuid_name(const char *uuid, char **name); * @param[out] adapter_state The current adapter state * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre Bluetooth service must be initialized with bt_initialize(). * @@ -127,12 +127,12 @@ int bt_adapter_get_state(bt_adapter_state_e *adapter_state); * * @return 0 on success, otherwise a negative error value. * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @see bt_adapter_get_name() @@ -150,16 +150,16 @@ int bt_adapter_get_address(char **local_address); * * @remarks The @a local_name must be released with free() by you. * - * @param[out] local_name The local device name + * @param[out] local_name The local device name * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @@ -178,13 +178,13 @@ int bt_adapter_get_name(char **local_name); * The maximum length is 248 characters. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @post bt_adapter_name_changed_cb() will be invoked if this function returns #BT_ERROR_NONE. @@ -204,12 +204,12 @@ int bt_adapter_set_name(const char *local_name); * @param[out] duration The duration until the visibility mode is changed to #BT_ADAPTER_VISIBILITY_MODE_NON_DISCOVERABLE (in seconds). * @a duration is valid only if @a mode is #BT_ADAPTER_VISIBILITY_MODE_LIMITED_DISCOVERABLE. This value can be NULL. * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. */ @@ -230,13 +230,13 @@ int bt_adapter_get_visibility(bt_adapter_visibility_mode_e *mode, int *duration) * The device discovery can be stopped by bt_adapter_stop_device_discovery(). * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is now in progress - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is now in progress + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @post This function invokes bt_adapter_device_discovery_state_changed_cb(). @@ -258,13 +258,13 @@ int bt_adapter_start_device_discovery(void); * @remarks The device discovery process will take 10 ~ 20 seconds to get all the devices in vicinity. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_NOT_IN_PROGRESS Operation is not in progress - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NOT_IN_PROGRESS Operation is not in progress + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The device discovery must be in progress with bt_adapter_start_device_discovery(). * @post This function invokes bt_adapter_device_discovery_state_changed_cb(). @@ -289,12 +289,12 @@ int bt_adapter_stop_device_discovery(void); * @param[out] is_discovering The discovering status: (@c true = in progress , @c false = not in progress ) * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @@ -313,9 +313,9 @@ int bt_adapter_is_discovering(bool *is_discovering); * @param[out] service_mask_list Service mask list converted from the given UUID list. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_service_class_t */ @@ -332,13 +332,13 @@ int bt_device_get_service_mask_from_uuid_list(char **uuids, * @param[in] user_data The user data passed from the foreach function * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @post This function invokes bt_adapter_bonded_device_cb(). @@ -357,14 +357,14 @@ int bt_adapter_foreach_bonded_device(bt_adapter_bonded_device_cb callback, void * @param[out] device_info The bonded device information * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_BONDED Remote device not bonded - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_BONDED Remote device not bonded * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @post This function invokes bt_adapter_bonded_device_cb(). @@ -381,9 +381,9 @@ int bt_adapter_get_bonded_device_info(const char *remote_address, bt_device_info * @param[in] device_info The bonded device information * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_adapter_get_bonded_device_info() */ @@ -397,28 +397,28 @@ int bt_adapter_free_device_info(bt_device_info_s *device_info); * @param[out] used Indicates whether the service is used or not * @return true on success, otherwise false. * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed */ int bt_adapter_is_service_used(const char *service_uuid, bool *used); /** * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_MODULE - * @brief Registers a callback function to be invoked when the Bluetooth adapter state changes. + * @brief Registers a callback function to be invoked when the Bluetooth adapter state changes. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * * @param[in] callback The callback function to invoke * @param[in] user_data The user data to be passed to the callback function * - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @post bt_adapter_state_changed_cb() will be invoked. @@ -435,9 +435,9 @@ int bt_adapter_set_state_changed_cb(bt_adapter_state_changed_cb callback, void * * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -448,17 +448,17 @@ int bt_adapter_unset_state_changed_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_MODULE - * @brief Registers a callback function to be invoked when the name of Bluetooth adapter changes. + * @brief Registers a callback function to be invoked when the name of Bluetooth adapter changes. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * * @param[in] callback The callback function to invoke * @param[in] user_data The user data to be passed to the callback function * - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @post bt_adapter_name_changed_cb() will be invoked. @@ -471,13 +471,13 @@ int bt_adapter_set_name_changed_cb(bt_adapter_name_changed_cb callback, void *us /** * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_MODULE - * @brief Unregisters the callback function. + * @brief Unregisters the callback function. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -488,17 +488,17 @@ int bt_adapter_unset_name_changed_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_MODULE - * @brief Registers a callback function to be invoked when the visibility mode changes. + * @brief Registers a callback function to be invoked when the visibility mode changes. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @post bt_adapter_visibility_mode_changed_cb() will be invoked. @@ -511,13 +511,13 @@ int bt_adapter_set_visibility_mode_changed_cb(bt_adapter_visibility_mode_changed /** * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_MODULE - * @brief Unregisters the callback function. + * @brief Unregisters the callback function. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -528,7 +528,7 @@ int bt_adapter_unset_visibility_mode_changed_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_MODULE - * @brief Registers a callback function to be invoked every second. + * @brief Registers a callback function to be invoked every second. * * @details When you set visibility mode as #BT_ADAPTER_VISIBILITY_MODE_LIMITED_DISCOVERABLE, \n * @a callback will be called every second until visibility mode is changed to #BT_ADAPTER_VISIBILITY_MODE_NON_DISCOVERABLE. @@ -538,11 +538,12 @@ int bt_adapter_unset_visibility_mode_changed_cb(void); * to #BT_ADAPTER_VISIBILITY_MODE_NON_DISCOVERABLE. * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized by bt_initialize(). * @post bt_adapter_visibility_duration_changed_cb() will be invoked. @@ -554,12 +555,12 @@ int bt_adapter_set_visibility_duration_changed_cb(bt_adapter_visibility_duration /** * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_MODULE - * @brief Unregisters the callback function. + * @brief Unregisters the callback function. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -569,17 +570,17 @@ int bt_adapter_unset_visibility_duration_changed_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_MODULE - * @brief Registers a callback function to be invoked when the device discovery state changes. + * @brief Registers a callback function to be invoked when the device discovery state changes. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @post bt_adapter_device_discovery_state_changed_cb() will be invoked. @@ -592,13 +593,13 @@ int bt_adapter_set_device_discovery_state_changed_cb(bt_adapter_device_discovery /** * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_MODULE - * @brief Unregisters the callback function. + * @brief Unregisters the callback function. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -615,17 +616,22 @@ int bt_adapter_unset_device_discovery_state_changed_cb(void); * @privilege %http://tizen.org/privilege/bluetooth * @remarks %http://tizen.org/privilege/bluetooth (public level privilege) is required to use this API since 5.5. * + * @remarks The @a hash should be released using free(). + * @remarks The @a randomizer should be released using free(). + * * @param[out] hash The hash value received from the controller - * @param[out] randomizer The hash value received from the controller + * @param[out] randomizer The randomizer value received from the controller * @param[out] hash_len The length of the hash value * @param[out] randomizer_len The length of the randomizer value + * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @pre The Bluetooth service must be initialized with bt_initialize(). @@ -643,17 +649,18 @@ int bt_adapter_get_local_oob_data(unsigned char **hash, unsigned char **randomiz * * @param[in] remote_address Remote device address * @param[in] hash The hash value received from the controller - * @param[in] randomizer The hash value received from the controller + * @param[in] randomizer The randomizer value received from the controller * @param[in] hash_len The length of the hash value. Allowed value is 16 * @param[in] randomizer_len The length of the randomizer value. Allowed value is 16 + * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @pre The Bluetooth service must be initialized with bt_initialize(). @@ -681,13 +688,15 @@ int bt_adapter_set_remote_oob_data(const char *remote_address, * @param[out] randomizer256 The randomizer value associated with the P-256 public key * @param[out] hash256_len The length of @a hash256 * @param[out] randomizer256_len The length of @a randomizer256 + * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @pre The Bluetooth service must be initialized with bt_initialize(). @@ -714,14 +723,15 @@ int bt_adapter_get_local_oob_ext_data(unsigned char **hash192, unsigned char **r * @param[in] randomizer256 The P-256 randomizer value received via OOB from remote device * @param[in] hash256_len The length of @a hash256 * @param[in] randomizer256_len The length of @a randomizer256 + * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @pre The Bluetooth service must be initialized with bt_initialize(). @@ -742,13 +752,13 @@ int bt_adapter_set_remote_oob_ext_data(const char *remote_address, * * @param[in] remote_address Remote device address * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @pre The Bluetooth service must be initialized with bt_initialize(). @@ -768,12 +778,12 @@ int bt_adapter_remove_remote_oob_data(const char *remote_address); * @param[out] is_discovering The discovering status: (@c true = in progress , @c false = not in progress ) * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. */ @@ -792,13 +802,13 @@ int bt_adapter_le_is_discovering(bool *is_discovering); * @param[in] user_data The user data to be passed when callback is called * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is now in progress - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is now in progress + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @post This function invokes bt_adapter_le_scan_result_cb(). @@ -815,13 +825,13 @@ int bt_adapter_le_start_scan(bt_adapter_le_scan_result_cb cb, void *user_data); * @privilege %http://tizen.org/privilege/bluetooth * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_NOT_IN_PROGRESS Operation is not in progress - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NOT_IN_PROGRESS Operation is not in progress + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The LE scan must be in progress with bt_adapter_le_start_scan(). * @@ -844,11 +854,11 @@ int bt_adapter_le_stop_scan(void); * @param[out] count The count of the service UUIDs * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NO_DATA No data available - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NO_DATA No data available * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -869,11 +879,11 @@ int bt_adapter_le_get_scan_result_service_uuids(const bt_adapter_le_device_scan_ * @param[out] name The device name * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NO_DATA No data available - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NO_DATA No data available * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -892,11 +902,11 @@ int bt_adapter_le_get_scan_result_device_name(const bt_adapter_le_device_scan_re * @param[out] power_level The transmission power level in dBm * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NO_DATA No data available - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NO_DATA No data available * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -921,11 +931,11 @@ int bt_adapter_le_get_scan_result_tx_power_level(const bt_adapter_le_device_scan * @param[out] count The count of the service UUIDs * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NO_DATA No data available - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NO_DATA No data available * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -947,11 +957,11 @@ int bt_adapter_le_get_scan_result_service_solicitation_uuids(const bt_adapter_le * @param[out] count The count of the service data list * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NO_DATA No data available - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NO_DATA No data available * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -969,9 +979,9 @@ int bt_adapter_le_get_scan_result_service_data_list(const bt_adapter_le_device_s * @param[in] count The count of the service data list * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_adapter_le_get_scan_result_service_data_list() */ @@ -987,11 +997,11 @@ int bt_adapter_le_free_service_data_list(bt_adapter_le_service_data_s *data_list * @param[out] appearance The appearance * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NO_DATA No data available - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NO_DATA No data available * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1014,11 +1024,11 @@ int bt_adapter_le_get_scan_result_appearance(const bt_adapter_le_device_scan_res * @param[out] manufacturer_data_len The length of manufacturer data * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NO_DATA No data available - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NO_DATA No data available * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1039,11 +1049,11 @@ int bt_adapter_le_get_scan_result_manufacturer_data(const bt_adapter_le_device_s * @param[out] ibeacon_info The iBeacon format's scan result data * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NO_DATA No data available - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NO_DATA No data available * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1061,9 +1071,9 @@ int bt_adapter_le_get_scan_result_ibeacon_report(const bt_adapter_le_device_scan * @param[in] ibeacon_info The iBeacon format's scan result data * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_adapter_le_get_scan_result_service_data_list() */ @@ -1077,11 +1087,11 @@ int bt_adapter_le_free_ibeacon_report(bt_adapter_le_ibeacon_scan_result_info_s * * @param[out] advertiser The handle of advertiser * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1097,10 +1107,10 @@ int bt_adapter_le_create_advertiser(bt_advertiser_h *advertiser); * @param[out] advertiser The handle of advertiser * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1115,11 +1125,11 @@ int bt_adapter_le_destroy_advertiser(bt_advertiser_h advertiser); * @param[in] callback The callback called when the initialization is finished * @param[in] user_data The user data to be passed to the callback function * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -1131,10 +1141,10 @@ int bt_ipsp_initialize(bt_ipsp_init_state_changed_cb callback, void *user_data); * @brief Deinitializes the Bluetooth IPSP (Internet Protocol Support Profile) service. * @since_tizen 4.0 * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -1149,13 +1159,13 @@ int bt_ipsp_deinitialize(void); * @privilege %http://tizen.org/privilege/bluetooth * @param[in] remote_address The remote address * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @post bt_ipsp_set_connection_state_changed_cb() will be invoked. * @see bt_ipsp_set_connection_state_changed_cb() @@ -1170,14 +1180,14 @@ int bt_ipsp_connect(const char *remote_address); * @privilege %http://tizen.org/privilege/bluetooth * @param[in] remote_address The remote address * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The remote device must be connected by bt_ipsp_connect(). * @post bt_ipsp_set_connection_state_changed_cb() will be invoked. @@ -1188,16 +1198,16 @@ int bt_ipsp_disconnect(const char *remote_address); /** * @ingroup CAPI_NETWORK_BLUETOOTH_IPSP_MODULE - * @brief Registers a callback function that will be invoked when the connection state changes. + * @brief Registers a callback function that will be invoked when the connection state changes. * @since_tizen 4.0 * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported - * + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() */ @@ -1206,12 +1216,12 @@ int bt_ipsp_set_connection_state_changed_cb(bt_ipsp_connection_state_changed_cb /** * @ingroup CAPI_NETWORK_BLUETOOTH_IPSP_MODULE - * @brief Unregisters the callback function called when the connection state changes. + * @brief Unregisters the callback function called when the connection state changes. * @since_tizen 4.0 - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -1238,12 +1248,12 @@ int bt_ipsp_unset_connection_state_changed_cb(void); * @param[in] uuid The string of the service UUID. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1272,12 +1282,12 @@ int bt_adapter_le_add_advertising_service_uuid(bt_advertiser_h advertiser, * @param[in] uuid The string of the service solicitation UUID. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1302,12 +1312,12 @@ int bt_adapter_le_add_advertising_service_solicitation_uuid(bt_advertiser_h adve * @param[in] service_data_len The data length of service data * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1328,12 +1338,12 @@ int bt_adapter_le_add_advertising_service_data(bt_advertiser_h advertiser, * @param[in] appearance The external appearance of device * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1358,12 +1368,12 @@ int bt_adapter_le_set_advertising_appearance(bt_advertiser_h advertiser, * @param[in] manufacturer_data_len The data length of manufacturer data * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1384,12 +1394,12 @@ int bt_adapter_le_add_advertising_manufacturer_data(bt_advertiser_h advertiser, * @param[in] include_name Whether the device name should be included * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1410,12 +1420,12 @@ int bt_adapter_le_set_advertising_device_name(bt_advertiser_h advertiser, * @param[in] include_tx_power Whether the transmission power level should be included * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_QUOTA_EXCEEDED Quota exceeded + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1436,10 +1446,10 @@ int bt_adapter_le_set_advertising_tx_power_level(bt_advertiser_h advertiser, * * @return 0 on success, otherwise a negative error value. * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1458,10 +1468,10 @@ int bt_adapter_le_set_advertising_flags(bt_advertiser_h advertiser, unsigned cha * @param[in] pkt_type The packet type to be cleared * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). */ @@ -1477,14 +1487,14 @@ int bt_adapter_le_clear_advertising_data(bt_advertiser_h advertiser, bt_adapter_ * @param[in] advertiser The handle of advertiser * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_NOT_IN_PROGRESS Operation is not in progress - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NOT_IN_PROGRESS Operation is not in progress + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The advertising must be going on with bt_adapter_le_start_advertising_new(). * @post This function invokes bt_adapter_le_advertising_state_changed_cb(). @@ -1510,14 +1520,14 @@ int bt_adapter_le_stop_advertising(bt_advertiser_h advertiser); * @param[in] user_data The user data to be passed when callback is called * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is now in progress - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is now in progress + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @post This function invokes bt_adapter_le_advertising_state_changed_cb(). @@ -1538,13 +1548,13 @@ int bt_adapter_le_start_advertising_new(bt_advertiser_h advertiser, bt_adapter_l * @param[in] mode The mode of advertising * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is now in progress - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is now in progress * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1563,13 +1573,13 @@ int bt_adapter_le_set_advertising_mode(bt_advertiser_h advertiser, bt_adapter_le * @param[in] connectable The type of advertising * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is now in progress - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is now in progress * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -1587,10 +1597,10 @@ int bt_adapter_le_set_advertising_connectable(bt_advertiser_h advertiser, bool c * * @return 0 on success, otherwise a negative error value. * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled - * @retval #BT_ERROR_INVALID_PARAMETER Parameter is invalid - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled * @pre The state of local bluetooth must be #BT_ADAPTER_ENABLED. * @pre The bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -1610,14 +1620,14 @@ int bt_adapter_le_set_scan_mode(bt_adapter_le_scan_mode_e scan_mode); * @param[in] remote_address The address of the remote Bluetooth device with which the bond should be created * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_RESOURCE_BUSY Device or resource busy - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Parameter is invalid + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_RESOURCE_BUSY Device or resource busy + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @pre The remote device must be discoverable with bt_adapter_start_device_discovery(). @@ -1643,12 +1653,12 @@ int bt_device_create_bond(const char *remote_address); * bond request or you wish to cancel the bonding request. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_NOT_IN_PROGRESS Operation not in progress - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NOT_IN_PROGRESS Operation not in progress * * @pre The creating a bond must be in progress by bt_device_create_bond(). * @@ -1669,15 +1679,15 @@ int bt_device_cancel_bonding(void); * @param[in] remote_address The address of the remote Bluetooth device to remove bonding * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_RESOURCE_BUSY Device or resource busy - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_BONDED Remote device not bonded - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_RESOURCE_BUSY Device or resource busy + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_BONDED Remote device not bonded + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @pre The bond with the remote device must be created with bt_device_create_bond(). @@ -1701,14 +1711,14 @@ int bt_device_destroy_bond(const char *remote_address); * @param[in] alias The alias of the remote Bluetooth device * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_BONDED Remote device not bonded - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_BONDED Remote device not bonded + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @pre The bond with the remote device must be created with bt_device_create_bond(). @@ -1730,14 +1740,14 @@ int bt_device_set_alias(const char *remote_address, const char *alias); * @param[in] authorization_state The Bluetooth authorization state * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_BONDED Remote device not bonded - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_BONDED Remote device not bonded + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @pre The bond with the remote device must be created with bt_device_create_bond(). @@ -1764,14 +1774,14 @@ int bt_device_set_authorization(const char *remote_address, bt_device_authorizat * @param[in] remote_address The address of the remote Bluetooth device whose services need to be checked * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_BONDED Remote device not bonded - * @retval #BT_ERROR_SERVICE_SEARCH_FAILED Service search failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_BONDED Remote device not bonded + * @retval #BT_ERROR_SERVICE_SEARCH_FAILED Service search failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @pre The remote device must be discoverable with bt_adapter_start_device_discovery(). @@ -1795,11 +1805,11 @@ int bt_device_start_service_search(const char *remote_address); * @param[in] callback The callback function to invoke * @param[in] user_data The user data to be passed to the callback function * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @post bt_device_connected_profile() will be invoked. @@ -1815,13 +1825,13 @@ int bt_device_foreach_connected_profiles(const char *remote_address, bt_device_c * @param[in] bt_profile wish to know bt_profile * @param[out] connected_status the connected status * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_BONDED Remote device not bonded - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_BONDED Remote device not bonded + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. */ @@ -1839,27 +1849,27 @@ int bt_device_is_profile_connected(const char *remote_address, bt_profile_e bt_p * @param[in] mode The LE connection mode * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed */ int bt_device_update_le_connection_mode(const char *remote_address, bt_device_le_connection_mode_e mode); /** * @ingroup CAPI_NETWORK_BLUETOOTH_DEVICE_MODULE - * @brief Registers a callback function to be invoked when the bond creates. + * @brief Registers a callback function to be invoked when the bond creates. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @post bt_device_bond_created_cb() will be invoked. @@ -1871,12 +1881,12 @@ int bt_device_set_bond_created_cb(bt_device_bond_created_cb callback, void *user /** * @ingroup CAPI_NETWORK_BLUETOOTH_DEVICE_MODULE - * @brief Unregisters the callback function. + * @brief Unregisters the callback function. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -1886,18 +1896,18 @@ int bt_device_unset_bond_created_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_DEVICE_MODULE - * @brief Registers a callback function to be invoked when the bond destroys. + * @brief Registers a callback function to be invoked when the bond destroys. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). - * @post bt_device_bond_destroyed_cb() will be invoked. + * @post bt_device_bond_destroyed_cb() will be invoked. * @see bt_initialize() * @see bt_device_bond_destroyed_cb() * @see bt_device_unset_bond_destroyed_cb() @@ -1906,12 +1916,12 @@ int bt_device_set_bond_destroyed_cb(bt_device_bond_destroyed_cb callback, void * /** * @ingroup CAPI_NETWORK_BLUETOOTH_DEVICE_MODULE - * @brief Unregisters the callback function. + * @brief Unregisters the callback function. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -1921,18 +1931,20 @@ int bt_device_unset_bond_destroyed_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_DEVICE_MODULE - * @brief Registers a callback function to be invoked when the authorization of device changes. + * @brief Registers a callback function to be invoked when the authorization of device changes. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif + * * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). - * @post bt_device_authorization_changed_cb() will be invoked. + * @post bt_device_authorization_changed_cb() will be invoked. * @see bt_initialize() * @see bt_device_authorization_changed_cb() * @see bt_device_unset_authorization_changed_cb() @@ -1941,12 +1953,12 @@ int bt_device_set_authorization_changed_cb(bt_device_authorization_changed_cb ca /** * @ingroup CAPI_NETWORK_BLUETOOTH_DEVICE_MODULE - * @brief Unregisters the callback function. + * @brief Unregisters the callback function. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -1956,15 +1968,15 @@ int bt_device_unset_authorization_changed_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_DEVICE_MODULE - * @brief Registers a callback function to be invoked when the process of service search finishes. + * @brief Registers a callback function to be invoked when the process of service search finishes. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @post bt_device_service_searched_cb() will be invoked. @@ -1976,12 +1988,12 @@ int bt_device_set_service_searched_cb(bt_device_service_searched_cb callback, vo /** * @ingroup CAPI_NETWORK_BLUETOOTH_DEVICE_MODULE - * @brief Unregisters the callback function. + * @brief Unregisters the callback function. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -1991,15 +2003,15 @@ int bt_device_unset_service_searched_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_DEVICE_MODULE - * @brief Registers a callback function to be invoked when the connection state is changed. + * @brief Registers a callback function to be invoked when the connection state is changed. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @post bt_device_connection_state_changed_cb() will be invoked. @@ -2011,12 +2023,12 @@ int bt_device_set_connection_state_changed_cb(bt_device_connection_state_changed /** * @ingroup CAPI_NETWORK_BLUETOOTH_DEVICE_MODULE - * @brief Unregisters the callback function to be invoked when the connection state is changed. + * @brief Unregisters the callback function to be invoked when the connection state is changed. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -2037,13 +2049,13 @@ int bt_device_unset_connection_state_changed_cb(void); * @param[out] socket_fd The file descriptor of socket to listen * @return 0 on success, otherwise a negative error value. * - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @@ -2063,13 +2075,13 @@ int bt_socket_create_rfcomm(const char *service_uuid, int *socket_fd); * * @param[in] socket_fd The file descriptor of socket (which was created using bt_socket_create_rfcomm()) to destroy * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The socket must be created with bt_socket_create_rfcomm(). * @post If callback function bt_socket_connection_state_changed_cb() is set and the remote Bluetooth device is connected, @@ -2093,13 +2105,13 @@ int bt_socket_destroy_rfcomm(int socket_fd); * @param[in] socket_fd The file descriptor of socket on which start to listen * @param[in] max_pending_connections The maximum number of pending connections * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The socket must be created with bt_socket_create_rfcomm(). * @post If callback function bt_socket_connection_state_changed_cb() is set, @@ -2124,13 +2136,13 @@ int bt_socket_listen_and_accept_rfcomm(int socket_fd, int max_pending_connection * @param[in] service_uuid The UUID of service provided by the remote Bluetooth device * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @pre The remote device must be discoverable with bt_adapter_start_device_discovery(). @@ -2155,12 +2167,12 @@ int bt_socket_connect_rfcomm(const char *remote_address, const char *service_uui * @privilege %http://tizen.org/privilege/bluetooth * @param[in] socket_fd The file descriptor of socket to close which was received using bt_socket_connection_state_changed_cb(). * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled * * @pre The connection must be established. * @@ -2184,11 +2196,11 @@ int bt_socket_disconnect_rfcomm(int socket_fd); * * @return the number of bytes written (zero indicates nothing was written). * @retval On error, -1 is returned, and errno is set appropriately. See write 2 man page. - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @exception BT_ERROR_PERMISSION_DENIED Permission denied - * @exception BT_ERROR_AGAIN Resource temporarily unavailable + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_AGAIN Resource temporarily unavailable * * @pre The connection must be established. * @@ -2200,18 +2212,18 @@ int bt_socket_send_data(int socket_fd, const char *data, int length); /** * @ingroup CAPI_NETWORK_BLUETOOTH_SOCKET_MODULE - * @brief Registers a callback function that will be invoked when you receive data. + * @brief Registers a callback function that will be invoked when you receive data. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). - * @post bt_socket_data_received_cb() will be invoked. + * @post bt_socket_data_received_cb() will be invoked. * @see bt_initialize() * @see bt_socket_data_received_cb() * @see bt_socket_unset_data_received_cb() @@ -2220,12 +2232,12 @@ int bt_socket_set_data_received_cb(bt_socket_data_received_cb callback, void *us /** * @ingroup CAPI_NETWORK_BLUETOOTH_SOCKET_MODULE - * @brief Unregisters the callback function. + * @brief Unregisters the callback function. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -2236,15 +2248,15 @@ int bt_socket_unset_data_received_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_SOCKET_MODULE - * @brief Registers a callback function that will be invoked when a RFCOMM connection is requested. + * @brief Registers a callback function that will be invoked when a RFCOMM connection is requested. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @post bt_socket_connection_requested_cb() will be invoked. @@ -2255,12 +2267,12 @@ int bt_socket_set_connection_requested_cb(bt_socket_connection_requested_cb call /** * @ingroup CAPI_NETWORK_BLUETOOTH_SOCKET_MODULE - * @brief Unregisters the callback function. + * @brief Unregisters the callback function. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -2271,19 +2283,19 @@ int bt_socket_unset_connection_requested_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_SOCKET_MODULE - * @brief Registers a callback function that will be invoked when the connection state changes. + * @brief Registers a callback function that will be invoked when the connection state changes. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported - * - * @pre The Bluetooth service must be initialized with bt_initialize(). - * @post bt_socket_connection_state_changed_cb() will be invoked. - * @see bt_initialize() + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * + * @pre The Bluetooth service must be initialized with bt_initialize(). + * @post bt_socket_connection_state_changed_cb() will be invoked. + * @see bt_initialize() * @see bt_socket_connection_state_changed_cb() * @see bt_socket_unset_connection_state_changed_cb() */ @@ -2291,12 +2303,12 @@ int bt_socket_set_connection_state_changed_cb(bt_socket_connection_state_changed /** * @ingroup CAPI_NETWORK_BLUETOOTH_SOCKET_MODULE - * @brief Unregisters the callback function. + * @brief Unregisters the callback function. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -2318,13 +2330,13 @@ int bt_socket_unset_connection_state_changed_cb(void); * @param[in] connection_requested_cb The callback called when an OPP connection is requested * @param[in] user_data The user data to be passed to the callback function * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_RESOURCE_BUSY Device or resource busy - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_RESOURCE_BUSY Device or resource busy + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @see bt_opp_server_connection_requested_cb() * @see bt_opp_server_deinitialize() @@ -2338,11 +2350,11 @@ int bt_opp_server_initialize_by_connection_request(const char *destination, bt_o * @brief Deinitializes the Bluetooth OPP server. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @see bt_opp_server_initialize_by_connection_request() */ @@ -2362,14 +2374,14 @@ int bt_opp_server_deinitialize(void); * @param[in] user_data The user data to be passed to the callback function * @param[out] transfer_id The ID of transfer * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOW_IN_PROGRESS Operation now in progress - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_NOW_IN_PROGRESS Operation now in progress * * @see bt_opp_server_reject() */ @@ -2384,12 +2396,12 @@ int bt_opp_server_accept(bt_opp_server_transfer_progress_cb progress_cb, * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @see bt_opp_server_accept() */ @@ -2403,13 +2415,13 @@ int bt_opp_server_reject(void); * @privilege %http://tizen.org/privilege/bluetooth * @param[in] transfer_id The ID of transfer * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @see bt_opp_server_accept() */ @@ -2423,13 +2435,13 @@ int bt_opp_server_cancel_transfer(int transfer_id); * @privilege %http://tizen.org/privilege/bluetooth * @param[in] destination The destination path of file to be pushed * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed */ int bt_opp_server_set_destination(const char *destination); @@ -2441,11 +2453,11 @@ int bt_opp_server_set_destination(const char *destination); * You must free all resources of the Bluetooth service by calling bt_opp_client_deinitialize() \n * if Bluetooth OPP service is no longer needed. * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_RESOURCE_BUSY Device or resource busy - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_RESOURCE_BUSY Device or resource busy + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @see bt_opp_client_deinitialize() */ @@ -2456,10 +2468,10 @@ int bt_opp_client_initialize(void); * @brief Deinitializes the Bluetooth OPP client. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @see bt_opp_client_initialize() */ @@ -2471,12 +2483,12 @@ int bt_opp_client_deinitialize(void); * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @param[in] file The path of file to be pushed * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @see bt_opp_client_clear_files() * @see bt_opp_client_push_files() @@ -2488,11 +2500,11 @@ int bt_opp_client_add_file(const char *file); * @brief Adds file to be pushed. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @see bt_opp_client_add_file() * @see bt_opp_client_push_files() @@ -2517,14 +2529,14 @@ int bt_opp_client_clear_files(void); * @param[in] finished_cb The callback called when the push request is finished * @param[in] user_data The user data to be passed to the callback function * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOW_IN_PROGRESS Operation now in progress - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_NOW_IN_PROGRESS Operation now in progress * * @see bt_opp_client_initialize() * @see bt_opp_client_cancel_push() @@ -2542,12 +2554,12 @@ int bt_opp_client_push_files(const char *remote_address, * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre bt_opp_client_push_files() must be called. * @post bt_opp_client_push_finished_cb() will be invoked with result #BT_ERROR_CANCELLED, @@ -2575,11 +2587,11 @@ int bt_opp_client_cancel_push(void); * @param[in] connection_cb The callback called when the connection state is changed * @param[in] user_data The user data to be passed to the callback function * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -2591,10 +2603,10 @@ int bt_hid_host_initialize(bt_hid_host_connection_state_changed_cb connection_cb * @brief Deinitializes the Bluetooth HID (Human Interface Device) Host. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth HID service must be initialized with bt_hid_host_initialize(). * @see bt_hid_host_initialize() @@ -2608,13 +2620,13 @@ int bt_hid_host_deinitialize(void); * @privilege %http://tizen.org/privilege/bluetooth * @param[in] remote_address The remote address * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The local device must be bonded with the remote device by bt_device_create_bond(). * @pre The Bluetooth HID service must be initialized with bt_hid_host_initialize(). @@ -2631,14 +2643,14 @@ int bt_hid_host_connect(const char *remote_address); * @privilege %http://tizen.org/privilege/bluetooth * @param[in] remote_address The remote address * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The remote device must be connected by bt_hid_host_connect(). * @post bt_hid_host_connection_state_changed_cb() will be invoked. @@ -2665,14 +2677,14 @@ int bt_hid_host_disconnect(const char *remote_address); * @param[in] callback The callback called when the connection state is changed * @param[in] user_data The user data to be passed to the callback function * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled * @retval #BT_ERROR_NOW_IN_PROGRESS Already activated - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -2691,13 +2703,13 @@ int bt_hid_device_activate(bt_hid_device_connection_state_changed_cb callback, v * @remarks This function must be called to deregister the HID UUID. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_NOT_IN_PROGRESS Not activated - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NOT_IN_PROGRESS Not activated + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -2718,15 +2730,15 @@ int bt_hid_device_deactivate(void); * @param[in] remote_address The remote device's address. * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_NOT_IN_PROGRESS Not activated - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_ALREADY_DONE Already connected - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NOT_IN_PROGRESS Not activated + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_ALREADY_DONE Already connected * * @pre The Bluetooth service must be initialized with bt_initialize(). * @pre The local device must be bonded with the remote device by bt_device_create_bond(). @@ -2745,14 +2757,14 @@ int bt_hid_device_connect(const char *remote_address); * * @param[in] remote_address The remote device's address. * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -2773,12 +2785,12 @@ int bt_hid_device_disconnect(const char *remote_address); * * @return the number of bytes written (zero indicates nothing was written). * @retval On error, -1 is returned, and errno is set appropriately. See write 2 man page. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The HID connection must be established. * @see bt_hid_device_connection_state_changed_cb() @@ -2799,12 +2811,12 @@ int bt_hid_device_send_mouse_event(const char *remote_address, * * @return the number of bytes written (zero indicates nothing was written). * @retval On error, -1 is returned, and errno is set appropriately. See write 2 man page. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The HID connection must be established. * @see bt_hid_device_connection_state_changed_cb() @@ -2821,10 +2833,10 @@ int bt_hid_device_send_key_event(const char *remote_address, * @param[in] callback The callback function to be set when data is received. * @param[in] user_data The user data to be passed to the callback. * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @see bt_hid_device_connection_state_changed_cb() */ @@ -2837,9 +2849,9 @@ int bt_hid_device_set_data_received_cb(bt_hid_device_data_received_cb callback, * @since_tizen @if WEARABLE 3.0 @endif * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @see bt_hid_device_connection_state_changed_cb() */ @@ -2861,13 +2873,12 @@ int bt_hid_device_unset_data_received_cb(void); * * @return the number of bytes written (zero indicates nothing was written). * @retval On error, -1 is returned, and errno is set appropriately. See write 2 man page. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The HID connection must be established. * @see bt_hid_device_connection_state_changed_cb() @@ -2885,10 +2896,10 @@ int bt_hid_device_reply_to_report(const char *remote_address, * You must free all resources of the this service by calling bt_audio_deinitialize() \n * if Bluetooth profiles related with audio service is no longer needed. * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -2901,10 +2912,10 @@ int bt_audio_initialize(void); * @brief Deinitializes the Bluetooth profiles related with audio. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth audio service must be initialized with bt_audio_initialize(). * @see bt_audio_initialize() @@ -2923,13 +2934,13 @@ int bt_audio_deinitialize(void); * @param[in] remote_address The remote address * @param[in] type The type of audio profile * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * @pre The Bluetooth audio service must be initialized with bt_audio_initialize(). * @pre The local device must be bonded with the remote device by bt_device_create_bond(). @@ -2950,13 +2961,13 @@ int bt_audio_connect(const char *remote_address, bt_audio_profile_type_e type); * @param[in] remote_address The remote address * @param[in] type The type of audio profile * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The remote device must be connected by bt_audio_connect(). * @post bt_audio_connection_state_changed_cb() will be invoked. @@ -2967,15 +2978,15 @@ int bt_audio_disconnect(const char *remote_address, bt_audio_profile_type_e type /** * @ingroup CAPI_NETWORK_BLUETOOTH_AUDIO_MODULE - * @brief Registers a callback function that will be invoked when the connection state is changed. + * @brief Registers a callback function that will be invoked when the connection state is changed. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth audio service must be initialized with bt_audio_initialize(). * @see bt_audio_initialize() @@ -2985,12 +2996,12 @@ int bt_audio_set_connection_state_changed_cb(bt_audio_connection_state_changed_c /** * @ingroup CAPI_NETWORK_BLUETOOTH_AUDIO_MODULE - * @brief Unregisters a callback function that will be invoked when the connection state is changed. + * @brief Unregisters a callback function that will be invoked when the connection state is changed. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth audio service must be initialized with bt_audio_initialize(). * @see bt_audio_initialize() @@ -3009,11 +3020,11 @@ int bt_audio_unset_connection_state_changed_cb(void); * @param[in] callback The callback function called when the connection state is changed * @param[in] user_data The user data to be passed to the callback function * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -3026,9 +3037,9 @@ int bt_avrcp_target_initialize(bt_avrcp_target_connection_state_changed_cb callb * @brief Deinitializes the Bluetooth AVRCP (Audio/Video Remote Control Profile) target service. * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth audio service must be initialized with bt_avrcp_target_initialize(). * @see bt_avrcp_target_initialize() @@ -3042,15 +3053,15 @@ int bt_avrcp_target_deinitialize(void); * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] state The state of equalizer - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3065,15 +3076,15 @@ int bt_avrcp_target_notify_equalizer_state(bt_avrcp_equalizer_state_e state); * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] mode The repeat mode - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3088,15 +3099,15 @@ int bt_avrcp_target_notify_repeat_mode(bt_avrcp_repeat_mode_e mode); * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] mode The repeat mode - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3111,15 +3122,15 @@ int bt_avrcp_target_notify_shuffle_mode(bt_avrcp_shuffle_mode_e mode); * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] mode The scan mode - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3134,15 +3145,15 @@ int bt_avrcp_target_notify_scan_mode(bt_avrcp_scan_mode_e mode); * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] state The player state - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3157,15 +3168,15 @@ int bt_avrcp_target_notify_player_state(bt_avrcp_player_state_e state); * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] position The current position in milliseconds - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3186,15 +3197,15 @@ int bt_avrcp_target_notify_position(unsigned int position); * @param[in] track_num The track number * @param[in] total_tracks The number of all tracks * @param[in] duration The duration of track in milliseconds - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3204,15 +3215,15 @@ int bt_avrcp_target_notify_track(const char *title, const char *artist, const ch /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Registers a callback function that will be invoked when the equalizer state is changed. (e.g., by a TV remote control or other input devices). + * @brief Registers a callback function that will be invoked when the equalizer state is changed. (e.g., by a TV remote control or other input devices). * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3223,12 +3234,12 @@ int bt_avrcp_set_equalizer_state_changed_cb(bt_avrcp_equalizer_state_changed_cb /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Unregisters a callback function that will be invoked when the equalizer state is changed. (e.g., by a TV remote control or other input devices). + * @brief Unregisters a callback function that will be invoked when the equalizer state is changed. (e.g., by a TV remote control or other input devices). * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3239,15 +3250,15 @@ int bt_avrcp_unset_equalizer_state_changed_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Registers a callback function that will be invoked when the repeat mode is changed. (e.g., by a TV remote control or other input devices). + * @brief Registers a callback function that will be invoked when the repeat mode is changed. (e.g., by a TV remote control or other input devices). * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3258,12 +3269,12 @@ int bt_avrcp_set_repeat_mode_changed_cb(bt_avrcp_repeat_mode_changed_cb callback /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Unregisters a callback function that will be invoked when the repeat mode is changed. (e.g., by a TV remote control or other input devices). + * @brief Unregisters a callback function that will be invoked when the repeat mode is changed. (e.g., by a TV remote control or other input devices). * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3274,15 +3285,15 @@ int bt_avrcp_unset_repeat_mode_changed_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Registers a callback function that will be invoked when the shuffle mode is changed. (e.g., by a TV remote control or other input devices). + * @brief Registers a callback function that will be invoked when the shuffle mode is changed. (e.g., by a TV remote control or other input devices). * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3293,12 +3304,12 @@ int bt_avrcp_set_shuffle_mode_changed_cb(bt_avrcp_shuffle_mode_changed_cb callba /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Unregisters a callback function that will be invoked when the shuffle mode is changed. (e.g., by a TV remote control or other input devices). + * @brief Unregisters a callback function that will be invoked when the shuffle mode is changed. (e.g., by a TV remote control or other input devices). * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3309,15 +3320,15 @@ int bt_avrcp_unset_shuffle_mode_changed_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Registers a callback function that will be invoked when the scan mode is changed. (e.g., by a TV remote control or other input devices). + * @brief Registers a callback function that will be invoked when the scan mode is changed. (e.g., by a TV remote control or other input devices). * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3328,12 +3339,12 @@ int bt_avrcp_set_scan_mode_changed_cb(bt_avrcp_scan_mode_changed_cb callback, vo /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Unregisters a callback function that will be invoked when the scan mode is changed. (e.g., by a TV remote control or other input devices). + * @brief Unregisters a callback function that will be invoked when the scan mode is changed. (e.g., by a TV remote control or other input devices). * @since_tizen @if WEARABLE 3.0 @else 2.4 @endif - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3344,15 +3355,15 @@ int bt_avrcp_unset_scan_mode_changed_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Registers a callback function that will be invoked when the song position is changed. (e.g., by a TV remote control or other input devices). + * @brief Registers a callback function that will be invoked when the song position is changed. (e.g., by a TV remote control or other input devices). * @since_tizen 3.0 * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3363,12 +3374,12 @@ int bt_avrcp_set_position_changed_cb(bt_avrcp_position_changed_cb callback, void /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Unregisters a callback function that will be invoked when the song position is changed. (e.g., by a TV remote control or other input devices). + * @brief Unregisters a callback function that will be invoked when the song position is changed. (e.g., by a TV remote control or other input devices). * @since_tizen 3.0 - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3379,15 +3390,15 @@ int bt_avrcp_unset_position_changed_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Registers a callback function that will be invoked when the Play status is changed. (e.g., by a TV remote control or other input devices). + * @brief Registers a callback function that will be invoked when the Play status is changed. (e.g., by a TV remote control or other input devices). * @since_tizen 3.0 * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3398,12 +3409,12 @@ int bt_avrcp_set_play_status_changed_cb(bt_avrcp_play_status_changed_cb callback /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Unregisters a callback function that will be invoked when the Play status is changed. (e.g., by a TV remote control or other input devices). + * @brief Unregisters a callback function that will be invoked when the Play status is changed. (e.g., by a TV remote control or other input devices). * @since_tizen 3.0 - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3414,15 +3425,15 @@ int bt_avrcp_unset_play_status_changed_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Registers a callback function that will be invoked when the track metadata is changed. (e.g., by a TV remote control or other input devices). + * @brief Registers a callback function that will be invoked when the track metadata is changed. (e.g., by a TV remote control or other input devices). * @since_tizen 3.0 * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3433,12 +3444,12 @@ int bt_avrcp_set_track_info_changed_cb(bt_avrcp_track_info_changed_cb callback, /** * @ingroup CAPI_NETWORK_BLUETOOTH_AVRCP_MODULE - * @brief Unregisters a callback function that will be invoked when the track metadata is changed. (e.g., by a TV remote control or other input devices). + * @brief Unregisters a callback function that will be invoked when the track metadata is changed. (e.g., by a TV remote control or other input devices). * @since_tizen 3.0 - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize(). * @see bt_avrcp_target_initialize() @@ -3457,11 +3468,11 @@ int bt_avrcp_unset_track_info_changed_cb(void); * @param[in] callback The callback function called when the connection state is changed * @param[in] user_data The user data to be passed to the callback function * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() * @see bt_avrcp_control_deinitialize() @@ -3473,9 +3484,9 @@ int bt_avrcp_control_initialize(bt_avrcp_control_connection_state_changed_cb cal * @brief Deinitializes the Bluetooth AVRCP (Audio/Video Remote Control Profile) controller service. * @since_tizen 3.0 * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * @pre The Bluetooth audio service must be initialized with bt_avrcp_control_initialize(). * @see bt_avrcp_control_initialize() */ @@ -3489,11 +3500,11 @@ int bt_avrcp_control_deinitialize(void); * @privilege %http://tizen.org/privilege/bluetooth * @param[in] remote_address The remote address * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * @pre The Bluetooth audio service must be initialized with bt_avrcp_control_initialize(). * @see bt_avrcp_control_initialize() */ @@ -3507,11 +3518,11 @@ int bt_avrcp_control_connect(const char *remote_address); * @privilege %http://tizen.org/privilege/bluetooth * @param[in] remote_address The remote address * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * @pre The Bluetooth audio service must be initialized with bt_avrcp_control_initialize(). * @see bt_avrcp_control_initialize() * @see bt_avrcp_control_connect() @@ -3526,14 +3537,14 @@ int bt_avrcp_control_disconnect(const char *remote_address); * @privilege %http://tizen.org/privilege/bluetooth * @param[in] cmd The commands, one of: Play, Pause, Next, Rewind. * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * @pre The Bluetooth audio service must be initialized with bt_avrcp_control_initialize(). * @see bt_avrcp_control_initialize() * @see bt_avrcp_control_connect() @@ -3547,15 +3558,15 @@ int bt_avrcp_control_send_player_command(bt_avrcp_player_command_e cmd); * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] state The new equalizer state, one of: ON, OFF - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3568,14 +3579,14 @@ int bt_avrcp_control_set_equalizer_state(bt_avrcp_equalizer_state_e state); * @brief Gets the the equalizer state of the remote device. * @since_tizen 3.0 * @param[out] state The equalizer state, one of: ON, OFF - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3590,15 +3601,15 @@ int bt_avrcp_control_get_equalizer_state(bt_avrcp_equalizer_state_e *state); * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] mode The new repeat mode, one of: OFF, SINGLE, ALL - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3611,14 +3622,14 @@ int bt_avrcp_control_set_repeat_mode(bt_avrcp_repeat_mode_e mode); * @brief Gets the repeat state of the remote device. * @since_tizen 3.0 * @param[out] mode The repeat mode, one of: OFF, SINGLE, ALL - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3633,15 +3644,15 @@ int bt_avrcp_control_get_repeat_mode(bt_avrcp_repeat_mode_e *mode); * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] mode The new shuffle mode, one of: OFF, GROUP, ALL - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3654,14 +3665,14 @@ int bt_avrcp_control_set_shuffle_mode(bt_avrcp_shuffle_mode_e mode); * @brief Gets the shuffle mode of the remote device. * @since_tizen 3.0 * @param[out] mode The shuffle mode, one of: OFF, GROUP, ALL - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3676,15 +3687,15 @@ int bt_avrcp_control_get_shuffle_mode(bt_avrcp_shuffle_mode_e *mode); * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] mode The new scan mode, one of: OFF, GROUP, ALL - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3697,14 +3708,14 @@ int bt_avrcp_control_set_scan_mode(bt_avrcp_scan_mode_e mode); * @brief Gets the scan mode of the remote device. * @since_tizen 3.0 * @param[out] mode The scan mode, one of: OFF, GROUP, ALL - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3717,14 +3728,14 @@ int bt_avrcp_control_get_scan_mode(bt_avrcp_scan_mode_e *mode); * @brief Gets the position of the song played by the remote device. * @since_tizen 3.0 * @param[out] position The position, in milliseconds - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3737,14 +3748,14 @@ int bt_avrcp_control_get_position(unsigned int *position); * @brief Gets the play status of the remote device. * @since_tizen 3.0 * @param[out] status The play status, one of: PLAYING, STOPPED... - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3758,14 +3769,14 @@ int bt_avrcp_control_get_play_status(bt_avrcp_player_state_e *status); * @since_tizen 3.0 * @remarks The @a track must be released using bt_avrcp_control_free_track_info(). * @param[out] track The track metadata. - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected * * @pre The remote device must be connected. * @see bt_avrcp_target_connection_state_changed_cb() @@ -3778,11 +3789,11 @@ int bt_avrcp_control_get_track_info(bt_avrcp_metadata_attributes_info_s **track) * @brief Frees the track metadata. * @since_tizen 3.0 * @param[in] track The track metadata. - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * @pre track should point to valid metadata address. * @see bt_avrcp_control_get_track_info() * @see bt_avrcp_target_initialize() @@ -3802,13 +3813,13 @@ int bt_avrcp_control_free_track_info(bt_avrcp_metadata_attributes_info_s *track) * For example, pulse oximeter is 0x1004 and blood pressure monitor is 0x1007. * @param[out] app_id The ID of application * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory + * @retval #BT_ERROR_NOT_ENABLED Not enabled * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @see bt_hdp_unregister_sink_app() @@ -3825,13 +3836,13 @@ int bt_hdp_register_sink_app(unsigned short data_type, char **app_id) TIZEN_DEPR * @remarks Deprecated, because of no usecase and supported devices. * @param[in] app_id The ID of application * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @see bt_hdp_register_sink_app() */ @@ -3848,14 +3859,14 @@ int bt_hdp_unregister_sink_app(const char *app_id) TIZEN_DEPRECATED_API; * @param[in] remote_address The remote address * @param[in] app_id The ID of application * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The Sink role of HDP must be registered with bt_hdp_register_sink_app(). * @pre The local device must be bonded with the remote device by bt_device_create_bond(). @@ -3877,15 +3888,15 @@ int bt_hdp_connect_to_source(const char *remote_address, const char *app_id) TIZ * @param[in] remote_address The remote address * @param[in] channel The connected data channel * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The remote device must be connected. * @post bt_hdp_disconnected_cb() will be invoked. @@ -3906,13 +3917,13 @@ int bt_hdp_disconnect(const char *remote_address, unsigned int channel) TIZEN_DE * @param[in] data The data to send * @param[in] size The size of data to send (byte) * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The remote device must be connected. * @see bt_hdp_data_received_cb() @@ -3924,17 +3935,17 @@ int bt_hdp_send_data(unsigned int channel, const char *data, unsigned int size) /** * @deprecated Deprecated since 5.0. * @ingroup CAPI_NETWORK_BLUETOOTH_HDP_MODULE - * @brief Registers a callback function that will be invoked when the connection state is changed. + * @brief Registers a callback function that will be invoked when the connection state is changed. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @remarks Deprecated, because of no usecase and supported devices. * @param[in] connected_cb The callback function called when a connection is established * @param[in] disconnected_cb The callback function called when a connection is disconnected * @param[in] user_data The user data to be passed to the callback function - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_hdp_unset_connection_state_changed_cb() @@ -3944,13 +3955,13 @@ int bt_hdp_set_connection_state_changed_cb(bt_hdp_connected_cb connected_cb, bt_ /** * @deprecated Deprecated since 5.0. * @ingroup CAPI_NETWORK_BLUETOOTH_HDP_MODULE - * @brief Unregisters a callback function that will be invoked when the connection state is changed. + * @brief Unregisters a callback function that will be invoked when the connection state is changed. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @remarks Deprecated, because of no usecase and supported devices. - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_hdp_set_connection_state_changed_cb() @@ -3960,16 +3971,16 @@ int bt_hdp_unset_connection_state_changed_cb(void) TIZEN_DEPRECATED_API; /** * @deprecated Deprecated since 5.0. * @ingroup CAPI_NETWORK_BLUETOOTH_HDP_MODULE - * @brief Registers a callback function that will be invoked when you receive the data. + * @brief Registers a callback function that will be invoked when you receive the data. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @remarks Deprecated, because of no usecase and supported devices. * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_hdp_unset_data_received_cb() @@ -3979,13 +3990,13 @@ int bt_hdp_set_data_received_cb(bt_hdp_data_received_cb callback, void *user_dat /** * @deprecated Deprecated since 5.0. * @ingroup CAPI_NETWORK_BLUETOOTH_HDP_MODULE - * @brief Unregisters a callback function that will be invoked when you receive the data. + * @brief Unregisters a callback function that will be invoked when you receive the data. * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * @remarks Deprecated, because of no usecase and supported devices. - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_hdp_set_data_received_cb() @@ -4004,10 +4015,10 @@ int bt_hdp_unset_data_received_cb(void) TIZEN_DEPRECATED_API; * @param[in] gatt_handle The handle of a characteristic or descriptor * @param[out] value The value of @a gatt_handle. It is a byte stream type. * @param[out] value_length The length of @a value - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter */ int bt_gatt_get_value(bt_gatt_h gatt_handle, char **value, int *value_length); @@ -4024,10 +4035,10 @@ int bt_gatt_get_value(bt_gatt_h gatt_handle, char **value, int *value_length); * @param[in] type The type of a saved value in @a gatt_handle * @param[in] offset The offset from where a value will be read from @a gatt_handle as an integer type * @param[out] value The integer type's value of @a gatt_handle - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter */ int bt_gatt_get_int_value(bt_gatt_h gatt_handle, bt_data_type_int_e type, int offset, int *value); @@ -4045,10 +4056,10 @@ int bt_gatt_get_int_value(bt_gatt_h gatt_handle, bt_data_type_int_e type, * @param[in] type The type of a saved value in @a gatt_handle * @param[in] offset The offset from where a value will be read from @a gatt_handle as an integer type * @param[out] value The float type's value of @a gatt_handle - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter */ int bt_gatt_get_float_value(bt_gatt_h gatt_handle, bt_data_type_float_e type, int offset, float *value); @@ -4065,11 +4076,11 @@ int bt_gatt_get_float_value(bt_gatt_h gatt_handle, bt_data_type_float_e type, * @param[in] gatt_handle The handle of a characteristic or descriptor * @param[in] value The value to be updated * @param[in] value_length The length of @a value - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_OPERATION_FAILED Operation failed */ int bt_gatt_set_value(bt_gatt_h gatt_handle, const char *value, int value_length); @@ -4086,11 +4097,11 @@ int bt_gatt_set_value(bt_gatt_h gatt_handle, const char *value, int value_length * @param[in] type @a value will be saved in @a gatt_handle as this type * @param[in] value The integer type's value to be updated * @param[in] offset The offset from where @a value will be saved in @a gatt_handle - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_OPERATION_FAILED Operation failed */ int bt_gatt_set_int_value(bt_gatt_h gatt_handle, bt_data_type_int_e type, int value, int offset); @@ -4109,11 +4120,11 @@ int bt_gatt_set_int_value(bt_gatt_h gatt_handle, bt_data_type_int_e type, * @param[in] mantissa The mantissa of float type's value to be updated * @param[in] exponent The exponent of float type's value to be updated * @param[in] offset The offset from where @a mantissa and @a exponent will be saved in @a gatt_handle - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_OPERATION_FAILED Operation failed */ int bt_gatt_set_float_value(bt_gatt_h gatt_handle, bt_data_type_float_e type, int mantissa, int exponent, int offset); @@ -4128,10 +4139,10 @@ int bt_gatt_set_float_value(bt_gatt_h gatt_handle, bt_data_type_float_e type, * * @param[in] gatt_handle The handle of a service, characteristic or descriptor * @param[out] uuid The string of the UUID of @a gatt_handle - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter */ int bt_gatt_get_uuid(bt_gatt_h gatt_handle, char **uuid); @@ -4142,10 +4153,10 @@ int bt_gatt_get_uuid(bt_gatt_h gatt_handle, char **uuid); * * @param[in] gatt_handle The GATT handle * @param[out] gatt_type The type of @a gatt_handle - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter */ int bt_gatt_get_type(bt_gatt_h gatt_handle, bt_gatt_type_e *gatt_type); @@ -4160,10 +4171,10 @@ int bt_gatt_get_type(bt_gatt_h gatt_handle, bt_gatt_type_e *gatt_type); * * @param[in] service The service's GATT handle * @param[out] client The GATT client handle which @a service belongs to - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_client_create() */ @@ -4181,11 +4192,11 @@ int bt_gatt_service_get_client(bt_gatt_h service, bt_gatt_client_h *client); * @param[in] service The service's GATT handle * @param[in] uuid The characteristic's GATT handle which has this UUID will be returned if it exists * @param[out] characteristic The characteristic's GATT handle which has @a uuid if it exists - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NO_DATA No data available - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NO_DATA No data available */ int bt_gatt_service_get_characteristic(bt_gatt_h service, const char *uuid, bt_gatt_h *characteristic); @@ -4198,10 +4209,10 @@ int bt_gatt_service_get_characteristic(bt_gatt_h service, const char *uuid, * @param[in] service The service's GATT handle * @param[in] callback The function to be invoked on each characteristic * @param[in] user_data The user data to be passed to @a callback function - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_foreach_cb() */ @@ -4220,11 +4231,11 @@ int bt_gatt_service_foreach_characteristics(bt_gatt_h service, * @param[in] service The service's GATT handle * @param[in] uuid The included service's GATT handle which has this UUID will be returned if it exists * @param[out] included_service The included service's GATT handle which has @a uuid if it exists - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NO_DATA No data available - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NO_DATA No data available */ int bt_gatt_service_get_included_service(bt_gatt_h service, const char *uuid, bt_gatt_h *included_service); @@ -4237,10 +4248,10 @@ int bt_gatt_service_get_included_service(bt_gatt_h service, const char *uuid, * @param[in] service The service's GATT handle * @param[in] callback The function to be invoked on each included service * @param[in] user_data The user data to be passed to the callback function - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_foreach_cb() */ @@ -4257,10 +4268,10 @@ int bt_gatt_service_foreach_included_services(bt_gatt_h service, * * @param[in] characteristic The characteristic's GATT handle * @param[out] service The service's GATT handle which @a characteristic belongs to - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter */ int bt_gatt_characteristic_get_service(bt_gatt_h characteristic, bt_gatt_h *service); @@ -4271,10 +4282,10 @@ int bt_gatt_characteristic_get_service(bt_gatt_h characteristic, bt_gatt_h *serv * * @param[in] characteristic The characteristic's GATT handle * @param[out] properties The properties which a characteristic's GATT handle has - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_property_e */ @@ -4287,10 +4298,10 @@ int bt_gatt_characteristic_get_properties(bt_gatt_h characteristic, int *propert * * @param[in] characteristic The characteristic's GATT handle * @param[out] write_type The write type of the specified characteristic - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_write_type_e */ @@ -4304,10 +4315,10 @@ int bt_gatt_characteristic_get_write_type(bt_gatt_h characteristic, * * @param[in] characteristic The characteristic's GATT handle * @param[in] write_type The write type to be updated - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_client_write_value() * @see bt_gatt_write_type_e @@ -4327,11 +4338,11 @@ int bt_gatt_characteristic_set_write_type(bt_gatt_h characteristic, * @param[in] characteristic The characteristic's GATT handle * @param[in] uuid The descriptor's GATT handle which has this UUID will be returned if it exists * @param[out] descriptor The descriptor's GATT handle which has @a uuid if it exists - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NO_DATA No data available - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NO_DATA No data available */ int bt_gatt_characteristic_get_descriptor(bt_gatt_h characteristic, const char *uuid, bt_gatt_h *descriptor); @@ -4344,10 +4355,10 @@ int bt_gatt_characteristic_get_descriptor(bt_gatt_h characteristic, const char * * @param[in] characteristic The characteristic's GATT handle * @param[in] callback The function to be invoked on each descriptor * @param[in] user_data The user data to be passed to @a callback function - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_foreach_cb() */ @@ -4364,10 +4375,10 @@ int bt_gatt_characteristic_foreach_descriptors(bt_gatt_h characteristic, * * @param[in] descriptor The descriptor's GATT handle * @param[out] characteristic The characteristic's GATT handle which @a descriptor belongs to - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter */ int bt_gatt_descriptor_get_characteristic(bt_gatt_h descriptor, bt_gatt_h *characteristic); @@ -4380,12 +4391,12 @@ int bt_gatt_descriptor_get_characteristic(bt_gatt_h descriptor, bt_gatt_h *chara * * @param[in] remote_address The address of the remote device * @param[out] client The created GATT client's handle - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory * @retval #BT_ERROR_ALREADY_DONE Operation is already done - * @retval #BT_ERROR_NOT_SUPPORTED Not supported * * @see bt_gatt_client_destroy() */ @@ -4399,10 +4410,10 @@ int bt_gatt_client_create(const char *remote_address, bt_gatt_client_h *client); * @remarks All related service, characteristic and descriptor's GATT handles are freed also. * * @param[in] client The GATT client's handle - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_client_create() */ @@ -4415,10 +4426,10 @@ int bt_gatt_client_destroy(bt_gatt_client_h client); * * @param[in] client The created GATT client's handle * @param[out] remote_address The address of the remote device which is associated with @a client - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_client_create() */ @@ -4435,15 +4446,15 @@ int bt_gatt_client_get_remote_address(bt_gatt_client_h client, * @param[in] gatt_handle The GATT handle of a characteristic or descriptor * @param[in] callback When a read request is completed, this callback function will be called * @param[in] user_data The user data to be passed to @a callback function - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOW_IN_PROGRESS Operation now in progress - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_NOW_IN_PROGRESS Operation now in progress * * @see bt_gatt_client_create() * @see bt_gatt_client_request_completed_cb() @@ -4461,15 +4472,15 @@ int bt_gatt_client_read_value(bt_gatt_h gatt_handle, * @param[in] gatt_handle The GATT handle of a characteristic or descriptor * @param[in] callback When a write request is completed, this callback function will be called * @param[in] user_data The user data to be passed to @a callback function - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOW_IN_PROGRESS Operation now in progress - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_NOW_IN_PROGRESS Operation now in progress * * @see bt_gatt_client_create() * @see bt_gatt_characteristic_set_write_type() @@ -4492,13 +4503,13 @@ int bt_gatt_client_write_value(bt_gatt_h gatt_handle, * @param[in] mtu The new MTU value * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * @see bt_gatt_client_set_att_mtu_changed_cb() */ int bt_gatt_client_request_att_mtu_change(bt_gatt_client_h client, unsigned int mtu); @@ -4512,28 +4523,28 @@ int bt_gatt_client_request_att_mtu_change(bt_gatt_client_h client, unsigned int * @param[out] mtu The MTU value set for a connection * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported - * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED Remote device is not connected */ int bt_gatt_client_get_att_mtu(bt_gatt_client_h client, unsigned int *mtu); /** * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_CLIENT_MODULE - * @brief Registers a callback function to be invoked when the ATT MTU is changed. + * @brief Registers a callback function to be invoked when the ATT MTU is changed. * @since_tizen 4.0 * @param[in] client The created GATT client's handle * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @post bt_device_connection_state_changed_cb() will be invoked. @@ -4549,10 +4560,10 @@ int bt_gatt_client_set_att_mtu_changed_cb(bt_gatt_client_h client, bt_gatt_clien * @since_tizen 4.0 * @param[in] client The created GATT client's handle * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -4563,17 +4574,17 @@ int bt_gatt_client_unset_att_mtu_changed_cb(bt_gatt_client_h client); /** * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_CLIENT_MODULE - * @brief Registers a callback function to be invoked when the characteristic value is changed on the remote device. + * @brief Registers a callback function to be invoked when the characteristic value is changed on the remote device. * @since_tizen 2.3.1 * * @param[in] characteristic The characteristic's GATT handle * @param[in] callback The callback to be invoked when the value is changed and it is informed * @param[in] user_data The user data to be passed to @a callback function - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @see bt_gatt_client_characteristic_value_changed_cb() * @see bt_gatt_client_unset_characteristic_value_changed_cb() @@ -4584,15 +4595,15 @@ int bt_gatt_client_set_characteristic_value_changed_cb(bt_gatt_h characteristic, /** * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_CLIENT_MODULE - * @brief Unregisters a callback function to be invoked when the characteristic value is changed on the remote device. + * @brief Unregisters a callback function to be invoked when the characteristic value is changed on the remote device. * @since_tizen 2.3.1 * * @param[in] characteristic The characteristic's GATT handle, whose value change will not be informed - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @see bt_gatt_client_set_characteristic_value_changed_cb() */ @@ -4610,11 +4621,11 @@ int bt_gatt_client_unset_characteristic_value_changed_cb(bt_gatt_h characteristi * @param[in] client The GATT client's handle * @param[in] uuid The service's GATT handle which has this UUID will be returned if it exists * @param[out] service The service's GATT handle which has @a uuid if it exists - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NO_DATA No data available - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NO_DATA No data available */ int bt_gatt_client_get_service(bt_gatt_client_h client, const char *uuid, bt_gatt_h *service); @@ -4627,10 +4638,10 @@ int bt_gatt_client_get_service(bt_gatt_client_h client, const char *uuid, * @param[in] client The GATT client's handle * @param[in] callback The function to be invoked on each service * @param[in] user_data The user data to be passed to @a callback function - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_foreach_cb() */ @@ -4639,16 +4650,16 @@ int bt_gatt_client_foreach_services(bt_gatt_client_h client, /** * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_CLIENT_MODULE - * @brief Registers a callback function to be invoked when service is changed from a remote device(GATT server). + * @brief Registers a callback function to be invoked when service is changed from a remote device(GATT server). * @since_tizen 3.0 * * @param[in] client The GATT client's handle * @param[in] callback The callback to be invoked * @param[in] user_data The user data to be passed to @a callback function - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_client_unset_service_changed_cb() */ @@ -4657,14 +4668,14 @@ int bt_gatt_client_set_service_changed_cb(bt_gatt_client_h client, /** * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_CLIENT_MODULE - * @brief Unregisters a callback function. + * @brief Unregisters a callback function. * @since_tizen 3.0 * * @param[in] client The GATT client's handle - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_client_set_service_changed_cb() */ @@ -4683,13 +4694,13 @@ int bt_gatt_client_unset_service_changed_cb(bt_gatt_client_h client); * @param[in] auto_connect The flag of the auto connection. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported * * @pre The Bluetooth service must be initialized with bt_initialize(). * @pre The remote device must support le connection. @@ -4713,13 +4724,13 @@ int bt_gatt_connect(const char *address, bool auto_connect); * @param[in] address The address of the remote Bluetooth device * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported * * @post This function invokes bt_gatt_connection_state_changed_cb(). * @@ -4740,10 +4751,10 @@ int bt_gatt_disconnect(const char *address); * @param[in] user_data The user data to be passed to the callback function. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @see bt_gatt_connect() * @see bt_gatt_disconnect() @@ -4757,9 +4768,9 @@ int bt_gatt_set_connection_state_changed_cb(bt_gatt_connection_state_changed_cb * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @see bt_gatt_connect() * @see bt_gatt_disconnect() @@ -4773,10 +4784,10 @@ int bt_gatt_unset_connection_state_changed_cb(void); * @since_tizen 3.0 * * @param[in] gatt_handle The handle of service - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_service_create() */ @@ -4788,10 +4799,10 @@ int bt_gatt_service_destroy(bt_gatt_h gatt_handle); * @since_tizen 3.0 * * @param[in] gatt_handle The handle of characteristic - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_characteristic_create() */ @@ -4803,10 +4814,10 @@ int bt_gatt_characteristic_destroy(bt_gatt_h gatt_handle); * @since_tizen 3.0 * * @param[in] gatt_handle The handle of descriptor - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_descriptor_create() */ @@ -4821,10 +4832,10 @@ int bt_gatt_descriptor_destroy(bt_gatt_h gatt_handle); * * @param[in] gatt_handle The handle of a characteristic * @param[out] permissions The permissions which a characteristic's GATT handle has - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_characteristic_create() * @see bt_gatt_permission_e @@ -4840,10 +4851,10 @@ int bt_gatt_characteristic_get_permissions(bt_gatt_h gatt_handle, int *permissio * * @param[in] gatt_handle The handle of a descriptor * @param[out] permissions The permissions which a descriptor's GATT handle has - * @return 0 on success, otherwise a negative error value - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_descriptor_create() * @see bt_gatt_permission_e @@ -4860,11 +4871,11 @@ int bt_gatt_descriptor_get_permissions(bt_gatt_h gatt_handle, int *permissions); * @param[in] uuid The UUID of the service * @param[in] type The type of the service * @param[out] service The GATT handle of the created service - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory * * @see bt_gatt_service_destroy() */ @@ -4878,10 +4889,10 @@ int bt_gatt_service_create(const char *uuid, bt_gatt_service_type_e type, * * @param[in] service The service's GATT handle * @param[in] characteristic The characteristic's GATT handle to be added - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_service_create() * @see bt_gatt_characteristic_create() @@ -4896,10 +4907,10 @@ int bt_gatt_service_add_characteristic(bt_gatt_h service, * * @param[in] service The service's GATT handle * @param[in] included_service The service's GATT handle to be added as included service - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_service_create() */ @@ -4915,10 +4926,10 @@ int bt_gatt_service_add_included_service(bt_gatt_h service, * * @param[in] service The service's GATT handle * @param[out] server The GATT server handle to which @a service belongs - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_server_create() * @see bt_gatt_service_create() @@ -4941,11 +4952,11 @@ int bt_gatt_service_get_server(bt_gatt_h service, bt_gatt_server_h *server); * @param[in] value The value(byte stream) of the characteristic * @param[in] value_length The length of @a value * @param[out] characteristic The GATT handle of the created characteristic - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory * * @see bt_gatt_characteristic_destroy() */ @@ -4960,10 +4971,10 @@ int bt_gatt_characteristic_create(const char *uuid, int permissions, * * @param[in] characteristic The GATT handle of the characteristic * @param[in] descriptor The descriptor's GATT handle to be added - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_characteristic_create() * @see bt_gatt_descriptor_create() @@ -4984,11 +4995,11 @@ int bt_gatt_characteristic_add_descriptor(bt_gatt_h characteristic, * @param[in] value The value(byte stream) associated with the descriptor * @param[in] value_length The length of @a value * @param[out] descriptor The GATT handle of the created characteristic descriptor - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory * * @see bt_gatt_descriptor_destroy() */ @@ -5001,14 +5012,14 @@ int bt_gatt_descriptor_create(const char *uuid, int permissions, * @brief Initializes the GATT Server. * @since_tizen 3.0 * - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * - * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. - * @see bt_gatt_server_deinitialize() + * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. + * @see bt_gatt_server_deinitialize() */ int bt_gatt_server_initialize(void); @@ -5017,14 +5028,14 @@ int bt_gatt_server_initialize(void); * @brief DeInitializes the GATT server. * @since_tizen 3.0 * - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * - * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. - * @see bt_gatt_server_initialize() + * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. + * @see bt_gatt_server_initialize() */ int bt_gatt_server_deinitialize(void); @@ -5036,11 +5047,11 @@ int bt_gatt_server_deinitialize(void); * @remarks The @a server handle should be destroyed by using bt_gatt_server_destroy(). * * @param[out] server The GATT server's handle - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory * * @see bt_gatt_server_destroy() */ @@ -5054,10 +5065,10 @@ int bt_gatt_server_create(bt_gatt_server_h *server); * @remarks All registered services to GATT server are unregistered. * * @param[in] server The GATT server's handle - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_server_create() */ @@ -5065,16 +5076,16 @@ int bt_gatt_server_destroy(bt_gatt_server_h server); /** * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_SERVER_MODULE - * @brief Registers a callback function to be invoked when a read request for a specified characteristic or descriptor is issued from a remote device(GATT client). + * @brief Registers a callback function to be invoked when a read request for a specified characteristic or descriptor is issued from a remote device(GATT client). * @since_tizen 3.0 * * @param[in] gatt_handle The GATT handle of a characteristic or descriptor * @param[in] callback The callback to be invoked * @param[in] user_data The user data to be passed to @a callback function - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_server_read_value_requested_cb() * @see bt_gatt_server_send_response() @@ -5085,16 +5096,16 @@ int bt_gatt_server_set_read_value_requested_cb(bt_gatt_h gatt_handle, /** * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_SERVER_MODULE - * @brief Registers a callback function to be invoked when the remote device enables or disables the Notification/Indication for particular characteristics. + * @brief Registers a callback function to be invoked when the remote device enables or disables the Notification/Indication for particular characteristics. * @since_tizen 3.0 * * @param[in] gatt_handle The GATT handle of a characteristic * @param[in] callback The callback to be invoked * @param[in] user_data The user data to be passed to @a callback function - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_server_characteristic_notification_state_changed_cb() */ @@ -5104,16 +5115,16 @@ int bt_gatt_server_set_characteristic_notification_state_change_cb(bt_gatt_h gat /** * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_SERVER_MODULE - * @brief Registers a callback function to be invoked when a value of a characteristic or descriptor has been changed by a remote device(GATT client)'s request. + * @brief Registers a callback function to be invoked when a value of a characteristic or descriptor has been changed by a remote device(GATT client)'s request. * @since_tizen 3.0 * * @param[in] gatt_handle The GATT handle of a characteristic or descriptor * @param[in] callback The callback to be invoked * @param[in] user_data The user data to be passed to @a callback function - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_server_write_value_requested_cb() */ @@ -5123,20 +5134,20 @@ int bt_gatt_server_set_write_value_requested_cb(bt_gatt_h gatt_handle, /** * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_SERVER_MODULE - * @brief Registers a specified service to the specified GATT server that the local device is hosting. + * @brief Registers a specified service to the specified GATT server that the local device is hosting. * @since_tizen 3.0 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * * @param[in] server The GATT server that local device is hosting * @param[in] service The service, which needs to be registered in @a server - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * @retval #BT_ERROR_ALREADY_DONE Operation is already done - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported * * @see bt_gatt_server_create() * @see bt_gatt_service_create() @@ -5147,19 +5158,19 @@ int bt_gatt_server_register_service(bt_gatt_server_h server, bt_gatt_h service); /** * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_SERVER_MODULE - * @brief Unregisters a specified service from the specified GATT server that the local device is hosting. + * @brief Unregisters a specified service from the specified GATT server that the local device is hosting. * @since_tizen 3.0 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * * @param[in] server The GATT server that local device is hosting * @param[in] service The service, which needs to be unregistered from @a server - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #BT_ERROR_SERVICE_NOT_FOUND Service not found - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported * * @see bt_gatt_server_register_service() */ @@ -5167,17 +5178,17 @@ int bt_gatt_server_unregister_service(bt_gatt_server_h server, bt_gatt_h service /** * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_SERVER_MODULE - * @brief Unregisters all services from the specified GATT server that the local device is hosting. + * @brief Unregisters all services from the specified GATT server that the local device is hosting. * @since_tizen 3.0 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * * @param[in] server The GATT server that local device is hosting - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_server_register_service() */ @@ -5185,17 +5196,17 @@ int bt_gatt_server_unregister_all_services(bt_gatt_server_h server); /** * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_SERVER_MODULE - * @brief Registers the application along with the GATT services of the application it is hosting. + * @brief Registers the application along with the GATT services of the application it is hosting. * @since_tizen 3.0 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * @retval #BT_ERROR_ALREADY_DONE Operation is already done - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported * * @see bt_gatt_server_initialize() * @see bt_gatt_server_create() @@ -5219,11 +5230,11 @@ int bt_gatt_server_start(void); * @param[in] resp_status The application error if any occurred or BT_ERROR_NONE for successful. * @param[in] value The value to be sent. It will be sent from @a offset. If it is NULL, a requested GATT handle's value will be sent from @a offset. * @param[in] value_length Value Length - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_server_read_value_requested_cb() */ @@ -5239,10 +5250,10 @@ int bt_gatt_server_send_response(int request_id, bt_gatt_att_request_type_e requ * @param[in] callback The function to be invoked on each remote device when a sending operation is done * @param[in] device_address Remote device address to send notify or indicate and if set to NULL then notify/indicate all is enabled. * @param[in] user_data The user data to be passed to @a callback function - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_server_notification_sent_cb() */ @@ -5262,11 +5273,11 @@ int bt_gatt_server_notify_characteristic_changed_value(bt_gatt_h characteristic, * @param[in] server The GATT server's handle * @param[in] uuid The service's GATT handle which has this UUID will be returned if it exists * @param[out] service The service's GATT handle which has @a uuid if it exists - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NO_DATA No data available - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NO_DATA No data available */ int bt_gatt_server_get_service(bt_gatt_server_h server, const char *uuid, bt_gatt_h *service); @@ -5279,10 +5290,10 @@ int bt_gatt_server_get_service(bt_gatt_server_h server, const char *uuid, * @param[in] server The GATT server's handle * @param[in] callback The function to be invoked on each service * @param[in] user_data The user data to be passed to @a callback function - * @return 0 on success, otherwise a negative error value + * @return 0 on success, otherwise a negative error value * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter * * @see bt_gatt_foreach_cb() */ @@ -5299,12 +5310,12 @@ int bt_gatt_server_foreach_services(bt_gatt_server_h server, * @param[out] mtu The MTU value for a connection * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_SUPPORTED Not supported - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed */ int bt_gatt_server_get_device_mtu(const char *remote_address, unsigned int *mtu); @@ -5318,11 +5329,11 @@ int bt_gatt_server_get_device_mtu(const char *remote_address, unsigned int *mtu) * @remarks This function must be called to initialize Bluetooth PBAP client. You must free all resources of the Bluetooth service \n * by calling bt_pbap_client_deinitialize() if Bluetooth PBAP Client is no longer needed. * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of the local Bluetooth adapter must be #BT_ADAPTER_ENABLED. * @@ -5345,14 +5356,14 @@ int bt_pbap_client_initialize(void); * @since_tizen 3.0 * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of the local Bluetooth adapter must be #BT_ADAPTER_ENABLED. - * The PBAP client must be initialized with bt_pbap_client_initialize(). + * The PBAP client must be initialized with bt_pbap_client_initialize(). * @see bt_pbap_client_initialize() * @see bt_pbap_client_connect() * @see bt_pbap_client_disconnect() @@ -5367,15 +5378,15 @@ int bt_pbap_client_deinitialize(void); /** * @WEARABLE_ONLY * @ingroup CAPI_NETWORK_BLUETOOTH_PBAP_MODULE - * @brief Registers a callback function that will be invoked when the connection state is changed. + * @brief Registers a callback function that will be invoked when the connection state is changed. * @since_tizen 3.0 * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The PBAP client must be initialized with bt_pbap_client_initialize(). * @see bt_pbap_client_initialize() @@ -5385,12 +5396,12 @@ int bt_pbap_client_set_connection_state_changed_cb(bt_pbap_connection_state_chan /** * @WEARABLE_ONLY * @ingroup CAPI_NETWORK_BLUETOOTH_PBAP_MODULE - * @brief Unregisters a callback function that will be invoked when the connection state is changed. + * @brief Unregisters a callback function that will be invoked when the connection state is changed. * @since_tizen 3.0 - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The PBAP client must be initialized with bt_pbap_client_initialize(). * @see bt_pbap_client_initialize() @@ -5408,14 +5419,14 @@ int bt_pbap_client_unset_connection_state_changed_cb(void); * @param[in] address The other device's address * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported - * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is in progress + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is in progress * * @pre The state of the local Bluetooth adapter must be #BT_ADAPTER_ENABLED. * @pre The PBAP client must be initialized with bt_pbap_client_initialize(). @@ -5437,14 +5448,14 @@ int bt_pbap_client_connect(const char *address); * @param[in] address The other device's address * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported - * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is in progress + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed + * @retval #BT_ERROR_NOW_IN_PROGRESS Operation is in progress * * @pre The state of the local Bluetooth adapter must be #BT_ADAPTER_ENABLED. * @pre The PBAP client must be initialized with bt_pbap_client_initialize(). @@ -5470,13 +5481,13 @@ int bt_pbap_client_disconnect(const char *address); * @param[in] user_data Data to be passed to the PBAP phone book size callback. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of the local Bluetooth adapter must be #BT_ADAPTER_ENABLED. * @pre The PBAP client must be initialized with bt_pbap_client_initialize(). @@ -5512,13 +5523,13 @@ int bt_pbap_client_get_phone_book_size(const char *address, * @param[in] user_data Data to be passed to the PBAP phone book pulling callback. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of the local Bluetooth adapter must be #BT_ADAPTER_ENABLED. * @pre The PBAP client must be initialized with bt_pbap_client_initialize(). @@ -5555,13 +5566,13 @@ int bt_pbap_client_get_phone_book(const char *address, * @param[in] user_data Data to be passed to the PBAP phone book pulling callback. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of the local Bluetooth adapter must be #BT_ADAPTER_ENABLED. * @pre The PBAP client must be initialized with bt_pbap_client_initialize(). @@ -5600,13 +5611,13 @@ int bt_pbap_client_get_list(const char *address, * @param[in] user_data Data to be passed to the PBAP phone book Pulling callback. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of the local Bluetooth adapter must be #BT_ADAPTER_ENABLED. * @pre The PBAP client must be initialized with bt_pbap_client_initialize(). @@ -5645,13 +5656,13 @@ int bt_pbap_client_pull_vcard(const char *address, * @param[in] user_data Data to be passed to the PBAP phone book pulling callback. * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of the local Bluetooth adapter must be #BT_ADAPTER_ENABLED. * @pre The PBAP client must be initialized with bt_pbap_client_initialize(). @@ -5689,11 +5700,11 @@ int bt_pbap_client_search_phone_book(const char *address, * @param[out] scan_filter The scan filter handle * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_OUT_OF_MEMORY Out of memory * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -5709,10 +5720,10 @@ int bt_adapter_le_scan_filter_create(bt_scan_filter_h *scan_filter); * @param[in] scan_filter The scan filter handle * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -5729,10 +5740,10 @@ int bt_adapter_le_scan_filter_destroy(bt_scan_filter_h scan_filter); * @param[in] address The device address by which advertisements will be filtered * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -5749,10 +5760,10 @@ int bt_adapter_le_scan_filter_set_device_address(bt_scan_filter_h scan_filter, c * @param[in] name The device name by which advertisements will be filtered * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -5769,10 +5780,10 @@ int bt_adapter_le_scan_filter_set_device_name(bt_scan_filter_h scan_filter, cons * @param[in] uuid The service UUID by which advertisements will be filtered * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -5796,10 +5807,10 @@ int bt_adapter_le_scan_filter_set_service_uuid(bt_scan_filter_h scan_filter, con * @param[in] mask The mask to filter advertisements * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -5817,10 +5828,10 @@ int bt_adapter_le_scan_filter_set_service_uuid_with_mask(bt_scan_filter_h scan_f * @param[in] uuid The service solicitation UUID by which advertisements will be filtered * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -5844,10 +5855,10 @@ int bt_adapter_le_scan_filter_set_service_solicitation_uuid(bt_scan_filter_h sca * @param[in] mask The mask by which advertisements will be filtered * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -5867,10 +5878,10 @@ int bt_adapter_le_scan_filter_set_service_solicitation_uuid_with_mask(bt_scan_fi * @param[in] data_len The length of the service data * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -5898,10 +5909,10 @@ int bt_adapter_le_scan_filter_set_service_data(bt_scan_filter_h scan_filter, * @param[in] mask_len The length of the mask * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -5925,10 +5936,10 @@ int bt_adapter_le_scan_filter_set_service_data_with_mask(bt_scan_filter_h scan_f * @param[in] data_len The length of the manufacturer data * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -5958,10 +5969,10 @@ int bt_adapter_le_scan_filter_set_manufacturer_data(bt_scan_filter_h scan_filter * @param[in] mask_len The length of the mask * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -5986,10 +5997,10 @@ int bt_adapter_le_scan_filter_set_manufacturer_data_with_mask(bt_scan_filter_h s * @param[in] mode The scan filter type * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -6011,12 +6022,12 @@ int bt_adapter_le_scan_filter_set_type(bt_scan_filter_h scan_filter, * @param[in] scan_filter The scan filter handle * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOW_IN_PROGRESS Scan is in progress - * @retval #BT_ERROR_NOT_SUPPORTED Not supported - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOW_IN_PROGRESS Scan is in progress * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -6033,12 +6044,12 @@ int bt_adapter_le_scan_filter_register(bt_scan_filter_h scan_filter); * @param[in] scan_filter The scan filter handle * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOW_IN_PROGRESS Scan is in progress - * @retval #BT_ERROR_NOT_SUPPORTED Not supported - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOW_IN_PROGRESS Scan is in progress * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -6053,11 +6064,11 @@ int bt_adapter_le_scan_filter_unregister(bt_scan_filter_h scan_filter); * @privilege %http://tizen.org/privilege/bluetooth * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOW_IN_PROGRESS Scan is in progress - * @retval #BT_ERROR_NOT_SUPPORTED Not supported - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOW_IN_PROGRESS Scan is in progress * * @pre The Bluetooth service must be initialized with bt_initialize(). * @@ -6074,12 +6085,12 @@ int bt_adapter_le_scan_filter_unregister_all(void); * @param[out] is_supported The LE 2M PHY feature support: (@c true = supported , @c false = not supported) * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. */ @@ -6095,12 +6106,12 @@ int bt_adapter_le_is_2m_phy_supported(bool *is_supported); * @param[out] is_supported The LE CODED PHY feature support: (@c true = supported , @c false = not supported) * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Adapter is not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. */ @@ -6121,13 +6132,13 @@ int bt_adapter_le_is_coded_phy_supported(bool *is_supported); * @param[out] socket_fd The file descriptor of socket to listen * @return 0 on success, otherwise a negative error value. * - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @@ -6147,13 +6158,13 @@ int bt_socket_create_l2cap_channel(int psm, int *socket_fd); * * @param[in] socket_fd The file descriptor of socket (which was created using bt_socket_create_l2cap_channel()) to destroy * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The socket must be created with bt_socket_create_l2cap_channel(). * @post If callback function bt_socket_l2cap_channel_connection_state_changed_cb() is set and the remote Bluetooth device is connected, @@ -6177,13 +6188,13 @@ int bt_socket_destroy_l2cap_channel(int socket_fd); * @param[in] socket_fd The file descriptor of socket on which start to listen * @param[in] max_pending_connections The maximum number of pending connections * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The socket must be created with bt_socket_create_l2cap_channel(). * @post If callback function bt_socket_l2cap_channel_connection_state_changed_cb() is set, @@ -6209,13 +6220,13 @@ int bt_socket_listen_and_accept_l2cap_channel(int socket_fd, * @param[out] psm The assigned dynamic PSM value for the listening L2CAP CoC server socket * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The bt_socket_listen_and_accept_l2cap_channel() must be called. * @@ -6237,13 +6248,13 @@ int bt_socket_get_l2cap_psm(int socket_fd, int *psm); * @param[in] psm The dynamic PSM of a remote Bluetooth device * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The state of local Bluetooth must be #BT_ADAPTER_ENABLED. * @pre The remote device must be scannable with bt_adapter_le_start_scan(). @@ -6265,13 +6276,13 @@ int bt_socket_connect_l2cap_channel(const char *remote_address, int psm); * @privilege %http://tizen.org/privilege/bluetooth * @param[in] socket_fd The file descriptor of socket to close which was received using bt_socket_l2cap_channel_connection_state_changed_cb(). * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The connection must be established. * @@ -6295,12 +6306,12 @@ int bt_socket_disconnect_l2cap_channel(int socket_fd); * * @return the number of bytes written (zero indicates nothing was written). * @retval On error, -1 is returned, and errno is set appropriately. See write 2 man page. - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @exception BT_ERROR_PERMISSION_DENIED Permission denied - * @exception BT_ERROR_AGAIN Resource temporarily unavailable - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval BT_ERROR_AGAIN Resource temporarily unavailable * * @pre The connection must be established. * @@ -6312,15 +6323,15 @@ int bt_socket_send_data_l2cap_channel(int socket_fd, const char *data, int lengt /** * @ingroup CAPI_NETWORK_BLUETOOTH_L2CAP_SOCKET_MODULE - * @brief Registers a callback function that will be invoked when a L2CAP CoC connection is requested. + * @brief Registers a callback function that will be invoked when a L2CAP CoC connection is requested. * @since_tizen 7.0 * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @post bt_socket_connection_requested_cb() will be invoked. @@ -6334,10 +6345,10 @@ int bt_socket_set_l2cap_channel_connection_requested_cb( * @ingroup CAPI_NETWORK_BLUETOOTH_L2CAP_SOCKET_MODULE * @brief Unregisters the L2CAP CoC connection requested callback. * @since_tizen 7.0 - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -6348,15 +6359,15 @@ int bt_socket_unset_l2cap_channel_connection_requested_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_L2CAP_SOCKET_MODULE - * @brief Registers a callback function that will be invoked when the connection state changes. + * @brief Registers a callback function that will be invoked when the connection state changes. * @since_tizen 7.0 * @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 #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @post bt_socket_l2cap_channel_connection_state_changed_cb() will be invoked. @@ -6371,10 +6382,10 @@ int bt_socket_set_l2cap_channel_connection_state_changed_cb( * @ingroup CAPI_NETWORK_BLUETOOTH_L2CAP_SOCKET_MODULE * @brief Unregisters the L2CAP CoC connection state changed callback. * @since_tizen 7.0 - * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @return 0 on success, otherwise a negative error value. + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized * * @pre The Bluetooth service must be initialized with bt_initialize(). * @see bt_initialize() @@ -6386,22 +6397,22 @@ int bt_socket_unset_l2cap_channel_connection_state_changed_cb(void); /** * @ingroup CAPI_NETWORK_BLUETOOTH_L2CAP_SOCKET_MODULE * @brief Starts listening on passed L2CAP Connection-oriented Channel (CoC) socket. + * @details bt_socket_l2cap_channel_connection_requested_cb() will be called when a L2CAP CoC connection is requested. * @since_tizen 7.0 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth - * @details bt_socket_l2cap_channel_connection_requested_cb() will be called when a L2CAP CoC connection is requested. * * @param[in] socket_fd The file descriptor socket on which start to listen * @param[in] max_pending_connections The number of pending connections * * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The socket must be created with bt_socket_create_l2cap_channel(). * @post This function invokes bt_socket_l2cap_channel_connection_state_changed_cb(). @@ -6421,13 +6432,13 @@ int bt_socket_listen_l2cap_channel(int socket_fd, int max_pending_connections); * @privilege %http://tizen.org/privilege/bluetooth * @param[in] requested_socket_fd The file descriptor of socket on which a connection is requested * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The connection is requested by bt_socket_l2cap_channel_connection_requested_cb(). * @see bt_socket_create_l2cap_channel() @@ -6445,13 +6456,13 @@ int bt_socket_accept_l2cap_channel(int requested_socket_fd); * @privilege %http://tizen.org/privilege/bluetooth * @param[in] socket_fd The file descriptor of socket on which a connection is requested * @return 0 on success, otherwise a negative error value. - * @retval #BT_ERROR_NONE Successful - * @retval #BT_ERROR_NOT_INITIALIZED Not initialized - * @retval #BT_ERROR_NOT_ENABLED Not enabled - * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter - * @retval #BT_ERROR_OPERATION_FAILED Operation failed - * @retval #BT_ERROR_PERMISSION_DENIED Permission denied - * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_NONE Successful + * @retval #BT_ERROR_NOT_SUPPORTED Not supported + * @retval #BT_ERROR_PERMISSION_DENIED Permission denied + * @retval #BT_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #BT_ERROR_NOT_INITIALIZED Not initialized + * @retval #BT_ERROR_NOT_ENABLED Not enabled + * @retval #BT_ERROR_OPERATION_FAILED Operation failed * * @pre The connection is requested by bt_socket_l2cap_channel_connection_requested_cb(). * @see bt_socket_create_l2cap_channel() diff --git a/include/bluetooth_type.h b/include/bluetooth_type.h index 2d0d823..c896fca 100644 --- a/include/bluetooth_type.h +++ b/include/bluetooth_type.h @@ -181,7 +181,7 @@ typedef enum { /** * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE - * @brief Enumerations of the Bluetooth LE advertising flags + * @brief Enumerations of the Bluetooth LE advertising flags. * @since_tizen 8.0 */ typedef enum { @@ -1733,7 +1733,6 @@ typedef void (*bt_gatt_client_characteristic_value_changed_cb) (bt_gatt_h charac * @param[in] result The result of changing the connection state. * @param[in] connected The state to be changed, true means connected state, Otherwise, false. * @param[in] remote_address The remote_address - * @param[in] user_data The user data passed from the callback registration function. * */ typedef void (*bt_hrp_connection_state_changed_cb)(int result, bool connected, const char *remote_address); -- 2.7.4