Instruction for using the SerialComm software package
-----------------------------------------------------

This package is supplied as a ZIP file.
Simply unzip the package in a directory.
Each file is self documented, detailed instructions for use should 
be checked directly in their header comment.

One custom component is part of the package, it is contained in the 
file SerialComm.cc. I recommend (but this is not compulsory) that you 
include this component in you component palette, at least the time to get 
used to it and to the demo programs.

Four demo programs are included in the package. I recommend that you 
run and examine these demo programs in the following order :

	- First, try OneShotDemo.wfm, it is very (too much) simple
	- Second, take a look at ContReadDemo.wfm, to see the continuous read mechanism.
	- Third, run FullDuplexDemo.wfm, where you can start exchanging data with a host.
	- Fourth, test TTYDemo.wfm, the most sophisticated with many features.

Here is a brief description of each file, and what it is intented for.

   - SerialComm.cc
      This file contains the component that operates the serial communication 
      handler. Many properties and methods are provided to let you control 
      the communication port configuration, including port parameters, error and
      status reporting, asynchronous reception and full duplex transmissions.

   - StructureEx.cc
      It contains a structureEx class that allows easy handling of C structures
      used within Win 32 API calls, especially for serial communications ones.

   - OneShotDemo.wfm
      This demo, typically intented to be used with a modem, simply sends a 
      character string representing the AT Hayes command ATZ. This should make
      your modem reset.

   - ConReadDemo.wfm
      This demo shows the mechanism proposed by SerialComm to easily handle the
      asynchronism of the reception process, that makes the design of the 
      communication application really simple. To illustrate, this sample sends
      a Hayes ATI command, so that the modem should reply its identification string.

   - FullDuplexDemo.wfm
      This demo will allow you to dialog directly with a host device, sending 
      data and displaying received data from the line, in complete full duplex
      mode.

   - TTYDemo.wfm
      In order to show the new improvements brought to the version 1.21 of the
      SerialComm component since the previous one (1.01), this mini TTY terminal 
      emulator will show how to process communication errors, port status, 
      handshake methods, and how to deal with error situations.
