TizenRT Public API  v2.0 M2
bluetooth_internal.h File Reference
Include dependency graph for bluetooth_internal.h:

Go to the source code of this file.

Functions

int bt_audio_select_role (bt_audio_role_e role)
 A2DP source/sink role is switched using this API 4.0. More...
 
int bt_adapter_set_authentication_req_cb (bt_adapter_authentication_req_cb callback, void *user_data)
 Registers a callback function that will be invoked when remote device requests authentication. More...
 
int bt_adapter_unset_authentication_req_cb (void)
 Unregisters a callback function that will be invoked when remote device requests authentication. More...
 
int bt_adapter_passkey_reply (char *passkey, bool authentication_reply)
 API to reply with PIN or PASSKEY with authentication type - TRUE or FALSE. More...
 
int bt_adapter_passkey_confirmation_reply (bool confirmation_reply)
 API to reply to the PASSKEY confirmation for on-going pairing with remote device. More...
 
int bt_adapter_le_set_remote_oob_ext_data (const char *remote_address, bt_device_address_type_e address_type, const unsigned char *hash256, const unsigned char *randomizer256, int hash256_len, int randomizer256_len)
 Sets the Hash and Randomizer value, synchronously for LE OOB pairing. 4.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_adapter_le_set_advertising_filter_policy (bt_advertiser_h advertiser, bt_adapter_le_advertising_filter_policy_e filter_policy)
 Set advertising filter policy to use white list 2.4 public http://tizen.org/privilege/bluetooth. More...
 
int bt_device_request_att_mtu (const char *remote_address, unsigned int mtu) TIZEN_DEPRECATED_API
 Request to change ATT MTU value 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_device_get_att_mtu (const char *remote_address, unsigned int *mtu) TIZEN_DEPRECATED_API
 Gets the ATT MTU value set for a connection 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_device_set_att_mtu_changed_cb (bt_device_att_mtu_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API
 Registers a callback function to be invoked when the ATT MTU is changed. 3.0. More...
 
int bt_device_unset_att_mtu_changed_cb (void) TIZEN_DEPRECATED_API
 Unregisters the callback function to be invoked when the ATT MTU is changed. 3.0. More...
 
int bt_ag_set_vendor_cmd_cb (bt_ag_vendor_cmd_cb callback, void *user_data)
 Registers a callback function that will be invoked when a XSATvendor AT command is transmitted from Hands-Free. . More...
 
int bt_ag_unset_vendor_cmd_cb (void)
 Unregisters a callback function that will be invoked when a XSATvendor AT command is transmitted from Hands-Free . More...
 
int bt_ag_is_wbs_mode (bool *wbs_mode)
 Checks whether the remoted device is wbs (Wide Band Speech) mode or not. . More...
 
int bt_ag_is_connected (bool *connected)
 Gets the HF(Hands-Free) profile connected status for AG role. 2.4. More...
 
int bt_ag_switch_headset (const char *remote_addr)
 Switch between the connected headsets for AG role. 3.0. More...
 
int bt_hf_set_sco_state_changed_cb (bt_hf_sco_state_changed_cb callback, void *user_data)
 Registers a callback function that will be invoked when the SCO(Synchronous Connection Oriented link) state is changed. . More...
 
int bt_hf_unset_sco_state_changed_cb (void)
 Unregisters a callback function that will be invoked when the SCO(Synchronous Connection Oriented link) state is changed. . More...
 
int bt_hf_set_call_handling_event_cb (bt_hf_call_handling_event_cb callback, void *user_data)
 Registers a callback function that will be invoked when a call handling event happened from Hands-Free. . More...
 
int bt_hf_unset_call_handling_event_cb (void)
 Unregisters a callback function that will be invoked when a call handling event happened from Hands-Free. . More...
 
int bt_hf_set_remote_call_event_cb (bt_hf_remote_call_event_cb callback, void *user_data)
 Registers a callback function that will be invoked when a call event happend from Audio-Gateway device. 3.0. More...
 
int bt_hf_unset_remote_call_event_cb (void)
 Unregisters a callback function. 3.0. More...
 
int bt_hf_set_multi_call_handling_event_cb (bt_hf_multi_call_handling_event_cb callback, void *user_data)
 Registers a callback function that will be invoked when a multi call handling event happened from Hands-Free. . More...
 
int bt_hf_unset_multi_call_handling_event_cb (void)
 Unregisters a callback function that will be invoked when a multi call handling event happened from Hands-Free. . More...
 
int bt_hf_initialize (void)
 Initializes the Bluetooth HF profile related with audio. . More...
 
int bt_hf_deinitialize (void)
 Deinitializes the Bluetooth HF profile related with audio. . More...
 
int bt_hf_notify_call_event (bt_hf_call_event_e event, char *phone_number)
 Notifies the call event to the remote bluetooth device. platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_hf_notify_speaker_gain (int gain)
 Notifies the speaker gain to the remote device. platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_hf_set_speaker_gain_changed_cb (bt_hf_speaker_gain_changed_cb callback, void *user_data)
 Registers a callback function that will be invoked when the speaker gain of the remote device is changed. . More...
 
int bt_hf_unset_speaker_gain_changed_cb (void)
 Unregisters a callback function that will be invoked when the speaker gain of the remote device is changed. . More...
 
int bt_hf_notify_voice_recognition_state (bool state)
 Notifies the state of voice recognition. platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_hf_unset_call_status_updated_event_cb (void)
 Registers a callback function that will be invoked when a call status event happened from Hands-Free. . More...
 
int bt_hf_close_sco (void)
 Closes an opened SCO(Synchronous Connection Oriented link), synchronously. platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_hf_send_dtmf (char *dtmf)
 Sends the DTMF(Dual Tone Multi Frequency). platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_hf_is_connected (bool *connected)
 Gets the HF(Hands-Free) profile connected status for HF role. . More...
 
int bt_hf_is_sco_opened (bool *opened)
 Checks whether an opened SCO(Synchronous Connection Oriented link) exists or not. . More...
 
int bt_hf_get_codec_id (unsigned int *codec_id)
 Gets the codec ID. . More...
 
int bt_hf_request_call_status_info_list (void)
 Gets the call status information list. . More...
 
int bt_hf_is_inband_ringtone_supported (bool *supported)
 Checks whether the remote AG device supports inband ringtone or not. . More...
 
int bt_a2dp_set_content_protection (bool status)
 Sets copy protection. streaming application that needs to have the copy protection for the streaming data, shall invoke this API. platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_avrcp_control_send_player_command_to (bt_avrcp_player_command_e cmd, char *remote_address)
 Sends a command to the target device. 5.5 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_gatt_set_permissions (bt_gatt_h gatt_handle, int permissions)
 Updates the permissions which a characteristic or descriptor's GATT handle has. 3.0. More...
 
int bt_gatt_characteristic_set_properties (bt_gatt_h characteristic, int properties)
 Updates the properties which a characteristic's GATT handle has. 3.0. More...
 
int bt_gatt_destroy (bt_gatt_h gatt_handle)
 Destroys the GATT handle 2.4. More...
 
int bt_a2dp_source_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 A2DP Source connection state is changed. . More...
 
int bt_a2dp_source_audio_unset_connection_state_changed_cb (void)
 Unregisters a callback function that will be invoked when the A2DP Source connection state is changed. . More...
 
int bt_hid_device_activate (bt_hid_device_connection_state_changed_cb callback, void *user_data)
 Registers the method for HID Device role 2.3.1 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_hid_device_deactivate (void)
 Unregisters the method for HID Device role 2.3.1 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_hid_device_connect (const char *remote_address)
 Initiates HID device Connection with device role, asynchronously. 2.3.1 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_hid_device_disconnect (const char *remote_address)
 Disconnects the connection with HID Host device, asynchronously. 2.3.1 platform http://tizen.org/privilege/bluetooth.admin. 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. 2.3.1 platform http://tizen.org/privilege/bluetooth.admin. 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. 2.3.1 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_hid_device_set_data_received_cb (bt_hid_device_data_received_cb callback, void *user_data)
 Sets the callback when device gets some data from HID Host. 2.3.1. More...
 
int bt_hid_device_unset_data_received_cb (void)
 Unsets the callback when device gets some data from HID Host. 2.3.1. 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 the reports from HID Host. 2.3.1 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_hid_device_send_custom_event (const char *remote_address, unsigned char report_id, const char *data, unsigned int data_len)
 Sends the custom event data. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_set_allow_bluetooth_mode (bt_dpm_allow_e value)
 Sets Restriction for BT mode(BT allowed or not). 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_get_allow_bluetooth_mode (bt_dpm_allow_e *value)
 Reads Restriction for BT mode(BT allowed or not). 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_activate_device_restriction (bt_dpm_status_e value)
 Sets the Restriction for device. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_is_device_restriction_active (bt_dpm_status_e *value)
 Reads the Restriction for device. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_activate_uuid_restriction (bt_dpm_status_e value)
 Sets the Restriction for uuid. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_is_uuid_restriction_active (bt_dpm_status_e *value)
 Reads the Restriction for uuid. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_add_devices_to_blacklist (const char *device_address)
 Adds the device to blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_add_devices_to_whitelist (const char *device_address)
 Adds the device to whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_add_uuids_to_blacklist (const char *service_uuid)
 Adds the uuids to blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_add_uuids_to_whitelist (const char *service_uuid)
 Adds the uuid to whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_clear_devices_from_blacklist (void)
 Clears the device from blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_clear_devices_from_whitelist (void)
 Clears the device from whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_clear_uuids_from_blacklist (void)
 Clears the uuids from blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_clear_uuids_from_whitelist (void)
 Clears the uuids from whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_get_devices_from_blacklist (bt_dpm_device_list_s **device_list)
 Reads the devices from blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_get_devices_from_whitelist (bt_dpm_device_list_s **device_list)
 Reads the devices from whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_get_uuids_from_blacklist (bt_dpm_uuids_list_s **uuid_list)
 Reads the uuids from blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_get_uuids_from_whitelist (bt_dpm_uuids_list_s **uuid_list)
 Reads the uuids from whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_remove_device_from_whitelist (const char *device_address)
 Removes the devices from whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_remove_device_from_blacklist (const char *device_address)
 Removes the devices from blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_remove_uuid_from_whitelist (const char *service_uuid)
 Removes the uuids from whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_remove_uuid_from_blacklist (const char *service_uuid)
 Removes the uuids from blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_set_allow_outgoing_call (bt_dpm_status_e value)
 Sets the Restriction for outgoing call. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_get_allow_outgoing_call (bt_dpm_status_e *value)
 Reads the Restriction for outgoing call. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_set_pairing_state (bt_dpm_status_e value)
 Sets the Restriction for pairing. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_get_pairing_state (bt_dpm_status_e *value)
 Reads the Restriction for pairing. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_set_profile_state (bt_dpm_profile_e profile, bt_dpm_status_e value)
 Sets the Restriction for profiles. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_get_profile_state (bt_dpm_profile_e profile, bt_dpm_status_e *value)
 Reads the Restriction for profiles. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_set_desktop_connectivity_state (bt_dpm_status_e value)
 Sets the Restriction for desktop connectivity. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_get_desktop_connectivity_state (bt_dpm_status_e *value)
 Reads the Restriction for desktop connectivity. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_set_discoverable_state (bt_dpm_status_e value)
 Sets the Restriction for discoverable mode. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_get_discoverable_state (bt_dpm_status_e *value)
 Reads the Restriction for discoverable mode. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_set_limited_discoverable_state (bt_dpm_status_e value)
 Sets the Restriction for limited discoverable mode. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_get_limited_discoverable_state (bt_dpm_status_e *value)
 Reads the Restriction for limited discoverable mode. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_set_data_transfer_state (bt_dpm_status_e value)
 Sets the Restriction for Data transfer. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_dpm_get_data_transfer_state (bt_dpm_status_e *value)
 Reads the Restriction for Data transfer. 3.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_pbap_client_is_connected (const char *address, bool *connected_status)
 Gets the pbap connected status. 3.0. More...
 
int bt_avrcp_control_set_absolute_volume (unsigned int value)
 Sends the volume change request to the remote device. 4.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_avrcp_control_increase_volume (void)
 Sends the volume up request to the remote device. 5.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_avrcp_control_decrease_volume (void)
 Sends the volume down request to the remote device. 5.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_avrcp_control_send_delay_report (unsigned int value)
 Sends the delay report to the remote device. 5.0 platform http://tizen.org/privilege/bluetooth.admin. More...
 
int bt_avrcp_set_delay_changed_cb (bt_avrcp_delay_changed_cb callback, void *user_data)
 Registers a callback function that will be invoked when the delay is changed. 5.0. More...
 
int bt_avrcp_unset_delay_changed_cb (void)
 Unregisters a callback function that will be invoked when the delay is changed. 5.0. More...
 
int bt_proximity_reporter_create (bt_proximity_reporter_h *reporter)
 Creates the Proximity Profile Reporter Role. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_reporter_destroy (bt_proximity_reporter_h reporter)
 Destroys the Proximity Profile Reporter Role. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_monitor_create (const char *remote_address, bt_proximity_monitor_h *monitor)
 Creates the Proximity Profile Monitor Role. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_monitor_destroy (bt_proximity_monitor_h monitor)
 Creates the Proximity Profile Monitor Role. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_monitor_connect (bt_proximity_monitor_h monitor)
 Proximity Monitor initiates the connection to remote reporter device. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_monitor_disconnect (bt_proximity_monitor_h monitor)
 Proximity Monitor disconnects with the remote reporter device. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_monitor_set_connection_state_changed_cb (bt_proximity_monitor_h monitor, bt_proximity_monitor_connection_state_changed_cb callback, void *user_data)
 Sets proximity monitor connection state changed event change callback. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_monitor_unset_connection_state_changed_cb (bt_proximity_monitor_h monitor)
 Unsets proximity monitor connection state changed event change callback. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_reporter_set_connection_state_changed_cb (bt_proximity_reporter_h reporter, bt_proximity_reporter_connection_state_changed_cb callback, void *user_data)
 Sets proximity reporter connection state changed event change callback. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_reporter_unset_connection_state_changed_cb (bt_proximity_reporter_h reporter)
 Unsets proximity reporter connection state changed event change callback. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_reporter_set_property_changed_cb (bt_proximity_reporter_h reporter, bt_proximity_reporter_property_changed_cb callback, void *user_data)
 Sets proximity reporter properties change callback. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_reporter_unset_property_changed_cb (bt_proximity_reporter_h reporter)
 Unsets proximity reporter properties change callback. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_monitor_set_linkloss_alert (bt_proximity_monitor_h monitor, int value)
 Set the Proximity Profile monitor linkloss alert value. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_monitor_set_immediate_alert (bt_proximity_monitor_h monitor, int value)
 Set the Proximity Profile monitor immediate alert value. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_monitor_get_linkloss_alert (bt_proximity_monitor_h monitor, int *value)
 Read the Proximity Profile monitor linkloss alert value. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_monitor_get_immediate_alert (bt_proximity_monitor_h monitor, int *value)
 Read the Proximity Profile monitor immediate alert value. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_monitor_get_signal_level (bt_proximity_monitor_h monitor, int *value)
 Read the Proximity Profile monitor Signal level value. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_reporter_get_linkloss_alert (const char *remote_address, int *value)
 Read the Proximity Profile reporter linkloss alert value. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_proximity_reporter_get_immediate_alert (const char *remote_address, int *value)
 Read the Proximity Profile reporter immediate alert value. 4.0 public http://tizen.org/privilege/bluetooth. More...
 
int bt_otp_server_initialize (const char *directory)
 Starts OTP server on the given directory location. More...
 
int bt_otp_server_deinitialize (void)
 Stops OTP server. More...
 
int bt_otp_set_server_state_changed_cb (bt_otp_server_state_changed_cb callback, void *user_data)
 Registers a callback function that will be invoked when the server state is changed. More...
 
int bt_otp_unset_server_state_changed_cb (void)
 Registers a callback function that will be invoked when the server state is changed. More...
 

Function Documentation

int bt_a2dp_set_content_protection ( bool  status)

Sets copy protection. streaming application that needs to have the copy protection for the streaming data, shall invoke this API. platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]status- TRUE/FALSE
Returns
0 on success, otherwise negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_OPERATION_FAILEDon failure
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
int bt_a2dp_source_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 A2DP Source connection state is changed. .

Parameters
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_audio_connection_state_changed_cb()
int bt_a2dp_source_audio_unset_connection_state_changed_cb ( void  )

Unregisters a callback function that will be invoked when the A2DP Source connection state is changed. .

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_audio_connection_state_changed_cb()
bt_audio_set_connection_state_changed_cb()
int bt_adapter_le_set_advertising_filter_policy ( bt_advertiser_h  advertiser,
bt_adapter_le_advertising_filter_policy_e  filter_policy 
)

Set advertising filter policy to use white list 2.4 public http://tizen.org/privilege/bluetooth.

Parameters
[in]advertiserThe handle of advertiser
[in]filter_policyThe filter policy of advertising
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_NOW_IN_PROGRESSOperation is now in progress
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth service must be initialized with bt_initialize().
See also
bt_adapter_le_start_advertising_new()
int bt_adapter_le_set_remote_oob_ext_data ( const char *  remote_address,
bt_device_address_type_e  address_type,
const unsigned char *  hash256,
const unsigned char *  randomizer256,
int  hash256_len,
int  randomizer256_len 
)

Sets the Hash and Randomizer value, synchronously for LE OOB pairing. 4.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]remote_addressRemote device address
[in]address_typeRemote device address type
[in]hash256The P-256 hash value received via OOB from remote device
[in]randomizer256The P-256 randomizer value received via OOB from remote device
[in]hash256_lenThe length of hash256
[in]randomizer256_lenThe length of randomizer256
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The state of local Bluetooth must be BT_ADAPTER_ENABLED.
The Bluetooth service must be initialized with bt_initialize().
See also
bt_initialize()
int bt_adapter_passkey_confirmation_reply ( bool  confirmation_reply)

API to reply to the PASSKEY confirmation for on-going pairing with remote device.

Remarks
This function can be called by application, when local adapter wants PASSKEY confirmation from user.
Parameters
[in]confirmation_replyThis indicates whether application wants to accepts or cancels the on-going pairing confirmation_reply : TRUE will indicate that Application has confirmed the PASSKEY confirmation_reply : FALSE will indicate that Application has failed to confirm the PASSKEY. In this situation the pairing will be failed.
Precondition
This function can only be called when application receives authentication event (BT_AUTH_PASSKEY_CONFIRM_REQUEST) from remote device.
See also
bt_adapter_set_authentication_req_cb()
int bt_adapter_passkey_reply ( char *  passkey,
bool  authentication_reply 
)

API to reply with PIN or PASSKEY with authentication type - TRUE or FALSE.

Remarks
This function can be called by application when remote device requests PIN or PASSKEY from local adapter.
Parameters
[in]passkeyThe passkey to be provided by application when remote devices requests for it.
[in]authentication_replyThis indicates whether application wants to accept or cancel the on-going pairing
Precondition
This function can only be called when application receieves authentication event (BT_AUTH_PIN_REQUEST) from remote device.
See also
bt_adapter_set_authentication_req_cb()
int bt_adapter_set_authentication_req_cb ( bt_adapter_authentication_req_cb  callback,
void *  user_data 
)

Registers a callback function that will be invoked when remote device requests authentication.

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
Precondition
The Bluetooth service must be initialized by bt_initialize().
Parameters
[in]callbackcallback function to be set when a request is received.
[in]user_datadata from application which will be provided in callback.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
See also
bt_initialize()
bt_adapter_set_authentication_req_cb()
int bt_adapter_unset_authentication_req_cb ( void  )

Unregisters a callback function that will be invoked when remote device requests authentication.

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
Precondition
The Bluetooth service must be initialized by bt_initialize().
See also
bt_initialize()
bt_adapter_set_authentication_req_cb()
int bt_ag_is_connected ( bool *  connected)

Gets the HF(Hands-Free) profile connected status for AG role. 2.4.

Parameters
[out]connectedthe connected status: (true = connected , false = not connected )
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The state of local Bluetooth must be BT_ADAPTER_ENABLED.
int bt_ag_is_wbs_mode ( bool *  wbs_mode)

Checks whether the remoted device is wbs (Wide Band Speech) mode or not. .

Parameters
[out]wbs_modeThe wbs status: (true = wide band speech, false = narrow band speech)
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDRemote device is not connected
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The remote device is connected by bt_audio_connect() with BT_AUDIO_PROFILE_TYPE_HSP_HFP service.
See also
bt_audio_connect()
int bt_ag_set_vendor_cmd_cb ( bt_ag_vendor_cmd_cb  callback,
void *  user_data 
)

Registers a callback function that will be invoked when a XSATvendor AT command is transmitted from Hands-Free. .

Parameters
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_ag_vendor_cmd_cb()
bt_ag_unset_vendor_cmd_cb()
int bt_ag_switch_headset ( const char *  remote_addr)

Switch between the connected headsets for AG role. 3.0.

Parameters
[out]
int bt_ag_unset_vendor_cmd_cb ( void  )

Unregisters a callback function that will be invoked when a XSATvendor AT command is transmitted from Hands-Free .

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_ag_vendor_cmd_cb()
bt_ag_set_vendor_cmd_cb()
int bt_audio_select_role ( bt_audio_role_e  role)

A2DP source/sink role is switched using this API 4.0.

Parameters
[in]Rolefor A2DP
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_SUPPORTEDNot supported
BT_ERROR_OPERATION_FAILEDInternal Error
Precondition
The Bluetooth service must be initialized with bt_initialize().
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_initialize()
bt_audio_initialize()
int bt_avrcp_control_decrease_volume ( void  )

Sends the volume down request to the remote device. 5.0 platform http://tizen.org/privilege/bluetooth.admin.

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDRemote device is not connected
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The remote device must be connected.
See also
bt_avrcp_control_connect()
bt_avrcp_control_initialize()
int bt_avrcp_control_increase_volume ( void  )

Sends the volume up request to the remote device. 5.0 platform http://tizen.org/privilege/bluetooth.admin.

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDRemote device is not connected
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The remote device must be connected.
See also
bt_avrcp_control_connect()
bt_avrcp_control_initialize()
int bt_avrcp_control_send_delay_report ( unsigned int  value)

Sends the delay report to the remote device. 5.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]valueThe new delay level
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDRemote device is not connected
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The remote device must be connected.
See also
bt_avrcp_target_connection_state_changed_cb()
bt_avrcp_target_initialize()
int bt_avrcp_control_send_player_command_to ( bt_avrcp_player_command_e  cmd,
char *  remote_address 
)

Sends a command to the target device. 5.5 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]cmdThe commands, one of: Play, Pause, Next, Rewind.
[in]remote_addressThe address of the remote Bluetooth device
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDRemote device is not connected
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_avrcp_control_initialize().
See also
bt_avrcp_control_initialize()
bt_avrcp_control_connect()
int bt_avrcp_control_set_absolute_volume ( unsigned int  value)

Sends the volume change request to the remote device. 4.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]valueThe new volume level
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDRemote device is not connected
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The remote device must be connected.
See also
bt_avrcp_target_connection_state_changed_cb()
bt_avrcp_target_initialize()
int bt_avrcp_set_delay_changed_cb ( bt_avrcp_delay_changed_cb  callback,
void *  user_data 
)

Registers a callback function that will be invoked when the delay is changed. 5.0.

Parameters
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize().
See also
bt_avrcp_target_initialize()
bt_avrcp_control_initialize()
int bt_avrcp_unset_delay_changed_cb ( void  )

Unregisters a callback function that will be invoked when the delay is changed. 5.0.

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The AVRCP service must be initialized with bt_avrcp_target_initialize() or bt_avrcp_control_initialize().
See also
bt_avrcp_target_initialize()
bt_avrcp_control_initialize()
bt_avrcp_set_delay_changed_cb()
int bt_device_get_att_mtu ( const char *  remote_address,
unsigned int *  mtu 
)

Gets the ATT MTU value set for a connection 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Deprecated:
Deprecated since 4.0. Use bt_gatt_client_get_att_mtu instead.
Parameters
[in]remote_addressThe address of the remote Bluetooth device
int bt_device_request_att_mtu ( const char *  remote_address,
unsigned int  mtu 
)

Request to change ATT MTU value 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Deprecated:
Deprecated since 4.0. Use bt_gatt_client_request_att_mtu_change instead.
Parameters
[in]remote_addressThe address of the remote Bluetooth device
[in]mtuNew MTU value to be changed
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
int bt_device_set_att_mtu_changed_cb ( bt_device_att_mtu_changed_cb  callback,
void *  user_data 
)

Registers a callback function to be invoked when the ATT MTU is changed. 3.0.

Deprecated:
Deprecated since 4.0. Use bt_gatt_client_set_att_mtu_changed_cb instead.
Parameters
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth service must be initialized with bt_initialize().
Postcondition
bt_device_connection_state_changed_cb() will be invoked.
See also
bt_initialize()
bt_device_unset_att_mtu_changed_cb()
int bt_device_unset_att_mtu_changed_cb ( void  )

Unregisters the callback function to be invoked when the ATT MTU is changed. 3.0.

Deprecated:
Deprecated since 4.0. Use bt_gatt_client_unset_att_mtu_changed_cb instead.
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth service must be initialized with bt_initialize().
See also
bt_initialize()
bt_device_set_att_mtu_changed_cb()
int bt_dpm_activate_device_restriction ( bt_dpm_status_e  value)

Sets the Restriction for device. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_activate_uuid_restriction ( bt_dpm_status_e  value)

Sets the Restriction for uuid. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_add_devices_to_blacklist ( const char *  device_address)

Adds the device to blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]device_address- Device address
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_add_devices_to_whitelist ( const char *  device_address)

Adds the device to whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]device_address- Device address
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_add_uuids_to_blacklist ( const char *  service_uuid)

Adds the uuids to blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]service_uuids- profile or custom service uuids
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_add_uuids_to_whitelist ( const char *  service_uuid)

Adds the uuid to whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]service_uuids- profile or custom service uuids
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_clear_devices_from_blacklist ( void  )

Clears the device from blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]none
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_clear_devices_from_whitelist ( void  )

Clears the device from whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]none
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_clear_uuids_from_blacklist ( void  )

Clears the uuids from blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]none
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_clear_uuids_from_whitelist ( void  )

Clears the uuids from whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]none
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_get_allow_bluetooth_mode ( bt_dpm_allow_e value)

Reads Restriction for BT mode(BT allowed or not). 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]none
[out]value- BT Allow value. BT_DPM_ERROR = -1, < bluetooth allowance error BT_DPM_BT_ALLOWED, < bluetooth allowance allowed BT_DPM_HANDSFREE_ONLY, < bluetooth allowance handsfree only BT_DPM_BT_RESTRICTED, < bluetooth allowance restricted
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
none.
See also
bt_dpm_set_allow_bluetooth_mode()
int bt_dpm_get_allow_outgoing_call ( bt_dpm_status_e value)

Reads the Restriction for outgoing call. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[out]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_get_data_transfer_state ( bt_dpm_status_e value)

Reads the Restriction for Data transfer. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[out]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_get_desktop_connectivity_state ( bt_dpm_status_e value)

Reads the Restriction for desktop connectivity. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[out]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_get_devices_from_blacklist ( bt_dpm_device_list_s **  device_list)

Reads the devices from blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[out]device_list- list of devices
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_get_devices_from_whitelist ( bt_dpm_device_list_s **  device_list)

Reads the devices from whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[out]device_list- list of devices
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_get_discoverable_state ( bt_dpm_status_e value)

Reads the Restriction for discoverable mode. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[out]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_get_limited_discoverable_state ( bt_dpm_status_e value)

Reads the Restriction for limited discoverable mode. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[out]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_get_pairing_state ( bt_dpm_status_e value)

Reads the Restriction for pairing. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[out]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_get_profile_state ( bt_dpm_profile_e  profile,
bt_dpm_status_e value 
)

Reads the Restriction for profiles. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]
int bt_dpm_get_uuids_from_blacklist ( bt_dpm_uuids_list_s **  uuid_list)

Reads the uuids from blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[out]uuid_list- list of uuids
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_get_uuids_from_whitelist ( bt_dpm_uuids_list_s **  uuid_list)

Reads the uuids from whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[out]uuid_list- list of uuids
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_is_device_restriction_active ( bt_dpm_status_e value)

Reads the Restriction for device. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[out]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_is_uuid_restriction_active ( bt_dpm_status_e value)

Reads the Restriction for uuid. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[out]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_remove_device_from_blacklist ( const char *  device_address)

Removes the devices from blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]device_address- Device address
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_remove_device_from_whitelist ( const char *  device_address)

Removes the devices from whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]device_address- Device address
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_remove_uuid_from_blacklist ( const char *  service_uuid)

Removes the uuids from blacklist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]service_uuids- profile or custom service uuids
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_remove_uuid_from_whitelist ( const char *  service_uuid)

Removes the uuids from whitelist. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]service_uuids- profile or custom service uuids
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_set_allow_bluetooth_mode ( bt_dpm_allow_e  value)

Sets Restriction for BT mode(BT allowed or not). 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]value- BT Allow value. BT_DPM_ERROR = -1, < bluetooth allowance error BT_DPM_BT_ALLOWED, < bluetooth allowance allowed BT_DPM_HANDSFREE_ONLY, < bluetooth allowance handsfree only BT_DPM_BT_RESTRICTED, < bluetooth allowance restricted
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
none.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_set_allow_outgoing_call ( bt_dpm_status_e  value)

Sets the Restriction for outgoing call. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_set_data_transfer_state ( bt_dpm_status_e  value)

Sets the Restriction for Data transfer. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_set_desktop_connectivity_state ( bt_dpm_status_e  value)

Sets the Restriction for desktop connectivity. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_set_discoverable_state ( bt_dpm_status_e  value)

Sets the Restriction for discoverable mode. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_set_limited_discoverable_state ( bt_dpm_status_e  value)

Sets the Restriction for limited discoverable mode. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_set_pairing_state ( bt_dpm_status_e  value)

Sets the Restriction for pairing. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]value- State value. BT_DPM_ALLOWED = 0, < DPM Policy status allowed. BT_DPM_RESTRICTED = 1, < DPM Policy status restricted.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERinvalid paramter
BT_ERROR_NOT_SUPPORTEDNot suported
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDoperation failed
Precondition
bt_dpm_set_allow_bluetooth_mode must be allowed.
See also
bt_dpm_get_allow_bluetooth_mode()
int bt_dpm_set_profile_state ( bt_dpm_profile_e  profile,
bt_dpm_status_e  value 
)

Sets the Restriction for profiles. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]
int bt_gatt_characteristic_set_properties ( bt_gatt_h  characteristic,
int  properties 
)

Updates the properties which a characteristic's GATT handle has. 3.0.

Parameters
[in]characteristicThe characteristic's GATT handle
[in]propertiesThe properties to be updated
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
See also
bt_gatt_property_e
int bt_gatt_destroy ( bt_gatt_h  gatt_handle)

Destroys the GATT handle 2.4.

Parameters
[in]gatt_handleThe handle of service, characteristic or descriptor
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
See also
bt_gatt_service_create()
bt_gatt_characteristic_create()
bt_gatt_descriptor_create()
int bt_gatt_set_permissions ( bt_gatt_h  gatt_handle,
int  permissions 
)

Updates the permissions which a characteristic or descriptor's GATT handle has. 3.0.

Parameters
[in]gatt_handleThe handle of a characteristic or descriptor
[in]permissionsThe permissions to be updated
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
See also
bt_gatt_characteristic_create()
bt_gatt_descriptor_create()
bt_gatt_permission_e
int bt_hf_close_sco ( void  )

Closes an opened SCO(Synchronous Connection Oriented link), synchronously. platform http://tizen.org/privilege/bluetooth.admin.

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
int bt_hf_deinitialize ( void  )

Deinitializes the Bluetooth HF profile related with audio. .

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
int bt_hf_get_codec_id ( unsigned int *  codec_id)

Gets the codec ID. .

Remarks
The codec_id must be released with free() by you.
Parameters
[out]codec_idThe codec ID
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio device must be connected with bt_audio_connect().
See also
bt_audio_connect()
int bt_hf_initialize ( void  )

Initializes the Bluetooth HF profile related with audio. .

Remarks
This function must be called before Bluetooth profiles related with audio starts.
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth service must be initialized with bt_initialize().
See also
bt_hf_deinitialize()
int bt_hf_is_connected ( bool *  connected)

Gets the HF(Hands-Free) profile connected status for HF role. .

Parameters
[out]connectedthe connected status: (true = connected , false = not connected )
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The state of local Bluetooth must be BT_ADAPTER_ENABLED.
int bt_hf_is_inband_ringtone_supported ( bool *  supported)

Checks whether the remote AG device supports inband ringtone or not. .

Parameters
[out]supportedInband support: (true = supported, false = not supported)
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDRemote device is not connected
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio device must be connected with bt_audio_connect().
See also
bt_audio_connect()
int bt_hf_is_sco_opened ( bool *  opened)

Checks whether an opened SCO(Synchronous Connection Oriented link) exists or not. .

Parameters
[out]openedThe SCO status: (true = opened, false = not opened)
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio device must be connected with bt_audio_connect().
See also
bt_audio_connect()
int bt_hf_notify_call_event ( bt_hf_call_event_e  event,
char *  phone_number 
)

Notifies the call event to the remote bluetooth device. platform http://tizen.org/privilege/bluetooth.admin.

Remarks
Before notifying #BT_HF_CALL_EVENT_ANSWERED or #BT_HF_CALL_EVENT_DIALING, you should open SCO(Synchronous Connection Oriented link) if Bluetooth Hands-Free need SCO connection.
Parameters
[in]eventThe call event
[in]call_idThe call ID
[in]phone_numberThe phone number. You must set this value in case of #BT_HF_CALL_EVENT_DIALING and BT_HF_CALL_EVENT_INCOMING. In other cases, this value can be NULL.
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDRemote device is not connected
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio device must be connected with bt_audio_connect().
See also
bt_audio_connect()
int bt_hf_notify_speaker_gain ( int  gain)

Notifies the speaker gain to the remote device. platform http://tizen.org/privilege/bluetooth.admin.

This function sends a signal to the remote device. This signal has the gain value. gain is represented on a scale from 0 to 15. This value is absolute value relating to a particular volume level. When the speaker gain of remote device is changed to the requested gain, bt_audio_speaker_gain_changed_cb() will be called.

Parameters
[in]gainThe gain of speaker (0 ~ 15)
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDRemote device is not connected
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The remote device is connected by bt_audio_connect() with BT_AUDIO_PROFILE_TYPE_HSP_HFP service.
See also
bt_hf_get_speaker_gain()
bt_hf_set_speaker_gain_changed_cb()
bt_hf_unset_speaker_gain_changed_cb()
int bt_hf_notify_voice_recognition_state ( bool  state)

Notifies the state of voice recognition. platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]stateThe state of voice recognition: (true = enabled, false = disabled)
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDRemote device is not connected
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio device must be connected with bt_audio_connect().
See also
bt_audio_connect()
int bt_hf_request_call_status_info_list ( void  )

Gets the call status information list. .

Remarks
The call_list must be released with bt_hf_free_call_status_info_list() by you.
call_info_list has elements which consist of bt_hf_call_status_info_s
Parameters
[out]call_listThe call status information list
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio device must be connected with bt_audio_connect().
See also
bt_hf_call_status_info_s
bt_audio_connect()

Frees the call status information list.

Parameters
[in]call_listThe call status information list
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
See also
bt_hf_get_call_status_info_list()

Requests the call status information list. 3.0

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_NO_DATANo data available
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio device must be connected with bt_audio_connect().
The bt_hf_set_call_status_updated_event_cb() should be set to receive the event of call status update.
Postcondition
This function invokes bt_hf_call_status_updated_event_cb().
See also
bt_audio_connect()
bt_hf_set_call_status_updated_event_cb()
bt_hf_unset_call_status_updated_event_cb()
bt_hf_call_status_updated_event_cb()
int bt_hf_send_dtmf ( char *  dtmf)

Sends the DTMF(Dual Tone Multi Frequency). platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]dtmfThe DTMF to send
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio device must be connected with bt_audio_connect().
See also
bt_audio_connect()
int bt_hf_set_call_handling_event_cb ( bt_hf_call_handling_event_cb  callback,
void *  user_data 
)

Registers a callback function that will be invoked when a call handling event happened from Hands-Free. .

Parameters
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_ag_call_handling_event_cb()
bt_ag_unset_call_handling_event_cb()
int bt_hf_set_multi_call_handling_event_cb ( bt_hf_multi_call_handling_event_cb  callback,
void *  user_data 
)

Registers a callback function that will be invoked when a multi call handling event happened from Hands-Free. .

Parameters
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_ag_multi_call_handling_event_cb()
bt_ag_unset_multi_call_handling_event_cb()
int bt_hf_set_remote_call_event_cb ( bt_hf_remote_call_event_cb  callback,
void *  user_data 
)

Registers a callback function that will be invoked when a call event happend from Audio-Gateway device. 3.0.

Parameters
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_hf_remote_call_event_cb()
bt_hf_unset_remote_call_event_cb()
int bt_hf_set_sco_state_changed_cb ( bt_hf_sco_state_changed_cb  callback,
void *  user_data 
)

Registers a callback function that will be invoked when the SCO(Synchronous Connection Oriented link) state is changed. .

Parameters
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_ag_sco_state_changed_cb()
bt_ag_unset_sco_state_changed_cb()
int bt_hf_set_speaker_gain_changed_cb ( bt_hf_speaker_gain_changed_cb  callback,
void *  user_data 
)

Registers a callback function that will be invoked when the speaker gain of the remote device is changed. .

This function let you know the change of the speaker gain of the remote device. gain is represented on a scale from 0 to 15. This value is absolute value relating to a particular volume level.

Parameters
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_hf_unset_speaker_gain_changed_cb()
int bt_hf_unset_call_handling_event_cb ( void  )

Unregisters a callback function that will be invoked when a call handling event happened from Hands-Free. .

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_ag_call_handling_event_cb()
bt_ag_set_call_handling_event_cb()
int bt_hf_unset_call_status_updated_event_cb ( void  )

Registers a callback function that will be invoked when a call status event happened from Hands-Free. .

Parameters
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_hf_unset_call_status_updated_event_cb()

Unregisters a callback function that will be invoked when a call status event happened from Hands-Free.

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_hf_set_call_status_updated_event_cb()
int bt_hf_unset_multi_call_handling_event_cb ( void  )

Unregisters a callback function that will be invoked when a multi call handling event happened from Hands-Free. .

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_ag_multi_call_handling_event_cb()
bt_ag_set_multi_call_handling_event_cb()
int bt_hf_unset_remote_call_event_cb ( void  )

Unregisters a callback function. 3.0.

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_hf_remote_call_event_cb()
bt_hf_set_remote_call_event_cb()
int bt_hf_unset_sco_state_changed_cb ( void  )

Unregisters a callback function that will be invoked when the SCO(Synchronous Connection Oriented link) state is changed. .

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_ag_sco_state_changed_cb()
bt_ag_set_sco_state_changed_cb()
int bt_hf_unset_speaker_gain_changed_cb ( void  )

Unregisters a callback function that will be invoked when the speaker gain of the remote device is changed. .

Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth audio service must be initialized with bt_audio_initialize().
See also
bt_audio_initialize()
bt_hf_set_speaker_gain_changed_cb()
int bt_hid_device_activate ( bt_hid_device_connection_state_changed_cb  callback,
void *  user_data 
)

Registers the method for HID Device role 2.3.1 platform http://tizen.org/privilege/bluetooth.admin.

Remarks
This function must be called to register HID UUID then only remote device could be able identify this one as HID device
Parameters
[in]callbackThe callback called when the connection state is changed
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_NOW_IN_PROGRESSAlready activated
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The Bluetooth service must be initialized with bt_initialize().
See also
bt_initialize()
bt_hid_device_deactivate()
int bt_hid_device_connect ( const char *  remote_address)

Initiates HID device Connection with device role, asynchronously. 2.3.1 platform http://tizen.org/privilege/bluetooth.admin.

Remarks
This function must be called to Initiate Hid device role connection
Parameters
[in]remote_addressdevice address of remote device.
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_NOT_IN_PROGRESSNot activated
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_PERMISSION_DENIEDPermission denied
BT_ERROR_ALREADY_DONEAlready connected
Precondition
The Bluetooth service must be initialized with bt_initialize().
The local device must be bonded with the remote device by bt_device_create_bond().
See also
bt_initialize()
bt_hid_device_activate()
int bt_hid_device_deactivate ( void  )

Unregisters the method for HID Device role 2.3.1 platform http://tizen.org/privilege/bluetooth.admin.

Remarks
This function must be called to deregister HID UUID
Parameters
[in]socket_fdon which uuid need to be deregistered.
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_NOT_IN_PROGRESSNot activated
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_PERMISSION_DENIEDPermission denied
Precondition
The Bluetooth service must be initialized with bt_initialize().
See also
bt_initialize()
bt_hid_device_activate()
int bt_hid_device_disconnect ( const char *  remote_address)

Disconnects the connection with HID Host device, asynchronously. 2.3.1 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]remote_addressdevice address of remote device.
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDRemote device is not connected
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_PERMISSION_DENIEDPermission denied
Precondition
The Bluetooth service must be initialized with bt_initialize().
See also
bt_initialize()
bt_hid_device_connection_state_changed_cb()
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 the reports from HID Host. 2.3.1 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]remote_addressdevice address of remote device.
[in]header_typeHeader type to be there in response
[in]param_typeParameter type to be there in response.
[in]dataData to be present in data payload of response.
[in]data_lenThe length of the response data
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_PERMISSION_DENIEDPermission denied
Precondition
The HID connection must be established.
See also
bt_hid_device_connection_state_changed_cb()
int bt_hid_device_send_custom_event ( const char *  remote_address,
unsigned char  report_id,
const char *  data,
unsigned int  data_len 
)

Sends the custom event data. 3.0 platform http://tizen.org/privilege/bluetooth.admin.

Sends the custom event data. platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]remote_addressdevice address of remote device.
[in]report_idreoport id need to be passed to remote device
[in]dataThe data need to be passed to remote device
[in]data_lenThe length of the data
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_PERMISSION_DENIEDPermission denied
Precondition
The HID connection must be established.
See also
bt_hid_device_connection_state_changed_cb()
int bt_hid_device_send_key_event ( const char *  remote_address,
const bt_hid_key_data_s key_data 
)

Sends the keyboard event data. 2.3.1 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]remote_addressdevice address of remote device.
[in]key_datakey data the need to be passed to remote device
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_PERMISSION_DENIEDPermission denied
Precondition
The HID connection must be established.
See also
bt_hid_device_connection_state_changed_cb()
int bt_hid_device_send_mouse_event ( const char *  remote_address,
const bt_hid_mouse_data_s mouse_data 
)

Sends the mouse event data. 2.3.1 platform http://tizen.org/privilege/bluetooth.admin.

Parameters
[in]remote_addressdevice address of remote device.
[in]mouse_datamouse data that need to be passed to remote device
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_PERMISSION_DENIEDPermission denied
Precondition
The HID connection must be established.
See also
bt_hid_device_connection_state_changed_cb()
int bt_hid_device_set_data_received_cb ( bt_hid_device_data_received_cb  callback,
void *  user_data 
)

Sets the callback when device gets some data from HID Host. 2.3.1.

Parameters
[in]callbackcallback function to be set when data is received.
[in]user_datadata from application which will be provided in callback.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_INVALID_PARAMETERInvalid parameter
See also
bt_hid_device_connection_state_changed_cb()
int bt_hid_device_unset_data_received_cb ( void  )

Unsets the callback when device gets some data from HID Host. 2.3.1.

Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
See also
bt_hid_device_connection_state_changed_cb()
int bt_otp_server_deinitialize ( void  )

Stops OTP server.

int bt_otp_server_initialize ( const char *  directory)

Starts OTP server on the given directory location.

int bt_otp_set_server_state_changed_cb ( bt_otp_server_state_changed_cb  callback,
void *  user_data 
)

Registers a callback function that will be invoked when the server state is changed.

int bt_otp_unset_server_state_changed_cb ( void  )

Registers a callback function that will be invoked when the server state is changed.

int bt_pbap_client_is_connected ( const char *  address,
bool *  connected_status 
)

Gets the pbap connected status. 3.0.

Parameters
[in]remote_addressThe address of the remote device
[out]connected_statusthe connected status
Returns
0 on success, otherwise a negative error value.
Return values
BT_ERROR_NONESuccessful
BT_ERROR_INVALID_PARAMETERInvalid parameter
BT_ERROR_NOT_INITIALIZEDNot initialized
BT_ERROR_NOT_ENABLEDNot enabled
BT_ERROR_REMOTE_DEVICE_NOT_BONDEDRemote device not bonded
BT_ERROR_OPERATION_FAILEDOperation failed
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition
The state of local Bluetooth must be BT_ADAPTER_ENABLED.
int bt_proximity_monitor_connect ( bt_proximity_monitor_h  monitor)

Proximity Monitor initiates the connection to remote reporter device. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]monitorproximity monitor handle
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
int bt_proximity_monitor_create ( const char *  remote_address,
bt_proximity_monitor_h monitor 
)

Creates the Proximity Profile Monitor Role. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]remoteaddress
[out]monitorproximity monitor handle
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_ALREADY_DONEAlready Enabled
BT_ERROR_OUT_OF_MEMORYout Of Memory
int bt_proximity_monitor_destroy ( bt_proximity_monitor_h  monitor)

Creates the Proximity Profile Monitor Role. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]monitorproximity monitor handle
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDDevice not Connected
int bt_proximity_monitor_disconnect ( bt_proximity_monitor_h  monitor)

Proximity Monitor disconnects with the remote reporter device. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]proximitymonitor handle
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
int bt_proximity_monitor_get_immediate_alert ( bt_proximity_monitor_h  monitor,
int *  value 
)

Read the Proximity Profile monitor immediate alert value. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]monitorproximity monitor handle
[out]valuevalue read for the immedaite alert.
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDDevice not Connected
BT_ERROR_NOT_SUPPORTEDNot supported
int bt_proximity_monitor_get_linkloss_alert ( bt_proximity_monitor_h  monitor,
int *  value 
)

Read the Proximity Profile monitor linkloss alert value. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]monitorproximity monitor handle
[out]valuevalue read for the linkloss alert.
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDDevice not Connected
BT_ERROR_NOT_SUPPORTEDNot supported
int bt_proximity_monitor_get_signal_level ( bt_proximity_monitor_h  monitor,
int *  value 
)

Read the Proximity Profile monitor Signal level value. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]monitorproximity monitor handle
[out]valuevalue read for the signal level.
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDDevice not Connected
BT_ERROR_NOT_SUPPORTEDNot supported
int bt_proximity_monitor_set_connection_state_changed_cb ( bt_proximity_monitor_h  monitor,
bt_proximity_monitor_connection_state_changed_cb  callback,
void *  user_data 
)

Sets proximity monitor connection state changed event change callback. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]proximitymonitor handle
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDDevice not Connected
int bt_proximity_monitor_set_immediate_alert ( bt_proximity_monitor_h  monitor,
int  value 
)

Set the Proximity Profile monitor immediate alert value. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]monitorproximity monitor handle
[in]valueThe value to be set for immediate alert
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDDevice not Connected
BT_ERROR_NOT_SUPPORTEDNot supported
int bt_proximity_monitor_set_linkloss_alert ( bt_proximity_monitor_h  monitor,
int  value 
)

Set the Proximity Profile monitor linkloss alert value. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]monitorproximity monitor handle
[in]valueThe value to be set for link loss alert
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDDevice not Connected
BT_ERROR_NOT_SUPPORTEDNot supported
int bt_proximity_monitor_unset_connection_state_changed_cb ( bt_proximity_monitor_h  monitor)

Unsets proximity monitor connection state changed event change callback. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]proximitymonitor handle
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTEDDevice not Connected
int bt_proximity_reporter_create ( bt_proximity_reporter_h reporter)

Creates the Proximity Profile Reporter Role. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]None
[out]reporterproximity reporter server handle
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_ALREADY_DONEAlready Enabled
BT_ERROR_OUT_OF_MEMORYout Of Memory
int bt_proximity_reporter_destroy ( bt_proximity_reporter_h  reporter)

Destroys the Proximity Profile Reporter Role. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]reporterproximity reporter server handle
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDNot initialized
int bt_proximity_reporter_get_immediate_alert ( const char *  remote_address,
int *  value 
)

Read the Proximity Profile reporter immediate alert value. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]remote_addressremote device reporter address
[out]valuevalue read for the immediate alert.
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDnot initialized
BT_ERROR_NOT_SUPPORTEDNot supported
int bt_proximity_reporter_get_linkloss_alert ( const char *  remote_address,
int *  value 
)

Read the Proximity Profile reporter linkloss alert value. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]remote_addressremote device reporter address
[out]valuevalue read for the linkloss alert.
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
BT_ERROR_NOT_INITIALIZEDnot initialized
BT_ERROR_NOT_SUPPORTEDNot supported
int bt_proximity_reporter_set_connection_state_changed_cb ( bt_proximity_reporter_h  reporter,
bt_proximity_reporter_connection_state_changed_cb  callback,
void *  user_data 
)

Sets proximity reporter connection state changed event change callback. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]reporterproximity reporter handle
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
int bt_proximity_reporter_set_property_changed_cb ( bt_proximity_reporter_h  reporter,
bt_proximity_reporter_property_changed_cb  callback,
void *  user_data 
)

Sets proximity reporter properties change callback. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]reporterproximity reporter handle
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
int bt_proximity_reporter_unset_connection_state_changed_cb ( bt_proximity_reporter_h  reporter)

Unsets proximity reporter connection state changed event change callback. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]proximityreporter handle
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful
int bt_proximity_reporter_unset_property_changed_cb ( bt_proximity_reporter_h  reporter)

Unsets proximity reporter properties change callback. 4.0 public http://tizen.org/privilege/bluetooth.

Parameters
[in]reporterproximity reporter handle
Returns
0 on success, otherwise a negative error value
Return values
BT_ERROR_NONESuccessful