<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US"> <head> <title>kpilot/lib: DeviceCommThread Class Reference (kpilot/lib)</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org" r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org" r (n 0 s 0 v 0 l 0))' /> <meta name="trademark" content="KDE e.V." /> <meta name="description" content="K Desktop Environment Homepage, KDE.org" /> <meta name="MSSmartTagsPreventParsing" content="true" /> <meta name="robots" content="all" /> <link rel="shortcut icon" href="../../../favicon.ico" /> <link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" /> <style type="text/css"> <!-- hr { display: none; } #content h2 { margin-left: 0px; } table.mdTable { background-color: #f8f8f8; border: .2em solid #d7d7d7; } td.mdRow { padding: 8px 20px; } td.md { font-weight: bold; } td.mdname1 { font-weight: bold; color: #602020; } td.mdname { font-weight: bold; color: #602020; } --> </style> </head> <body> <div id="nav_header_top" align="right"> <a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a> <a href="../../.."><img id="nav_header_logo" alt="Home" align="left" src="../../../kde_gear_64.png" border="0" /></a> <span class="doNotDisplay">::</span> <img id="nav_header_logo_right" alt="" align="right" src="../../../pimlogo.png" border="0" /> <div id="nav_header_title" align="left">KDE PIM API Reference</div> </div> <div id="nav_header_bottom" align="right"> <span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span> <div id="nav_header_bottom_left" style="text-align: left;"> / <a href="../../../">API Reference</a> / <a href="../../html/index.html">kpilot</a> / <a href=".">lib</a> </div> </div> <table id="main" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr> <td valign="top" class="menuheader" height="0"></td> <td id="contentcolumn" valign="top" rowspan="2" > <div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;"> <h2><a name="content"></a>kpilot/lib</h2> <!-- Generated by Doxygen 1.5.5 --> <div class="contents"> <h1>DeviceCommThread Class Reference</h1><!-- doxytag: class="DeviceCommThread" --><!-- doxytag: inherits="QObject,QThread" --><code>#include <<a class="el" href="kpilotdevicelinkPrivate_8h-source.html">kpilotdevicelinkPrivate.h</a>></code> <p> Inherits QObject, and QThread. <p> <p> <a href="classDeviceCommThread-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2> Class that handles all device communications. <p> We do this in a different thread so that we do not block the main Qt Event thread (similar to Swing's AWT event dispatch thread). <p>Definition at line <a class="el" href="kpilotdevicelinkPrivate_8h-source.html#l00214">214</a> of file <a class="el" href="kpilotdevicelinkPrivate_8h-source.html">kpilotdevicelinkPrivate.h</a>.</p> <table border="0" cellpadding="0" cellspacing="0"> <tr><td></td></tr> <tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="4bcc77186a63a59adea7a5d009c49277"></a><!-- doxytag: member="DeviceCommThread::DeviceCommThread" ref="4bcc77186a63a59adea7a5d009c49277" args="(KPilotDeviceLink *d)" --> </td><td class="memItemRight" valign="bottom"><b>DeviceCommThread</b> (<a class="el" href="classKPilotDeviceLink.html">KPilotDeviceLink</a> *d)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="890d4a8982c7f22ab780c4fd30ed098d"></a><!-- doxytag: member="DeviceCommThread::run" ref="890d4a8982c7f22ab780c4fd30ed098d" args="()" --> virtual void </td><td class="memItemRight" valign="bottom"><b>run</b> ()</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="46b6eb848b8945c16df814f4ea13ca1d"></a><!-- doxytag: member="DeviceCommThread::setDone" ref="46b6eb848b8945c16df814f4ea13ca1d" args="(bool b)" --> void </td><td class="memItemRight" valign="bottom"><b>setDone</b> (bool b)</td></tr> <tr><td colspan="2"><br><h2>Protected Slots</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDeviceCommThread.html#6ae9e24a146c1f51c691f685b3ecb108">openDevice</a> ()</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDeviceCommThread.html#edd1966c42f5a936ac610ad742491f63">acceptDevice</a> ()</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDeviceCommThread.html#1c11ffbf720e699496f7284684932c5b">workaroundUSB</a> ()</td></tr> <tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="f7ce6f4b50cfcaf53685fbe375918be6"></a><!-- doxytag: member="DeviceCommThread::close" ref="f7ce6f4b50cfcaf53685fbe375918be6" args="()" --> void </td><td class="memItemRight" valign="bottom"><b>close</b> ()</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="17da6c497d9c3c357309043448c1bf56"></a><!-- doxytag: member="DeviceCommThread::reset" ref="17da6c497d9c3c357309043448c1bf56" args="()" --> void </td><td class="memItemRight" valign="bottom"><b>reset</b> ()</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classDeviceCommThread.html#a1ae57caa1b8bc175275e5c6f9318539">open</a> (const QString &device=QString::null)</td></tr> <tr><td colspan="2"><br><h2>Friends</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="c7d26fbdcef9a0472348a27a2292040c"></a><!-- doxytag: member="DeviceCommThread::KPilotDeviceLink" ref="c7d26fbdcef9a0472348a27a2292040c" args="" --> class </td><td class="memItemRight" valign="bottom"><a class="el" href="classDeviceCommThread.html#c7d26fbdcef9a0472348a27a2292040c">KPilotDeviceLink</a></td></tr> </table> <hr><h2>Member Function Documentation</h2> <a class="anchor" name="a1ae57caa1b8bc175275e5c6f9318539"></a><!-- doxytag: member="DeviceCommThread::open" ref="a1ae57caa1b8bc175275e5c6f9318539" args="(const QString &device=QString::null)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">bool DeviceCommThread::open </td> <td>(</td> <td class="paramtype">const QString & </td> <td class="paramname"> <em>device</em> = <code>QString::null</code> </td> <td> ) </td> <td width="100%"><code> [protected]</code></td> </tr> </table> </div> <div class="memdoc"> <p> Does the low-level opening of the device and handles the pilot-link library initialisation. <p> <p> We _always_ want to set a maximum amount of time that we will wait for the sync process to start. In the case where our user has told us that he has a funky USB device, set the workaround timeout for shorter than normal. <p>Definition at line <a class="el" href="kpilotdevicelink_8cc-source.html#l00222">222</a> of file <a class="el" href="kpilotdevicelink_8cc-source.html">kpilotdevicelink.cc</a>.</p> </div> </div><p> <a class="anchor" name="6ae9e24a146c1f51c691f685b3ecb108"></a><!-- doxytag: member="DeviceCommThread::openDevice" ref="6ae9e24a146c1f51c691f685b3ecb108" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void DeviceCommThread::openDevice </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"><code> [protected, slot]</code></td> </tr> </table> </div> <div class="memdoc"> <p> Attempt to open the device. <p> This is an asyncronous process.<p> Called regularly to check if the device exists (to handle USB-style devices).<p> We try to create a socket with the Palm and then bind to it (in <a class="el" href="classDeviceCommThread.html#a1ae57caa1b8bc175275e5c6f9318539" title="Does the low-level opening of the device and handles the pilot-link library initialisation...">open()</a>). If we're able to do those 2 things, then we do 2 things: we set a timeout timer (which will tell us that X amount of time has transpired before we get into the meat of the sync transaction), and we also set up a QSocketNotifier, which will tell us when data is available to be read from the Palm socket. If we were unable to create a socket and/or bind to the Palm in this method, we'll start our timer again. <p>Definition at line <a class="el" href="kpilotdevicelink_8cc-source.html#l00170">170</a> of file <a class="el" href="kpilotdevicelink_8cc-source.html">kpilotdevicelink.cc</a>.</p> </div> </div><p> <a class="anchor" name="edd1966c42f5a936ac610ad742491f63"></a><!-- doxytag: member="DeviceCommThread::acceptDevice" ref="edd1966c42f5a936ac610ad742491f63" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void DeviceCommThread::acceptDevice </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"><code> [protected, slot]</code></td> </tr> </table> </div> <div class="memdoc"> <p> Called when the device is opened *and* activity occurs on the device. <p> We've been notified by our QSocketNotifier that we have data available on the socket.<p> This indicates the beginning of a hotsync.<p> Try to go through the remaining steps of the connnection process. Note: If we return at all from this before the very end without a successful connection, we need to make sure we restart our connection open timer, otherwise it won't be restarted. <p> Our socket notifier should be the only reason that we end up here. If we're here without him being active, we have a problem. Try to clean up and get out. <p>Definition at line <a class="el" href="kpilotdevicelink_8cc-source.html#l00339">339</a> of file <a class="el" href="kpilotdevicelink_8cc-source.html">kpilotdevicelink.cc</a>.</p> </div> </div><p> <a class="anchor" name="1c11ffbf720e699496f7284684932c5b"></a><!-- doxytag: member="DeviceCommThread::workaroundUSB" ref="1c11ffbf720e699496f7284684932c5b" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void DeviceCommThread::workaroundUSB </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"><code> [protected, slot]</code></td> </tr> </table> </div> <div class="memdoc"> <p> This slot fires whenever we've been trying to establish a hotsync with the device for longer than a given amount of time. <p> When this slot is fired, we will tear down the communications process and start over again. <p>Definition at line <a class="el" href="kpilotdevicelink_8cc-source.html#l00501">501</a> of file <a class="el" href="kpilotdevicelink_8cc-source.html">kpilotdevicelink.cc</a>.</p> </div> </div><p> <hr>The documentation for this class was generated from the following files:<ul> <li><a class="el" href="kpilotdevicelinkPrivate_8h-source.html">kpilotdevicelinkPrivate.h</a><li><a class="el" href="kpilotdevicelink_8cc-source.html">kpilotdevicelink.cc</a></ul> </div> </div></div> </td> </tr> <tr> <td valign="top" id="leftmenu" width="25%"> <a name="navigation"></a> <div class="menu_box"><h2>kpilot/lib</h2> <div class="nav_list"> <ul><li><a href="index.html">Main Page</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="functions.html">Class Members</a></li></ul> <!-- <h2>Class Picker</h2> <div style="text-align: center;"> <form name="guideform"> <select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value"> <option value="annotated.html">-- Choose --</option> <option value="classActionQueue.html">actionqueue</option>, <option value="classCleanupAction.html">cleanupaction</option>, <option value="classConduitAction.html">conduitaction</option>, <option value="classConduitConfigBase.html">conduitconfigbase</option>, <option value="classConduitFactory.html">conduitfactory</option>, <option value="classConduitProxy.html">conduitproxy</option>, <option value="classCUDCounter.html">cudcounter</option>, <option value="classDatabaseInterpreter.html">databaseinterpreter</option>, <option value="classDeviceCommThread.html">devicecommthread</option>, <option value="classIDMapper.html">idmapper</option>, <option value="classKPilotDeviceLink.html">kpilotdevicelink</option>, <option value="classKPilotLink.html">kpilotlink</option>, <option value="classKPilotLocalLink.html">kpilotlocallink</option>, <option value="classNullMapper.html">nullmapper</option>, <option value="classPhoneSlot.html">phoneslot</option>, <option value="classPilotAddress.html">pilotaddress</option>, <option value="classPilotAppInfo.html">pilotappinfo</option>, <option value="classPilotAppInfoBase.html">pilotappinfobase</option>, <option value="classPilotDatabase.html">pilotdatabase</option>, <option value="classPilotDateEntry.html">pilotdateentry</option>, <option value="classPilotLocalDatabase.html">pilotlocaldatabase</option>, <option value="classPilotRecord.html">pilotrecord</option>, <option value="classPilotRecordBase.html">pilotrecordbase</option>, <option value="classPilotSerialDatabase.html">pilotserialdatabase</option>, <option value="classPilotTodoEntry.html">pilottodoentry</option>, <option value="classRecordConduitBase.html">recordconduitbase</option>, <option value="classSorryAction.html">sorryaction</option>, <option value="classSyncAction_1_1SyncMode.html">syncaction::syncmode</option>, <option value="classTestLink.html">testlink</option>, <option value="classWelcomeAction.html">welcomeaction</option>, </select> </form> </div> --> </div></div> <div class="menu_box"><h2>API Dox</h2> <div class="nav_list"> <ul> <li><a href="../../../akregator/html/index.html">akregator</a></li><li> <a href="../../../akregator/src/html/index.html">src</a></li><li> <a href="../../../akregator/src/librss/html/index.html">librss</a></li><li><a href="../../../certmanager/html/index.html">certmanager</a></li><li> <a href="../../../certmanager/lib/html/index.html">lib</a></li><li><a href="../../../kaddressbook/html/index.html">kaddressbook</a></li><li><a href="../../../kalarm/html/index.html">kalarm</a></li><li> <a href="../../../kalarm/lib/html/index.html">lib</a></li><li><a href="../../../kandy/html/index.html">kandy</a></li><li><a href="../../../karm/html/index.html">karm</a></li><li><a href="../../../kdgantt/html/index.html">kdgantt</a></li><li><a href="../../../kgantt/html/index.html">kgantt</a></li><li><a href="../../../kioslaves/html/index.html">kioslaves</a></li><li> <a href="../../../kioslaves/imap4/html/index.html">imap4</a></li><li> <a href="../../../kioslaves/mbox/html/index.html">mbox</a></li><li><a href="../../../kitchensync/html/index.html">kitchensync</a></li><li><a href="../../../kmail/html/index.html">kmail</a></li><li><a href="../../../knotes/html/index.html">knotes</a></li><li><a href="../../../konsolekalendar/html/index.html">konsolekalendar</a></li><li><a href="../../../kontact/html/index.html">kontact</a></li><li><a href="../../../korganizer/html/index.html">korganizer</a></li><li><a href="../../../kpilot/html/index.html">kpilot</a></li><li> <a href="../../../kpilot/kpilot/html/index.html">kpilot</a></li><li> <a href="../../../kpilot/lib/html/index.html">lib</a></li><li><a href="../../../libemailfunctions/html/index.html">libemailfunctions</a></li><li><a href="../../../libkcal/html/index.html">libkcal</a></li><li><a href="../../../libkdepim/html/index.html">libkdepim</a></li><li><a href="../../../libkholidays/html/index.html">libkholidays</a></li><li><a href="../../../libkmime/html/index.html">libkmime</a></li><li><a href="../../../libkpgp/html/index.html">libkpgp</a></li><li><a href="../../../libkpimidentities/html/index.html">libkpimidentities</a></li> </ul></div></div> </td> </tr> </table> <span class="doNotDisplay"> <a href="http://www.kde.org/" accesskey="8">KDE Home</a> | <a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> | <a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a> </span> <div style="height: 8px"></div> <div id="footer"> <div id="footer_left"> Maintained by <a href="mailto:groot@kde.org">Adriaan de Groot</a> and <a href="mailto:winter@kde.org">Allen Winter</a>. <br/> KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> | <a href="http://www.kde.org/contact/impressum.php">Legal</a> </div> <div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div> </div> <!-- WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL BE BLOCKED INSTANTLY AND PERMANENTLY! <a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a> WARNING END --> </body> </html>