TizenRT Public API
v2.0 M2
|
Files | |
file | bluetooth.h |
API to control the Bluetooth adapter and devices and communications. | |
Enumerations |
Functions | |
int | bt_initialize (void) |
Initializes the Bluetooth API. 2.3. More... | |
int | bt_deinitialize (void) |
Releases all resources of the Bluetooth API. 2.3. More... | |
int | bt_get_uuid_name (const char *uuid, char **name) |
Gets the specification name for the given UUID. 3.0. More... | |
int | bt_adapter_get_state (bt_adapter_state_e *adapter_state) |
Gets the current state of local Bluetooth adapter. 2.3. More... | |
int | bt_adapter_get_address (char **local_address) |
Gets the address of local Bluetooth adapter. 2.3. More... | |
int | bt_adapter_get_name (char **local_name) |
Gets the name of local Bluetooth adapter. More... | |
int | bt_adapter_set_name (const char *local_name) |
Sets the name of local Bluetooth adapter. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_get_visibility (bt_adapter_visibility_mode_e *mode, int *duration) |
Gets the visibility mode of local Bluetooth adapter. 2.3. More... | |
int | bt_adapter_start_device_discovery (void) |
Starts the device discovery, asynchronously. More... | |
int | bt_adapter_stop_device_discovery (void) |
Stops the device discovery, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_is_discovering (bool *is_discovering) |
Checks for the device discovery is in progress or not. 2.3. More... | |
int | bt_device_get_service_mask_from_uuid_list (char **uuids, int no_of_service, bt_service_class_t *service_mask_list) |
Gets the service mask from the UUID list. 2.3. More... | |
int | bt_adapter_foreach_bonded_device (bt_adapter_bonded_device_cb callback, void *user_data) |
Retrieves the device information of all bonded devices. 2.3. More... | |
int | bt_adapter_get_bonded_device_info (const char *remote_address, bt_device_info_s **device_info) |
Gets the device information of a bonded device. 2.3. More... | |
int | bt_adapter_free_device_info (bt_device_info_s *device_info) |
Frees device info. 2.3. More... | |
int | bt_adapter_is_service_used (const char *service_uuid, bool *used) |
Checks whether the UUID of service is used or not. 2.3. More... | |
int | bt_adapter_set_state_changed_cb (bt_adapter_state_changed_cb callback, void *user_data) |
Registers a callback function to be invoked when the Bluetooth adapter state changes. 2.3. More... | |
int | bt_adapter_unset_state_changed_cb (void) |
Unregisters the callback function. 2.3. More... | |
int | bt_adapter_set_name_changed_cb (bt_adapter_name_changed_cb callback, void *user_data) |
Registers a callback function to be invoked when the name of Bluetooth adapter changes. 2.3. More... | |
int | bt_adapter_unset_name_changed_cb (void) |
Unregisters the callback function. 2.3. More... | |
int | bt_adapter_set_visibility_mode_changed_cb (bt_adapter_visibility_mode_changed_cb callback, void *user_data) |
Registers a callback function to be invoked when the visibility mode changes. 2.3. More... | |
int | bt_adapter_unset_visibility_mode_changed_cb (void) |
Unregisters the callback function. 2.3. More... | |
int | bt_adapter_set_visibility_duration_changed_cb (bt_adapter_visibility_duration_changed_cb callback, void *user_data) |
Registers a callback function to be invoked every second. More... | |
int | bt_adapter_unset_visibility_duration_changed_cb (void) |
Unregisters the callback function. 2.3. More... | |
int | bt_adapter_set_device_discovery_state_changed_cb (bt_adapter_device_discovery_state_changed_cb callback, void *user_data) |
Registers a callback function to be invoked when the device discovery state changes. 2.3. More... | |
int | bt_adapter_unset_device_discovery_state_changed_cb (void) |
Unregisters the callback function. 2.3. More... | |
int | bt_adapter_get_local_oob_data (unsigned char **hash, unsigned char **randomizer, int *hash_len, int *randomizer_len) |
Gets the Hash and Randomizer value, synchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_set_remote_oob_data (const char *remote_address, unsigned char *hash, unsigned char *randomizer, int hash_len, int randomizer_len) |
Sets the Hash and Randomizer value, synchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_get_local_oob_ext_data (unsigned char **hash192, unsigned char **randomizer192, int *hash192_len, int *randomizer192_len, unsigned char **hash256, unsigned char **randomizer256, int *hash256_len, int *randomizer256_len) |
Gets the Hash and Randomizer value, synchronously. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_set_remote_oob_ext_data (const char *remote_address, const unsigned char *hash192, const unsigned char *randomizer192, int hash192_len, int randomizer192_len, const unsigned char *hash256, const unsigned char *randomizer256, int hash256_len, int randomizer256_len) |
Sets the Hash and Randomizer value, synchronously. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_remove_remote_oob_data (const char *remote_address) |
Deletes the Hash and Randomizer value, synchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_le_is_discovering (bool *is_discovering) TIZEN_DEPRECATED_API |
Checks for the LE device discovery is in progress or not. 2.3. More... | |
int | bt_adapter_le_start_scan (bt_adapter_le_scan_result_cb cb, void *user_data) |
Starts the LE scan to find LE advertisement. More... | |
int | bt_adapter_le_stop_scan (void) |
Stops the LE scan. 2.3.1 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_le_get_scan_result_service_uuids (const bt_adapter_le_device_scan_result_info_s *info, bt_adapter_le_packet_type_e pkt_type, char ***uuids, int *count) |
Gets the service UUID list from the scan result information. 2.3.1. More... | |
int | bt_adapter_le_get_scan_result_device_name (const bt_adapter_le_device_scan_result_info_s *info, bt_adapter_le_packet_type_e pkt_type, char **name) |
Gets the device name from the scan result information. 2.3.1. More... | |
int | bt_adapter_le_get_scan_result_tx_power_level (const bt_adapter_le_device_scan_result_info_s *info, bt_adapter_le_packet_type_e pkt_type, int *power_level) |
Gets the transmission power level from the scan result information. 2.3.1. More... | |
int | bt_adapter_le_get_scan_result_service_solicitation_uuids (const bt_adapter_le_device_scan_result_info_s *info, bt_adapter_le_packet_type_e pkt_type, char ***uuids, int *count) |
Gets the service solicitation UUID list from the scan result information. 2.3.1. More... | |
int | bt_adapter_le_get_scan_result_service_data_list (const bt_adapter_le_device_scan_result_info_s *info, bt_adapter_le_packet_type_e pkt_type, bt_adapter_le_service_data_s **data_list, int *count) |
Gets the service data list from the scan result information. 2.3.1. More... | |
int | bt_adapter_le_free_service_data_list (bt_adapter_le_service_data_s *data_list, int count) |
Frees service data list. 2.3.1. More... | |
int | bt_adapter_le_get_scan_result_appearance (const bt_adapter_le_device_scan_result_info_s *info, bt_adapter_le_packet_type_e pkt_type, int *appearance) |
Gets the appearance from the scan result information. 2.3.1. More... | |
int | bt_adapter_le_get_scan_result_manufacturer_data (const bt_adapter_le_device_scan_result_info_s *info, bt_adapter_le_packet_type_e pkt_type, int *manufacturer_id, char **manufacturer_data, int *manufacturer_data_len) |
Gets the manufacturer data from the scan result information. 2.3.1. More... | |
int | bt_adapter_le_get_scan_result_ibeacon_report (const bt_adapter_le_device_scan_result_info_s *info, bt_adapter_le_packet_type_e pkt_type, bt_adapter_le_ibeacon_scan_result_info_s **ibeacon_info) |
Gets iBeacon format's data from the scan result information. 4.0. More... | |
int | bt_adapter_le_free_ibeacon_report (bt_adapter_le_ibeacon_scan_result_info_s *ibeacon_info) |
Frees iBeacon information. 4.0. More... | |
int | bt_adapter_le_create_advertiser (bt_advertiser_h *advertiser) |
Creates advertiser to advertise device's existence or respond to LE scanning request. 2.3. More... | |
int | bt_adapter_le_destroy_advertiser (bt_advertiser_h advertiser) |
Destroys advertiser. 2.3. More... | |
int | bt_ipsp_initialize (bt_ipsp_init_state_changed_cb callback, void *user_data) |
Initializes the Bluetooth IPSP (Internet Protocol Support Profile) service. 4.0. More... | |
int | bt_ipsp_deinitialize (void) |
Deinitializes the Bluetooth IPSP (Internet Protocol Support Profile) service. 4.0. More... | |
int | bt_ipsp_connect (const char *remote_address) |
Connects to a remote device's IPSP service over LE, asynchronously. 4.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_ipsp_disconnect (const char *remote_address) |
Disconnects from a remote device's IPSP service, asynchronously. 4.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_ipsp_set_connection_state_changed_cb (bt_ipsp_connection_state_changed_cb callback, void *user_data) |
Registers a callback function that will be invoked when the connection state changes. 4.0. More... | |
int | bt_ipsp_unset_connection_state_changed_cb (void) |
Unregisters the callback function called when the connection state changes. 4.0. More... | |
int | bt_adapter_le_add_advertising_service_uuid (bt_advertiser_h advertiser, bt_adapter_le_packet_type_e pkt_type, const char *uuid) |
Adds a service UUID to advertise or scan response data. The maximum advertised or responded data size is 31 bytes including data type and system wide data. 2.3.1. More... | |
int | bt_adapter_le_add_advertising_service_solicitation_uuid (bt_advertiser_h advertiser, bt_adapter_le_packet_type_e pkt_type, const char *uuid) |
Adds a service solicitation UUID to advertise or scan response data. The maximum advertised or responded data size is 31 bytes including data type and system wide data. 2.3.1. More... | |
int | bt_adapter_le_add_advertising_service_data (bt_advertiser_h advertiser, bt_adapter_le_packet_type_e pkt_type, const char *uuid, const char *service_data, int service_data_len) |
Adds service data to advertise or scan response data. The maximum advertised or responded data size is 31 bytes including data type and system wide data. 2.3.1. More... | |
int | bt_adapter_le_set_advertising_appearance (bt_advertiser_h advertiser, bt_adapter_le_packet_type_e pkt_type, int appearance) |
Sets the external appearance of this device to advertise or scan response data. Please refer to the adopted Bluetooth specification for the the appearance. 2.3.1. More... | |
int | bt_adapter_le_add_advertising_manufacturer_data (bt_advertiser_h advertiser, bt_adapter_le_packet_type_e pkt_type, int manufacturer_id, const char *manufacturer_data, int manufacturer_data_len) |
Adds manufacturer specific data to advertise or scan response data. Please refer to the Bluetooth Assigned Numbers provided by the Bluetooth SIG for a list of existing company identifiers. The maximum advertised or responded data size is 31 bytes including data type and system wide data. 2.3.1. More... | |
int | bt_adapter_le_set_advertising_device_name (bt_advertiser_h advertiser, bt_adapter_le_packet_type_e pkt_type, bool include_name) |
Sets whether the device name should be included in advertise or scan response data. The maximum advertised or responded data size is 31 bytes including data type and system wide data. 2.3.1. More... | |
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) |
Sets whether the transmission power level should be included in advertise or scan response data. The maximum advertised or responded data size is 31 bytes including data type and system wide data. 2.3.1. More... | |
int | bt_adapter_le_clear_advertising_data (bt_advertiser_h advertiser, bt_adapter_le_packet_type_e pkt_type) |
Clears all data to be advertised or responded to scan request from LE scanning device. 2.3. More... | |
int | bt_adapter_le_stop_advertising (bt_advertiser_h advertiser) |
Stops the advertising. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_le_start_advertising_new (bt_advertiser_h advertiser, bt_adapter_le_advertising_state_changed_cb cb, void *user_data) |
Starts advertising with passed advertiser and advertising parameters. More... | |
int | bt_adapter_le_set_advertising_mode (bt_advertiser_h advertiser, bt_adapter_le_advertising_mode_e mode) |
Sets advertising mode to control the advertising power and latency. 2.3.1 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_le_set_advertising_connectable (bt_advertiser_h advertiser, bool connectable) |
Sets whether the advertising type should be connectable or non-connectable. 2.3.1 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_le_set_scan_mode (bt_adapter_le_scan_mode_e scan_mode) |
Sets Bluetooth LE scan mode. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_device_create_bond (const char *remote_address) |
Creates a bond with a remote Bluetooth device, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_device_cancel_bonding (void) |
Cancels the bonding process. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_device_destroy_bond (const char *remote_address) |
Destroys the bond, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_device_set_alias (const char *remote_address, const char *alias) |
Sets an alias for the bonded device. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_device_set_authorization (const char *remote_address, bt_device_authorization_e authorization_state) |
Sets the authorization of a bonded device, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_device_start_service_search (const char *remote_address) |
Starts the search for services supported by the specified device, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_device_foreach_connected_profiles (const char *remote_address, bt_device_connected_profile callback, void *user_data) |
Gets the connected profiles. 2.3. More... | |
int | bt_device_is_profile_connected (const char *remote_address, bt_profile_e bt_profile, bool *connected_status) |
Gets the profile connected status. 2.3. More... | |
int | bt_device_update_le_connection_mode (const char *remote_address, bt_device_le_connection_mode_e mode) |
Updates a LE connection mode. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_device_set_bond_created_cb (bt_device_bond_created_cb callback, void *user_data) |
Registers a callback function to be invoked when the bond creates. 2.3. More... | |
int | bt_device_unset_bond_created_cb (void) |
Unregisters the callback function. 2.3. More... | |
int | bt_device_set_bond_destroyed_cb (bt_device_bond_destroyed_cb callback, void *user_data) |
Registers a callback function to be invoked when the bond destroys. 2.3. More... | |
int | bt_device_unset_bond_destroyed_cb (void) |
Unregisters the callback function. 2.3. More... | |
int | bt_device_set_authorization_changed_cb (bt_device_authorization_changed_cb callback, void *user_data) |
Registers a callback function to be invoked when the authorization of device changes. 2.3. More... | |
int | bt_device_unset_authorization_changed_cb (void) |
Unregisters the callback function. 2.3. More... | |
int | bt_device_set_service_searched_cb (bt_device_service_searched_cb callback, void *user_data) |
Registers a callback function to be invoked when the process of service search finishes. 2.3. More... | |
int | bt_device_unset_service_searched_cb (void) |
Unregisters the callback function. 2.3. More... | |
int | bt_device_set_connection_state_changed_cb (bt_device_connection_state_changed_cb callback, void *user_data) |
Registers a callback function to be invoked when the connection state is changed. 2.3. More... | |
int | bt_device_unset_connection_state_changed_cb (void) |
Unregisters the callback function to be invoked when the connection state is changed. 2.3. More... | |
int | bt_socket_create_rfcomm (const char *service_uuid, int *socket_fd) |
Registers a RFCOMM server socket with a specific UUID. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_socket_destroy_rfcomm (int socket_fd) |
Removes the RFCOMM server socket which was created using bt_socket_create_rfcomm(). 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_socket_listen_and_accept_rfcomm (int socket_fd, int max_pending_connections) |
Starts listening on passed RFCOMM socket and accepts connection requests. More... | |
int | bt_socket_connect_rfcomm (const char *remote_address, const char *service_uuid) |
Connects to a specific RFCOMM based service on a remote Bluetooth device UUID, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_socket_disconnect_rfcomm (int socket_fd) |
Disconnects the RFCOMM connection with the given file descriptor of connected socket. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_socket_send_data (int socket_fd, const char *data, int length) |
Sends data to the connected device. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_socket_set_data_received_cb (bt_socket_data_received_cb callback, void *user_data) |
Registers a callback function that will be invoked when you receive data. 2.3. More... | |
int | bt_socket_unset_data_received_cb (void) |
Unregisters the callback function. 2.3. More... | |
int | bt_socket_set_connection_requested_cb (bt_socket_connection_requested_cb callback, void *user_data) |
Registers a callback function that will be invoked when a RFCOMM connection is requested. 2.3. More... | |
int | bt_socket_unset_connection_requested_cb (void) |
Unregisters the callback function. 2.3. More... | |
int | bt_socket_set_connection_state_changed_cb (bt_socket_connection_state_changed_cb callback, void *user_data) |
Registers a callback function that will be invoked when the connection state changes. 2.3. More... | |
int | bt_socket_unset_connection_state_changed_cb (void) |
Unregisters the callback function. 2.3. More... | |
int | bt_opp_server_initialize_by_connection_request (const char *destination, bt_opp_server_connection_requested_cb connection_requested_cb, void *user_data) |
Initializes the Bluetooth OPP server requested by bt_opp_server_connection_requested_cb(). More... | |
int | bt_opp_server_deinitialize (void) |
Deinitializes the Bluetooth OPP server. 2.3. More... | |
int | bt_opp_server_accept (bt_opp_server_transfer_progress_cb progress_cb, bt_opp_server_transfer_finished_cb finished_cb, const char *name, void *user_data, int *transfer_id) |
Accepts the push request from the remote device. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_opp_server_reject (void) |
Rejects the push request from the remote device. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_opp_server_cancel_transfer (int transfer_id) |
Cancels the transfer. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_opp_server_set_destination (const char *destination) |
Sets the destination path of file to be pushed. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_opp_client_initialize (void) |
Initializes the Bluetooth OPP client. 2.3. More... | |
int | bt_opp_client_deinitialize (void) |
Deinitializes the Bluetooth OPP client. 2.3. More... | |
int | bt_opp_client_add_file (const char *file) |
Adds file to be pushed. 2.3. More... | |
int | bt_opp_client_clear_files (void) |
Adds file to be pushed. 2.3. More... | |
int | bt_opp_client_push_files (const char *remote_address, bt_opp_client_push_responded_cb responded_cb, bt_opp_client_push_progress_cb progress_cb, bt_opp_client_push_finished_cb finished_cb, void *user_data) |
Pushes the file to the remote device, asynchronously. More... | |
int | bt_opp_client_cancel_push (void) |
Cancels the push request in progress, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hid_host_initialize (bt_hid_host_connection_state_changed_cb connection_cb, void *user_data) |
Initializes the Bluetooth HID (Human Interface Device) Host. 2.3. More... | |
int | bt_hid_host_deinitialize (void) |
Deinitializes the Bluetooth HID (Human Interface Device) Host. 2.3. More... | |
int | bt_hid_host_connect (const char *remote_address) |
Connects the remote device with the HID (Human Interface Device) service, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hid_host_disconnect (const char *remote_address) |
Disconnects the remote device with the HID (Human Interface Device) service, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hid_device_activate (bt_hid_device_connection_state_changed_cb callback, void *user_data) |
Activates the Bluetooth HID Device role. public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hid_device_deactivate (void) |
Deactivates the Bluetooth HID Device role. public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hid_device_connect (const char *remote_address) |
Initiates the HID device connection with the Device role, asynchronously. public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hid_device_disconnect (const char *remote_address) |
Disconnects from the HID Host device, asynchronously. public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hid_device_send_mouse_event (const char *remote_address, const bt_hid_mouse_data_s *mouse_data) |
Sends the mouse event data to the remote device. public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hid_device_send_key_event (const char *remote_address, const bt_hid_key_data_s *key_data) |
Sends the keyboard event data to the remote device. public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hid_device_set_data_received_cb (bt_hid_device_data_received_cb callback, void *user_data) |
Sets the callback called when the device receives data from the HID Host. . More... | |
int | bt_hid_device_unset_data_received_cb (void) |
Unsets the data received callback. . More... | |
int | bt_hid_device_reply_to_report (const char *remote_address, bt_hid_header_type_e header_type, bt_hid_param_type_e param_type, const char *data, unsigned int data_len) |
Responds to reports from the HID Host. public http://tizen.org/privilege/bluetooth. More... | |
int | bt_audio_initialize (void) |
Initializes the Bluetooth profiles related with audio. 2.3. More... | |
int | bt_audio_deinitialize (void) |
Deinitializes the Bluetooth profiles related with audio. 2.3. More... | |
int | bt_audio_connect (const char *remote_address, bt_audio_profile_type_e type) |
Connects the remote device with the given audio profile, asynchronously. More... | |
int | bt_audio_disconnect (const char *remote_address, bt_audio_profile_type_e type) |
Disconnects the remote device with the given audio profile, asynchronously. More... | |
int | bt_audio_set_connection_state_changed_cb (bt_audio_connection_state_changed_cb callback, void *user_data) |
Registers a callback function that will be invoked when the connection state is changed. 2.3. More... | |
int | bt_audio_unset_connection_state_changed_cb (void) |
Unregisters a callback function that will be invoked when the connection state is changed. 2.3. More... | |
int | bt_avrcp_target_initialize (bt_avrcp_target_connection_state_changed_cb callback, void *user_data) |
Initializes the Bluetooth AVRCP (Audio/Video Remote Control Profile) target service. 2.4. More... | |
int | bt_avrcp_target_deinitialize (void) |
Deinitializes the Bluetooth AVRCP (Audio/Video Remote Control Profile) target service. 2.4. More... | |
int | bt_avrcp_target_notify_equalizer_state (bt_avrcp_equalizer_state_e state) |
Notifies the equalizer state to the remote device. 2.4 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_target_notify_repeat_mode (bt_avrcp_repeat_mode_e mode) |
Notifies the repeat mode to the remote device. 2.4 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_target_notify_shuffle_mode (bt_avrcp_shuffle_mode_e mode) |
Notifies the shuffle mode to the remote device. 2.4 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_target_notify_scan_mode (bt_avrcp_scan_mode_e mode) |
Notifies the scan mode to the remote device. 2.4 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_target_notify_player_state (bt_avrcp_player_state_e state) |
Notifies the player state to the remote device. 2.4 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_target_notify_position (unsigned int position) |
Notifies the current position of song to the remote device. 2.4 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_target_notify_track (const char *title, const char *artist, const char *album, const char *genre, unsigned int track_num, unsigned int total_tracks, unsigned int duration) |
Notifies the track to the remote device. 2.4 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_set_equalizer_state_changed_cb (bt_avrcp_equalizer_state_changed_cb callback, void *user_data) |
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). 2.4. More... | |
int | bt_avrcp_unset_equalizer_state_changed_cb (void) |
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). 2.4. More... | |
int | bt_avrcp_set_repeat_mode_changed_cb (bt_avrcp_repeat_mode_changed_cb callback, void *user_data) |
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). 2.4. More... | |
int | bt_avrcp_unset_repeat_mode_changed_cb (void) |
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). 2.4. More... | |
int | bt_avrcp_set_shuffle_mode_changed_cb (bt_avrcp_shuffle_mode_changed_cb callback, void *user_data) |
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). 2.4. More... | |
int | bt_avrcp_unset_shuffle_mode_changed_cb (void) |
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). 2.4. More... | |
int | bt_avrcp_set_scan_mode_changed_cb (bt_avrcp_scan_mode_changed_cb callback, void *user_data) |
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). 2.4. More... | |
int | bt_avrcp_unset_scan_mode_changed_cb (void) |
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). 2.4. More... | |
int | bt_avrcp_set_position_changed_cb (bt_avrcp_position_changed_cb callback, void *user_data) |
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). 3.0. More... | |
int | bt_avrcp_unset_position_changed_cb (void) |
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). 3.0. More... | |
int | bt_avrcp_set_play_status_changed_cb (bt_avrcp_play_status_changed_cb callback, void *user_data) |
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). 3.0. More... | |
int | bt_avrcp_unset_play_status_changed_cb (void) |
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). 3.0. More... | |
int | bt_avrcp_set_track_info_changed_cb (bt_avrcp_track_info_changed_cb callback, void *user_data) |
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). 3.0. More... | |
int | bt_avrcp_unset_track_info_changed_cb (void) |
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). 3.0. More... | |
int | bt_avrcp_control_initialize (bt_avrcp_control_connection_state_changed_cb callback, void *user_data) |
Initializes the Bluetooth AVRCP (Audio/Video Remote Control Profile) controller service. 3.0. More... | |
int | bt_avrcp_control_deinitialize (void) |
Deinitializes the Bluetooth AVRCP (Audio/Video Remote Control Profile) controller service. 3.0. More... | |
int | bt_avrcp_control_connect (const char *remote_address) |
Connects the AVRCP (Audio/Video Remote Control Profile) target device. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_control_disconnect (const char *remote_address) |
Disconnects from the AVRCP (Audio/Video Remote Control Profile) target device. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_control_send_player_command (bt_avrcp_player_command_e cmd) |
Sends a command to the target device. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_control_set_equalizer_state (bt_avrcp_equalizer_state_e state) |
Sends the equalizer state change request to the remote device. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_control_get_equalizer_state (bt_avrcp_equalizer_state_e *state) |
Gets the the equalizer state of the remote device. 3.0. More... | |
int | bt_avrcp_control_set_repeat_mode (bt_avrcp_repeat_mode_e mode) |
Sends the repeat change request to the remote device. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_control_get_repeat_mode (bt_avrcp_repeat_mode_e *mode) |
Gets the repeat state of the remote device. 3.0. More... | |
int | bt_avrcp_control_set_shuffle_mode (bt_avrcp_shuffle_mode_e mode) |
Sends the shuffle mode change request to the remote device. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_control_get_shuffle_mode (bt_avrcp_shuffle_mode_e *mode) |
Gets the shuffle mode of the remote device. 3.0. More... | |
int | bt_avrcp_control_set_scan_mode (bt_avrcp_scan_mode_e mode) |
Sends the scan mode change request to the remote device. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_avrcp_control_get_scan_mode (bt_avrcp_scan_mode_e *mode) |
Gets the scan mode of the remote device. 3.0. More... | |
int | bt_avrcp_control_get_position (unsigned int *position) |
Gets the position of the song played by the remote device. 3.0. More... | |
int | bt_avrcp_control_get_play_status (bt_avrcp_player_state_e *status) |
Gets the play status of the remote device. 3.0. More... | |
int | bt_avrcp_control_get_track_info (bt_avrcp_metadata_attributes_info_s **track) |
Gets the metadata of the track played by the remote device. 3.0. More... | |
int | bt_avrcp_control_free_track_info (bt_avrcp_metadata_attributes_info_s *track) |
Frees the track metadata. 3.0. More... | |
int | bt_hdp_register_sink_app (unsigned short data_type, char **app_id) TIZEN_DEPRECATED_API |
Registers an application that acts as the Sink role of HDP (Health Device Profile). 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hdp_unregister_sink_app (const char *app_id) TIZEN_DEPRECATED_API |
Unregisters the given application that acts as the Sink role of HDP (Health Device Profile). 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hdp_connect_to_source (const char *remote_address, const char *app_id) TIZEN_DEPRECATED_API |
Connects the remote device which acts as Source role, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hdp_disconnect (const char *remote_address, unsigned int channel) TIZEN_DEPRECATED_API |
Disconnects the remote device, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hdp_send_data (unsigned int channel, const char *data, unsigned int size) TIZEN_DEPRECATED_API |
Sends the data to the remote device. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_hdp_set_connection_state_changed_cb (bt_hdp_connected_cb connected_cb, bt_hdp_disconnected_cb disconnected_cb, void *user_data) TIZEN_DEPRECATED_API |
Registers a callback function that will be invoked when the connection state is changed. 2.3. More... | |
int | bt_hdp_unset_connection_state_changed_cb (void) TIZEN_DEPRECATED_API |
Unregisters a callback function that will be invoked when the connection state is changed. 2.3. More... | |
int | bt_hdp_set_data_received_cb (bt_hdp_data_received_cb callback, void *user_data) TIZEN_DEPRECATED_API |
Registers a callback function that will be invoked when you receive the data. 2.3. More... | |
int | bt_hdp_unset_data_received_cb (void) TIZEN_DEPRECATED_API |
Unregisters a callback function that will be invoked when you receive the data. 2.3. More... | |
int | bt_gatt_get_value (bt_gatt_h gatt_handle, char **value, int *value_length) |
Gets the value of a characteristic or descriptor's GATT handle. 2.3.1. More... | |
int | bt_gatt_get_int_value (bt_gatt_h gatt_handle, bt_data_type_int_e type, int offset, int *value) |
Gets the value of a characteristic or descriptor's GATT handle as an integer type. 2.3.1. More... | |
int | bt_gatt_get_float_value (bt_gatt_h gatt_handle, bt_data_type_float_e type, int offset, float *value) |
Gets the value of a characteristic or descriptor's GATT handle as a float type. 2.3.1. More... | |
int | bt_gatt_set_value (bt_gatt_h gatt_handle, const char *value, int value_length) |
Updates the value of a characteristic or descriptor's GATT handle. 2.3.1. More... | |
int | bt_gatt_set_int_value (bt_gatt_h gatt_handle, bt_data_type_int_e type, int value, int offset) |
Updates the value of a characteristic or descriptor's GATT handle using a integer type's value. 2.3.1. More... | |
int | bt_gatt_set_float_value (bt_gatt_h gatt_handle, bt_data_type_float_e type, int mantissa, int exponent, int offset) |
Updates the value of a characteristic or descriptor's GATT handle using a float type's value. 2.3.1. More... | |
int | bt_gatt_get_uuid (bt_gatt_h gatt_handle, char **uuid) |
Gets the UUID of a service, characteristic or descriptor's GATT handle. 2.3.1. More... | |
int | bt_gatt_get_type (bt_gatt_h gatt_handle, bt_gatt_type_e *gatt_type) |
Gets the type of GATT handle. 2.3.1. More... | |
int | bt_gatt_service_get_client (bt_gatt_h service, bt_gatt_client_h *client) |
Gets the GATT client handle which the specified service belongs to. 2.3.1. More... | |
int | bt_gatt_service_get_characteristic (bt_gatt_h service, const char *uuid, bt_gatt_h *characteristic) |
Gets a characteristic's GATT handle which has specific UUID. 2.3.1. More... | |
int | bt_gatt_service_foreach_characteristics (bt_gatt_h service, bt_gatt_foreach_cb callback, void *user_data) |
Invokes callback function on each characteristic that belongs to the specified service. 2.3.1. More... | |
int | bt_gatt_service_get_included_service (bt_gatt_h service, const char *uuid, bt_gatt_h *included_service) |
Gets an included service's GATT handle which has specific UUID. 2.3.1. More... | |
int | bt_gatt_service_foreach_included_services (bt_gatt_h service, bt_gatt_foreach_cb callback, void *user_data) |
Invokes callback function on each included service that belongs to the specified service. 2.3.1. More... | |
int | bt_gatt_characteristic_get_service (bt_gatt_h characteristic, bt_gatt_h *service) |
Gets the service's GATT handle which the specified characteristic belongs to. 2.3.1. More... | |
int | bt_gatt_characteristic_get_properties (bt_gatt_h characteristic, int *properties) |
Gets the properties which a characteristic's GATT handle has. 2.3.1. More... | |
int | bt_gatt_characteristic_get_write_type (bt_gatt_h characteristic, bt_gatt_write_type_e *write_type) |
Gets the write type of the specified characteristic. 2.3.1. More... | |
int | bt_gatt_characteristic_set_write_type (bt_gatt_h characteristic, bt_gatt_write_type_e write_type) |
Updates the write type of the specified characteristic. 2.3.1. More... | |
int | bt_gatt_characteristic_get_descriptor (bt_gatt_h characteristic, const char *uuid, bt_gatt_h *descriptor) |
Gets a descriptor's GATT handle which has specific UUID. 2.3.1. More... | |
int | bt_gatt_characteristic_foreach_descriptors (bt_gatt_h characteristic, bt_gatt_foreach_cb callback, void *user_data) |
Invokes callback function on each descriptor that belongs to the specified characteristic. 2.3.1. More... | |
int | bt_gatt_descriptor_get_characteristic (bt_gatt_h descriptor, bt_gatt_h *characteristic) |
Gets the characteristic's GATT handle which the specified descriptor belongs to. 2.3.1. More... | |
int | bt_gatt_client_create (const char *remote_address, bt_gatt_client_h *client) |
Creates the GATT client handle. 2.3.1. More... | |
int | bt_gatt_client_destroy (bt_gatt_client_h client) |
Destroys the GATT client's handle. 2.3.1. More... | |
int | bt_gatt_client_get_remote_address (bt_gatt_client_h client, char **remote_address) |
Gets the address of remote device. 2.3.1. More... | |
int | bt_gatt_client_read_value (bt_gatt_h gatt_handle, bt_gatt_client_request_completed_cb callback, void *user_data) |
Reads the value of a characteristic or descriptor from the remote device asynchronously. 2.3.1 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_gatt_client_write_value (bt_gatt_h gatt_handle, bt_gatt_client_request_completed_cb callback, void *user_data) |
Writes the value of a characteristic or descriptor to the remote device asynchronously. 2.3.1 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_gatt_client_request_att_mtu_change (bt_gatt_client_h client, unsigned int mtu) |
Requests a change of the ATT MTU value. 4.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_gatt_client_get_att_mtu (bt_gatt_client_h client, unsigned int *mtu) |
Gets the ATT MTU value set for a connection. 4.0. More... | |
int | bt_gatt_client_set_att_mtu_changed_cb (bt_gatt_client_h client, bt_gatt_client_att_mtu_changed_cb callback, void *user_data) |
Registers a callback function to be invoked when the ATT MTU is changed. 4.0. More... | |
int | bt_gatt_client_unset_att_mtu_changed_cb (bt_gatt_client_h client) |
Unregisters the callback function to be invoked when the ATT MTU is changed. 4.0. More... | |
int | bt_gatt_client_set_characteristic_value_changed_cb (bt_gatt_h characteristic, bt_gatt_client_characteristic_value_changed_cb callback, void *user_data) |
Registers a callback function to be invoked when the characteristic value is changed on the remote device. 2.3.1. More... | |
int | bt_gatt_client_unset_characteristic_value_changed_cb (bt_gatt_h characteristic) |
Unregisters a callback function to be invoked when the characteristic value is changed on the remote device. 2.3.1. More... | |
int | bt_gatt_client_get_service (bt_gatt_client_h client, const char *uuid, bt_gatt_h *service) |
Gets a service's GATT handle which has specific UUID. 2.3.1. More... | |
int | bt_gatt_client_foreach_services (bt_gatt_client_h client, bt_gatt_foreach_cb callback, void *user_data) |
Invokes callback function on each service that belongs to the specified GATT client. 2.3.1. More... | |
int | bt_gatt_client_set_service_changed_cb (bt_gatt_client_h client, bt_gatt_client_service_changed_cb callback, void *user_data) |
Registers a callback function to be invoked when service is changed from a remote device(GATT server). 3.0. More... | |
int | bt_gatt_client_unset_service_changed_cb (bt_gatt_client_h client) |
Unregisters a callback function. 3.0. More... | |
int | bt_gatt_connect (const char *address, bool auto_connect) |
Connects to a specific LE based service on a remote bluetooth device address, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_gatt_disconnect (const char *address) |
Disconnects to LE connection with the given remote Bluetooth device address, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_gatt_set_connection_state_changed_cb (bt_gatt_connection_state_changed_cb callback, void *user_data) |
Registers a callback function that will be invoked when the connection state is changed. 2.3. More... | |
int | bt_gatt_unset_connection_state_changed_cb (void) |
Unregisters a callback function that will be invoked when the connection state is changed. 2.3. More... | |
int | bt_gatt_service_destroy (bt_gatt_h gatt_handle) |
Destroys the GATT handle of service. 3.0. More... | |
int | bt_gatt_characteristic_destroy (bt_gatt_h gatt_handle) |
Destroys the GATT handle of characteristic. 3.0. More... | |
int | bt_gatt_descriptor_destroy (bt_gatt_h gatt_handle) |
Destroys the GATT handle of descriptor. 3.0. More... | |
int | bt_gatt_characteristic_get_permissions (bt_gatt_h gatt_handle, int *permissions) |
Gets the permissions which a characteristic's GATT handle has. 3.0. More... | |
int | bt_gatt_descriptor_get_permissions (bt_gatt_h gatt_handle, int *permissions) |
Gets the permissions which a descriptor's GATT handle has. 3.0. More... | |
int | bt_gatt_service_create (const char *uuid, bt_gatt_service_type_e type, bt_gatt_h *service) |
Creates the GATT service. 3.0. More... | |
int | bt_gatt_service_add_characteristic (bt_gatt_h service, bt_gatt_h characteristic) |
Adds a characteristic to a specified service. 3.0. More... | |
int | bt_gatt_service_add_included_service (bt_gatt_h service, bt_gatt_h included_service) |
Adds a service to a specified service as included service. 3.0. More... | |
int | bt_gatt_service_get_server (bt_gatt_h service, bt_gatt_server_h *server) |
Gets the GATT server handle to which the specified service belongs. 3.0. More... | |
int | bt_gatt_characteristic_create (const char *uuid, int permissions, int properties, const char *value, int value_length, bt_gatt_h *characteristic) |
Creates the GATT characteristic. 3.0. More... | |
int | bt_gatt_characteristic_add_descriptor (bt_gatt_h characteristic, bt_gatt_h descriptor) |
Adds a descriptor to a specified characteristic. 3.0. More... | |
int | bt_gatt_descriptor_create (const char *uuid, int permissions, const char *value, int value_length, bt_gatt_h *descriptor) |
Creates the GATT characteristic descriptor. 3.0. More... | |
int | bt_gatt_server_initialize (void) |
Initializes the GATT Server. 3.0. More... | |
int | bt_gatt_server_deinitialize (void) |
DeInitializes the GATT server. 3.0. More... | |
int | bt_gatt_server_create (bt_gatt_server_h *server) |
Creates the GATT server's handle. 3.0. More... | |
int | bt_gatt_server_destroy (bt_gatt_server_h server) |
Destroys the GATT server's handle. 3.0. More... | |
int | bt_gatt_server_set_read_value_requested_cb (bt_gatt_h gatt_handle, bt_gatt_server_read_value_requested_cb callback, void *user_data) |
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). 3.0. More... | |
int | bt_gatt_server_set_characteristic_notification_state_change_cb (bt_gatt_h gatt_handle, bt_gatt_server_characteristic_notification_state_changed_cb callback, void *user_data) |
Registers a callback function to be invoked when the remote device enables or disables the Notification/Indication for particular characteristics. 3.0. More... | |
int | bt_gatt_server_set_write_value_requested_cb (bt_gatt_h gatt_handle, bt_gatt_server_write_value_requested_cb callback, void *user_data) |
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. 3.0. More... | |
int | bt_gatt_server_register_service (bt_gatt_server_h server, bt_gatt_h service) |
Registers a specified service to the specified GATT server that the local device is hosting. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_gatt_server_unregister_service (bt_gatt_server_h server, bt_gatt_h service) |
Unregisters a specified service from the specified GATT server that the local device is hosting. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_gatt_server_unregister_all_services (bt_gatt_server_h server) |
Unregisters all services from the specified GATT server that the local device is hosting. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_gatt_server_start (void) |
Registers the application along with the GATT services of the application it is hosting. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_gatt_server_send_response (int request_id, bt_gatt_att_request_type_e request_type, int offset, int resp_status, char *value, int value_length) |
Sends a response to the remote device as a result of a read/write request. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_gatt_server_notify_characteristic_changed_value (bt_gatt_h characteristic, bt_gatt_server_notification_sent_cb callback, const char *device_address, void *user_data) |
Notifies value change of the characteristic to the remote devices which enable a Client Characteristic Configuration Descriptor. 3.0. More... | |
int | bt_gatt_server_get_service (bt_gatt_server_h server, const char *uuid, bt_gatt_h *service) |
Gets a service's GATT handle which has specific UUID. 3.0. More... | |
int | bt_gatt_server_foreach_services (bt_gatt_server_h server, bt_gatt_foreach_cb callback, void *user_data) |
Invokes callback function on each service that belongs to the specified GATT server. 3.0. More... | |
int | bt_pbap_client_initialize (void) |
Initializes the Bluetooth PBAP Client. More... | |
int | bt_pbap_client_deinitialize (void) |
Deinitializes the Bluetooth PBAP Client. More... | |
int | bt_pbap_client_set_connection_state_changed_cb (bt_pbap_connection_state_changed_cb callback, void *user_data) |
Registers a callback function that will be invoked when the connection state is changed. 3.0. More... | |
int | bt_pbap_client_unset_connection_state_changed_cb (void) |
Unregisters a callback function that will be invoked when the connection state is changed. 3.0. More... | |
int | bt_pbap_client_connect (const char *address) |
Connects to PBAP server, asynchronously. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_pbap_client_disconnect (const char *address) |
Disconnects from PBAP server, asynchronously. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_pbap_client_get_phone_book_size (const char *address, bt_pbap_address_book_source_e source, bt_pbap_folder_type_e folder_type, bt_pbap_phone_book_size_cb callback, void *user_data) |
Gets size of phone book from PBAP server, asynchronously. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_pbap_client_get_phone_book (const char *address, bt_pbap_address_book_source_e source, bt_pbap_folder_type_e folder_type, bt_pbap_vcard_format_e format, bt_pbap_sort_order_e order, unsigned short offset, unsigned short max_list_count, unsigned int fields, bt_pbap_phone_book_received_cb callback, void *user_data) |
Gets all contacts and call logs as vCard from PBAP server, asynchronously. More... | |
int | bt_pbap_client_get_list (const char *address, bt_pbap_address_book_source_e source, bt_pbap_folder_type_e folder_type, bt_pbap_sort_order_e order, unsigned short offset, unsigned short max_list_count, bt_pbap_list_vcards_cb callback, void *user_data) |
Gets contact and call log information from the PBAP server, asynchronously. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_pbap_client_pull_vcard (const char *address, bt_pbap_address_book_source_e source, bt_pbap_folder_type_e folder_type, int index, bt_pbap_vcard_format_e format, unsigned int fields, bt_pbap_phone_book_received_cb callback, void *user_data) |
Gets the selected contact using the index parameter as vCard from PBAP server, asynchronously. More... | |
int | bt_pbap_client_search_phone_book (const char *address, bt_pbap_address_book_source_e source, bt_pbap_folder_type_e folder_type, bt_pbap_search_field_e search_attribute, const char *search_value, bt_pbap_sort_order_e order, unsigned short offset, unsigned short max_list_count, bt_pbap_list_vcards_cb callback, void *user_data) |
Finds and fetches the contact and call log information from the PBAP server, asynchronously. 3.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_le_scan_filter_create (bt_scan_filter_h *scan_filter) |
Creates a scan filter to find only LE advertisements which match specific requirements. More... | |
int | bt_adapter_le_scan_filter_destroy (bt_scan_filter_h scan_filter) |
Destroys a scan filter. 4.0. More... | |
int | bt_adapter_le_scan_filter_set_device_address (bt_scan_filter_h scan_filter, const char *address) |
Sets the device address for the advertisements filter. 4.0. More... | |
int | bt_adapter_le_scan_filter_set_device_name (bt_scan_filter_h scan_filter, const char *name) |
Sets the device name for the advertisements filter. More... | |
int | bt_adapter_le_scan_filter_set_service_uuid (bt_scan_filter_h scan_filter, const char *uuid) |
Sets the service UUID for the advertisements filter. More... | |
int | bt_adapter_le_scan_filter_set_service_uuid_with_mask (bt_scan_filter_h scan_filter, const char *uuid, const char *mask) |
Sets the service UUID and the mask for the advertisements filter, to use for filtering by partial data. More... | |
int | bt_adapter_le_scan_filter_set_service_solicitation_uuid (bt_scan_filter_h scan_filter, const char *uuid) |
Sets the service solicitation UUID for the advertisements filter. More... | |
int | bt_adapter_le_scan_filter_set_service_solicitation_uuid_with_mask (bt_scan_filter_h scan_filter, const char *uuid, const char *mask) |
Sets the service solicitation UUID and the mask for the advertisements filter, to use for filtering by partial data. More... | |
int | bt_adapter_le_scan_filter_set_service_data (bt_scan_filter_h scan_filter, const char *uuid, const char *data, unsigned int data_len) |
Sets the service data for the advertisements filter. More... | |
int | bt_adapter_le_scan_filter_set_service_data_with_mask (bt_scan_filter_h scan_filter, const char *uuid, const char *data, unsigned int data_len, const char *mask, unsigned int mask_len) |
Sets the service data and the mask for the advertisements filter, to use for filtering by partial data. More... | |
int | bt_adapter_le_scan_filter_set_manufacturer_data (bt_scan_filter_h scan_filter, int manufacturer_id, const char *data, unsigned int data_len) |
Sets the manufacturer data for the advertisements filter. More... | |
int | bt_adapter_le_scan_filter_set_manufacturer_data_with_mask (bt_scan_filter_h scan_filter, int manufacturer_id, const char *data, unsigned int data_len, const char *mask, unsigned int mask_len) |
Sets the manufacturer data and the mask for the advertisements filter, to use for filtering by partial data. More... | |
int | bt_adapter_le_scan_filter_set_type (bt_scan_filter_h scan_filter, bt_adapter_le_scan_filter_type_e mode) |
Sets the scan filter type for the advertisements filter. More... | |
int | bt_adapter_le_scan_filter_register (bt_scan_filter_h scan_filter) |
Registers a scan filter to use for scanning. More... | |
int | bt_adapter_le_scan_filter_unregister (bt_scan_filter_h scan_filter) |
Unregisters all registered scan filters. 4.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_le_scan_filter_unregister_all (void) |
Unregisters all registered scan filters. 4.0 public http://tizen.org/privilege/bluetooth. More... | |
int | bt_adapter_le_is_2m_phy_supported (bool *is_supported) |
Checks if LE 2M PHY feature is supported or not. 5.0. More... | |
int | bt_adapter_le_is_coded_phy_supported (bool *is_supported) |
Checks if LE CODED PHY feature is supported or not. 5.0. More... | |
enum bt_error_e |
Enumerations of Bluetooth error codes. 2.3.
Definition at line 82 of file bluetooth_type.h.
int bt_adapter_foreach_bonded_device | ( | bt_adapter_bonded_device_cb | callback, |
void * | user_data | ||
) |
Retrieves the device information of all bonded devices. 2.3.
[in] | callback | The callback function to invoke |
[in] | user_data | The user data passed from the foreach function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_free_device_info | ( | bt_device_info_s * | device_info | ) |
Frees device info. 2.3.
[in] | device_info | The bonded device information |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_get_address | ( | char ** | local_address | ) |
Gets the address of local Bluetooth adapter. 2.3.
[out] | local_address | The device address of local Bluetooth adapter |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_get_bonded_device_info | ( | const char * | remote_address, |
bt_device_info_s ** | device_info | ||
) |
Gets the device information of a bonded device. 2.3.
[in] | remote_address | The address of remote device |
[out] | device_info | The bonded device information |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_BONDED | Remote device not bonded |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_get_local_oob_data | ( | unsigned char ** | hash, |
unsigned char ** | randomizer, | ||
int * | hash_len, | ||
int * | randomizer_len | ||
) |
Gets the Hash and Randomizer value, synchronously. 2.3 public http://tizen.org/privilege/bluetooth.
[out] | hash | The hash value received from the controller |
[out] | randomizer | The hash value received from the controller |
[out] | hash_len | The length of the hash value |
[out] | randomizer_len | The length of the randomizer value |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_get_local_oob_ext_data | ( | unsigned char ** | hash192, |
unsigned char ** | randomizer192, | ||
int * | hash192_len, | ||
int * | randomizer192_len, | ||
unsigned char ** | hash256, | ||
unsigned char ** | randomizer256, | ||
int * | hash256_len, | ||
int * | randomizer256_len | ||
) |
Gets the Hash and Randomizer value, synchronously. 3.0 public http://tizen.org/privilege/bluetooth.
[out] | hash192 | The hash value derived from the P-192 public key |
[out] | randomizer192 | The randomizer value associated with the P-192 public key |
[out] | hash192_len | The length of hash192 |
[out] | randomizer192_len | The length of randomizer192 |
[out] | hash256 | The hash value derived from the P-256 public key |
[out] | randomizer256 | The randomizer value associated with the P-256 public key |
[out] | hash256_len | The length of hash256 |
[out] | randomizer256_len | The length of randomizer256 |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_get_name | ( | char ** | local_name | ) |
Gets the name of local Bluetooth adapter.
Use this function to get the friendly name associated with Bluetooth
device, retrieved by the remote Bluetooth devices.
2.3
[out] | local_name | The local device name |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_get_state | ( | bt_adapter_state_e * | adapter_state | ) |
Gets the current state of local Bluetooth adapter. 2.3.
[out] | adapter_state | The current adapter state |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_get_visibility | ( | bt_adapter_visibility_mode_e * | mode, |
int * | duration | ||
) |
Gets the visibility mode of local Bluetooth adapter. 2.3.
[out] | mode | The visibility mode of the Bluetooth device |
[out] | duration | The duration until the visibility mode is changed to BT_ADAPTER_VISIBILITY_MODE_NON_DISCOVERABLE (in seconds). duration is valid only if mode is BT_ADAPTER_VISIBILITY_MODE_LIMITED_DISCOVERABLE. This value can be NULL. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_is_discovering | ( | bool * | is_discovering | ) |
Checks for the device discovery is in progress or not. 2.3.
[out] | is_discovering | The discovering status: (true = in progress , false = not in progress ) |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_is_service_used | ( | const char * | service_uuid, |
bool * | used | ||
) |
Checks whether the UUID of service is used or not. 2.3.
[in] | service_uuid | The UUID of service |
[out] | used | Indicates whether the service is used or not |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_add_advertising_manufacturer_data | ( | bt_advertiser_h | advertiser, |
bt_adapter_le_packet_type_e | pkt_type, | ||
int | manufacturer_id, | ||
const char * | manufacturer_data, | ||
int | manufacturer_data_len | ||
) |
Adds manufacturer specific data to advertise or scan response data. Please refer to the Bluetooth Assigned Numbers provided by the Bluetooth SIG for a list of existing company identifiers. The maximum advertised or responded data size is 31 bytes including data type and system wide data. 2.3.1.
[in] | advertiser | The handle of advertiser |
[in] | pkt_type | The packet type |
[in] | manufacturer_id | Manufacturer identifier |
[in] | manufacturer_data | The manufacturer specific data |
[in] | manufacturer_data_len | The data length of manufacturer data |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_QUOTA_EXCEEDED | Quota exceeded |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_add_advertising_service_data | ( | bt_advertiser_h | advertiser, |
bt_adapter_le_packet_type_e | pkt_type, | ||
const char * | uuid, | ||
const char * | service_data, | ||
int | service_data_len | ||
) |
Adds service data to advertise or scan response data. The maximum advertised or responded data size is 31 bytes including data type and system wide data. 2.3.1.
[in] | advertiser | The handle of advertiser |
[in] | pkt_type | The packet type |
[in] | uuid | 16-bit UUID of the service |
[in] | service_data | The service data |
[in] | service_data_len | The data length of service data |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_QUOTA_EXCEEDED | Quota exceeded |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_add_advertising_service_solicitation_uuid | ( | bt_advertiser_h | advertiser, |
bt_adapter_le_packet_type_e | pkt_type, | ||
const char * | uuid | ||
) |
Adds a service solicitation UUID to advertise or scan response data. The maximum advertised or responded data size is 31 bytes including data type and system wide data. 2.3.1.
[in] | advertiser | The handle of advertiser |
[in] | pkt_type | The packet type |
[in] | uuid | The string of the service solicitation UUID. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_QUOTA_EXCEEDED | Quota exceeded |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_add_advertising_service_uuid | ( | bt_advertiser_h | advertiser, |
bt_adapter_le_packet_type_e | pkt_type, | ||
const char * | uuid | ||
) |
Adds a service UUID to advertise or scan response data. The maximum advertised or responded data size is 31 bytes including data type and system wide data. 2.3.1.
[in] | advertiser | The handle of advertiser |
[in] | pkt_type | The packet type |
[in] | uuid | The string of the service UUID. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_QUOTA_EXCEEDED | Quota exceeded |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_clear_advertising_data | ( | bt_advertiser_h | advertiser, |
bt_adapter_le_packet_type_e | pkt_type | ||
) |
Clears all data to be advertised or responded to scan request from LE scanning device. 2.3.
[in] | advertiser | The handle of advertiser |
[in] | pkt_type | The packet type to be cleared |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_create_advertiser | ( | bt_advertiser_h * | advertiser | ) |
Creates advertiser to advertise device's existence or respond to LE scanning request. 2.3.
[out] | advertiser | The handle of advertiser |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_destroy_advertiser | ( | bt_advertiser_h | advertiser | ) |
Destroys advertiser. 2.3.
[out] | advertiser | The handle of advertiser |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_free_ibeacon_report | ( | bt_adapter_le_ibeacon_scan_result_info_s * | ibeacon_info | ) |
Frees iBeacon information. 4.0.
[in] | ibeacon_info | The iBeacon format's scan result data |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_free_service_data_list | ( | bt_adapter_le_service_data_s * | data_list, |
int | count | ||
) |
Frees service data list. 2.3.1.
[in] | data_list | The list of the service data |
[in] | count | The count of the service data list |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_get_scan_result_appearance | ( | const bt_adapter_le_device_scan_result_info_s * | info, |
bt_adapter_le_packet_type_e | pkt_type, | ||
int * | appearance | ||
) |
Gets the appearance from the scan result information. 2.3.1.
[in] | info | The scan result information |
[in] | pkt_type | The packet type |
[out] | appearance | The appearance |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NO_DATA | No data available |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_get_scan_result_device_name | ( | const bt_adapter_le_device_scan_result_info_s * | info, |
bt_adapter_le_packet_type_e | pkt_type, | ||
char ** | name | ||
) |
Gets the device name from the scan result information. 2.3.1.
[in] | info | The scan result information |
[in] | pkt_type | The packet type |
[out] | name | The device name |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NO_DATA | No data available |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_get_scan_result_ibeacon_report | ( | const bt_adapter_le_device_scan_result_info_s * | info, |
bt_adapter_le_packet_type_e | pkt_type, | ||
bt_adapter_le_ibeacon_scan_result_info_s ** | ibeacon_info | ||
) |
Gets iBeacon format's data from the scan result information. 4.0.
[in] | info | The scan result information |
[in] | pkt_type | The packet type |
[out] | ibeacon_info | The iBeacon format's scan result data |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NO_DATA | No data available |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_get_scan_result_manufacturer_data | ( | const bt_adapter_le_device_scan_result_info_s * | info, |
bt_adapter_le_packet_type_e | pkt_type, | ||
int * | manufacturer_id, | ||
char ** | manufacturer_data, | ||
int * | manufacturer_data_len | ||
) |
Gets the manufacturer data from the scan result information. 2.3.1.
[in] | info | The scan result information |
[in] | pkt_type | The packet type |
[out] | manufacturer_id | The manufacturer ID |
[out] | manufacturer_data | The manufacturer data (byte array) |
[out] | manufacturer_data_len | The length of manufacturer data |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NO_DATA | No data available |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_get_scan_result_service_data_list | ( | const bt_adapter_le_device_scan_result_info_s * | info, |
bt_adapter_le_packet_type_e | pkt_type, | ||
bt_adapter_le_service_data_s ** | data_list, | ||
int * | count | ||
) |
Gets the service data list from the scan result information. 2.3.1.
[in] | info | The scan result information |
[in] | pkt_type | The packet type |
[out] | data_list | The list of the service data |
[out] | count | The count of the service data list |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NO_DATA | No data available |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_get_scan_result_service_solicitation_uuids | ( | const bt_adapter_le_device_scan_result_info_s * | info, |
bt_adapter_le_packet_type_e | pkt_type, | ||
char *** | uuids, | ||
int * | count | ||
) |
Gets the service solicitation UUID list from the scan result information. 2.3.1.
[in] | info | The scan result information |
[in] | pkt_type | The packet type |
[out] | uuids | The list of string of the service solicitation UUID |
[out] | count | The count of the service UUIDs |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NO_DATA | No data available |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_get_scan_result_service_uuids | ( | const bt_adapter_le_device_scan_result_info_s * | info, |
bt_adapter_le_packet_type_e | pkt_type, | ||
char *** | uuids, | ||
int * | count | ||
) |
Gets the service UUID list from the scan result information. 2.3.1.
[in] | info | The scan result information |
[in] | pkt_type | The packet type |
[out] | uuids | The list of string of the service UUID |
[out] | count | The count of the service UUIDs |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NO_DATA | No data available |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_get_scan_result_tx_power_level | ( | const bt_adapter_le_device_scan_result_info_s * | info, |
bt_adapter_le_packet_type_e | pkt_type, | ||
int * | power_level | ||
) |
Gets the transmission power level from the scan result information. 2.3.1.
[in] | info | The scan result information |
[in] | pkt_type | The packet type |
[out] | power_level | The transmission power level in dBm |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NO_DATA | No data available |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_is_2m_phy_supported | ( | bool * | is_supported | ) |
Checks if LE 2M PHY feature is supported or not. 5.0.
[out] | is_supported | The LE 2M PHY feature support: (true = supported , false = not supported) |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Adapter is not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_is_coded_phy_supported | ( | bool * | is_supported | ) |
Checks if LE CODED PHY feature is supported or not. 5.0.
[out] | is_supported | The LE CODED PHY feature support: (true = supported , false = not supported) |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Adapter is not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_is_discovering | ( | bool * | is_discovering | ) |
Checks for the LE device discovery is in progress or not. 2.3.
[out] | is_discovering | The discovering status: (true = in progress , false = not in progress ) |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_create | ( | bt_scan_filter_h * | scan_filter | ) |
Creates a scan filter to find only LE advertisements which match specific requirements.
If the filter's attribute is not set, then the filter will accept all values of that attribute. If an attribute is set, the filter will accept only advertisements which match the set attribute.
For example, if device name is set with bt_adapter_le_scan_filter_set_device_name(), the filter will accept only advertisements from devices with the given name. If device name is not set, advertisements will be filtered without regard to device names. 4.0
[out] | scan_filter | The scan filter handle |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_destroy | ( | bt_scan_filter_h | scan_filter | ) |
Destroys a scan filter. 4.0.
[in] | scan_filter | The scan filter handle |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_register | ( | bt_scan_filter_h | scan_filter | ) |
Registers a scan filter to use for scanning.
If the filter is registered, it cannot be changed. 4.0 public http://tizen.org/privilege/bluetooth
[in] | scan_filter | The scan filter handle |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOW_IN_PROGRESS | Scan is in progress |
BT_ERROR_NOT_SUPPORTED | Not supported |
BT_ERROR_PERMISSION_DENIED | Permission denied |
int bt_adapter_le_scan_filter_set_device_address | ( | bt_scan_filter_h | scan_filter, |
const char * | address | ||
) |
Sets the device address for the advertisements filter. 4.0.
[in] | scan_filter | The scan filter handle |
[in] | address | The device address by which advertisements will be filtered |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_set_device_name | ( | bt_scan_filter_h | scan_filter, |
const char * | name | ||
) |
Sets the device name for the advertisements filter.
Any previously set value will be overwritten. 4.0
[in] | scan_filter | The scan filter handle |
[in] | name | The device name by which advertisements will be filtered |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_set_manufacturer_data | ( | bt_scan_filter_h | scan_filter, |
int | manufacturer_id, | ||
const char * | data, | ||
unsigned int | data_len | ||
) |
Sets the manufacturer data for the advertisements filter.
Any previously set value will be overwritten. 4.0
[in] | scan_filter | The scan filter handle |
[in] | manufacturer_id | The manufacturer ID (0x0000 ~ 0xFFFF) |
[in] | data | The manufacturer data (byte array) |
[in] | data_len | The length of the manufacturer data |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_set_manufacturer_data_with_mask | ( | bt_scan_filter_h | scan_filter, |
int | manufacturer_id, | ||
const char * | data, | ||
unsigned int | data_len, | ||
const char * | mask, | ||
unsigned int | mask_len | ||
) |
Sets the manufacturer data and the mask for the advertisements filter, to use for filtering by partial data.
Any previously set value will be overwritten. The mask works as follows: For each bit set to 1 in the mask, the corresponding bits in data and in the filtered data will have to be equal. If the mask bit is set to 0, the corresponding bits will be ignored. 4.0
[in] | scan_filter | The scan filter handle |
[in] | manufacturer_id | The manufacturer ID (0x0000 ~ 0xFFFF) |
[in] | data | The manufacturer data (byte array) |
[in] | data_len | The length of the manufacturer data |
[in] | mask | The mask by which advertisements will be filtered |
[in] | mask_len | The length of the mask |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_set_service_data | ( | bt_scan_filter_h | scan_filter, |
const char * | uuid, | ||
const char * | data, | ||
unsigned int | data_len | ||
) |
Sets the service data for the advertisements filter.
Any previously set value will be overwritten. 4.0
[in] | scan_filter | The scan filter handle |
[in] | uuid | The service UUID by which advertisements will be filtered |
[in] | data | The service data by which advertisements will be filtered |
[in] | data_len | The length of the service data |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_set_service_data_with_mask | ( | bt_scan_filter_h | scan_filter, |
const char * | uuid, | ||
const char * | data, | ||
unsigned int | data_len, | ||
const char * | mask, | ||
unsigned int | mask_len | ||
) |
Sets the service data and the mask for the advertisements filter, to use for filtering by partial data.
Any previously set value will be overwritten. The mask works as follows: For each bit set to 1 in the mask, the corresponding bits in data and in the filtered data will have to be equal. If the mask bit is set to 0, the corresponding bits will be ignored. 4.0
[in] | scan_filter | The scan filter handle |
[in] | uuid | The service UUID by which advertisements will be filtered |
[in] | data | The service data by which advertisements will be filtered |
[in] | data_len | The length of the service data |
[in] | mask | The mask by which advertisements will be filtered |
[in] | mask_len | The length of the mask |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_set_service_solicitation_uuid | ( | bt_scan_filter_h | scan_filter, |
const char * | uuid | ||
) |
Sets the service solicitation UUID for the advertisements filter.
Any previously set value will be overwritten. 4.0
[in] | scan_filter | The scan filter handle |
[in] | uuid | The service solicitation UUID by which advertisements will be filtered |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_set_service_solicitation_uuid_with_mask | ( | bt_scan_filter_h | scan_filter, |
const char * | uuid, | ||
const char * | mask | ||
) |
Sets the service solicitation UUID and the mask for the advertisements filter, to use for filtering by partial data.
Any previously set value will be overwritten. The mask works as follows: For each bit set to 1 in the mask, the corresponding bits in uuid and in the filtered data will have to be equal. If the mask bit is set to 0, the corresponding bits will be ignored. 4.0
[in] | scan_filter | The scan filter handle |
[in] | uuid | The service solicitation UUID by which advertisements will be filtered |
[in] | mask | The mask by which advertisements will be filtered |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_set_service_uuid | ( | bt_scan_filter_h | scan_filter, |
const char * | uuid | ||
) |
Sets the service UUID for the advertisements filter.
Any previously set value will be overwritten. 4.0
[in] | scan_filter | The scan filter handle |
[in] | uuid | The service UUID by which advertisements will be filtered |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_set_service_uuid_with_mask | ( | bt_scan_filter_h | scan_filter, |
const char * | uuid, | ||
const char * | mask | ||
) |
Sets the service UUID and the mask for the advertisements filter, to use for filtering by partial data.
Any previously set value will be overwritten. The mask works as follows: For each bit set to 1 in the mask, the corresponding bits in uuid and in the filtered data will have to be equal. If the mask bit is set to 0, the corresponding bits will be ignored. 4.0
[in] | scan_filter | The scan filter handle |
[in] | uuid | The service UUID by which advertisements will be filtered |
[in] | mask | The mask to filter advertisements |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_set_type | ( | bt_scan_filter_h | scan_filter, |
bt_adapter_le_scan_filter_type_e | mode | ||
) |
Sets the scan filter type for the advertisements filter.
The filter type is used when searching only for iBeacon or proximity type's advertising data. If the type is not set, LE scanner will search devices as with regard to other filtered attributes. If the type is set, all other attributes set for the filter are ignored. 4.0
[in] | scan_filter | The scan filter handle |
[in] | mode | The scan filter type |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_scan_filter_unregister | ( | bt_scan_filter_h | scan_filter | ) |
Unregisters all registered scan filters. 4.0 public http://tizen.org/privilege/bluetooth.
[in] | scan_filter | The scan filter handle |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOW_IN_PROGRESS | Scan is in progress |
BT_ERROR_NOT_SUPPORTED | Not supported |
BT_ERROR_PERMISSION_DENIED | Permission denied |
int bt_adapter_le_scan_filter_unregister_all | ( | void | ) |
Unregisters all registered scan filters. 4.0 public http://tizen.org/privilege/bluetooth.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOW_IN_PROGRESS | Scan is in progress |
BT_ERROR_NOT_SUPPORTED | Not supported |
BT_ERROR_PERMISSION_DENIED | Permission denied |
int bt_adapter_le_set_advertising_appearance | ( | bt_advertiser_h | advertiser, |
bt_adapter_le_packet_type_e | pkt_type, | ||
int | appearance | ||
) |
Sets the external appearance of this device to advertise or scan response data. Please refer to the adopted Bluetooth specification for the the appearance. 2.3.1.
[in] | advertiser | The handle of advertiser |
[in] | pkt_type | The packet type |
[in] | appearance | The external appearance of device |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_QUOTA_EXCEEDED | Quota exceeded |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_set_advertising_connectable | ( | bt_advertiser_h | advertiser, |
bool | connectable | ||
) |
Sets whether the advertising type should be connectable or non-connectable. 2.3.1 public http://tizen.org/privilege/bluetooth.
[in] | advertiser | The handle of advertiser |
[in] | connectable | The type of advertising |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_NOW_IN_PROGRESS | Operation is now in progress |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_set_advertising_device_name | ( | bt_advertiser_h | advertiser, |
bt_adapter_le_packet_type_e | pkt_type, | ||
bool | include_name | ||
) |
Sets whether the device name should be included in advertise or scan response data. The maximum advertised or responded data size is 31 bytes including data type and system wide data. 2.3.1.
[in] | advertiser | The handle of advertiser |
[in] | pkt_type | The packet type |
[in] | include_name | Whether the device name should be included |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_QUOTA_EXCEEDED | Quota exceeded |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_set_advertising_mode | ( | bt_advertiser_h | advertiser, |
bt_adapter_le_advertising_mode_e | mode | ||
) |
Sets advertising mode to control the advertising power and latency. 2.3.1 public http://tizen.org/privilege/bluetooth.
[in] | advertiser | The handle of advertiser |
[in] | mode | The mode of advertising |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_NOW_IN_PROGRESS | Operation is now in progress |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
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 | ||
) |
Sets whether the transmission power level should be included in advertise or scan response data. The maximum advertised or responded data size is 31 bytes including data type and system wide data. 2.3.1.
[in] | advertiser | The handle of advertiser |
[in] | pkt_type | The packet type |
[in] | include_tx_power | Whether the transmission power level should be included |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_QUOTA_EXCEEDED | Quota exceeded |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_set_scan_mode | ( | bt_adapter_le_scan_mode_e | scan_mode | ) |
Sets Bluetooth LE scan mode. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | scan_mode | The scan mode |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_ENABLED | Adapter is not enabled |
BT_ERROR_INVALID_PARAMETER | Parameter is invalid |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_start_advertising_new | ( | bt_advertiser_h | advertiser, |
bt_adapter_le_advertising_state_changed_cb | cb, | ||
void * | user_data | ||
) |
Starts advertising with passed advertiser and advertising parameters.
Once Bluetooth advertising is started, nearby Bluetooth LE (Low Energy) supported
devices can know this device's existence. And one of them can make a connection request,
if it is allowed.
2.3.1 public http://tizen.org/privilege/bluetooth
[in] | advertiser | The handle of advertiser |
[in] | cb | The callback to report the result of this function |
[in] | user_data | The user data to be passed when callback is called |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_NOW_IN_PROGRESS | Operation is now in progress |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_start_scan | ( | bt_adapter_le_scan_result_cb | cb, |
void * | user_data | ||
) |
Starts the LE scan to find LE advertisement.
If a LE advertisement is found, bt_adapter_le_scan_result_cb() will be invoked.
2.3.1 public http://tizen.org/privilege/bluetooth
[in] | cb | The callback to report the result of this function |
[in] | user_data | The user data to be passed when callback is called |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_NOW_IN_PROGRESS | Operation is now in progress |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_stop_advertising | ( | bt_advertiser_h | advertiser | ) |
Stops the advertising. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | advertiser | The handle of advertiser |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_NOT_IN_PROGRESS | Operation is not in progress |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_le_stop_scan | ( | void | ) |
Stops the LE scan. 2.3.1 public http://tizen.org/privilege/bluetooth.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_NOT_IN_PROGRESS | Operation is not in progress |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_remove_remote_oob_data | ( | const char * | remote_address | ) |
Deletes the Hash and Randomizer value, synchronously. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | Remote device address |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_set_device_discovery_state_changed_cb | ( | bt_adapter_device_discovery_state_changed_cb | callback, |
void * | user_data | ||
) |
Registers a callback function to be invoked when the device discovery state changes. 2.3.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_set_name | ( | const char * | local_name | ) |
Sets the name of local Bluetooth adapter. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | local_name | The name of the Bluetooth device. The maximum length is 248 characters. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_set_name_changed_cb | ( | bt_adapter_name_changed_cb | callback, |
void * | user_data | ||
) |
Registers a callback function to be invoked when the name of Bluetooth adapter changes. 2.3.
[in] | callback | The callback function to invoke |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_set_remote_oob_data | ( | const char * | remote_address, |
unsigned char * | hash, | ||
unsigned char * | randomizer, | ||
int | hash_len, | ||
int | randomizer_len | ||
) |
Sets the Hash and Randomizer value, synchronously. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | Remote device address |
[in] | hash | The hash value received from the controller |
[in] | randomizer | The hash value received from the controller |
[in] | hash_len | The length of the hash value. Allowed value is 16 |
[in] | randomizer_len | The length of the randomizer value. Allowed value is 16 |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_set_remote_oob_ext_data | ( | const char * | remote_address, |
const unsigned char * | hash192, | ||
const unsigned char * | randomizer192, | ||
int | hash192_len, | ||
int | randomizer192_len, | ||
const unsigned char * | hash256, | ||
const unsigned char * | randomizer256, | ||
int | hash256_len, | ||
int | randomizer256_len | ||
) |
Sets the Hash and Randomizer value, synchronously. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | Remote device address |
[in] | hash192 | The P-192 hash value received via OOB from remote device |
[in] | randomizer192 | The P-192 randomizer value received via OOB from remote device |
[in] | hash192_len | The length of hash192 |
[in] | randomizer192_len | The length of randomizer192 |
[in] | hash256 | The P-256 hash value received via OOB from remote device |
[in] | randomizer256 | The P-256 randomizer value received via OOB from remote device |
[in] | hash256_len | The length of hash256 |
[in] | randomizer256_len | The length of randomizer256 |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_set_state_changed_cb | ( | bt_adapter_state_changed_cb | callback, |
void * | user_data | ||
) |
Registers a callback function to be invoked when the Bluetooth adapter state changes. 2.3.
[in] | callback | The callback function to invoke |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_set_visibility_duration_changed_cb | ( | bt_adapter_visibility_duration_changed_cb | callback, |
void * | user_data | ||
) |
Registers a callback function to be invoked every second.
When you set visibility mode as BT_ADAPTER_VISIBILITY_MODE_LIMITED_DISCOVERABLE,
callback will be called every second until visibility mode is changed to BT_ADAPTER_VISIBILITY_MODE_NON_DISCOVERABLE.
2.3 until the visibility mode is changed from BT_ADAPTER_VISIBILITY_MODE_LIMITED_DISCOVERABLE to BT_ADAPTER_VISIBILITY_MODE_NON_DISCOVERABLE.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_set_visibility_mode_changed_cb | ( | bt_adapter_visibility_mode_changed_cb | callback, |
void * | user_data | ||
) |
Registers a callback function to be invoked when the visibility mode changes. 2.3.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_start_device_discovery | ( | void | ) |
Starts the device discovery, asynchronously.
If a device is discovered, bt_adapter_device_discovery_state_changed_cb() will be invoked
with BT_ADAPTER_DEVICE_DISCOVERY_FOUND, and then bt_adapter_device_discovery_state_changed_cb()
will be called with BT_ADAPTER_DEVICE_DISCOVERY_FINISHED in case of the completion or cancellation of the discovery.
2.3 public http://tizen.org/privilege/bluetooth
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_NOW_IN_PROGRESS | Operation is now in progress |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_stop_device_discovery | ( | void | ) |
Stops the device discovery, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_NOT_IN_PROGRESS | Operation is not in progress |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_unset_device_discovery_state_changed_cb | ( | void | ) |
Unregisters the callback function. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_unset_name_changed_cb | ( | void | ) |
Unregisters the callback function. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_unset_state_changed_cb | ( | void | ) |
Unregisters the callback function. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_unset_visibility_duration_changed_cb | ( | void | ) |
Unregisters the callback function. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_adapter_unset_visibility_mode_changed_cb | ( | void | ) |
Unregisters the callback function. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_audio_connect | ( | const char * | remote_address, |
bt_audio_profile_type_e | type | ||
) |
Connects the remote device with the given audio profile, asynchronously.
If you input type as BT_AUDIO_PROFILE_TYPE_ALL and connection request succeeds, then bt_audio_connection_state_changed_cb() will be called twice
when BT_AUDIO_PROFILE_TYPE_HSP_HFP is connected and BT_AUDIO_PROFILE_TYPE_A2DP is connected.
2.3 public http://tizen.org/privilege/bluetooth
[in] | remote_address | The remote address |
[in] | type | The type of audio profile |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_audio_deinitialize | ( | void | ) |
Deinitializes the Bluetooth profiles related with audio. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_audio_disconnect | ( | const char * | remote_address, |
bt_audio_profile_type_e | type | ||
) |
Disconnects the remote device with the given audio profile, asynchronously.
If you input type as BT_AUDIO_PROFILE_TYPE_ALL and disconnection request succeeds, then bt_audio_connection_state_changed_cb() will be called twice
when BT_AUDIO_PROFILE_TYPE_HSP_HFP is disconnected and BT_AUDIO_PROFILE_TYPE_A2DP is disconnected. 2.3 public http://tizen.org/privilege/bluetooth
[in] | remote_address | The remote address |
[in] | type | The type of audio profile |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_audio_initialize | ( | void | ) |
Initializes the Bluetooth profiles related with audio. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_audio_set_connection_state_changed_cb | ( | bt_audio_connection_state_changed_cb | callback, |
void * | user_data | ||
) |
Registers a callback function that will be invoked when the connection state is changed. 2.3.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_audio_unset_connection_state_changed_cb | ( | void | ) |
Unregisters a callback function that will be invoked when the connection state is changed. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_connect | ( | const char * | remote_address | ) |
Connects the AVRCP (Audio/Video Remote Control Profile) target device. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The remote address |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
BT_ERROR_PERMISSION_DENIED | Permission denied |
int bt_avrcp_control_deinitialize | ( | void | ) |
Deinitializes the Bluetooth AVRCP (Audio/Video Remote Control Profile) controller service. 3.0.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_disconnect | ( | const char * | remote_address | ) |
Disconnects from the AVRCP (Audio/Video Remote Control Profile) target device. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The remote address |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
BT_ERROR_PERMISSION_DENIED | Permission denied |
int bt_avrcp_control_free_track_info | ( | bt_avrcp_metadata_attributes_info_s * | track | ) |
Frees the track metadata. 3.0.
[in] | track | The track metadata. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_get_equalizer_state | ( | bt_avrcp_equalizer_state_e * | state | ) |
Gets the the equalizer state of the remote device. 3.0.
[out] | state | The equalizer state, one of: ON, OFF |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_get_play_status | ( | bt_avrcp_player_state_e * | status | ) |
Gets the play status of the remote device. 3.0.
[out] | status | The play status, one of: PLAYING, STOPPED... |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_get_position | ( | unsigned int * | position | ) |
Gets the position of the song played by the remote device. 3.0.
[out] | position | The position, in milliseconds |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_get_repeat_mode | ( | bt_avrcp_repeat_mode_e * | mode | ) |
Gets the repeat state of the remote device. 3.0.
[out] | mode | The repeat mode, one of: OFF, SINGLE, ALL |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_get_scan_mode | ( | bt_avrcp_scan_mode_e * | mode | ) |
Gets the scan mode of the remote device. 3.0.
[out] | mode | The scan mode, one of: OFF, GROUP, ALL |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_get_shuffle_mode | ( | bt_avrcp_shuffle_mode_e * | mode | ) |
Gets the shuffle mode of the remote device. 3.0.
[out] | mode | The shuffle mode, one of: OFF, GROUP, ALL |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_get_track_info | ( | bt_avrcp_metadata_attributes_info_s ** | track | ) |
Gets the metadata of the track played by the remote device. 3.0.
[out] | track | The track metadata. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_initialize | ( | bt_avrcp_control_connection_state_changed_cb | callback, |
void * | user_data | ||
) |
Initializes the Bluetooth AVRCP (Audio/Video Remote Control Profile) controller service. 3.0.
[in] | callback | The callback function called when the connection state is changed |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_send_player_command | ( | bt_avrcp_player_command_e | cmd | ) |
Sends a command to the target device. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | cmd | The commands, one of: Play, Pause, Next, Rewind. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_set_equalizer_state | ( | bt_avrcp_equalizer_state_e | state | ) |
Sends the equalizer state change request to the remote device. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | state | The new equalizer state, one of: ON, OFF |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_set_repeat_mode | ( | bt_avrcp_repeat_mode_e | mode | ) |
Sends the repeat change request to the remote device. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | mode | The new repeat mode, one of: OFF, SINGLE, ALL |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_set_scan_mode | ( | bt_avrcp_scan_mode_e | mode | ) |
Sends the scan mode change request to the remote device. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | mode | The new scan mode, one of: OFF, GROUP, ALL |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_control_set_shuffle_mode | ( | bt_avrcp_shuffle_mode_e | mode | ) |
Sends the shuffle mode change request to the remote device. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | mode | The new shuffle mode, one of: OFF, GROUP, ALL |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_set_equalizer_state_changed_cb | ( | bt_avrcp_equalizer_state_changed_cb | callback, |
void * | user_data | ||
) |
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). 2.4.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_set_play_status_changed_cb | ( | bt_avrcp_play_status_changed_cb | callback, |
void * | user_data | ||
) |
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). 3.0.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_set_position_changed_cb | ( | bt_avrcp_position_changed_cb | callback, |
void * | user_data | ||
) |
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). 3.0.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_set_repeat_mode_changed_cb | ( | bt_avrcp_repeat_mode_changed_cb | callback, |
void * | user_data | ||
) |
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). 2.4.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_set_scan_mode_changed_cb | ( | bt_avrcp_scan_mode_changed_cb | callback, |
void * | user_data | ||
) |
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). 2.4.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_set_shuffle_mode_changed_cb | ( | bt_avrcp_shuffle_mode_changed_cb | callback, |
void * | user_data | ||
) |
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). 2.4.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_set_track_info_changed_cb | ( | bt_avrcp_track_info_changed_cb | callback, |
void * | user_data | ||
) |
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). 3.0.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_target_deinitialize | ( | void | ) |
Deinitializes the Bluetooth AVRCP (Audio/Video Remote Control Profile) target service. 2.4.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_target_initialize | ( | bt_avrcp_target_connection_state_changed_cb | callback, |
void * | user_data | ||
) |
Initializes the Bluetooth AVRCP (Audio/Video Remote Control Profile) target service. 2.4.
[in] | callback | The callback function called when the connection state is changed |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_target_notify_equalizer_state | ( | bt_avrcp_equalizer_state_e | state | ) |
Notifies the equalizer state to the remote device. 2.4 public http://tizen.org/privilege/bluetooth.
[in] | state | The state of equalizer |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_target_notify_player_state | ( | bt_avrcp_player_state_e | state | ) |
Notifies the player state to the remote device. 2.4 public http://tizen.org/privilege/bluetooth.
[in] | state | The player state |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_target_notify_position | ( | unsigned int | position | ) |
Notifies the current position of song to the remote device. 2.4 public http://tizen.org/privilege/bluetooth.
[in] | position | The current position in milliseconds |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_target_notify_repeat_mode | ( | bt_avrcp_repeat_mode_e | mode | ) |
Notifies the repeat mode to the remote device. 2.4 public http://tizen.org/privilege/bluetooth.
[in] | mode | The repeat mode |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_target_notify_scan_mode | ( | bt_avrcp_scan_mode_e | mode | ) |
Notifies the scan mode to the remote device. 2.4 public http://tizen.org/privilege/bluetooth.
[in] | mode | The scan mode |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_target_notify_shuffle_mode | ( | bt_avrcp_shuffle_mode_e | mode | ) |
Notifies the shuffle mode to the remote device. 2.4 public http://tizen.org/privilege/bluetooth.
[in] | mode | The repeat mode |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_target_notify_track | ( | const char * | title, |
const char * | artist, | ||
const char * | album, | ||
const char * | genre, | ||
unsigned int | track_num, | ||
unsigned int | total_tracks, | ||
unsigned int | duration | ||
) |
Notifies the track to the remote device. 2.4 public http://tizen.org/privilege/bluetooth.
[in] | title | The title of track |
[in] | artist | The artist of track |
[in] | album | The album of track |
[in] | genre | The genre of track |
[in] | track_num | The track number |
[in] | total_tracks | The number of all tracks |
[in] | duration | The duration of track in milliseconds |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_unset_equalizer_state_changed_cb | ( | void | ) |
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). 2.4.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_unset_play_status_changed_cb | ( | void | ) |
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). 3.0.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_unset_position_changed_cb | ( | void | ) |
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). 3.0.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_unset_repeat_mode_changed_cb | ( | void | ) |
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). 2.4.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_unset_scan_mode_changed_cb | ( | void | ) |
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). 2.4.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_unset_shuffle_mode_changed_cb | ( | void | ) |
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). 2.4.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_avrcp_unset_track_info_changed_cb | ( | void | ) |
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). 3.0.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_deinitialize | ( | void | ) |
Releases all resources of the Bluetooth API. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_cancel_bonding | ( | void | ) |
Cancels the bonding process. 2.3 public http://tizen.org/privilege/bluetooth.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_NOT_IN_PROGRESS | Operation not in progress |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_create_bond | ( | const char * | remote_address | ) |
Creates a bond with a remote Bluetooth device, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The address of the remote Bluetooth device with which the bond should be created |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_RESOURCE_BUSY | Device or resource busy |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_destroy_bond | ( | const char * | remote_address | ) |
Destroys the bond, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The address of the remote Bluetooth device to remove bonding |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_RESOURCE_BUSY | Device or resource busy |
BT_ERROR_REMOTE_DEVICE_NOT_BONDED | Remote device not bonded |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_foreach_connected_profiles | ( | const char * | remote_address, |
bt_device_connected_profile | callback, | ||
void * | user_data | ||
) |
Gets the connected profiles. 2.3.
[in] | remote_address | The address of the remote device |
[in] | callback | The callback function to invoke |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_get_service_mask_from_uuid_list | ( | char ** | uuids, |
int | no_of_service, | ||
bt_service_class_t * | service_mask_list | ||
) |
Gets the service mask from the UUID list. 2.3.
[in] | uuids | The UUID list of the device. |
[in] | no_of_service | The number of the UUID list count. |
[out] | service_mask_list | Service mask list converted from the given UUID list. |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_is_profile_connected | ( | const char * | remote_address, |
bt_profile_e | bt_profile, | ||
bool * | connected_status | ||
) |
Gets the profile connected status. 2.3.
[in] | remote_address | The address of the remote device |
[in] | bt_profile | wish to know bt_profile |
[out] | connected_status | the connected status |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_REMOTE_DEVICE_NOT_BONDED | Remote device not bonded |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_set_alias | ( | const char * | remote_address, |
const char * | alias | ||
) |
Sets an alias for the bonded device. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The address of the remote Bluetooth device |
[in] | alias | The alias of the remote Bluetooth device |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_REMOTE_DEVICE_NOT_BONDED | Remote device not bonded |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_set_authorization | ( | const char * | remote_address, |
bt_device_authorization_e | authorization_state | ||
) |
Sets the authorization of a bonded device, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The address of the remote Bluetooth device to authorize |
[in] | authorization_state | The Bluetooth authorization state |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_REMOTE_DEVICE_NOT_BONDED | Remote device not bonded |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_set_authorization_changed_cb | ( | bt_device_authorization_changed_cb | callback, |
void * | user_data | ||
) |
Registers a callback function to be invoked when the authorization of device changes. 2.3.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_set_bond_created_cb | ( | bt_device_bond_created_cb | callback, |
void * | user_data | ||
) |
Registers a callback function to be invoked when the bond creates. 2.3.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_set_bond_destroyed_cb | ( | bt_device_bond_destroyed_cb | callback, |
void * | user_data | ||
) |
Registers a callback function to be invoked when the bond destroys. 2.3.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_set_connection_state_changed_cb | ( | bt_device_connection_state_changed_cb | callback, |
void * | user_data | ||
) |
Registers a callback function to be invoked when the connection state is changed. 2.3.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_set_service_searched_cb | ( | bt_device_service_searched_cb | callback, |
void * | user_data | ||
) |
Registers a callback function to be invoked when the process of service search finishes. 2.3.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_start_service_search | ( | const char * | remote_address | ) |
Starts the search for services supported by the specified device, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The address of the remote Bluetooth device whose services need to be checked |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_REMOTE_DEVICE_NOT_BONDED | Remote device not bonded |
BT_ERROR_SERVICE_SEARCH_FAILED | Service search failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_unset_authorization_changed_cb | ( | void | ) |
Unregisters the callback function. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_unset_bond_created_cb | ( | void | ) |
Unregisters the callback function. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_unset_bond_destroyed_cb | ( | void | ) |
Unregisters the callback function. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_unset_connection_state_changed_cb | ( | void | ) |
Unregisters the callback function to be invoked when the connection state is changed. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_unset_service_searched_cb | ( | void | ) |
Unregisters the callback function. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_device_update_le_connection_mode | ( | const char * | remote_address, |
bt_device_le_connection_mode_e | mode | ||
) |
Updates a LE connection mode. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The address of the remote Bluetooth device |
[in] | mode | The LE connection mode |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
Adds a descriptor to a specified characteristic. 3.0.
[in] | characteristic | The GATT handle of the characteristic |
[in] | descriptor | The descriptor's GATT handle to be added |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_characteristic_create | ( | const char * | uuid, |
int | permissions, | ||
int | properties, | ||
const char * | value, | ||
int | value_length, | ||
bt_gatt_h * | characteristic | ||
) |
Creates the GATT characteristic. 3.0.
[in] | uuid | The UUID of the characteristic |
[in] | permissions | the permissions of the characteristic |
[in] | properties | The properties of the characteristic |
[in] | value | The value(byte stream) of the characteristic |
[in] | value_length | The length of value |
[out] | characteristic | The GATT handle of the created characteristic |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_characteristic_destroy | ( | bt_gatt_h | gatt_handle | ) |
Destroys the GATT handle of characteristic. 3.0.
[in] | gatt_handle | The handle of characteristic |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_characteristic_foreach_descriptors | ( | bt_gatt_h | characteristic, |
bt_gatt_foreach_cb | callback, | ||
void * | user_data | ||
) |
Invokes callback function on each descriptor that belongs to the specified characteristic. 2.3.1.
[in] | characteristic | The characteristic's GATT handle |
[in] | callback | The function to be invoked on each descriptor |
[in] | user_data | The user data to be passed to callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_characteristic_get_descriptor | ( | bt_gatt_h | characteristic, |
const char * | uuid, | ||
bt_gatt_h * | descriptor | ||
) |
Gets a descriptor's GATT handle which has specific UUID. 2.3.1.
[in] | characteristic | The characteristic's GATT handle |
[in] | uuid | The descriptor's GATT handle which has this UUID will be returned if it exists |
[out] | descriptor | The descriptor's GATT handle which has uuid if it exists |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NO_DATA | No data available |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_characteristic_get_permissions | ( | bt_gatt_h | gatt_handle, |
int * | permissions | ||
) |
Gets the permissions which a characteristic's GATT handle has. 3.0.
[in] | gatt_handle | The handle of a characteristic |
[out] | permissions | The permissions which a characteristic's GATT handle has |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_characteristic_get_properties | ( | bt_gatt_h | characteristic, |
int * | properties | ||
) |
Gets the properties which a characteristic's GATT handle has. 2.3.1.
[in] | characteristic | The characteristic's GATT handle |
[out] | properties | The properties which a characteristic's GATT handle has |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
Gets the service's GATT handle which the specified characteristic belongs to. 2.3.1.
[in] | characteristic | The characteristic's GATT handle |
[out] | service | The service's GATT handle which characteristic belongs to |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_characteristic_get_write_type | ( | bt_gatt_h | characteristic, |
bt_gatt_write_type_e * | write_type | ||
) |
Gets the write type of the specified characteristic. 2.3.1.
[in] | characteristic | The characteristic's GATT handle |
[out] | write_type | The write type of the specified characteristic |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_characteristic_set_write_type | ( | bt_gatt_h | characteristic, |
bt_gatt_write_type_e | write_type | ||
) |
Updates the write type of the specified characteristic. 2.3.1.
[in] | characteristic | The characteristic's GATT handle |
[in] | write_type | The write type to be updated |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_create | ( | const char * | remote_address, |
bt_gatt_client_h * | client | ||
) |
Creates the GATT client handle. 2.3.1.
[in] | remote_address | The address of the remote device |
[out] | client | The created GATT client's handle |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_ALREADY_DONE | Operation is already done |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_destroy | ( | bt_gatt_client_h | client | ) |
Destroys the GATT client's handle. 2.3.1.
[in] | client | The GATT client's handle |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_foreach_services | ( | bt_gatt_client_h | client, |
bt_gatt_foreach_cb | callback, | ||
void * | user_data | ||
) |
Invokes callback function on each service that belongs to the specified GATT client. 2.3.1.
[in] | client | The GATT client's handle |
[in] | callback | The function to be invoked on each service |
[in] | user_data | The user data to be passed to callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_get_att_mtu | ( | bt_gatt_client_h | client, |
unsigned int * | mtu | ||
) |
Gets the ATT MTU value set for a connection. 4.0.
[in] | client | The created GATT client's handle |
[out] | mtu | The MTU value set for a connection |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_get_remote_address | ( | bt_gatt_client_h | client, |
char ** | remote_address | ||
) |
Gets the address of remote device. 2.3.1.
[in] | client | The created GATT client's handle |
[out] | remote_address | The address of the remote device which is associated with client |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_get_service | ( | bt_gatt_client_h | client, |
const char * | uuid, | ||
bt_gatt_h * | service | ||
) |
Gets a service's GATT handle which has specific UUID. 2.3.1.
[in] | client | The GATT client's handle |
[in] | uuid | The service's GATT handle which has this UUID will be returned if it exists |
[out] | service | The service's GATT handle which has uuid if it exists |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NO_DATA | No data available |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_read_value | ( | bt_gatt_h | gatt_handle, |
bt_gatt_client_request_completed_cb | callback, | ||
void * | user_data | ||
) |
Reads the value of a characteristic or descriptor from the remote device asynchronously. 2.3.1 public http://tizen.org/privilege/bluetooth.
[in] | gatt_handle | The GATT handle of a characteristic or descriptor |
[in] | callback | When a read request is completed, this callback function will be called |
[in] | user_data | The user data to be passed to callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOW_IN_PROGRESS | Operation now in progress |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_request_att_mtu_change | ( | bt_gatt_client_h | client, |
unsigned int | mtu | ||
) |
Requests a change of the ATT MTU value. 4.0 public http://tizen.org/privilege/bluetooth.
[in] | client | The created GATT client's handle |
[in] | mtu | The new MTU value |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_set_att_mtu_changed_cb | ( | bt_gatt_client_h | client, |
bt_gatt_client_att_mtu_changed_cb | callback, | ||
void * | user_data | ||
) |
Registers a callback function to be invoked when the ATT MTU is changed. 4.0.
[in] | client | The created GATT client's handle |
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_set_characteristic_value_changed_cb | ( | bt_gatt_h | characteristic, |
bt_gatt_client_characteristic_value_changed_cb | callback, | ||
void * | user_data | ||
) |
Registers a callback function to be invoked when the characteristic value is changed on the remote device. 2.3.1.
[in] | characteristic | The characteristic's GATT handle |
[in] | callback | The callback to be invoked when the value is changed and it is informed |
[in] | user_data | The user data to be passed to callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_set_service_changed_cb | ( | bt_gatt_client_h | client, |
bt_gatt_client_service_changed_cb | callback, | ||
void * | user_data | ||
) |
Registers a callback function to be invoked when service is changed from a remote device(GATT server). 3.0.
[in] | client | The GATT client's handle |
[in] | callback | The callback to be invoked |
[in] | user_data | The user data to be passed to callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_unset_att_mtu_changed_cb | ( | bt_gatt_client_h | client | ) |
Unregisters the callback function to be invoked when the ATT MTU is changed. 4.0.
[in] | client | The created GATT client's handle |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_unset_characteristic_value_changed_cb | ( | bt_gatt_h | characteristic | ) |
Unregisters a callback function to be invoked when the characteristic value is changed on the remote device. 2.3.1.
[in] | characteristic | The characteristic's GATT handle, whose value change will not be informed |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_unset_service_changed_cb | ( | bt_gatt_client_h | client | ) |
Unregisters a callback function. 3.0.
[in] | client | The GATT client's handle |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_client_write_value | ( | bt_gatt_h | gatt_handle, |
bt_gatt_client_request_completed_cb | callback, | ||
void * | user_data | ||
) |
Writes the value of a characteristic or descriptor to the remote device asynchronously. 2.3.1 public http://tizen.org/privilege/bluetooth.
[in] | gatt_handle | The GATT handle of a characteristic or descriptor |
[in] | callback | When a write request is completed, this callback function will be called |
[in] | user_data | The user data to be passed to callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOW_IN_PROGRESS | Operation now in progress |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_connect | ( | const char * | address, |
bool | auto_connect | ||
) |
Connects to a specific LE based service on a remote bluetooth device address, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | address | The address of the remote Bluetooth device. |
[in] | auto_connect | The flag of the auto connection. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_descriptor_create | ( | const char * | uuid, |
int | permissions, | ||
const char * | value, | ||
int | value_length, | ||
bt_gatt_h * | descriptor | ||
) |
Creates the GATT characteristic descriptor. 3.0.
[in] | uuid | The UUID of the descriptor |
[in] | permissions | The permissions of the descriptor |
[in] | value | The value(byte stream) associated with the descriptor |
[in] | value_length | The length of value |
[out] | descriptor | The GATT handle of the created characteristic descriptor |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_descriptor_destroy | ( | bt_gatt_h | gatt_handle | ) |
Destroys the GATT handle of descriptor. 3.0.
[in] | gatt_handle | The handle of descriptor |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
Gets the characteristic's GATT handle which the specified descriptor belongs to. 2.3.1.
[in] | descriptor | The descriptor's GATT handle |
[out] | characteristic | The characteristic's GATT handle which descriptor belongs to |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_descriptor_get_permissions | ( | bt_gatt_h | gatt_handle, |
int * | permissions | ||
) |
Gets the permissions which a descriptor's GATT handle has. 3.0.
[in] | gatt_handle | The handle of a descriptor |
[out] | permissions | The permissions which a descriptor's GATT handle has |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_disconnect | ( | const char * | address | ) |
Disconnects to LE connection with the given remote Bluetooth device address, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | address | The address of the remote Bluetooth device |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_get_float_value | ( | bt_gatt_h | gatt_handle, |
bt_data_type_float_e | type, | ||
int | offset, | ||
float * | value | ||
) |
Gets the value of a characteristic or descriptor's GATT handle as a float type. 2.3.1.
[in] | gatt_handle | The handle of a characteristic or descriptor |
[in] | type | The type of a saved value in gatt_handle |
[in] | offset | The offset from where a value will be read from gatt_handle as an integer type |
[out] | value | The float type's value of gatt_handle |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_get_int_value | ( | bt_gatt_h | gatt_handle, |
bt_data_type_int_e | type, | ||
int | offset, | ||
int * | value | ||
) |
Gets the value of a characteristic or descriptor's GATT handle as an integer type. 2.3.1.
[in] | gatt_handle | The handle of a characteristic or descriptor |
[in] | type | The type of a saved value in gatt_handle |
[in] | offset | The offset from where a value will be read from gatt_handle as an integer type |
[out] | value | The integer type's value of gatt_handle |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_get_type | ( | bt_gatt_h | gatt_handle, |
bt_gatt_type_e * | gatt_type | ||
) |
Gets the type of GATT handle. 2.3.1.
[in] | gatt_handle | The GATT handle |
[out] | gatt_type | The type of gatt_handle |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_get_uuid | ( | bt_gatt_h | gatt_handle, |
char ** | uuid | ||
) |
Gets the UUID of a service, characteristic or descriptor's GATT handle. 2.3.1.
[in] | gatt_handle | The handle of a service, characteristic or descriptor |
[out] | uuid | The string of the UUID of gatt_handle |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_get_value | ( | bt_gatt_h | gatt_handle, |
char ** | value, | ||
int * | value_length | ||
) |
Gets the value of a characteristic or descriptor's GATT handle. 2.3.1.
[in] | gatt_handle | The handle of a characteristic or descriptor |
[out] | value | The value of gatt_handle. It is a byte stream type. |
[out] | value_length | The length of value |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_create | ( | bt_gatt_server_h * | server | ) |
Creates the GATT server's handle. 3.0.
[out] | server | The GATT server's handle |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_deinitialize | ( | void | ) |
DeInitializes the GATT server. 3.0.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_destroy | ( | bt_gatt_server_h | server | ) |
Destroys the GATT server's handle. 3.0.
[in] | server | The GATT server's handle |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_foreach_services | ( | bt_gatt_server_h | server, |
bt_gatt_foreach_cb | callback, | ||
void * | user_data | ||
) |
Invokes callback function on each service that belongs to the specified GATT server. 3.0.
[in] | server | The GATT server's handle |
[in] | callback | The function to be invoked on each service |
[in] | user_data | The user data to be passed to callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_get_service | ( | bt_gatt_server_h | server, |
const char * | uuid, | ||
bt_gatt_h * | service | ||
) |
Gets a service's GATT handle which has specific UUID. 3.0.
[in] | server | The GATT server's handle |
[in] | uuid | The service's GATT handle which has this UUID will be returned if it exists |
[out] | service | The service's GATT handle which has uuid if it exists |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NO_DATA | No data available |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_initialize | ( | void | ) |
Initializes the GATT Server. 3.0.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_notify_characteristic_changed_value | ( | bt_gatt_h | characteristic, |
bt_gatt_server_notification_sent_cb | callback, | ||
const char * | device_address, | ||
void * | user_data | ||
) |
Notifies value change of the characteristic to the remote devices which enable a Client Characteristic Configuration Descriptor. 3.0.
[in] | characteristic | The characteristic which has a changed value |
[in] | callback | The function to be invoked on each remote device when a sending operation is done |
[in] | device_address | Remote device address to send notify or indicate and if set to NULL then notify/indicate all is enabled. |
[in] | user_data | The user data to be passed to callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_register_service | ( | bt_gatt_server_h | server, |
bt_gatt_h | service | ||
) |
Registers a specified service to the specified GATT server that the local device is hosting. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | server | The GATT server that local device is hosting |
[in] | service | The service, which needs to be registered in server |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_ALREADY_DONE | Operation is already done |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_send_response | ( | int | request_id, |
bt_gatt_att_request_type_e | request_type, | ||
int | offset, | ||
int | resp_status, | ||
char * | value, | ||
int | value_length | ||
) |
Sends a response to the remote device as a result of a read/write request. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | request_id | The identification of a read/write request |
[in] | request_type | The request type for read/write |
[in] | offset | The offset from where a value is read |
[in] | resp_status | The application error if any occurred or BT_ERROR_NONE for successful. |
[in] | value | The value to be sent. It will be sent from offset. If it is NULL, a requested GATT handle's value will be sent from offset. |
[in] | value_length | Value Length |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_set_characteristic_notification_state_change_cb | ( | bt_gatt_h | gatt_handle, |
bt_gatt_server_characteristic_notification_state_changed_cb | callback, | ||
void * | user_data | ||
) |
Registers a callback function to be invoked when the remote device enables or disables the Notification/Indication for particular characteristics. 3.0.
[in] | gatt_handle | The GATT handle of a characteristic |
[in] | callback | The callback to be invoked |
[in] | user_data | The user data to be passed to callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_set_read_value_requested_cb | ( | bt_gatt_h | gatt_handle, |
bt_gatt_server_read_value_requested_cb | callback, | ||
void * | user_data | ||
) |
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). 3.0.
[in] | gatt_handle | The GATT handle of a characteristic or descriptor |
[in] | callback | The callback to be invoked |
[in] | user_data | The user data to be passed to callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_set_write_value_requested_cb | ( | bt_gatt_h | gatt_handle, |
bt_gatt_server_write_value_requested_cb | callback, | ||
void * | user_data | ||
) |
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. 3.0.
[in] | gatt_handle | The GATT handle of a characteristic or descriptor |
[in] | callback | The callback to be invoked |
[in] | user_data | The user data to be passed to callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_start | ( | void | ) |
Registers the application along with the GATT services of the application it is hosting. 3.0 public http://tizen.org/privilege/bluetooth.
BT_ERROR_NONE | Successful |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_ALREADY_DONE | Operation is already done |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_unregister_all_services | ( | bt_gatt_server_h | server | ) |
Unregisters all services from the specified GATT server that the local device is hosting. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | server | The GATT server that local device is hosting |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_server_unregister_service | ( | bt_gatt_server_h | server, |
bt_gatt_h | service | ||
) |
Unregisters a specified service from the specified GATT server that the local device is hosting. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | server | The GATT server that local device is hosting |
[in] | service | The service, which needs to be unregistered from server |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_SERVICE_NOT_FOUND | Service not found |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
Adds a characteristic to a specified service. 3.0.
[in] | service | The service's GATT handle |
[in] | characteristic | The characteristic's GATT handle to be added |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
Adds a service to a specified service as included service. 3.0.
[in] | service | The service's GATT handle |
[in] | included_service | The service's GATT handle to be added as included service |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_service_create | ( | const char * | uuid, |
bt_gatt_service_type_e | type, | ||
bt_gatt_h * | service | ||
) |
Creates the GATT service. 3.0.
[in] | uuid | The UUID of the service |
[in] | type | The type of the service |
[out] | service | The GATT handle of the created service |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_service_destroy | ( | bt_gatt_h | gatt_handle | ) |
Destroys the GATT handle of service. 3.0.
[in] | gatt_handle | The handle of service |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_service_foreach_characteristics | ( | bt_gatt_h | service, |
bt_gatt_foreach_cb | callback, | ||
void * | user_data | ||
) |
Invokes callback function on each characteristic that belongs to the specified service. 2.3.1.
[in] | service | The service's GATT handle |
[in] | callback | The function to be invoked on each characteristic |
[in] | user_data | The user data to be passed to callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_service_foreach_included_services | ( | bt_gatt_h | service, |
bt_gatt_foreach_cb | callback, | ||
void * | user_data | ||
) |
Invokes callback function on each included service that belongs to the specified service. 2.3.1.
[in] | service | The service's GATT handle |
[in] | callback | The function to be invoked on each included service |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_service_get_characteristic | ( | bt_gatt_h | service, |
const char * | uuid, | ||
bt_gatt_h * | characteristic | ||
) |
Gets a characteristic's GATT handle which has specific UUID. 2.3.1.
[in] | service | The service's GATT handle |
[in] | uuid | The characteristic's GATT handle which has this UUID will be returned if it exists |
[out] | characteristic | The characteristic's GATT handle which has uuid if it exists |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NO_DATA | No data available |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_service_get_client | ( | bt_gatt_h | service, |
bt_gatt_client_h * | client | ||
) |
Gets the GATT client handle which the specified service belongs to. 2.3.1.
[in] | service | The service's GATT handle |
[out] | client | The GATT client handle which service belongs to |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_service_get_included_service | ( | bt_gatt_h | service, |
const char * | uuid, | ||
bt_gatt_h * | included_service | ||
) |
Gets an included service's GATT handle which has specific UUID. 2.3.1.
[in] | service | The service's GATT handle |
[in] | uuid | The included service's GATT handle which has this UUID will be returned if it exists |
[out] | included_service | The included service's GATT handle which has uuid if it exists |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NO_DATA | No data available |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_service_get_server | ( | bt_gatt_h | service, |
bt_gatt_server_h * | server | ||
) |
Gets the GATT server handle to which the specified service belongs. 3.0.
[in] | service | The service's GATT handle |
[out] | server | The GATT server handle to which service belongs |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_set_connection_state_changed_cb | ( | bt_gatt_connection_state_changed_cb | callback, |
void * | user_data | ||
) |
Registers a callback function that will be invoked when the connection state is changed. 2.3.
[in] | callback | The callback function to register. |
[in] | user_data | The user data to be passed to the callback function. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_set_float_value | ( | bt_gatt_h | gatt_handle, |
bt_data_type_float_e | type, | ||
int | mantissa, | ||
int | exponent, | ||
int | offset | ||
) |
Updates the value of a characteristic or descriptor's GATT handle using a float type's value. 2.3.1.
[in] | gatt_handle | The handle of a characteristic or descriptor |
[in] | type | mantissa and exponent will be saved in gatt_handle as this type |
[in] | mantissa | The mantissa of float type's value to be updated |
[in] | exponent | The exponent of float type's value to be updated |
[in] | offset | The offset from where mantissa and exponent will be saved in gatt_handle |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_set_int_value | ( | bt_gatt_h | gatt_handle, |
bt_data_type_int_e | type, | ||
int | value, | ||
int | offset | ||
) |
Updates the value of a characteristic or descriptor's GATT handle using a integer type's value. 2.3.1.
[in] | gatt_handle | The handle of a characteristic or descriptor |
[in] | type | value will be saved in gatt_handle as this type |
[in] | value | The integer type's value to be updated |
[in] | offset | The offset from where value will be saved in gatt_handle |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_set_value | ( | bt_gatt_h | gatt_handle, |
const char * | value, | ||
int | value_length | ||
) |
Updates the value of a characteristic or descriptor's GATT handle. 2.3.1.
[in] | gatt_handle | The handle of a characteristic or descriptor |
[in] | value | The value to be updated |
[in] | value_length | The length of value |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_gatt_unset_connection_state_changed_cb | ( | void | ) |
Unregisters a callback function that will be invoked when the connection state is changed. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_get_uuid_name | ( | const char * | uuid, |
char ** | name | ||
) |
Gets the specification name for the given UUID. 3.0.
[in] | uuid | The UUID |
[out] | name | The specification name defined at www.bluetooth.com |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hdp_connect_to_source | ( | const char * | remote_address, |
const char * | app_id | ||
) |
Connects the remote device which acts as Source role, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The remote address |
[in] | app_id | The ID of application |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hdp_disconnect | ( | const char * | remote_address, |
unsigned int | channel | ||
) |
Disconnects the remote device, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The remote address |
[in] | channel | The connected data channel |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hdp_register_sink_app | ( | unsigned short | data_type, |
char ** | app_id | ||
) |
Registers an application that acts as the Sink role of HDP (Health Device Profile). 2.3 public http://tizen.org/privilege/bluetooth.
[in] | data_type | The data type of MDEP. This value is defined in ISO/IEEE 11073-20601 spec. For example, pulse oximeter is 0x1004 and blood pressure monitor is 0x1007. |
[out] | app_id | The ID of application |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OUT_OF_MEMORY | Out of memory |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hdp_send_data | ( | unsigned int | channel, |
const char * | data, | ||
unsigned int | size | ||
) |
Sends the data to the remote device. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | channel | The connected data channel |
[in] | data | The data to send |
[in] | size | The size of data to send (byte) |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hdp_set_connection_state_changed_cb | ( | bt_hdp_connected_cb | connected_cb, |
bt_hdp_disconnected_cb | disconnected_cb, | ||
void * | user_data | ||
) |
Registers a callback function that will be invoked when the connection state is changed. 2.3.
[in] | connected_cb | The callback function called when a connection is established |
[in] | disconnected_cb | The callback function called when a connection is disconnected |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hdp_set_data_received_cb | ( | bt_hdp_data_received_cb | callback, |
void * | user_data | ||
) |
Registers a callback function that will be invoked when you receive the data. 2.3.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hdp_unregister_sink_app | ( | const char * | app_id | ) |
Unregisters the given application that acts as the Sink role of HDP (Health Device Profile). 2.3 public http://tizen.org/privilege/bluetooth.
[in] | app_id | The ID of application |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hdp_unset_connection_state_changed_cb | ( | void | ) |
Unregisters a callback function that will be invoked when the connection state is changed. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hdp_unset_data_received_cb | ( | void | ) |
Unregisters a callback function that will be invoked when you receive the data. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hid_device_activate | ( | bt_hid_device_connection_state_changed_cb | callback, |
void * | user_data | ||
) |
Activates the Bluetooth HID Device role. public http://tizen.org/privilege/bluetooth.
[in] | callback | The callback called when the connection state is changed |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_NOW_IN_PROGRESS | Already activated |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hid_device_connect | ( | const char * | remote_address | ) |
Initiates the HID device connection with the Device role, asynchronously. public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The remote device's address. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_NOT_IN_PROGRESS | Not activated |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_ALREADY_DONE | Already connected |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hid_device_deactivate | ( | void | ) |
Deactivates the Bluetooth HID Device role. public http://tizen.org/privilege/bluetooth.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_NOT_IN_PROGRESS | Not activated |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hid_device_disconnect | ( | const char * | remote_address | ) |
Disconnects from the HID Host device, asynchronously. public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The remote device's address. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hid_device_reply_to_report | ( | const char * | remote_address, |
bt_hid_header_type_e | header_type, | ||
bt_hid_param_type_e | param_type, | ||
const char * | data, | ||
unsigned int | data_len | ||
) |
Responds to reports from the HID Host. public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The remote device's address. |
[in] | header_type | The response header type |
[in] | param_type | The response parameter type |
[in] | data | The response data |
[in] | data_len | The length of the response data |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hid_device_send_key_event | ( | const char * | remote_address, |
const bt_hid_key_data_s * | key_data | ||
) |
Sends the keyboard event data to the remote device. public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The remote device's address. |
[in] | key_data | The key data to be passed to the remote device |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hid_device_send_mouse_event | ( | const char * | remote_address, |
const bt_hid_mouse_data_s * | mouse_data | ||
) |
Sends the mouse event data to the remote device. public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The remote device's address. |
[in] | mouse_data | The mouse data to be passed to the remote device. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hid_device_set_data_received_cb | ( | bt_hid_device_data_received_cb | callback, |
void * | user_data | ||
) |
Sets the callback called when the device receives data from the HID Host. .
[in] | callback | The callback function to be set when data is received. |
[in] | user_data | The user data to be passed to the callback. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hid_device_unset_data_received_cb | ( | void | ) |
Unsets the data received callback. .
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hid_host_connect | ( | const char * | remote_address | ) |
Connects the remote device with the HID (Human Interface Device) service, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth.
@ @ @
[in] | remote_address | The remote address |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hid_host_deinitialize | ( | void | ) |
Deinitializes the Bluetooth HID (Human Interface Device) Host. 2.3.
@ @ @
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hid_host_disconnect | ( | const char * | remote_address | ) |
Disconnects the remote device with the HID (Human Interface Device) service, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth.
@ @ @
[in] | remote_address | The remote address |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_hid_host_initialize | ( | bt_hid_host_connection_state_changed_cb | connection_cb, |
void * | user_data | ||
) |
Initializes the Bluetooth HID (Human Interface Device) Host. 2.3.
@ @ @
[in] | connection_cb | The callback called when the connection state is changed |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_initialize | ( | void | ) |
Initializes the Bluetooth API. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_ipsp_connect | ( | const char * | remote_address | ) |
Connects to a remote device's IPSP service over LE, asynchronously. 4.0 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The remote address |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_ipsp_deinitialize | ( | void | ) |
Deinitializes the Bluetooth IPSP (Internet Protocol Support Profile) service. 4.0.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_ipsp_disconnect | ( | const char * | remote_address | ) |
Disconnects from a remote device's IPSP service, asynchronously. 4.0 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The remote address |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED | Remote device is not connected |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_ipsp_initialize | ( | bt_ipsp_init_state_changed_cb | callback, |
void * | user_data | ||
) |
Initializes the Bluetooth IPSP (Internet Protocol Support Profile) service. 4.0.
[in] | callback | The callback called when the initialization is finished |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_ipsp_set_connection_state_changed_cb | ( | bt_ipsp_connection_state_changed_cb | callback, |
void * | user_data | ||
) |
Registers a callback function that will be invoked when the connection state changes. 4.0.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_ipsp_unset_connection_state_changed_cb | ( | void | ) |
Unregisters the callback function called when the connection state changes. 4.0.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_opp_client_add_file | ( | const char * | file | ) |
Adds file to be pushed. 2.3.
[in] | file | The path of file to be pushed |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
int bt_opp_client_cancel_push | ( | void | ) |
Cancels the push request in progress, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_opp_client_clear_files | ( | void | ) |
Adds file to be pushed. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_opp_client_deinitialize | ( | void | ) |
Deinitializes the Bluetooth OPP client. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_opp_client_initialize | ( | void | ) |
Initializes the Bluetooth OPP client. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_RESOURCE_BUSY | Device or resource busy |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_opp_client_push_files | ( | const char * | remote_address, |
bt_opp_client_push_responded_cb | responded_cb, | ||
bt_opp_client_push_progress_cb | progress_cb, | ||
bt_opp_client_push_finished_cb | finished_cb, | ||
void * | user_data | ||
) |
Pushes the file to the remote device, asynchronously.
At first, bt_opp_client_push_responded_cb() will be called when OPP server responds to the push request.
After connection is established, bt_opp_client_push_progress_cb() will be called repeatedly until a file is transferred completely.
If you send several files, then bt_opp_client_push_progress_cb() with another file will be called repeatedly until the file is transferred completely.
bt_opp_client_push_finished_cb() will be called when the push request is finished.
2.3 public http://tizen.org/privilege/bluetooth
[in] | remote_address | The remote address |
[in] | responded_cb | The callback called when OPP server responds to the push request |
[in] | progress_cb | The callback called when each file is being transferred |
[in] | finished_cb | The callback called when the push request is finished |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOW_IN_PROGRESS | Operation now in progress |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_opp_server_accept | ( | bt_opp_server_transfer_progress_cb | progress_cb, |
bt_opp_server_transfer_finished_cb | finished_cb, | ||
const char * | name, | ||
void * | user_data, | ||
int * | transfer_id | ||
) |
Accepts the push request from the remote device. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | progress_cb | The callback called when a file is being transferred |
[in] | finished_cb | The callback called when a transfer is finished |
[in] | name | The name to store. This can be NULL if you initialize OPP server by bt_opp_server_initialize_by_connection_request(). |
[in] | user_data | The user data to be passed to the callback function |
[out] | transfer_id | The ID of transfer |
BT_ERROR_NONE | Successful |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOW_IN_PROGRESS | Operation now in progress |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_opp_server_cancel_transfer | ( | int | transfer_id | ) |
Cancels the transfer. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | transfer_id | The ID of transfer |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_opp_server_deinitialize | ( | void | ) |
Deinitializes the Bluetooth OPP server. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_opp_server_initialize_by_connection_request | ( | const char * | destination, |
bt_opp_server_connection_requested_cb | connection_requested_cb, | ||
void * | user_data | ||
) |
Initializes the Bluetooth OPP server requested by bt_opp_server_connection_requested_cb().
No popup appears when an OPP connection is requested from a remote device.
Instead, connection_requested_cb() will be called.
At that time, you can call either bt_opp_server_accept() or bt_opp_server_reject(). 2.3
[in] | destination | The destination path |
[in] | connection_requested_cb | The callback called when an OPP connection is requested |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_RESOURCE_BUSY | Device or resource busy |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_opp_server_reject | ( | void | ) |
Rejects the push request from the remote device. 2.3 public http://tizen.org/privilege/bluetooth.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_opp_server_set_destination | ( | const char * | destination | ) |
Sets the destination path of file to be pushed. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | destination | The destination path of file to be pushed |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_pbap_client_connect | ( | const char * | address | ) |
Connects to PBAP server, asynchronously. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | address | The other device's address |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Adapter is not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_pbap_client_deinitialize | ( | void | ) |
Deinitializes the Bluetooth PBAP Client.
This deinitialization must be done to free resources when the PBAP client is not longer needed. 3.0
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_pbap_client_disconnect | ( | const char * | address | ) |
Disconnects from PBAP server, asynchronously. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | address | The other device's address |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Adapter is not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_pbap_client_get_list | ( | const char * | address, |
bt_pbap_address_book_source_e | source, | ||
bt_pbap_folder_type_e | folder_type, | ||
bt_pbap_sort_order_e | order, | ||
unsigned short | offset, | ||
unsigned short | max_list_count, | ||
bt_pbap_list_vcards_cb | callback, | ||
void * | user_data | ||
) |
Gets contact and call log information from the PBAP server, asynchronously. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | address | The other device's address |
[in] | source | Source of phone book (Phone/SIM) |
[in] | folder_type | Type of folder |
[in] | order | Specifies which field shall be used to sort vCards. |
[in] | offset | vCards to be excluded from beginning. |
[in] | max_list_count | Maximum number of vCards to be fetched |
[in] | callback | The callback function called when PBAP List is returned. |
[in] | user_data | Data to be passed to the PBAP phone book pulling callback. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Adapter is not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_pbap_client_get_phone_book | ( | const char * | address, |
bt_pbap_address_book_source_e | source, | ||
bt_pbap_folder_type_e | folder_type, | ||
bt_pbap_vcard_format_e | format, | ||
bt_pbap_sort_order_e | order, | ||
unsigned short | offset, | ||
unsigned short | max_list_count, | ||
unsigned int | fields, | ||
bt_pbap_phone_book_received_cb | callback, | ||
void * | user_data | ||
) |
Gets all contacts and call logs as vCard from PBAP server, asynchronously.
The received phone book file will be saved in the platform downloads folder. 3.0 public http://tizen.org/privilege/bluetooth http://tizen.org/privilege/mediastorage
[in] | address | The other device's address |
[in] | source | Source of phone book (Phone/SIM) |
[in] | folder_type | Type of folder |
[in] | format | The vCard format |
[in] | order | Specifies which field shall be used to sort vCards. |
[in] | offset | The number of vCards to be excluded, counting from the beginning |
[in] | max_list_count | The maximum number of vCards to be fetched |
[in] | fields | vCard fields to be fetched; one or more bt_pbap_field_e values combined with bitwise 'or' |
[in] | callback | The callback function called when PBAP phone book is Pulled. |
[in] | user_data | Data to be passed to the PBAP phone book pulling callback. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Adapter is not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_pbap_client_get_phone_book_size | ( | const char * | address, |
bt_pbap_address_book_source_e | source, | ||
bt_pbap_folder_type_e | folder_type, | ||
bt_pbap_phone_book_size_cb | callback, | ||
void * | user_data | ||
) |
Gets size of phone book from PBAP server, asynchronously. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | address | The other device's address |
[in] | source | Source of the phone book (Phone/SIM) |
[in] | folder_type | Type of folder |
[in] | callback | The callback function called when PBAP phone book size is returned. |
[in] | user_data | Data to be passed to the PBAP phone book size callback. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Adapter is not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_pbap_client_initialize | ( | void | ) |
Initializes the Bluetooth PBAP Client.
This initialization is necessary to call other PBAP client APIs. 3.0
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_pbap_client_pull_vcard | ( | const char * | address, |
bt_pbap_address_book_source_e | source, | ||
bt_pbap_folder_type_e | folder_type, | ||
int | index, | ||
bt_pbap_vcard_format_e | format, | ||
unsigned int | fields, | ||
bt_pbap_phone_book_received_cb | callback, | ||
void * | user_data | ||
) |
Gets the selected contact using the index parameter as vCard from PBAP server, asynchronously.
The received phone book file will be saved in the platform downloads folder. The index value should be equal to the value of the index field in the bt_pbap_vcard_info_s structure, which can be obtained with bt_pbap_client_get_list() or bt_pbap_client_search_phone_book(). 3.0 public http://tizen.org/privilege/bluetooth http://tizen.org/privilege/mediastorage
[in] | address | The other device's address |
[in] | source | Source of phone book (Phone/SIM) |
[in] | folder_type | Type of folder |
[in] | index | The handle index of vCard to be fetched |
[in] | format | Format of vCard |
[in] | fields | vCard fields to be fetched; one or more bt_pbap_field_e values combined with bitwise 'or' |
[in] | callback | The callback function called when PBAP phone book is Pulled. |
[in] | user_data | Data to be passed to the PBAP phone book Pulling callback. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Adapter is not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_pbap_client_search_phone_book | ( | const char * | address, |
bt_pbap_address_book_source_e | source, | ||
bt_pbap_folder_type_e | folder_type, | ||
bt_pbap_search_field_e | search_attribute, | ||
const char * | search_value, | ||
bt_pbap_sort_order_e | order, | ||
unsigned short | offset, | ||
unsigned short | max_list_count, | ||
bt_pbap_list_vcards_cb | callback, | ||
void * | user_data | ||
) |
Finds and fetches the contact and call log information from the PBAP server, asynchronously. 3.0 public http://tizen.org/privilege/bluetooth.
[in] | address | The other device's address |
[in] | source | Source of phone book (Phone/SIM) |
[in] | folder_type | Type of folder |
[in] | search_attribute | field to be search |
[in] | search_value | pattern to be searched for |
[in] | order | Specifies which field shall be used to sort vCards. |
[in] | offset | vCards to be excluded from beginning. |
[in] | max_list_count | Maximum number of vCards to be fetched |
[in] | callback | The callback function called when PBAP List is returned. |
[in] | user_data | Data to be passed to the PBAP phone book pulling callback. |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Adapter is not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_pbap_client_set_connection_state_changed_cb | ( | bt_pbap_connection_state_changed_cb | callback, |
void * | user_data | ||
) |
Registers a callback function that will be invoked when the connection state is changed. 3.0.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_pbap_client_unset_connection_state_changed_cb | ( | void | ) |
Unregisters a callback function that will be invoked when the connection state is changed. 3.0.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_socket_connect_rfcomm | ( | const char * | remote_address, |
const char * | service_uuid | ||
) |
Connects to a specific RFCOMM based service on a remote Bluetooth device UUID, asynchronously. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | remote_address | The address of the remote Bluetooth device |
[in] | service_uuid | The UUID of service provided by the remote Bluetooth device |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_socket_create_rfcomm | ( | const char * | service_uuid, |
int * | socket_fd | ||
) |
Registers a RFCOMM server socket with a specific UUID. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | service_uuid | The UUID of service to provide |
[out] | socket_fd | The file descriptor of socket to listen |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_socket_destroy_rfcomm | ( | int | socket_fd | ) |
Removes the RFCOMM server socket which was created using bt_socket_create_rfcomm(). 2.3 public http://tizen.org/privilege/bluetooth.
[in] | socket_fd | The file descriptor of socket (which was created using bt_socket_create_rfcomm()) to destroy |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_socket_disconnect_rfcomm | ( | int | socket_fd | ) |
Disconnects the RFCOMM connection with the given file descriptor of connected socket. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | socket_fd | The file descriptor of socket to close which was received using bt_socket_connection_state_changed_cb(). |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_socket_listen_and_accept_rfcomm | ( | int | socket_fd, |
int | max_pending_connections | ||
) |
Starts listening on passed RFCOMM socket and accepts connection requests.
Pop-up is shown automatically when a RFCOMM connection is requested.
bt_socket_connection_state_changed_cb() will be called with
BT_SOCKET_CONNECTED if you click "yes" and connection is finished successfully. 2.3 public http://tizen.org/privilege/bluetooth
[in] | socket_fd | The file descriptor of socket on which start to listen |
[in] | max_pending_connections | The maximum number of pending connections |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_ENABLED | Not enabled |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_OPERATION_FAILED | Operation failed |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_socket_send_data | ( | int | socket_fd, |
const char * | data, | ||
int | length | ||
) |
Sends data to the connected device. 2.3 public http://tizen.org/privilege/bluetooth.
[in] | socket_fd | The file descriptor of connected socket which was received using bt_socket_connection_state_changed_cb() |
[in] | data | The data to be sent |
[in] | length | The length of data to be sent |
On | error, -1 is returned, and errno is set appropriately. See write 2 man page. |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_PERMISSION_DENIED | Permission denied |
BT_ERROR_AGAIN | Resource temporarily unavailable |
int bt_socket_set_connection_requested_cb | ( | bt_socket_connection_requested_cb | callback, |
void * | user_data | ||
) |
Registers a callback function that will be invoked when a RFCOMM connection is requested. 2.3.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_socket_set_connection_state_changed_cb | ( | bt_socket_connection_state_changed_cb | callback, |
void * | user_data | ||
) |
Registers a callback function that will be invoked when the connection state changes. 2.3.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_socket_set_data_received_cb | ( | bt_socket_data_received_cb | callback, |
void * | user_data | ||
) |
Registers a callback function that will be invoked when you receive data. 2.3.
[in] | callback | The callback function to register |
[in] | user_data | The user data to be passed to the callback function |
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_INVALID_PARAMETER | Invalid parameter |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_socket_unset_connection_requested_cb | ( | void | ) |
Unregisters the callback function. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_socket_unset_connection_state_changed_cb | ( | void | ) |
Unregisters the callback function. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |
int bt_socket_unset_data_received_cb | ( | void | ) |
Unregisters the callback function. 2.3.
BT_ERROR_NONE | Successful |
BT_ERROR_NOT_INITIALIZED | Not initialized |
BT_ERROR_NOT_SUPPORTED | Not supported |