GlassTerm: glass teletype terminal

Download

Click on the following link to download the example: GlassTerm.zip

Download some additional files required by the example: CommonFiles

Click: browse to view the example code.

View the additional files: browse.

Description

GlassTerm is a terminal application with configurable handshaking that illustrates the use of the Serial Communications API.

Class Summary

RComm: serial port

RCommServ: Comms server

TCommCaps: serial port capabilities (in package buffer)

TCommConfig: serial port configuration (in package buffer)

TRequestStatus: asynchronous request status

TSerialInfo: serial protocol information

Build

The source code for this example application can be found in the directory:

examples\SerialComms\ServerClientSide\GlassTerm

The source code may be in the directory in which you installed the Symbian platform, or it may be in src\common\developerlibrary\. The source code includes the two project files needed for building the example: bld.inf and the .mmp file.

The Symbian build process describes how to build this application, which results in an executable called \epoc32\release\<target>\<urel or udeb>\GLASSTERM.EXE.

Usage

  1. Run the executable GLASSTERM.EXE.

    Executables for the emulator targets wins and winscw can be run on your PC. Executables for ARM targets must be copied to your target platform before being run.

  2. Once running, the glass teletype application performs two simple functions:

    • Read any key presses and send the characters to the serial port.

    • Receive any incoming characters from the serial port and display them on screen.

    It sends and receives at 19200 baud, 8 data bits, no parity, 1 stop bit.

In order to see the application working, you must make a suitable serial port connection. A simple way is to connect a PC and a Symbian device, and run the application on both machines simultaneously. (Before doing this, make sure to close down any other applications using the serial port on the PC, and set the device's Link To Desktop option to Off). Characters typed on one machine are then echoed to the application on the other.