Symbian^3 Product 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

  • CBluetoothPhysicalLinks
Public Member Functions
~CBluetoothPhysicalLinks()
RBTBaseband &BTBaseband()
IMPORT_C TIntBroadcast(const TDesC8 &)
IMPORT_C voidCancelCreateConnection()
IMPORT_C TIntCreateConnection(const TBTDevAddr &)
IMPORT_C TIntDisconnect(const TBTDevAddr &)
IMPORT_C TIntDisconnectAll()
IMPORT_C TIntDisconnectAllForPowerOff()
IMPORT_C TIntEnumerate(RBTDevAddrArray &, TUint)
voidHandleCreateConnectionCompleteL(TInt)
voidHandleDisconnectAllCompleteL(TInt)
voidHandleDisconnectCompleteL(TInt)
IMPORT_C CBluetoothPhysicalLinks *NewL(MBluetoothPhysicalLinksNotifier &, RSocketServ &)
IMPORT_C CBluetoothPhysicalLinks *NewLC(MBluetoothPhysicalLinksNotifier &, RSocketServ &)
MBluetoothPhysicalLinksNotifier &Notifier()
IMPORT_C TIntReadRaw(TDes8 &)
RSocketServ &SockServer()
Private Member Functions
CBluetoothPhysicalLinks(MBluetoothPhysicalLinksNotifier &, RSocketServ &)
voidConstructL()
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 TIntBroadcast(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 & aDataContains data to be broadcast.

CancelCreateConnection()

IMPORT_C voidCancelCreateConnection()

Cancel bringing in a new member to the piconet

ConstructL()

voidConstructL()[private]

CreateConnection(const TBTDevAddr &)

IMPORT_C TIntCreateConnection(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 & aDevAddrBluetooth address specifying remote device (new member of piconet)

Disconnect(const TBTDevAddr &)

IMPORT_C TIntDisconnect(const TBTDevAddr &aDevAddr)

Disconnect a single member of piconet

capability
NetworkControl

Parameters

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

DisconnectAll()

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

DisconnectAllForPowerOff()

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

Enumerate(RBTDevAddrArray &, TUint)

IMPORT_C TIntEnumerate(RBTDevAddrArray &aBTDevAddrArray,
TUintaMaxNumber
)

Enumerate connected members of the piconet

Parameters

RBTDevAddrArray & aBTDevAddrArrayBluetooth device address array to be filled with bluetooth addresses of connected members of the piconet.
TUint aMaxNumberUpper limit on number of members to be returned.

HandleCreateConnectionCompleteL(TInt)

voidHandleCreateConnectionCompleteL(TIntaErr)

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

Parameters

TInt aErr

HandleDisconnectAllCompleteL(TInt)

voidHandleDisconnectAllCompleteL(TIntaErr)

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

Parameters

TInt aErr

HandleDisconnectCompleteL(TInt)

voidHandleDisconnectCompleteL(TIntaErr)

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 & aNotifierThe object which will receive asynchronous events.
RSocketServ & aServerThe 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 & aNotifierThe object which will receive asynchronous events.
RSocketServ & aServerThe 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 TIntReadRaw(TDes8 &aData)

Receive (raw) broadcast data

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

Parameters

TDes8 & aDataContains 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.