The Bluetooth Client Library component (Bluetooth User) provides APIs for configuring and managing Bluetooth® connections.
The Symbian platform Bluetooth subsystem provides developer support for creating Bluetooth aware applications. Bluetooth User is a collection of components and their corresponding DLLs that set up, configure and manage Bluetooth sockets, access the HCI, and configure Bluetooth AV sessions.
The following terms are used:
Provides setup and configuration details such as device type, Bluetooth sockets and link management options.
Sockets provided by CBluetoothSocket instead of RSocket. CBluetoothSocket::Connect() takes a TBTSockAddr, whose constructor TBTSockAddr::TBTSockAddr() takes a TSockAddr.
Provides useful setup, configuration and error handling for Audio / Video applications.
Used by licensees to customise HCI functionality. See RHCIDirectAccess.
Bluetooth Client Library (Bluetooth User) is a collection of helper APIs.
We will briefly look at each of the above components below.
Bluetooth library
Primarily this component provides Bluetooth sockets. There are two kinds of sockets, they are:
ACL (CBluetoothSocket) and
SCO (CBluetoothSynchronousLink) sockets.
Bluetooth library classes
Bluetooth library provides classes to handle:
Audio / Video library
The Bluetooth Audio / Video library provides API classes to configure a system as defined by the AV profile.
Audio / Video library namespaces
The Bluetooth AV library provides the following namespaces:
We will look at common tasks associated with some of the Bluetooth User APIs here.
Task backgrounder
Before setting up a Bluetooth connection you need to think about the kind of connection needed and how best to go about setting up the connection. These topics will get you started.
This is a set of tutorial documents, the contents of which have been split up here according to main functionality grouping.
Socket tasks
The following tutorial guides deal mainly with sockets.
Connecting to Remote Devices
Inquiring About Remote Devices
This tutorial shows you how to create a Bluetooth socket, make an inquiry for a remote device address and establish a connection to the remote device.
Listening for Incoming Bluetooth Connections
This tutorial shows you how to set up a Bluetooth socket to listen for a connect attempt by remote devices.
Notifier tasks
Notifiers are used to manage aspects of a Bluetooth connection.
Connecting to Remote Devices
Connecting and Transferring Data to a Remote Device
This tutorial shows you how to work with a remote device over Bluetooth once the connection is established.
Utility tasks
These tasks show you how to do things like configure a local or remote device, access protocol level data and send HCI commands.
Connecting to Remote Devices
Inquiring About Services on a Remote Device
This tutorial shows you how to inspect remote devices for suitability before connecting to them.
Processing an Extended Inquiry Response
This tutorial shows you how to retrieve and process the data from a Bluetooth Extended Inquiry Response (EIR).
Using Security on Outgoing Sockets
This tutorial shows you how to configure the Bluetooth sockets for authentication or encryption based security.
Handling the Local Device Name
This code shows you how to set and get the local device name.
Performing Low-level Configuration
This tutorial introduces you to HCI, L2CAP and RFCOMM commands and options and shows you how to read the Class of device attribute on an L2CAP socket.
This tutorial shows you how to issue vendor specific HCI commands via the stack.
This tutorial shows you how to drop a remote device from a connection while leaving the socket up.
Audio / Video tasks
Currently there are no tutorials for the Audio / Video profiles.