<?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>