bluetooth/btexample/example/btsocket/group/mainpage.dox
changeset 0 29b1cd4cb562
equal deleted inserted replaced
-1:000000000000 0:29b1cd4cb562
       
     1 /**
       
     2 \mainpage
       
     3 
       
     4 \section Overview
       
     5 
       
     6 This example demonstrates using CBluetoothSocket and SDP APIs.
       
     7 It demonstrates a number of "Smart connector" helper classes that interact with these components.
       
     8 
       
     9 \section Smart-connector
       
    10 
       
    11 The classes CBtClient and CBtService implement the client side and service side 
       
    12 connection establishment of a bluetooth application respectively.
       
    13 
       
    14 CBtService demonstrates how to register an application in the SDP database using RSdpDatabase,
       
    15 and how to listen for and accept incoming connections using CBluetoothSocket.
       
    16 
       
    17 CBtClient demonstrates how to discover bluetooth devices using RNotifier,
       
    18 search for a service by UUID using CSdpAgent, 
       
    19 retrieve the protocol and port needed to connect to it 
       
    20 and create an appropriate CBluetoothSocket.
       
    21 
       
    22 These classes could be reused for a simple bluetooth application such as a game, 
       
    23 but to implement a complete bluetooth profile, further functionality is needed.
       
    24 Official profiles tend to have configuration parameters in the SDP record, 
       
    25 so these would need to be retrieved as well as the port to connect to.  
       
    26 The data being transferred is generally much more complex than in this simple example.
       
    27 
       
    28 \section Supported-Platforms
       
    29 
       
    30 The current version supports the following platforms, other platforms are either
       
    31 incompletely ported, or untested.
       
    32 
       
    33 Symbian OS 8.1a + Techview (tested on emulator)
       
    34 
       
    35 Symbian OS 8.0a + Series 60 v2.6 (tested on emulator and Nokia 6630)
       
    36 
       
    37 */