Revision as of 02:26, 31 May 2013 by hamishwillee (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

BTCOMM serial communication.

From Nokia Developer Wiki
Jump to: navigation, search
Article Metadata
Created: judith14 (27 Jul 2007)
Last edited: hamishwillee (31 May 2013)

Bluetooth CSY is provided primarily to support serial communication (RS232) over Bluetooth. BTComm is itself provided by a serial communications module in the form of a CSY file.

BTComm provides the framework to produce an RS232 emulation plug-in communicating over a Bluetooth RFComm connection.

The following Serial Communication C32 classes are used in making an RS232 BTComm connection:

  • RCommServ - A session on the Serial Comms server.
  • RComm - A subsession on the Serial Comms server.
  • RCommServ::Connect() - Creates a session on the comms server.
  • RCommServ::LoadCommModule() - The desired serial communication protocol Module(CSY Module) is loaded using this function.
  • RComm::Open() - Open a port on the serial server.
  • RComm::Close() - Closes the port.
  • RComm::Read(), RComm::ReadOneOrMore() - Reading data over the port.
  • RComm::Write() - Writing data over the port.

How to use the above APIs for BTCOMM

First you need to create some objects.

// Opening a simple BTCOMM connection.
// Create an RCommServ object.
RCommServ server;
// Create an RComm object.
RComm commport;
// Required LITs

Connect to the serial comms server:


Load the Bluetooth BTComm CSY module using RCommServ::LoadCommModule().


Prepare the port name for the connection.

TBuf8<15> commname(KTxtBTCommName); commname.AppendNum(0); The TDes8::AppendNum() function above appends the decimal character '0', representing the port for this example, onto the end of the 'commname' descriptor. The RCommServ::GetPortInfo() function is used to discover the port number if it is not known.

Open and configure the BTComm serial port.

//Configuring Port is done by using the code
TCommConfig cBuf;
TCommConfigV01 &c=cBuf();
// Get the current configuration
// Set new settings
c.iFifo = EFifoEnable;
c.iRate = EBps19200;
c.iHandshake = KConfigObeyCTS;
c.iTerminatorCount = 0;
c.iDataBits = EData8;
c.iParity = EParityNone;
c.iStopBits = EStop1;
// Write the settings out

After Succesfull opening of a port can allow to do data transfer. RComm allows you to read and write data over the port. There are several kinds of read and write methods available.


RComm::Read() reads data from the serial port.

Writing RComm::Write() writes data to the serial port.

iComm.Read(iStatus, iBuffer);
//iComm is the instance of RComm opened earlier.


You can cancel a pending Read() or Write() using ReadCancel() or WriteCancel().

iComm.ReadCancel(); The TRequestStatus of the pending Read(), or Write() will be set to KErrCancel.

Close the serial port is done using RComm::Close():

//Closes the serial port.
This page was last modified on 31 May 2013, at 02:26.
35 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.


Thank you!

We appreciate your feedback.