From: Wootak Jung Date: Thu, 22 Mar 2018 06:16:47 +0000 (+0900) Subject: Add @MOBILE_ONLY tag for mobile only APIs to hide on Wearable API reference X-Git-Tag: submit/tizen_4.0/20180328.084945^0 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=980dbd0960993e7a3763e4dae7327027121eff8e;p=platform%2Fcore%2Fapi%2Fbluetooth.git Add @MOBILE_ONLY tag for mobile only APIs to hide on Wearable API reference Change-Id: Iacfe4b1078a2ead65bfd2aea9f37a808fafe2d65 --- diff --git a/include/bluetooth.h b/include/bluetooth.h index 1510e42..4db5481 100644 --- a/include/bluetooth.h +++ b/include/bluetooth.h @@ -758,10 +758,11 @@ int bt_adapter_set_remote_oob_ext_data(const char *remote_address, int bt_adapter_remove_remote_oob_data(const char *remote_address); /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Starts the LE device discovery. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @@ -792,10 +793,11 @@ int bt_adapter_remove_remote_oob_data(const char *remote_address); int bt_adapter_le_start_device_discovery(void) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Stops the LE device discovery, asynchronously. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @@ -820,10 +822,11 @@ int bt_adapter_le_start_device_discovery(void) TIZEN_DEPRECATED_API; int bt_adapter_le_stop_device_discovery(void) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Checks for the LE device discovery is in progress or not. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @remarks If Bluetooth LE discovery is in progress, other operations are not allowed and * you have to either stop the LE discovery operation, or wait for it to be finished, @@ -847,10 +850,11 @@ int bt_adapter_le_stop_device_discovery(void) TIZEN_DEPRECATED_API; int bt_adapter_le_is_discovering(bool *is_discovering) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Registers a callback function to be invoked when the LE device discovery state changes. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @param[in] callback The callback function to register * @param[in] user_data The user data to be passed to the callback function @@ -871,10 +875,11 @@ int bt_adapter_le_is_discovering(bool *is_discovering) TIZEN_DEPRECATED_API; int bt_adapter_le_set_device_discovery_state_changed_cb(bt_adapter_le_device_discovery_state_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Unregisters the callback function. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @return 0 on success, otherwise a negative error value. * @retval #BT_ERROR_NONE Successful @@ -1328,12 +1333,13 @@ int bt_ipsp_set_connection_state_changed_cb(bt_ipsp_connection_state_changed_cb int bt_ipsp_unset_connection_state_changed_cb(void); /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Set the data to be advertised or responded to scan request from LE scanning device. * The maximum advertised or responded data size is 31 bytes * including data type and system wide data. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @remarks In case the data_type is local name or tx power level, you don't need to input data * because the data value is written automatically by system. @@ -1556,10 +1562,11 @@ int bt_adapter_le_set_advertising_tx_power_level(bt_advertiser_h advertiser, bt_adapter_le_packet_type_e pkt_type, bool include_tx_power); /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Unset the data to be advertised or responded to scan request from LE scanning device. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @param[in] advertiser The handle of advertiser * @param[in] pkt_type The packet type @@ -1601,10 +1608,11 @@ int bt_adapter_le_remove_advertising_data(bt_advertiser_h advertiser, int bt_adapter_le_clear_advertising_data(bt_advertiser_h advertiser, bt_adapter_le_packet_type_e pkt_type); /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Start advertising with passed advertiser and advertising parameters. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @@ -4110,10 +4118,11 @@ int bt_hdp_set_data_received_cb(bt_hdp_data_received_cb callback, void *user_dat int bt_hdp_unset_data_received_cb(void); /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_client_foreach_services or bt_gatt_client_get_service instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Gets the primary services of GATT(Generic Attribute Profile). - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] remote_address The address of the remote device @@ -4135,10 +4144,11 @@ int bt_hdp_unset_data_received_cb(void); int bt_gatt_foreach_primary_services(const char *remote_address, bt_gatt_primary_service_cb callback, void *user_data) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. This function call is not required because characteristic discovery is happened automatically. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Discovers the characteristics in service, asynchronously. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] service The attribute handle of service @@ -4159,10 +4169,11 @@ int bt_gatt_foreach_primary_services(const char *remote_address, bt_gatt_primary int bt_gatt_discover_characteristics(bt_gatt_attribute_h service, bt_gatt_characteristics_discovered_cb callback, void *user_data) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_get_uuid instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Gets the UUID of service. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @remarks @a uuid must be released with free() by you. @@ -4182,10 +4193,11 @@ int bt_gatt_discover_characteristics(bt_gatt_attribute_h service, bt_gatt_charac int bt_gatt_get_service_uuid(bt_gatt_attribute_h service, char **uuid) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_service_foreach_included_services or bt_gatt_service_get_included_service instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Gets the included services in service. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] service The attribute handle of service @@ -4207,10 +4219,11 @@ int bt_gatt_get_service_uuid(bt_gatt_attribute_h service, char **uuid) TIZEN_DEP int bt_gatt_foreach_included_services(bt_gatt_attribute_h service, bt_gatt_included_service_cb callback, void *user_data) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_client_set_characteristic_value_changed_cb instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Registers a callback function that will be invoked when a characteristic value is changed. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @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. @@ -4225,10 +4238,11 @@ int bt_gatt_foreach_included_services(bt_gatt_attribute_h service, bt_gatt_inclu int bt_gatt_set_characteristic_changed_cb(bt_gatt_characteristic_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_client_unset_characteristic_value_changed_cb instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Unregisters a callback function that will be invoked when a characteristic is changed. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @return 0 on success, otherwise a negative error value. * @retval #BT_ERROR_NONE Successful * @retval #BT_ERROR_NOT_INITIALIZED Not initialized @@ -4240,10 +4254,11 @@ int bt_gatt_set_characteristic_changed_cb(bt_gatt_characteristic_changed_cb call int bt_gatt_unset_characteristic_changed_cb(void) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_client_set_characteristic_value_changed_cb instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Watches all the characteristic value changes of the service. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] service The attribute handle of service @@ -4260,10 +4275,11 @@ int bt_gatt_unset_characteristic_changed_cb(void) TIZEN_DEPRECATED_API; int bt_gatt_watch_characteristic_changes(bt_gatt_attribute_h service) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_client_unset_characteristic_value_changed_cb instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Remove watching of all the characteristic value changes of the service. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] service The attribute handle of service @@ -4280,10 +4296,11 @@ int bt_gatt_watch_characteristic_changes(bt_gatt_attribute_h service) TIZEN_DEPR int bt_gatt_unwatch_characteristic_changes(bt_gatt_attribute_h service) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_get_value or bt_gatt_get_uuid after bt_gatt_client_read_value instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Gets the characteristic declaration. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @remarks @a uuid and @a value must be released with free() by you. @@ -4306,10 +4323,11 @@ int bt_gatt_unwatch_characteristic_changes(bt_gatt_attribute_h service) TIZEN_DE int bt_gatt_get_characteristic_declaration(bt_gatt_attribute_h characteristic, char **uuid, unsigned char **value, int *value_length) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_set_value and bt_gatt_client_write_value instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Sets the value of characteristic. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] characteristic The attribute handle of characteristic @@ -4329,10 +4347,11 @@ int bt_gatt_get_characteristic_declaration(bt_gatt_attribute_h characteristic, c int bt_gatt_set_characteristic_value(bt_gatt_attribute_h characteristic, const unsigned char *value, int value_length) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_set_value and bt_gatt_client_write_value instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Sets the value of characteristic request. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] characteristic The attribute handle of characteristic @@ -4354,10 +4373,11 @@ int bt_gatt_set_characteristic_value_request(bt_gatt_attribute_h characteristic, int value_length, bt_gatt_characteristic_write_cb callback) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. GATT handle clone is not allowed. Instead, all handles for client role must be got from GATT client handle. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Clones the attribute handle. -* @since_tizen @if WEARABLE @else 2.3 @endif +* @since_tizen 2.3 * @remarks @a clone must be released with bt_gatt_destroy_attribute_handle(). * @param[out] clone The cloned attribute handle * @param[in] origin The origin attribute handle @@ -4373,10 +4393,11 @@ int bt_gatt_clone_attribute_handle(bt_gatt_attribute_h *clone, bt_gatt_attribute_h origin) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. GATT handle clone and destroy are not allowed. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Destroys the attribute handle. -* @since_tizen @if WEARABLE @else 2.3 @endif +* @since_tizen 2.3 * @param[in] handle The attribute handle * @return 0 on success, otherwise negative error value. * @retval #BT_ERROR_NONE Successful @@ -4388,10 +4409,11 @@ int bt_gatt_clone_attribute_handle(bt_gatt_attribute_h *clone, int bt_gatt_destroy_attribute_handle(bt_gatt_attribute_h handle) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use gatt_client_read_value instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Reads the value of characteristic from remote device. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] char_handle The attribute handle of characteristic @@ -4411,10 +4433,11 @@ int bt_gatt_read_characteristic_value(bt_gatt_attribute_h char_handle, bt_gatt_characteristic_read_cb callback) TIZEN_DEPRECATED_API; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. This function call is not required because descriptor discovery is happened automatically. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Discovers the characteristic descriptors of a characteristic within its definition, asynchronously. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel public * @privilege %http://tizen.org/privilege/bluetooth * @param[in] characteristic_handle The attribute handle of characteristic diff --git a/include/bluetooth_internal.h b/include/bluetooth_internal.h index d385024..eab15f1 100644 --- a/include/bluetooth_internal.h +++ b/include/bluetooth_internal.h @@ -704,11 +704,12 @@ int bt_adapter_le_add_white_list(const char *address, bt_device_address_type_e a int bt_adapter_le_remove_white_list(const char *address, bt_device_address_type_e address_type); /** + * @MOBILE_ONLY * @internal * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief clear address from the whitelist for not accepting scanning request. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * @privlevel platform * @privilege %http://tizen.org/privilege/bluetooth.admin * diff --git a/include/bluetooth_type.h b/include/bluetooth_type.h index d69849f..59107ad 100644 --- a/include/bluetooth_type.h +++ b/include/bluetooth_type.h @@ -141,10 +141,11 @@ typedef enum { } bt_adapter_device_discovery_state_e; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Enumerations of the discovery state of Bluetooth LE device. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * */ typedef enum { @@ -190,10 +191,11 @@ typedef enum { } bt_adapter_le_advertising_filter_policy_e; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Enumerations of the Bluetooth advertising type. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 */ typedef enum { BT_ADAPTER_LE_ADVERTISING_CONNECTABLE = 0x00, /**< Connectable undirected advertising (ADV_IND) */ @@ -214,11 +216,12 @@ typedef enum { } bt_adapter_le_packet_type_e; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Enumerations of the Bluetooth LE data type * that can be included in LE packets. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 */ typedef enum { BT_ADAPTER_LE_PACKET_DATA_COMP_LIST_16_BIT_SERVICE_CLASS_UUIDS = 0x03, /**< Complete list of 16 bit UUIDs */ @@ -869,10 +872,11 @@ typedef enum { } bt_pbap_sort_order_e; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_h instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief The attribute handle of GATT(Generic Attribute Profile). - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 */ typedef void *bt_gatt_attribute_h; @@ -943,10 +947,11 @@ typedef struct { } bt_adapter_device_discovery_info_s; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Structure of le device discovery information. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @see #bt_class_s * @see bt_adapter_le_device_discovery_state_changed_cb() @@ -995,10 +1000,11 @@ typedef struct { } bt_adapter_le_ibeacon_scan_result_info_s; /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Structure of advertising parameters. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @see bt_adapter_le_advertising_state_changed_cb() * @see bt_adapter_le_start_advertising() @@ -1238,10 +1244,11 @@ typedef void (*bt_adapter_device_discovery_state_changed_cb) typedef bool (*bt_adapter_bonded_device_cb)(bt_device_info_s *device_info, void *user_data); /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1 * @ingroup CAPI_NETWORK_BLUETOOTH_ADAPTER_LE_MODULE * @brief Called when the state of LE device discovery changes. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @remarks If \a discovery_state is #BT_ADAPTER_LE_DEVICE_DISCOVERY_FOUND, * then you can get some information, such as remote LE device address, remote device name, rssi, and bonding state. @@ -1735,10 +1742,11 @@ typedef void (*bt_hdp_disconnected_cb) (int result, const char *remote_address, typedef void (*bt_hdp_data_received_cb) (unsigned int channel, const char *data, unsigned int size, void *user_data); /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_foreach_cb instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Called when you get the primary services repeatedly. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @param[in] service The attribute handle of service * @param[in] user_data The user data passed from the foreach function @@ -1750,10 +1758,11 @@ typedef void (*bt_hdp_data_received_cb) (unsigned int channel, const char *data, typedef bool (*bt_gatt_primary_service_cb) (bt_gatt_attribute_h service, void *user_data); /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. This is not required because characteristic discovery is happened automatically. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Called after the characteristics are discovered by bt_gatt_discover_characteristics(). - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @remarks If bt_gatt_discover_characteristics() failed, then this callback function is called only once with 0 total and NULL characteristic_handle. * @param[in] result The result of discovering @@ -1769,10 +1778,11 @@ typedef bool (*bt_gatt_primary_service_cb) (bt_gatt_attribute_h service, void *u typedef bool (*bt_gatt_characteristics_discovered_cb) (int result, int index, int total, bt_gatt_attribute_h characteristic, void *user_data); /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_foreach_cb instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Called when you get the included services repeatedly. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @param[in] service The attribute handle of service * @param[in] user_data The user data passed from the foreach function @@ -1784,10 +1794,11 @@ typedef bool (*bt_gatt_characteristics_discovered_cb) (int result, int index, in typedef bool (*bt_gatt_included_service_cb) (bt_gatt_attribute_h service, void *user_data); /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_client_characteristic_value_changed_cb instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Called when a characteristic in service is changed. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @param[in] characteristic The attribute handle of characteristic * @param[in] value The value of characteristic (byte array) @@ -1799,20 +1810,22 @@ typedef bool (*bt_gatt_included_service_cb) (bt_gatt_attribute_h service, void * typedef void (*bt_gatt_characteristic_changed_cb) (bt_gatt_attribute_h characteristic, unsigned char *value, int value_length, void *user_data); /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_client_request_completed_cb instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Called when a characteristic value is written. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @see bt_gatt_set_characteristic_value() */ typedef void (*bt_gatt_characteristic_write_cb) (void *user_data); /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. Use bt_gatt_client_request_completed_cb instead. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Called when a characteristic value is read. - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @param[in] value The value of characteristic (byte array) * @param[in] value_length The length of value @@ -1823,10 +1836,11 @@ typedef void (*bt_gatt_characteristic_read_cb) (unsigned char *value, int value_length, void *user_data); /** + * @MOBILE_ONLY * @deprecated Deprecated since 2.3.1. This is not required because descriptor discovery is happened automatically. * @ingroup CAPI_NETWORK_BLUETOOTH_GATT_MODULE * @brief Called after the characteristics descriptors are discovered by bt_gatt_discover_characteristic_descriptor(). - * @since_tizen @if WEARABLE @else 2.3 @endif + * @since_tizen 2.3 * * @param[in] result The result of discovering * @param[in] characteristic_format The format of the information data.