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
*
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
*
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,
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
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
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.
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
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
*
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
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
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.
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
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.
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
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
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
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.
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
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
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
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
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
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
} 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 {
} 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) */
} 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 */
} 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;
} 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()
} 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()
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.
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
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
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
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)
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
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.