Bluetooth

---

Bluetooth Service provides API to manage Bluetooth device.

Required Header

#include <bluetooth.h>

Overview

Bluetooth Service consists of Bluetooth Adapter, Bluetooth Device and Bluetooth Socket.

In order to use the above APIs, you must call bt_initialize() in advance. In addition, bt_deinitialize() should be called when Bluetooth Service is no longer needed. Please refer Bluetooth Tutorial if you want to get more detailed usages and information of this api.

Note on callbacks: All callbacks in this module are called in the main loop context.

Related Features

This API is related with the following features:

• http://tizen.org/feature/network.bluetooth
  

It is recommended to design feature related codes in your application for reliability.

You can check if a device supports the related features for this API by using System Information,thereby controlling the procedure of your application.

To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.

More details on featuring your application can be found from Feature Element.

Functions
int	bt_initialize (void)
	Initializes the Bluetooth API.
int	bt_deinitialize (void)
	Releases all resources of the Bluetooth API.
int	bt_get_uuid_name (const char *uuid, char **name)
	Gets the specification name for the given UUID.

---

Enumeration Type Documentation

enum bt_error_e

Enumerations of Bluetooth error codes.

Since :

2.3

Enumerator:

BT_ERROR_NONE	Successful
BT_ERROR_CANCELLED	Operation cancelled
BT_ERROR_INVALID_PARAMETER	Invalid parameter
BT_ERROR_OUT_OF_MEMORY	Out of memory
BT_ERROR_RESOURCE_BUSY	Device or resource busy
BT_ERROR_TIMED_OUT	Timeout error
BT_ERROR_NOW_IN_PROGRESS	Operation now in progress
BT_ERROR_NOT_SUPPORTED	BT is Not Supported
BT_ERROR_PERMISSION_DENIED	Permission denied
BT_ERROR_QUOTA_EXCEEDED	Quota exceeded
BT_ERROR_NO_DATA	No data available
BT_ERROR_DEVICE_POLICY_RESTRICTION	Device policy restriction (Since 3.0)
BT_ERROR_NOT_INITIALIZED	Local adapter not initialized
BT_ERROR_NOT_ENABLED	Local adapter not enabled
BT_ERROR_ALREADY_DONE	Operation already done
BT_ERROR_OPERATION_FAILED	Operation failed
BT_ERROR_NOT_IN_PROGRESS	Operation not in progress
BT_ERROR_REMOTE_DEVICE_NOT_BONDED	Remote device not bonded
BT_ERROR_AUTH_REJECTED	Authentication rejected
BT_ERROR_AUTH_FAILED	Authentication failed
BT_ERROR_REMOTE_DEVICE_NOT_FOUND	Remote device not found
BT_ERROR_SERVICE_SEARCH_FAILED	Service search failed
BT_ERROR_REMOTE_DEVICE_NOT_CONNECTED	Remote device is not connected
BT_ERROR_AGAIN	Resource temporarily unavailable
BT_ERROR_SERVICE_NOT_FOUND	Service Not Found
BT_ERROR_AUTHORIZATION_REJECTED	Authorization rejected (Since 5.0)

---

Function Documentation

int bt_deinitialize

(

void

)

Releases all resources of the Bluetooth API.

Since :

2.3

Remarks:

This function must be called if Bluetooth API is no longer needed.

Returns:

0 on success, otherwise a negative error value.

Return values:

BT_ERROR_NONE	Successful
BT_ERROR_NOT_INITIALIZED	Not initialized
BT_ERROR_OPERATION_FAILED	Operation failed
BT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

Bluetooth API must be initialized with bt_initialize().

See also:

bt_initialize()

int bt_get_uuid_name	(	const char *	uuid,
		char **	name
	)

Gets the specification name for the given UUID.

Since :

3.0

Remarks:

The name must be released using free().

Parameters:

[in]	uuid	The UUID
[out]	name	The specification name defined at www.bluetooth.com

Returns:

0 on success, otherwise a negative error value.

Return values:

BT_ERROR_NONE	Successful
BT_ERROR_INVALID_PARAMETER	Invalid parameter
BT_ERROR_NOT_SUPPORTED	Not supported

See also:

bt_gatt_get_uuid()

int bt_initialize

(

void

)

Initializes the Bluetooth API.

Since :

2.3

Remarks:

This function must be called before Bluetooth API starts.
You must free all resources of the Bluetooth service by calling bt_deinitialize() if Bluetooth service is no longer needed.

Returns:

0 on success, otherwise a negative error value.

Return values:

BT_ERROR_NONE	Successful
BT_ERROR_OPERATION_FAILED	Operation failed
BT_ERROR_NOT_SUPPORTED	Not supported

See also:

bt_deinitialize()