Bluetooth

The Bluetooth library allows your app to connect wirelessly to other Bluetooth devices and exchange data. This guide is intended to help you write applications that use the Bluetooth library.

Bluetooth service

The Bluetooth library supports Bluetooth 4.0 and provides APIs to access various aspects of the Bluetooth capabilities on your device.

<btapi/btdevice.h> General Bluetooth APIs to search for and connect with a remote device, and to access information on the local or remote device.
<btapi/btgatt.h> APIs that allow you to communicate with a Generic Attribute Profile (GATT) server. A base profile for other low-energy profiles, GATT defines how attributes are grouped into meaningful services. You can use these functions with Bluetooth capabilities on both low-energy and classic devices.
<btapi/btgattsrv.h> APIs that provide GATT server functions. You can use these functions with Bluetooth capabilities on both low-energy and classic devices.
<btapi/bthid.h> APIs to implement the Bluetooth Human Interface Device (HID) Profile in the device role. You can use these APIs to remote control HID hosts such as a PC.
<btapi/btle.h> APIs that allow you to access the Bluetooth low energy capabilities.
<btapi/btopp.h> APIs for the Bluetooth Object Push Profile (OPP). OPP enables file transfer between Bluetooth devices. These APIs allow you to send one or more files to a paired Bluetooth enabled device that supports OPP.
<btapi/btspp.h> APIs that allow you to work with the Bluetooth Serial Port Profile (SPP), which defines how to set up virtual serial ports and use them to connect Bluetooth devices.

Each Bluetooth library module has its own independent initialization and cleanup functions, for example, bt_device_init() and bt_device_deinit() in btdevice.h and bt_gatt_srv_init() and bt_gatt_srv_deinit() in btgattsrv.h. If an application needs to call any of the API functions in a module, it must first call the initialization function in that module; it must call the cleanup function when it finishes using that module.

Last modified: 2013-12-21

comments powered by Disqus