![Symbian Developer Library](../../../../../../../a_stock/images/mainheading.gif)
![]() |
![]() |
|
Bluetooth User provides APIs for configuring and managing Bluetooth® connections.
The Symbian OS Bluetooth subsystem provides developer support for creating Bluetooth aware applications. Bluetooth User is a collection of components and their corresponding DLLs that setup, 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 User is a grouping of several components that provide various setup, configuration and error handling functionality for a Bluetooth connection.
Bluetooth User is a collection of helper APIs.
Bluetooth library
Audio / Video library
HCI commands
We will briefly look at each of the above components below.
Primarily this component provides Bluetooth sockets. There are two kinds of sockets, they are:
ACL (CBluetoothSocket
) and
SCO (CBluetoothSynchronousLink
) sockets.
DLL |
|
---|---|
Library |
|
Profile | |
Protocol |
Bluetooth library provides classes to handle:
Bluetooth Sockets
Notifiers
Utility classes
RBluetoothPowerSwitch
RHCIDirectAccess
The Bluetooth Audio / Video library provides API classes to configure a system as defined by the AV profile.
DLL |
|
---|---|
Library |
|
Profile | |
Protocol |
The Bluetooth AV library provides the following namespaces:
SymbianAvctp
We will look at common tasks associated with some of the Bluetooth User APIs here.
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.
Discusses some of the issues about selecting a remote device that should be considered before writing any code.
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.
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.
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.
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.
Currently there are no tutorials for the Audio / Video profiles.