|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
|
2 <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"> |
|
3 <title>TB10.1 Example Applications: examples/SerialComms/ServerClientSide/GlassTerm/GlassTerm.cpp Source File</title> |
|
4 <link href="doxygen.css" rel="stylesheet" type="text/css"> |
|
5 <link href="tabs.css" rel="stylesheet" type="text/css"> |
|
6 </head><body> |
|
7 <!-- Generated by Doxygen 1.5.3 --> |
|
8 <h1>examples/SerialComms/ServerClientSide/GlassTerm/GlassTerm.cpp</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">// Copyright (c) 2000-2009 Nokia Corporation and/or its subsidiary(-ies).</span> |
|
9 <a name="l00002"></a>00002 <span class="comment">// All rights reserved.</span> |
|
10 <a name="l00003"></a>00003 <span class="comment">// This component and the accompanying materials are made available</span> |
|
11 <a name="l00004"></a>00004 <span class="comment">// under the terms of "Eclipse Public License v1.0"</span> |
|
12 <a name="l00005"></a>00005 <span class="comment">// which accompanies this distribution, and is available</span> |
|
13 <a name="l00006"></a>00006 <span class="comment">// at the URL "http://www.eclipse.org/legal/epl-v10.html".</span> |
|
14 <a name="l00007"></a>00007 <span class="comment">//</span> |
|
15 <a name="l00008"></a>00008 <span class="comment">// Initial Contributors:</span> |
|
16 <a name="l00009"></a>00009 <span class="comment">// Nokia Corporation - initial contribution.</span> |
|
17 <a name="l00010"></a>00010 <span class="comment">//</span> |
|
18 <a name="l00011"></a>00011 <span class="comment">// Contributors:</span> |
|
19 <a name="l00012"></a>00012 <span class="comment">//</span> |
|
20 <a name="l00013"></a>00013 <span class="comment">// Description:</span> |
|
21 <a name="l00014"></a>00014 <span class="comment">// Purpose: Glass Term : read/Write from keyboard/serial port : example code for SDK</span> |
|
22 <a name="l00015"></a>00015 <span class="comment">// This uses the first serial port on the system, and offers a choice between different</span> |
|
23 <a name="l00016"></a>00016 <span class="comment">// handshaking modes. All control characters apart from carriage returns and line feeds are</span> |
|
24 <a name="l00017"></a>00017 <span class="comment">// displayed on the screen with ^ carets in from of the the ASCII equivalent (so tab = ^I)</span> |
|
25 <a name="l00018"></a>00018 <span class="comment">// The ESC key is used to end the program</span> |
|
26 <a name="l00019"></a>00019 <span class="comment">// Note :</span> |
|
27 <a name="l00020"></a>00020 <span class="comment">// In order for this program to do anything, the serial port should be connected to something.</span> |
|
28 <a name="l00021"></a>00021 <span class="comment">// A modem is of course quite suitable. In the absence of a modem, a loopback plug with the</span> |
|
29 <a name="l00022"></a>00022 <span class="comment">// receive and transmit lines connected will echo all serial port output to the screen. In</span> |
|
30 <a name="l00023"></a>00023 <span class="comment">// the absence of a loopback plug, a bent paper clip or somethings similar connecting pins 2 and 3</span> |
|
31 <a name="l00024"></a>00024 <span class="comment">// on any 25 or 9 way serial connector will do exactly the same thing. This last suggestion</span> |
|
32 <a name="l00025"></a>00025 <span class="comment">// is something that is carried out entirely at your own risk, and you should be very careful</span> |
|
33 <a name="l00026"></a>00026 <span class="comment">// neither to connect any other pins nor to push the paper clip in too far !</span> |
|
34 <a name="l00027"></a>00027 <span class="comment">// If using the bent paper clip, you'll find that in order for the hardware handshaking option</span> |
|
35 <a name="l00028"></a>00028 <span class="comment">// to work, a second bent paper clip connecting pins 4 and 5 on a 25-way connector or pin 7 and 8</span> |
|
36 <a name="l00029"></a>00029 <span class="comment">// on a 9-way connector will also be needed - this second paper clip is needed to connect RTS to CTS</span> |
|
37 <a name="l00030"></a>00030 <span class="comment">// Note: this sample program now shows how to support infra-red as well</span> |
|
38 <a name="l00031"></a>00031 <span class="comment">// as RS232 and also systems with multiple serial ports and multiple</span> |
|
39 <a name="l00032"></a>00032 <span class="comment">// possible CSYs.</span> |
|
40 <a name="l00033"></a>00033 <span class="comment">//</span> |
|
41 <a name="l00034"></a>00034 |
|
42 <a name="l00035"></a>00035 <span class="preprocessor">#include <e32base.h></span> |
|
43 <a name="l00036"></a>00036 <span class="preprocessor">#include <e32test.h></span> |
|
44 <a name="l00037"></a>00037 <span class="preprocessor">#include <e32svr.h></span> |
|
45 <a name="l00038"></a>00038 <span class="preprocessor">#include <c32comm.h></span> |
|
46 <a name="l00039"></a>00039 <span class="preprocessor">#include <f32file.h></span> |
|
47 <a name="l00040"></a>00040 |
|
48 <a name="l00041"></a>00041 <span class="preprocessor">#include "CommonFiles.h"</span> |
|
49 <a name="l00042"></a>00042 |
|
50 <a name="l00043"></a>00043 <span class="comment">// first define our device driver names</span> |
|
51 <a name="l00044"></a>00044 |
|
52 <a name="l00045"></a>00045 _LIT(LDD_NAME,<span class="stringliteral">"ECOMM"</span>); |
|
53 <a name="l00046"></a>00046 |
|
54 <a name="l00047"></a>00047 <span class="preprocessor">#if defined (__WINS__)</span> |
|
55 <a name="l00048"></a>00048 <span class="preprocessor"></span>_LIT(PDD_NAME,<span class="stringliteral">"ECDRV"</span>); |
|
56 <a name="l00049"></a>00049 <span class="preprocessor">#else</span> |
|
57 <a name="l00050"></a>00050 <span class="preprocessor"></span>_LIT(PDD_NAME,<span class="stringliteral">"EUART"</span>); |
|
58 <a name="l00051"></a>00051 <span class="preprocessor">#endif</span> |
|
59 <a name="l00052"></a>00052 <span class="preprocessor"></span> |
|
60 <a name="l00053"></a>00053 <span class="comment">// next define an arbitrary buffer size and Hundred seconds in microseconds</span> |
|
61 <a name="l00054"></a>00054 |
|
62 <a name="l00055"></a>00055 <span class="keyword">const</span> TInt <a class="code" href="pubsub_8h.html#4d50a30ae986a2eb95e875b96296c482">KBufSize</a> (512); |
|
63 <a name="l00056"></a>00056 <span class="keyword">const</span> TInt KOneHundredSecond (100000000); |
|
64 <a name="l00057"></a>00057 |
|
65 <a name="l00058"></a>00058 <span class="comment">// short literals for use in doExampleL() declared at file scope</span> |
|
66 <a name="l00059"></a>00059 _LIT(KMessage2,<span class="stringliteral">"%c\n"</span>); |
|
67 <a name="l00060"></a>00060 _LIT(KMessage14,<span class="stringliteral">"^%c"</span>); |
|
68 <a name="l00061"></a>00061 _LIT(KMessage15,<span class="stringliteral">"%c"</span>); |
|
69 <a name="l00062"></a>00062 _LIT(KColons,<span class="stringliteral">"::"</span>); |
|
70 <a name="l00063"></a>00063 |
|
71 <a name="l00064"></a>00064 <span class="comment">// utility function to print received text</span> |
|
72 <a name="l00065"></a>00065 <span class="keywordtype">void</span> printReceivedText(TDes8& localInputBuffer,TInt numberRead); |
|
73 <a name="l00066"></a>00066 |
|
74 <a name="l00067"></a>00067 LOCAL_C <span class="keywordtype">void</span> doExampleL () |
|
75 <a name="l00068"></a>00068 { |
|
76 <a name="l00069"></a>00069 _LIT(KMessage0,<span class="stringliteral">"Select S for RS232 Serial or R for InfraRed port : "</span>); |
|
77 <a name="l00070"></a>00070 _LIT(KMessage1,<span class="stringliteral">"Select 0 for no handshaking, 1 for CTS/RTS and 2 for XON/XOFF :"</span>); |
|
78 <a name="l00071"></a>00071 _LIT(KMessage4,<span class="stringliteral">"Loading device drivers\n"</span>); |
|
79 <a name="l00072"></a>00072 _LIT(KMessage5,<span class="stringliteral">"Starting comms server\n"</span>); |
|
80 <a name="l00073"></a>00073 _LIT(KMessage6,<span class="stringliteral">"Connecting to comms server\n"</span>); |
|
81 <a name="l00074"></a>00074 _LIT(KMessage7,<span class="stringliteral">"Loading %S.CSY module\n"</span>); |
|
82 <a name="l00075"></a>00075 _LIT(KMessage8,<span class="stringliteral">"%S has %S available as %S::%u to %S::%u\n"</span>); |
|
83 <a name="l00076"></a>00076 _LIT(KMessage9,<span class="stringliteral">"Opened %S\n"</span>); |
|
84 <a name="l00077"></a>00077 _LIT(KMessage10,<span class="stringliteral">"Configuring Serial port for 115200 bps 8 bits no parity 1 stop\n"</span>); |
|
85 <a name="l00078"></a>00078 _LIT(KMessage11,<span class="stringliteral">"Powering up port\n"</span>); |
|
86 <a name="l00079"></a>00079 _LIT(KMessage12,<span class="stringliteral">"\nDisconnecting\n"</span>); |
|
87 <a name="l00080"></a>00080 _LIT(KMessage13,<span class="stringliteral">"\nWrite Failed %d\n"</span>); |
|
88 <a name="l00081"></a>00081 _LIT(KMessage16,<span class="stringliteral">"\nRead failed %d\n"</span>); |
|
89 <a name="l00082"></a>00082 _LIT(KMessage17,<span class="stringliteral">"Closed %S\n"</span>); |
|
90 <a name="l00083"></a>00083 _LIT(KMessage18,<span class="stringliteral">"Closing server connection\n"</span>); |
|
91 <a name="l00084"></a>00084 _LIT(KMessage19,<span class="stringliteral">"Comms server reports we have %u comms modules loaded\n"</span>); |
|
92 <a name="l00085"></a>00085 _LIT(KMessage20,<span class="stringliteral">"Using the lowest %S out of %S::%u to %S::%u\n"</span>); |
|
93 <a name="l00086"></a>00086 |
|
94 <a name="l00087"></a>00087 _LIT(KPanic,<span class="stringliteral">"StraySignal"</span>); |
|
95 <a name="l00088"></a>00088 _LIT(RS232,<span class="stringliteral">"ECUART"</span>); |
|
96 <a name="l00089"></a>00089 _LIT(IRCOMM,<span class="stringliteral">"IRCOMM"</span>); |
|
97 <a name="l00090"></a>00090 |
|
98 <a name="l00091"></a>00091 TBuf16 < 6 > csyName; |
|
99 <a name="l00092"></a>00092 |
|
100 <a name="l00093"></a>00093 TUint8 csyMode; |
|
101 <a name="l00094"></a>00094 <span class="keyword">const</span> TUint8 mask=0xdf; <span class="comment">// this mask 0xdf turns lower to upper case</span> |
|
102 <a name="l00095"></a>00095 |
|
103 <a name="l00096"></a>00096 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage0); |
|
104 <a name="l00097"></a>00097 <span class="keywordflow">do</span> |
|
105 <a name="l00098"></a>00098 csyMode = STATIC_CAST(TUint8,<a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Getch () & mask); |
|
106 <a name="l00099"></a>00099 <span class="keywordflow">while</span> ((csyMode < <span class="charliteral">'R'</span>) || (csyMode > <span class="charliteral">'S'</span>)); |
|
107 <a name="l00100"></a>00100 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage2, csyMode); |
|
108 <a name="l00101"></a>00101 |
|
109 <a name="l00102"></a>00102 <span class="keywordflow">if</span> (csyMode==<span class="charliteral">'S'</span>) |
|
110 <a name="l00103"></a>00103 csyName.Copy(RS232); |
|
111 <a name="l00104"></a>00104 <span class="keywordflow">else</span> |
|
112 <a name="l00105"></a>00105 csyName.Copy(IRCOMM); |
|
113 <a name="l00106"></a>00106 |
|
114 <a name="l00107"></a>00107 |
|
115 <a name="l00108"></a>00108 |
|
116 <a name="l00109"></a>00109 TKeyCode handshakingMode; |
|
117 <a name="l00110"></a>00110 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage1); |
|
118 <a name="l00111"></a>00111 <span class="keywordflow">do</span> |
|
119 <a name="l00112"></a>00112 handshakingMode = <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Getch (); |
|
120 <a name="l00113"></a>00113 <span class="keywordflow">while</span> ((handshakingMode < <span class="charliteral">'0'</span>) || (handshakingMode > <span class="charliteral">'2'</span>)); |
|
121 <a name="l00114"></a>00114 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage2, handshakingMode); |
|
122 <a name="l00115"></a>00115 |
|
123 <a name="l00116"></a>00116 |
|
124 <a name="l00117"></a>00117 <span class="comment">// Under WINS we must force a link to the file server</span> |
|
125 <a name="l00118"></a>00118 <span class="comment">// so that we're sure we'll be able to load the device drivers.</span> |
|
126 <a name="l00119"></a>00119 <span class="comment">// On a MARM implementation, this code would not</span> |
|
127 <a name="l00120"></a>00120 <span class="comment">// be required because higher level components</span> |
|
128 <a name="l00121"></a>00121 <span class="comment">// will automatically have started the services.</span> |
|
129 <a name="l00122"></a>00122 |
|
130 <a name="l00123"></a>00123 <span class="preprocessor">#if defined (__WINS__)</span> |
|
131 <a name="l00124"></a>00124 <span class="preprocessor"></span> _LIT(KMessage3,<span class="stringliteral">"Connect to file server\n"</span>); |
|
132 <a name="l00125"></a>00125 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage3); |
|
133 <a name="l00126"></a>00126 RFs fileServer; |
|
134 <a name="l00127"></a>00127 User::LeaveIfError (fileServer.Connect ()); |
|
135 <a name="l00128"></a>00128 fileServer.Close (); |
|
136 <a name="l00129"></a>00129 <span class="preprocessor">#endif</span> |
|
137 <a name="l00130"></a>00130 <span class="preprocessor"></span> |
|
138 <a name="l00131"></a>00131 |
|
139 <a name="l00132"></a>00132 <span class="comment">// Load the physical and logical device drivers</span> |
|
140 <a name="l00133"></a>00133 <span class="comment">// Symbian platform will automatically append .PDD and .LDD and</span> |
|
141 <a name="l00134"></a>00134 <span class="comment">// search /System/Libs on all drives starting from C:</span> |
|
142 <a name="l00135"></a>00135 <span class="comment">// If EIKON has done this, they'll already exist -</span> |
|
143 <a name="l00136"></a>00136 <span class="comment">// no harm will have been done</span> |
|
144 <a name="l00137"></a>00137 |
|
145 <a name="l00138"></a>00138 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage4); |
|
146 <a name="l00139"></a>00139 TInt r = User::LoadPhysicalDevice (PDD_NAME); |
|
147 <a name="l00140"></a>00140 <span class="keywordflow">if</span> (r != KErrNone && r != KErrAlreadyExists) |
|
148 <a name="l00141"></a>00141 User::Leave (r); |
|
149 <a name="l00142"></a>00142 r = User::LoadLogicalDevice (LDD_NAME); |
|
150 <a name="l00143"></a>00143 <span class="keywordflow">if</span> (r != KErrNone && r != KErrAlreadyExists) |
|
151 <a name="l00144"></a>00144 User::Leave (r); |
|
152 <a name="l00145"></a>00145 |
|
153 <a name="l00146"></a>00146 <span class="comment">// Both WINS and EIKON will have started the comms server process.</span> |
|
154 <a name="l00147"></a>00147 <span class="comment">// (this is only really needed for ARM hardware development racks)</span> |
|
155 <a name="l00148"></a>00148 |
|
156 <a name="l00149"></a>00149 <span class="preprocessor">#if !defined (__WINS__)</span> |
|
157 <a name="l00150"></a>00150 <span class="preprocessor"></span> <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage5); |
|
158 <a name="l00151"></a>00151 r = StartC32 (); |
|
159 <a name="l00152"></a>00152 <span class="keywordflow">if</span> (r != KErrNone && r != KErrAlreadyExists) |
|
160 <a name="l00153"></a>00153 User::Leave (r); |
|
161 <a name="l00154"></a>00154 <span class="preprocessor">#endif</span> |
|
162 <a name="l00155"></a>00155 <span class="preprocessor"></span> |
|
163 <a name="l00156"></a>00156 <span class="comment">// Now (at last) we can actually connect to the comm server</span> |
|
164 <a name="l00157"></a>00157 |
|
165 <a name="l00158"></a>00158 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage6); |
|
166 <a name="l00159"></a>00159 RCommServ server; |
|
167 <a name="l00160"></a>00160 User::LeaveIfError (server.Connect ()); |
|
168 <a name="l00161"></a>00161 |
|
169 <a name="l00162"></a>00162 <span class="comment">// Load the CSY module</span> |
|
170 <a name="l00163"></a>00163 <span class="comment">// Symbian platform will automatically search \System\Libs</span> |
|
171 <a name="l00164"></a>00164 <span class="comment">// on all drives starting from C:</span> |
|
172 <a name="l00165"></a>00165 |
|
173 <a name="l00166"></a>00166 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage7,&csyName); |
|
174 <a name="l00167"></a>00167 r = server.LoadCommModule (csyName); |
|
175 <a name="l00168"></a>00168 User::LeaveIfError (r); |
|
176 <a name="l00169"></a>00169 |
|
177 <a name="l00170"></a>00170 <span class="comment">// if we know our machine architecture we can just go ahead and open (say) COMM::0</span> |
|
178 <a name="l00171"></a>00171 <span class="comment">// however, for machine independence we are better off looking up that information</span> |
|
179 <a name="l00172"></a>00172 |
|
180 <a name="l00173"></a>00173 <span class="comment">// the oddly-named NumPorts function actually tells us how many CSYs are loaded</span> |
|
181 <a name="l00174"></a>00174 <span class="comment">// this isn't 0 since we've just loaded one ...</span> |
|
182 <a name="l00175"></a>00175 |
|
183 <a name="l00176"></a>00176 TInt numPorts; |
|
184 <a name="l00177"></a>00177 r = server.NumPorts (numPorts); |
|
185 <a name="l00178"></a>00178 User::LeaveIfError (r); |
|
186 <a name="l00179"></a>00179 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage19,numPorts); |
|
187 <a name="l00180"></a>00180 |
|
188 <a name="l00181"></a>00181 <span class="comment">// we can get port information for each loaded CSY in turn (note we</span> |
|
189 <a name="l00182"></a>00182 <span class="comment">// index them from 0) - we can find out the number of ports supported</span> |
|
190 <a name="l00183"></a>00183 <span class="comment">// together with their names, and their description. The information is</span> |
|
191 <a name="l00184"></a>00184 <span class="comment">// returned in a TSerialInfo structure together with the name of the</span> |
|
192 <a name="l00185"></a>00185 <span class="comment">// CSY that we've indexed</span> |
|
193 <a name="l00186"></a>00186 |
|
194 <a name="l00187"></a>00187 TSerialInfo portInfo; |
|
195 <a name="l00188"></a>00188 TBuf16 < 12 > moduleName; |
|
196 <a name="l00189"></a>00189 |
|
197 <a name="l00190"></a>00190 <span class="keywordflow">for</span> (TInt index=0 ; index < numPorts ; index++) |
|
198 <a name="l00191"></a>00191 { |
|
199 <a name="l00192"></a>00192 r = server.GetPortInfo (index, moduleName, portInfo); |
|
200 <a name="l00193"></a>00193 User::LeaveIfError (r); |
|
201 <a name="l00194"></a>00194 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage8, |
|
202 <a name="l00195"></a>00195 &moduleName, |
|
203 <a name="l00196"></a>00196 &portInfo.iDescription, |
|
204 <a name="l00197"></a>00197 &portInfo.iName, |
|
205 <a name="l00198"></a>00198 portInfo.iLowUnit, |
|
206 <a name="l00199"></a>00199 &portInfo.iName, |
|
207 <a name="l00200"></a>00200 portInfo.iHighUnit); |
|
208 <a name="l00201"></a>00201 } |
|
209 <a name="l00202"></a>00202 |
|
210 <a name="l00203"></a>00203 <span class="comment">// However, we are really only interested in using the CSY that we've</span> |
|
211 <a name="l00204"></a>00204 <span class="comment">// just loaded up ourselves. We could find out its portInfo by</span> |
|
212 <a name="l00205"></a>00205 <span class="comment">// comparing the moduleName returned by the version of GetPortInfo we</span> |
|
213 <a name="l00206"></a>00206 <span class="comment">// just used to the name of the CSY we loaded, but there's a better</span> |
|
214 <a name="l00207"></a>00207 <span class="comment">// version of GetPortInfo we can use, which just takes the name of a CSY</span> |
|
215 <a name="l00208"></a>00208 <span class="comment">// as a parameter. We'd expect to find this informtion is an exact </span> |
|
216 <a name="l00209"></a>00209 <span class="comment">// duplicate of the indexed portInfo for the last loaded CSY</span> |
|
217 <a name="l00210"></a>00210 <span class="comment">// Our example code will use the lowest possible port (why not?)</span> |
|
218 <a name="l00211"></a>00211 |
|
219 <a name="l00212"></a>00212 r = server.GetPortInfo (csyName, portInfo); |
|
220 <a name="l00213"></a>00213 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage20, |
|
221 <a name="l00214"></a>00214 &portInfo.iDescription, |
|
222 <a name="l00215"></a>00215 &portInfo.iName, |
|
223 <a name="l00216"></a>00216 portInfo.iLowUnit, |
|
224 <a name="l00217"></a>00217 &portInfo.iName, |
|
225 <a name="l00218"></a>00218 portInfo.iHighUnit); |
|
226 <a name="l00219"></a>00219 |
|
227 <a name="l00220"></a>00220 <span class="comment">// Now let's use a few Symbian platform functions to construct a descriptor for the</span> |
|
228 <a name="l00221"></a>00221 <span class="comment">// name of the lowest port our CSY supports -</span> |
|
229 <a name="l00222"></a>00222 <span class="comment">// The name can be as long as a TSerialInfo.iName plus a</span> |
|
230 <a name="l00223"></a>00223 <span class="comment">// couple of colons and digits</span> |
|
231 <a name="l00224"></a>00224 |
|
232 <a name="l00225"></a>00225 TBuf16 < KMaxPortName + 4 > portName; <span class="comment">// declare an empty descriptor buffer</span> |
|
233 <a name="l00226"></a>00226 portName.Num (portInfo.iLowUnit); <span class="comment">// put in the port number in ASCII</span> |
|
234 <a name="l00227"></a>00227 portName.Insert (0, KColons); <span class="comment">// stick in a couple of colons</span> |
|
235 <a name="l00228"></a>00228 portName.Insert (0, portInfo.iName); <span class="comment">// and lead off with the iName</span> |
|
236 <a name="l00229"></a>00229 |
|
237 <a name="l00230"></a>00230 <span class="comment">// and at last we can open the first serial port,which we do here in exclusive mode</span> |
|
238 <a name="l00231"></a>00231 |
|
239 <a name="l00232"></a>00232 RComm commPort; |
|
240 <a name="l00233"></a>00233 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage9, &portName); |
|
241 <a name="l00234"></a>00234 r = commPort.Open (server, portName, ECommExclusive); |
|
242 <a name="l00235"></a>00235 User::LeaveIfError (r); |
|
243 <a name="l00236"></a>00236 |
|
244 <a name="l00237"></a>00237 <span class="comment">// Now we can configure our serial port</span> |
|
245 <a name="l00238"></a>00238 <span class="comment">// we want to run it at 115200 bps 8 bits no parity (why not?)</span> |
|
246 <a name="l00239"></a>00239 <span class="comment">// so maybe we ought to get of its capabilities and check it can</span> |
|
247 <a name="l00240"></a>00240 <span class="comment">// do what we want before going ahead</span> |
|
248 <a name="l00241"></a>00241 |
|
249 <a name="l00242"></a>00242 TCommCaps ourCapabilities; |
|
250 <a name="l00243"></a>00243 commPort.Caps (ourCapabilities); |
|
251 <a name="l00244"></a>00244 |
|
252 <a name="l00245"></a>00245 <span class="keywordflow">if</span> (((ourCapabilities ().iRate & KCapsBps115200) == 0) || |
|
253 <a name="l00246"></a>00246 ((ourCapabilities ().iDataBits & KCapsData8) == 0) || |
|
254 <a name="l00247"></a>00247 ((ourCapabilities ().iStopBits & KCapsStop1) == 0) || |
|
255 <a name="l00248"></a>00248 ((ourCapabilities ().iParity & KCapsParityNone) == 0)) |
|
256 <a name="l00249"></a>00249 User::Leave (KErrNotSupported); |
|
257 <a name="l00250"></a>00250 |
|
258 <a name="l00251"></a>00251 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage10); |
|
259 <a name="l00252"></a>00252 |
|
260 <a name="l00253"></a>00253 TCommConfig portSettings; |
|
261 <a name="l00254"></a>00254 commPort.Config (portSettings); |
|
262 <a name="l00255"></a>00255 portSettings ().iRate = EBps115200; |
|
263 <a name="l00256"></a>00256 portSettings ().iParity = EParityNone; |
|
264 <a name="l00257"></a>00257 portSettings ().iDataBits = EData8; |
|
265 <a name="l00258"></a>00258 portSettings ().iStopBits = EStop1; |
|
266 <a name="l00259"></a>00259 |
|
267 <a name="l00260"></a>00260 <span class="comment">// as well as the physical characteristics, we need to set various logical ones</span> |
|
268 <a name="l00261"></a>00261 <span class="comment">// to do with handshaking, behaviour of reads and writes and so so</span> |
|
269 <a name="l00262"></a>00262 |
|
270 <a name="l00263"></a>00263 portSettings ().iFifo = EFifoEnable; |
|
271 <a name="l00264"></a>00264 <span class="keywordflow">if</span> (handshakingMode == <span class="charliteral">'2'</span>) |
|
272 <a name="l00265"></a>00265 portSettings ().iHandshake = (KConfigObeyXoff | KConfigSendXoff); <span class="comment">// for xon/xoff</span> |
|
273 <a name="l00266"></a>00266 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (handshakingMode == <span class="charliteral">'1'</span>) |
|
274 <a name="l00267"></a>00267 portSettings ().iHandshake = (KConfigObeyCTS | KConfigFreeRTS); <span class="comment">// for cts/rts</span> |
|
275 <a name="l00268"></a>00268 <span class="keywordflow">else</span> |
|
276 <a name="l00269"></a>00269 portSettings ().iHandshake = KConfigFailDSR; <span class="comment">// for no handshaking</span> |
|
277 <a name="l00270"></a>00270 |
|
278 <a name="l00271"></a>00271 portSettings ().iTerminator[0] = 10; |
|
279 <a name="l00272"></a>00272 portSettings ().iTerminatorCount = 1; <span class="comment">// so that we terminate a read on each line feed arrives</span> |
|
280 <a name="l00273"></a>00273 |
|
281 <a name="l00274"></a>00274 r = commPort.SetConfig (portSettings); |
|
282 <a name="l00275"></a>00275 User::LeaveIfError (r); |
|
283 <a name="l00276"></a>00276 |
|
284 <a name="l00277"></a>00277 <span class="comment">// now turn on DTR and RTS, and set our buffer size</span> |
|
285 <a name="l00278"></a>00278 |
|
286 <a name="l00279"></a>00279 commPort.SetSignals (KSignalDTR, 0); |
|
287 <a name="l00280"></a>00280 commPort.SetSignals (KSignalRTS, 0); |
|
288 <a name="l00281"></a>00281 TInt curlenth = commPort.ReceiveBufferLength (); |
|
289 <a name="l00282"></a>00282 commPort.SetReceiveBufferLength (4096); |
|
290 <a name="l00283"></a>00283 curlenth = commPort.ReceiveBufferLength (); |
|
291 <a name="l00284"></a>00284 |
|
292 <a name="l00285"></a>00285 <span class="comment">// now we can start using the port</span> |
|
293 <a name="l00286"></a>00286 |
|
294 <a name="l00287"></a>00287 TKeyCode key; |
|
295 <a name="l00288"></a>00288 TPtrC8 outputByte ((TUint8 *) & key, 1); |
|
296 <a name="l00289"></a>00289 TBuf8 < KBufSize > localInputBuffer; |
|
297 <a name="l00290"></a>00290 TRequestStatus readStat, keyStat; |
|
298 <a name="l00291"></a>00291 |
|
299 <a name="l00292"></a>00292 <span class="comment">// a null read or write powers up the port</span> |
|
300 <a name="l00293"></a>00293 |
|
301 <a name="l00294"></a>00294 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage11); |
|
302 <a name="l00295"></a>00295 commPort.Read (readStat, localInputBuffer, 0); |
|
303 <a name="l00296"></a>00296 User::WaitForRequest(readStat); |
|
304 <a name="l00297"></a>00297 r = readStat.Int (); |
|
305 <a name="l00298"></a>00298 User::LeaveIfError (r); |
|
306 <a name="l00299"></a>00299 |
|
307 <a name="l00300"></a>00300 <span class="comment">// now the main glass terminal</span> |
|
308 <a name="l00301"></a>00301 <span class="comment">// this could be either an active object</span> |
|
309 <a name="l00302"></a>00302 <span class="comment">// or, as in this case, an asynchronous loop</span> |
|
310 <a name="l00303"></a>00303 |
|
311 <a name="l00304"></a>00304 <span class="comment">// note that we use Read() with a timeout - we have configured the port so that</span> |
|
312 <a name="l00305"></a>00305 <span class="comment">// line feeds trigger early completion of reads, which optimizes text based reception.</span> |
|
313 <a name="l00306"></a>00306 |
|
314 <a name="l00307"></a>00307 <span class="comment">// if we'd used the request commPort.ReadOneOrMore (readStat, localInputBuffer) we</span> |
|
315 <a name="l00308"></a>00308 <span class="comment">// could well have ended up calling the server once per character (up to 2000 times</span> |
|
316 <a name="l00309"></a>00309 <span class="comment">// per second!) so a regular re-issuing of the read request once in every 100 second is no</span> |
|
317 <a name="l00310"></a>00310 <span class="comment">// big deal (to retain echoing of keyboard characters)</span> |
|
318 <a name="l00311"></a>00311 |
|
319 <a name="l00312"></a>00312 |
|
320 <a name="l00313"></a>00313 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Read (keyStat); |
|
321 <a name="l00314"></a>00314 commPort.Read (readStat, KOneHundredSecond, localInputBuffer); |
|
322 <a name="l00315"></a>00315 <span class="keywordflow">for</span> (;;) |
|
323 <a name="l00316"></a>00316 { |
|
324 <a name="l00317"></a>00317 User::WaitForRequest (readStat, keyStat); |
|
325 <a name="l00318"></a>00318 |
|
326 <a name="l00319"></a>00319 <span class="comment">// From keyboard</span> |
|
327 <a name="l00320"></a>00320 |
|
328 <a name="l00321"></a>00321 <span class="keywordflow">if</span> (keyStat != KRequestPending) |
|
329 <a name="l00322"></a>00322 { |
|
330 <a name="l00323"></a>00323 key = <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->KeyCode (); |
|
331 <a name="l00324"></a>00324 |
|
332 <a name="l00325"></a>00325 <span class="keywordflow">if</span> (key == 0x1b) <span class="comment">// ESCAPE - Disconnect</span> |
|
333 <a name="l00326"></a>00326 { |
|
334 <a name="l00327"></a>00327 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage12); |
|
335 <a name="l00328"></a>00328 commPort.ReadCancel (); <span class="comment">// Cancel Read</span> |
|
336 <a name="l00329"></a>00329 User::WaitForRequest (readStat); |
|
337 <a name="l00330"></a>00330 <span class="keywordflow">break</span>; |
|
338 <a name="l00331"></a>00331 } |
|
339 <a name="l00332"></a>00332 |
|
340 <a name="l00333"></a>00333 <span class="keywordflow">if</span> (key < 256) <span class="comment">// ASCII - Write to serial port</span> |
|
341 <a name="l00334"></a>00334 { |
|
342 <a name="l00335"></a>00335 TRequestStatus stat; |
|
343 <a name="l00336"></a>00336 commPort.Write (stat, outputByte); |
|
344 <a name="l00337"></a>00337 User::WaitForRequest (stat); |
|
345 <a name="l00338"></a>00338 r = stat.Int (); |
|
346 <a name="l00339"></a>00339 <span class="keywordflow">if</span> (r != KErrNone) <span class="comment">// Write has failed for some reason</span> |
|
347 <a name="l00340"></a>00340 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage13, r); |
|
348 <a name="l00341"></a>00341 } |
|
349 <a name="l00342"></a>00342 |
|
350 <a name="l00343"></a>00343 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Read (keyStat); <span class="comment">// When complete, read again</span> |
|
351 <a name="l00344"></a>00344 } |
|
352 <a name="l00345"></a>00345 |
|
353 <a name="l00346"></a>00346 <span class="comment">// From serial port - we display printable characters, line feeds and carriage returns</span> |
|
354 <a name="l00347"></a>00347 <span class="comment">// but control characters are displayed as a caret ^ followed by the printable equivalent</span> |
|
355 <a name="l00348"></a>00348 |
|
356 <a name="l00349"></a>00349 <span class="comment">// timeout errors are OK here, but we do need to check that there really is data in the</span> |
|
357 <a name="l00350"></a>00350 <span class="comment">// buffer before printing it to the screen as we might have timed out with no data</span> |
|
358 <a name="l00351"></a>00351 |
|
359 <a name="l00352"></a>00352 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (readStat != KRequestPending) |
|
360 <a name="l00353"></a>00353 { |
|
361 <a name="l00354"></a>00354 <span class="keywordflow">if</span> (readStat == KErrNone || readStat == KErrTimedOut) |
|
362 <a name="l00355"></a>00355 { |
|
363 <a name="l00356"></a>00356 <span class="comment">// check descriptor and print any characters</span> |
|
364 <a name="l00357"></a>00357 TInt numberRead = localInputBuffer.Length (); |
|
365 <a name="l00358"></a>00358 <span class="keywordflow">if</span> (numberRead != 0) |
|
366 <a name="l00359"></a>00359 printReceivedText(localInputBuffer,numberRead); |
|
367 <a name="l00360"></a>00360 <span class="keywordflow">else</span> |
|
368 <a name="l00361"></a>00361 <span class="comment">// else check the input buffer and print any characters</span> |
|
369 <a name="l00362"></a>00362 { |
|
370 <a name="l00363"></a>00363 numberRead = commPort.QueryReceiveBuffer(); |
|
371 <a name="l00364"></a>00364 <span class="keywordflow">if</span> (numberRead != 0) |
|
372 <a name="l00365"></a>00365 { |
|
373 <a name="l00366"></a>00366 commPort.ReadOneOrMore(readStat, localInputBuffer); |
|
374 <a name="l00367"></a>00367 User::WaitForRequest (readStat); |
|
375 <a name="l00368"></a>00368 <span class="keywordflow">if</span> (readStat == KErrNone) printReceivedText(localInputBuffer,numberRead); |
|
376 <a name="l00369"></a>00369 } |
|
377 <a name="l00370"></a>00370 } |
|
378 <a name="l00371"></a>00371 } |
|
379 <a name="l00372"></a>00372 <span class="keywordflow">else</span> <span class="comment">// An error occured on reading</span> |
|
380 <a name="l00373"></a>00373 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage16, readStat.Int ()); |
|
381 <a name="l00374"></a>00374 commPort.Read (readStat, KOneHundredSecond, localInputBuffer); |
|
382 <a name="l00375"></a>00375 } |
|
383 <a name="l00376"></a>00376 |
|
384 <a name="l00377"></a>00377 <span class="comment">// help !! a request we can't cater for</span> |
|
385 <a name="l00378"></a>00378 |
|
386 <a name="l00379"></a>00379 <span class="keywordflow">else</span> |
|
387 <a name="l00380"></a>00380 { |
|
388 <a name="l00381"></a>00381 User::Panic (KPanic, 0); |
|
389 <a name="l00382"></a>00382 } |
|
390 <a name="l00383"></a>00383 |
|
391 <a name="l00384"></a>00384 } |
|
392 <a name="l00385"></a>00385 |
|
393 <a name="l00386"></a>00386 <span class="comment">// Close port</span> |
|
394 <a name="l00387"></a>00387 |
|
395 <a name="l00388"></a>00388 commPort.Close (); |
|
396 <a name="l00389"></a>00389 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage17, &portName); |
|
397 <a name="l00390"></a>00390 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage18); |
|
398 <a name="l00391"></a>00391 server.Close (); |
|
399 <a name="l00392"></a>00392 } |
|
400 <a name="l00393"></a>00393 |
|
401 <a name="l00394"></a>00394 <span class="keywordtype">void</span> printReceivedText(TDes8& localInputBuffer,TInt numberRead) |
|
402 <a name="l00395"></a>00395 { |
|
403 <a name="l00396"></a>00396 TUint8 *nextByte = &localInputBuffer[0]; |
|
404 <a name="l00397"></a>00397 <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i = 0; i < numberRead; i++, nextByte++) |
|
405 <a name="l00398"></a>00398 { |
|
406 <a name="l00399"></a>00399 <span class="keywordflow">if</span> ((*nextByte < 32) && (*nextByte != 10) && (*nextByte != 13)) |
|
407 <a name="l00400"></a>00400 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage14, (*nextByte) + 64); |
|
408 <a name="l00401"></a>00401 <span class="keywordflow">else</span> |
|
409 <a name="l00402"></a>00402 <a class="code" href="dbllist_8cpp.html#d789d40251baeb2f60e118de4856583d">console</a>->Printf (KMessage15, *nextByte); |
|
410 <a name="l00403"></a>00403 } |
|
411 <a name="l00404"></a>00404 } |
|
412 </pre></div><hr size="1"><address style="text-align: right;"><small>Generated on Thu Jan 21 10:33:00 2010 for TB10.1 Example Applications by |
|
413 <a href="http://www.doxygen.org/index.html"> |
|
414 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.3 </small></address> |
|
415 </body> |
|
416 </html> |