Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

Communications: Bluetooth
Functional Description

Bluetooth is a wireless communications protocol which allows short range communication of typically 10 to 100 meters, between Bluetooth-equipped devices. The protocol supports authentication, service discovery and various forms of data transfer. Typically this is used for file transfer, wireless headsets (audio), synchronization, dial-up networking, printing and other capabilities. The services provided by the Bluetooth device are generally referred to as Profiles. Qt Extended Bluetooth support can be enabled for any device with a Linux BlueZ compatible Bluetooth host adapter.

Features

• Bluetooth service framework
• Bluetooth Sockets API
• Dependencies
• Device Configuration
• Dial-up Networking (DUN) (v1.1)
• End-user device configuration
• File Transfer Profile (FTP) (v1.1)
• GAP
• Hands-Free Profile (HFP) (v1.5)
• Headset Profile (HSP) (v1.1)
• Integration with FIC Freerunner phone
• OPP (v1.1)
• SDAP
• Sending and Receiving over Bluetooth

Bluetooth service framework

A generic management framework for Bluetooth services allows Bluetooth services to be registered and handled under a common set of practices. For example, a service registered under this framework will automatically be able to be controlled through the BTSettings GUI application. Third-party developers will also be able to make use of this framework to integrate their own Bluetooth services into the system environment.

Bluetooth Sockets API

Qt Extended supports RFCOMM, L2CAP and SCO sockets. RFCOMM sockets are STREAM based sockets, similar to TCP sockets. SCO and L2CAP sockets
are SEQPACKET type sockets. In general, they act similarly to TCP sockets, however the SEQPACKET type sockets preserve record boundaries.
Finally, DGRAM type L2CAP sockets are also supported. These sockets are similar to UDP sockets.

Dependencies

Bluetooth uses uses services provided by Contacts for:

• Sending a business card over Bluetooth
• Adding a received business card to the addressbook.

Device Configuration

The following device configuration options are available:

1. switch the Bluetooth adapter on or off for example, the device may need to be turned off to reduce power consumption.
2. control visibility - visibility is controlled by two variables:
   • page scan - controls whether remote devices can connect to the local device.
   • inquiry scan - controls whether remote devices can discover local device. Allowing the user to set the 'discoverable' state by setting the inquiry scan variable.
3. local device name - set to allow the user to identify the device quickly at a later time.

Other attributes can also be viewed by the user, such as the device manufacturer and the Bluetooth protocol version the device supports and the user can scan for services(profiles) supported by the device.

Dial-up Networking (DUN) (v1.1)

Dial-up Networking allows the user to connect to the Internet via third party Bluetooth devices (client profile) and Qt Extended devices themselves can provide dial-up connections to third party Bluetooth devices (server profile). Essentially requests from the client are forwarded directly to the hardware modem. Thus no PPP server is running on the server side.

End-user device configuration

Qt Extended has a built-in Bluetooth Settings application that allows users to perform basic Bluetooth configuration operations, such as:

• Setting the Bluetooth power state and discoverable mode
• Creating and removing pairings with other Bluetooth devices
• Configuring locally available Bluetooth services
• Connecting to Bluetooth headsets and handsfree devices
• Changing the name of the Bluetooth device

File Transfer Profile (FTP) (v1.1)

Qt Extended supports the Bluetooth FTP profile in both Client and Server modes. The FTP profile provides a file and directory browsing capabilities, similar to the TCP/IP File Transfer Protocol. Qt Extended's Bluetooth FTP implementation relies on the Qt Extended Document System for preserving document attributes such as mimetype and description.

GAP

Qt Extended fully supports the Bluetooth Generic Access Profile (GAP) which handles discovery and establishment of connections between Bluetooth devices and defines how secure connections can be established between two devices by a mechanism referred to as 'pairing'. It also defines the basic user-interface paradigm that must be used by all Bluetooth devices.

The Qt Extended Bluetooth API allows its clients to discover remote devices and various relevant attributes, such as device name, device manufacturer, Bluetooth protocol version supported, etc. It also supports the establishment of trust relationships by pairing remote devices.

Hands-Free Profile (HFP) (v1.5)

The Hands Free Profile is an expanded set of functionality compared to the headset profile. Qt Extended supports the Hands-free profile functionality in the Modem Emulator module. All control mechanisms available for HSP profile are also available for HFP profile.

Headset Profile (HSP) (v1.1)

Headset profile is supported using the Headset Bluetooth service and integrated into the Bluetooth service framework. The user is able to control the volume of the speaker and microphone of the Bluetooth headset. The user is also able to connect, disconnect, pair and unpair the Bluetooth headset device. The implementation of the headset profile assumes that the audio is routed over PCM (e.g. hardware assisted). Audio routing over HCI (in software) is not currently supported.

Integration with FIC Freerunner phone

Qt Extended provides an example device profile for the FIC GTA01 (aka Neo 1973, aka OpenMoko) and FIC GTA02 (aka Freerunner) phones.

OPP (v1.1)

Object Push Profile supports both client and server modes for applications that use the object push model of interaction.
The client mode is used to initiate an object push request to a remote device.

SDAP

SDAP describes how an application uses the Service Discovery Protocol (SDP) to discover services on a remote device. Using the Qt Extended Bluetooth API, clients can enable any application to discover services running on a remote device.

Two discovery modes are supported:
1. searching - to search for a specific service
2. browsing - to search for any services accessible from the public browse group.

Sending and Receiving over Bluetooth

The user can send and receive files over Bluetooth. If a file is received, the user can monitor the progress of the file transfer, and choose to accept or discard the file received. If a business card is received, the user has the option of saving it in the addressbook or discarding.