7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-35D49549-1F4D-583F-A45D-9B557A207DD2" xml:lang="en"><title>GlassTerm: |
12 <concept id="GUID-35D49549-1F4D-583F-A45D-9B557A207DD2" xml:lang="en"><title>GlassTerm: glass teletype terminal</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 glass teletype terminal</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 <section id="GUID-1D23EC68-021A-43E5-8584-28D8E85C0E62"><title>Download</title> <p>Click on the following link to download the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-e132f025-ded6-4ae4-8a4d-dc50d344b55b.zip" scope="external">GlassTerm.zip</xref></p>Download some additional |
14 <section id="GUID-1D23EC68-021A-43E5-8584-28D8E85C0E62"><title>Download</title> <p>Click on the following link to download |
14 files required by the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-16f2a07d-2ace-4a32-b383-6f1352dfd72e.zip" scope="external">CommonFiles</xref><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-e132f025-ded6-4ae4-8a4d-dc50d344b55b.html" scope="peer">browse</xref> to view the example code. </p>View the |
15 the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-e132f025-ded6-4ae4-8a4d-dc50d344b55b.zip" scope="external">GlassTerm.zip</xref></p>Download some additional files required |
15 additional files: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-16f2a07d-2ace-4a32-b383-6f1352dfd72e.html" scope="peer">browse</xref>. </section> |
16 by the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-16f2a07d-2ace-4a32-b383-6f1352dfd72e.zip" scope="external">CommonFiles</xref><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-e132f025-ded6-4ae4-8a4d-dc50d344b55b.html" scope="peer">browse</xref> to view the example code. </p>View the additional |
16 <section id="GUID-A2E5D50F-2DD3-4A5A-8433-13B8BADEB77B"><title>Description</title> <p>GlassTerm is a terminal application with configurable handshaking |
17 files: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-16f2a07d-2ace-4a32-b383-6f1352dfd72e.html" scope="peer">browse</xref>. </section> |
17 that illustrates the use of the Serial Communications API. </p> </section> |
18 <section id="GUID-A2E5D50F-2DD3-4A5A-8433-13B8BADEB77B"><title>Description</title> <p>GlassTerm is a terminal application |
18 <section id="GUID-5DDD6F0D-50FA-4887-A61F-2E6C8074E168"><title>Class |
19 with configurable handshaking that illustrates the use of the Serial Communications |
19 Summary</title><p><xref href="GUID-3B4E8ED5-72F7-3E51-B188-3C1045526DDF.dita"><apiname>RComm</apiname></xref>: serial port</p><p><xref href="GUID-6B3CA99B-ABF2-32EA-935D-23AE5AE2C306.dita"><apiname>RCommServ</apiname></xref>: Comms server</p><p><xref href="GUID-076DD315-CE3F-3640-BAB4-0FC51C906820.dita"><apiname>TCommCaps</apiname></xref>: serial port capabilities (in package buffer) </p><p><xref href="GUID-BF099B27-4E8A-3765-A6A8-DB88DB4F4F2E.dita"><apiname>TCommConfig</apiname></xref>: serial port configuration (in package buffer) </p><p><xref href="GUID-E0B34F3E-D4C4-3232-B8B1-7DB35B454646.dita"><apiname>TRequestStatus</apiname></xref>: asynchronous request status </p><p><xref href="GUID-A6E4627A-A3AE-3B64-9E5C-710EE15C5595.dita"><apiname>TSerialInfo</apiname></xref>: serial protocol information </p></section> |
20 API. </p> </section> |
20 <section id="GUID-2925258F-CF25-46F7-B6B6-761615C7526B"><title>Build</title> <p>The source code for this example application can be found in |
21 <section id="GUID-5DDD6F0D-50FA-4887-A61F-2E6C8074E168"><title>Class Summary</title><p><xref href="GUID-3B4E8ED5-72F7-3E51-B188-3C1045526DDF.dita"><apiname>RComm</apiname></xref>: serial port</p><p><xref href="GUID-6B3CA99B-ABF2-32EA-935D-23AE5AE2C306.dita"><apiname>RCommServ</apiname></xref>: |
21 the directory: </p> <p> <filepath>examples\SerialComms\ServerClientSide\GlassTerm</filepath> </p> <p>The source code may be in the directory in which you installed |
22 Comms server</p><p><xref href="GUID-076DD315-CE3F-3640-BAB4-0FC51C906820.dita"><apiname>TCommCaps</apiname></xref>: serial port capabilities |
22 the Symbian platform, or it may be in <filepath>src\common\developerlibrary\</filepath>. The source code includes the two project files needed for building |
23 (in package buffer) </p><p><xref href="GUID-BF099B27-4E8A-3765-A6A8-DB88DB4F4F2E.dita"><apiname>TCommConfig</apiname></xref>: serial port configuration |
23 the example: <filepath>bld.inf</filepath> and the <filepath>.mmp</filepath> file. </p> <p>The Symbian build process describes how to build this |
24 (in package buffer) </p><p><xref href="GUID-E0B34F3E-D4C4-3232-B8B1-7DB35B454646.dita"><apiname>TRequestStatus</apiname></xref>: asynchronous |
24 application, which results in an executable called <filepath>\epoc32\release\<target>\<urel |
25 request status </p><p><xref href="GUID-A6E4627A-A3AE-3B64-9E5C-710EE15C5595.dita"><apiname>TSerialInfo</apiname></xref>: serial protocol information </p></section> |
|
26 <section id="GUID-2925258F-CF25-46F7-B6B6-761615C7526B"><title>Build</title> <p>The source code for this example application |
|
27 can be found in the directory: </p> <p> <filepath>examples\SerialComms\ServerClientSide\GlassTerm</filepath> </p> <p>The |
|
28 source code may be in the directory in which you installed the Symbian platform, |
|
29 or it may be in <filepath>src\common\developerlibrary\</filepath>. The source |
|
30 code includes the two project files needed for building the example: <filepath>bld.inf</filepath> and |
|
31 the <filepath>.mmp</filepath> file. </p> <p><xref href="GUID-3100800B-B2F7-50EF-BD4C-3C345ECCB2A5.dita">The |
|
32 Symbian build process</xref> describes how to build this application, which |
|
33 results in an executable called <filepath>\epoc32\release\<target>\<urel |
|
34 or udeb>\GLASSTERM.EXE</filepath>. </p> </section> |
25 or udeb>\GLASSTERM.EXE</filepath>. </p> </section> |
35 <section id="GUID-13E2D7B4-19BD-4EF5-BD11-96858ED96A9C"><title>Usage</title> <ol id="GUID-1DB8E591-3818-51E6-BDE0-89FFE8B6F96A"> |
26 <section id="GUID-13E2D7B4-19BD-4EF5-BD11-96858ED96A9C"><title>Usage</title> <ol id="GUID-1DB8E591-3818-51E6-BDE0-89FFE8B6F96A"> |
36 <li id="GUID-A399AF4D-E821-5341-9645-B7F0FA42B76A"><p>Run the executable <filepath>GLASSTERM.EXE</filepath>. </p> <p>Executables |
27 <li id="GUID-A399AF4D-E821-5341-9645-B7F0FA42B76A"><p>Run the executable <filepath>GLASSTERM.EXE</filepath>. </p> <p>Executables for the emulator targets <filepath>wins</filepath> and <filepath>winscw</filepath> can be run on your |
37 for the emulator targets <filepath>wins</filepath> and <filepath>winscw</filepath> can |
28 PC. Executables for ARM targets must be copied to your target platform |
38 be run on your PC. Executables for ARM targets must be copied to your target |
29 before being run. </p> </li> |
39 platform before being run. </p> </li> |
30 <li id="GUID-BD9D8050-474C-5FD0-8485-08CED5D8AEEF"><p>Once running, |
40 <li id="GUID-BD9D8050-474C-5FD0-8485-08CED5D8AEEF"><p>Once running, the glass |
31 the glass teletype application performs two simple functions: </p> <ul> |
41 teletype application performs two simple functions: </p> <ul> |
32 <li id="GUID-3384ABA3-13A8-57F7-BE4F-7CC322BDA464"><p>Read any key |
42 <li id="GUID-3384ABA3-13A8-57F7-BE4F-7CC322BDA464"><p>Read any key presses |
33 presses and send the characters to the serial port. </p> </li> |
43 and send the characters to the serial port. </p> </li> |
34 <li id="GUID-A44E9991-D87A-5E20-BC01-91454379BFF8"><p>Receive any |
44 <li id="GUID-A44E9991-D87A-5E20-BC01-91454379BFF8"><p>Receive any incoming |
35 incoming characters from the serial port and display them on screen. </p> </li> |
45 characters from the serial port and display them on screen. </p> </li> |
36 </ul> <p>It sends and receives at 19200 baud, 8 data bits, no parity, |
46 </ul> <p>It sends and receives at 19200 baud, 8 data bits, no parity, 1 stop |
37 1 stop bit. </p> </li> |
47 bit. </p> </li> |
38 </ol> <p>In order to see the application working, you must make a |
48 </ol> <p>In order to see the application working, you must make a suitable |
39 suitable serial port connection. A simple way is to connect a PC and |
49 serial port connection. A simple way is to connect a PC and a Symbian device, |
40 a Symbian device, and run the application on both machines simultaneously. |
50 and run the application on both machines simultaneously. (Before doing this, |
41 (Before doing this, make sure to close down any other applications |
51 make sure to close down any other applications using the serial port on the |
42 using the serial port on the PC, and set the device's <systemoutput>Link To Desktop</systemoutput> option to <systemoutput>Off</systemoutput>). Characters typed on one machine are then echoed to the application |
52 PC, and set the device's <systemoutput>Link To Desktop</systemoutput> option |
43 on the other. </p> </section> |
53 to <systemoutput>Off</systemoutput>). Characters typed on one machine are |
|
54 then echoed to the application on the other. </p> </section> |
|
55 </conbody></concept> |
44 </conbody></concept> |