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

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

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

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

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

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE task

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

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

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

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

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

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

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

    18 </step>

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

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

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

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

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

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

    25 </step>

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

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

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

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

    30 </step>

    31 </steps>

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

    33 server.Connect ();

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

    35 RComm commPort;

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

    37 </taskbody><related-links>

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

    39 </link>

    40 </related-links></task>