Symbian^3 Application Developer Library >

CBluetoothPhysicalLinks Class Reference

class CBluetoothPhysicalLinks : public CBase

This is used to enumerate members of piconet, and attach and remove members thereof

It may also be used for non-service dependent reads and writes.

Inherits from

Public Member Functions
~CBluetoothPhysicalLinks ()
RBTBaseband & BTBaseband ()
IMPORT_C TInt Broadcast (const TDesC8 &)
IMPORT_C void CancelCreateConnection ()
IMPORT_C TInt CreateConnection (const TBTDevAddr &)
IMPORT_C TInt Disconnect (const TBTDevAddr &)
IMPORT_C TInt DisconnectAll ()
IMPORT_C TInt DisconnectAllForPowerOff ()
IMPORT_C TInt Enumerate ( RBTDevAddrArray &, TUint )
void HandleCreateConnectionCompleteL ( TInt )
void HandleDisconnectAllCompleteL ( TInt )
void HandleDisconnectCompleteL ( TInt )
IMPORT_C CBluetoothPhysicalLinks * NewL ( MBluetoothPhysicalLinksNotifier &, RSocketServ &)
IMPORT_C CBluetoothPhysicalLinks * NewLC ( MBluetoothPhysicalLinksNotifier &, RSocketServ &)
MBluetoothPhysicalLinksNotifier & Notifier ()
IMPORT_C TInt ReadRaw ( TDes8 &)
RSocketServ & SockServer ()
Private Member Functions
CBluetoothPhysicalLinks ( MBluetoothPhysicalLinksNotifier &, RSocketServ &)
void ConstructL ()
Inherited Functions
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
Private Attributes
RBTBaseband iBTBaseband
CBTBasebandConnecter * iBTBasebandConnecter
CBTDisconnector * iBTDisconnector
MBluetoothPhysicalLinksNotifier & iNotifier
RSocketServ & iSockServer

Constructor & Destructor Documentation

CBluetoothPhysicalLinks(MBluetoothPhysicalLinksNotifier &, RSocketServ &)

CBluetoothPhysicalLinks ( MBluetoothPhysicalLinksNotifier & aNotifier,
RSocketServ & aServer
) [private]

Parameters

MBluetoothPhysicalLinksNotifier & aNotifier
RSocketServ & aServer

~CBluetoothPhysicalLinks()

IMPORT_C ~CBluetoothPhysicalLinks ( )

Destructor

Member Functions Documentation

BTBaseband()

RBTBaseband & BTBaseband ( )

This method is for internal sub-system use only and should be not be used otherwise.

Broadcast(const TDesC8 &)

IMPORT_C TInt Broadcast ( const TDesC8 & aData )

Write (raw) broadcast data

Raw broadcast data is data that is not directed to any specified service. Test
capability
NetworkControl

Parameters

const TDesC8 & aData Contains data to be broadcast.

CancelCreateConnection()

IMPORT_C void CancelCreateConnection ( )

Cancel bringing in a new member to the piconet

ConstructL()

void ConstructL ( ) [private]

CreateConnection(const TBTDevAddr &)

IMPORT_C TInt CreateConnection ( const TBTDevAddr & aDevAddr )

Bring in a new member to the piconet

This can be useful for preparing for a logical link (service socket). Firstly if the local device has not bonded with the specified remote device, then this function can be used to allow the bonding procedure can take place in advance. Secondly if a CBluetoothSocket call is made to create a logical link within an internally specified time of this CreateConnection function being called, then that link will come up much faster since the physical link will already be in place. Unless this connection is taken up by a logical link (or a synchronous link) within that internally specified time then it will be closed.

This function can also be used to create a physical link ready for the setting up of a synchronous link (e.g. voice link).

Parameters

const TBTDevAddr & aDevAddr Bluetooth address specifying remote device (new member of piconet)

Disconnect(const TBTDevAddr &)

IMPORT_C TInt Disconnect ( const TBTDevAddr & aDevAddr )

Disconnect a single member of piconet

capability
NetworkControl

Parameters

const TBTDevAddr & aDevAddr Bluetooth address specifying remote device (member of piconet)

DisconnectAll()

IMPORT_C TInt DisconnectAll ( )
Disconnect all members of piconet with the reason code "Remote User Terminated Connection"
capability
NetworkControl

DisconnectAllForPowerOff()

IMPORT_C TInt DisconnectAllForPowerOff ( )
Disconnect all members of piconet with the reason code "Remote Device Terminated Connection due to Power Off"
capability
NetworkControl

Enumerate(RBTDevAddrArray &, TUint)

IMPORT_C TInt Enumerate ( RBTDevAddrArray & aBTDevAddrArray,
TUint aMaxNumber
)

Enumerate connected members of the piconet

Parameters

RBTDevAddrArray & aBTDevAddrArray Bluetooth device address array to be filled with bluetooth addresses of connected members of the piconet.
TUint aMaxNumber Upper limit on number of members to be returned.

HandleCreateConnectionCompleteL(TInt)

void HandleCreateConnectionCompleteL ( TInt aErr )

This method is for internal sub-system use only and should be not be used otherwise.

Parameters

TInt aErr

HandleDisconnectAllCompleteL(TInt)

void HandleDisconnectAllCompleteL ( TInt aErr )

This method is for internal sub-system use only and should be not be used otherwise.

Parameters

TInt aErr

HandleDisconnectCompleteL(TInt)

void HandleDisconnectCompleteL ( TInt aErr )

This method is for internal sub-system use only and should be not be used otherwise.

Parameters

TInt aErr

NewL(MBluetoothPhysicalLinksNotifier &, RSocketServ &)

IMPORT_C CBluetoothPhysicalLinks * NewL ( MBluetoothPhysicalLinksNotifier & aNotifier,
RSocketServ & aServer
) [static]

Constructor

Opens a Bluetooth socket.
Pre-condition
A session on the socket server has been started.
leave
No memory, or error on opening socket

Parameters

MBluetoothPhysicalLinksNotifier & aNotifier The object which will receive asynchronous events.
RSocketServ & aServer The socket server.

NewLC(MBluetoothPhysicalLinksNotifier &, RSocketServ &)

IMPORT_C CBluetoothPhysicalLinks * NewLC ( MBluetoothPhysicalLinksNotifier & aNotifier,
RSocketServ & aServer
) [static]

Constructor

Opens a Bluetooth socket.
Pre-condition
A session on the socket server has been started.
leave
No memory, or error on opening socket

Parameters

MBluetoothPhysicalLinksNotifier & aNotifier The object which will receive asynchronous events.
RSocketServ & aServer The socket server.

Notifier()

MBluetoothPhysicalLinksNotifier & Notifier ( )

This method is for internal sub-system use only and should be not be used otherwise.

ReadRaw(TDes8 &)

IMPORT_C TInt ReadRaw ( TDes8 & aData )

Receive (raw) broadcast data

Raw broadcast data is data that is not directed to any specified service. Test
capability
NetworkControl

Parameters

TDes8 & aData Contains data received.

SockServer()

RSocketServ & SockServer ( )

This method is for internal sub-system use only and should be not be used otherwise.

Member Data Documentation

RBTBaseband iBTBaseband

RBTBaseband iBTBaseband [private]

CBTBasebandConnecter * iBTBasebandConnecter

CBTBasebandConnecter * iBTBasebandConnecter [private]

CBTDisconnector * iBTDisconnector

CBTDisconnector * iBTDisconnector [private]

MBluetoothPhysicalLinksNotifier & iNotifier

MBluetoothPhysicalLinksNotifier & iNotifier [private]

RSocketServ & iSockServer

RSocketServ & iSockServer [private]

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.