<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE task

  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

<task id="GUID-397239F9-7EE8-52CF-9B37-328AE307BAA0" xml:lang="en"><title>How

to Open a Port with the IrDA Protocol Module: Tutorial</title><shortdesc>This tutorial shows how to load the Infrared Serial Protocol Module

and open a serial port. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<steps id="GUID-14CACE10-E139-5015-9382-AD0908E871C5">

<step id="GUID-BAEFC4D9-74C3-585D-9E88-95A6EB247FE1"><cmd>Call <xref href="GUID-6B3CA99B-ABF2-32EA-935D-23AE5AE2C306.dita#GUID-6B3CA99B-ABF2-32EA-935D-23AE5AE2C306/GUID-A202EC6D-2B5A-3BEA-BD29-E9E81FFC8803"><apiname>RCommServ::Connect()</apiname></xref> to

create a session with the Serial communications Server. </cmd>

</step>

<step id="GUID-E70B4B44-E823-5314-B4BB-3A82ED2321B4"><cmd/>

<info>Call <xref href="GUID-6B3CA99B-ABF2-32EA-935D-23AE5AE2C306.dita#GUID-6B3CA99B-ABF2-32EA-935D-23AE5AE2C306/GUID-F851835B-4585-3C3A-B257-ADAE04CD95AA"><apiname>RCommServ::LoadCommModule()</apiname></xref> with the <codeph>aFileName</codeph> parameter

set to <codeph>ircomm</codeph>. </info>

<info> <filepath>ircomm.csy</filepath> is the name of the DLL file for the

Serial Protocol Module. The extension <filepath>.csy</filepath> is optional

for the <codeph>LoadCommModule()</codeph> API. </info>

</step>

<step id="GUID-B2A9CD4A-7691-5318-A0BA-E3BDEA100BA3"><cmd/>

<info>Call <xref href="GUID-3B4E8ED5-72F7-3E51-B188-3C1045526DDF.dita#GUID-3B4E8ED5-72F7-3E51-B188-3C1045526DDF/GUID-F2CBC6B8-0BE8-3361-8BDA-774BFB245BE6"><apiname>RComm::Open()</apiname></xref> with the <codeph>aName</codeph> parameter

set to <codeph>IrComm::0</codeph>. <p>It is not recommended to change the

default settings for the Infrared serial ports.</p></info>

</step>

</steps>

<example><title>Example</title> <codeblock id="GUID-056287A1-CE68-5868-A939-FDAA1DDAEEC7" xml:space="preserve">RCommServ server; 

server.Connect ();

server.LoadCommModule (_L ("IRCOMM"));

RComm commPort;

commPort.Open (server, _L ("IrCOMM::0"), ECommExclusive); </codeblock> </example>

</taskbody><related-links>

<link href="GUID-D8E59924-4E17-56AE-8F6B-07749A2FF0B8.dita"><linktext>IrDA Serial</linktext>

</link>

</related-links></task>