Tizen Native API  5.5
Bluetooth HID

Bluetooth HID(Human Interface Device) API provides functions for connecting to Bluetooth HID such as keyboards and mouse.

Required Header

#include <bluetooth.h>

Overview

In HID Profile, there are two roles - Host and Device. The Host is a device that uses or requests the services of a HID. The Device is a device that provides the service of human data input and output to and from the Host. This API only supports Host role.

Related Features

This API is related with the following features:

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_hid_host_initialize (bt_hid_host_connection_state_changed_cb connection_cb, void *user_data)
 Initializes the Bluetooth HID (Human Interface Device) Host.
int bt_hid_host_deinitialize (void)
 Deinitializes the Bluetooth HID (Human Interface Device) Host.
int bt_hid_host_connect (const char *remote_address)
 Connects the remote device with the HID (Human Interface Device) service, asynchronously.
int bt_hid_host_disconnect (const char *remote_address)
 Disconnects the remote device with the HID (Human Interface Device) service, asynchronously.

Typedefs

typedef void(* bt_hid_host_connection_state_changed_cb )(int result, bool connected, const char *remote_address, void *user_data)
 Called when the connection state is changed.

Typedef Documentation

typedef void(* bt_hid_host_connection_state_changed_cb)(int result, bool connected, const char *remote_address, void *user_data)

Called when the connection state is changed.

This callback is called when the connection state is changed. When you call bt_hid_host_connect() or bt_hid_host_disconnect(), this callback is also called with error result even though these functions fail.

Since :
2.3
Parameters:
[in]resultThe result of changing the connection state
[in]connectedThe state to be changed. true means connected state, Otherwise, false.
[in]remote_addressThe remote address
[in]user_dataThe user data passed from the callback registration function
See also:
bt_hid_host_connect()
bt_hid_host_disconnect()

Function Documentation

int bt_hid_host_connect ( const char *  remote_address)

Connects the remote device with the HID (Human Interface Device) service, asynchronously.

Since :
2.3
Privilege Level:
public
Privilege:
http://tizen.org/privilege/bluetooth
Parameters:
[in]remote_addressThe remote address
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 local device must be bonded with the remote device by bt_device_create_bond().
The Bluetooth HID service must be initialized with bt_hid_host_initialize().
Postcondition:
bt_hid_host_connection_state_changed_cb() will be invoked.
See also:
bt_hid_host_disconnect()
bt_hid_host_connection_state_changed_cb()
int bt_hid_host_deinitialize ( void  )

Deinitializes the Bluetooth HID (Human Interface Device) Host.

Since :
2.3
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 HID service must be initialized with bt_hid_host_initialize().
See also:
bt_hid_host_initialize()
int bt_hid_host_disconnect ( const char *  remote_address)

Disconnects the remote device with the HID (Human Interface Device) service, asynchronously.

Since :
2.3
Privilege Level:
public
Privilege:
http://tizen.org/privilege/bluetooth
Parameters:
[in]remote_addressThe remote address
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 remote device must be connected by bt_hid_host_connect().
Postcondition:
bt_hid_host_connection_state_changed_cb() will be invoked.
See also:
bt_hid_host_connect()
bt_hid_host_connection_state_changed_cb()
int bt_hid_host_initialize ( bt_hid_host_connection_state_changed_cb  connection_cb,
void *  user_data 
)

Initializes the Bluetooth HID (Human Interface Device) Host.

Since :
2.3
Remarks:
This function must be called before Bluetooth HID Host starts.
You must free all resources of the Bluetooth service by calling bt_hid_host_deinitialize()
if Bluetooth HID Host service is no longer needed.
Parameters:
[in]connection_cbThe 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_OPERATION_FAILEDOperation failed
BT_ERROR_NOT_SUPPORTEDNot supported
Precondition:
The Bluetooth service must be initialized with bt_initialize().
See also:
bt_initialize()
bt_hid_host_deinitialize()