/****************************************************************************
 File: readme.txt

 (C) Copyright 1992 by GO Corporation, All Rights Reserved.

 $Revision:   1.0  $
   $Author:   aloomis  $
     $Date:   13 Aug 1992 12:12:56  $

 SXDemo is an example to show how to do simple serial I/O within PenPoint.
 Serial input is read by a semaphore-controlled subtask which places the
 received characters in a textview. Output is entered in an Insertion Pad
 and sent by the main task.

****************************************************************************/

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *                                Objectives                               *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/*
 This sample application shows how to:
	-:	Query a service manager for available instances
	-:	Open & close a serial service instance
	-:	Read from and write to a serial service instance
	-:	Get and set serial metrics
	-:	Respond to connection messages from the service manager
	-:	Handle serial service events
	-:	Create a subtask
	-:	Create and use a semaphore
	-:	Create and use a list
	-:	Create an option sheet and interpret its values
*/

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *                             Class Overview                              *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/*
 SX defines two classes: clsSX and clsSXView (a subclass of clsTextview).
 It makes use of the following classes:

	clsApp
	clsAppMgr
	clsButton
	clsChoice
	clsClass
	clsCommandBar
	clsIP
	clsLabel
	clsList
	clsNote
	clsObject
	clsOptionTable
	clsPopupChoice
	clsString
	clsTablelayout
*/

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *                                 Files Used                              *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/* 
 The code for SX is in \PENPOINT\SDK\SAMPLE\SX. The
 files are:

	METHODS.TBL:	the method tables for clsSX and clsSXView
	SXAPP.C:		the source code for the application class
	SXAPP.H:		header file containing all definitions for SX;
					tags, messages, structures etc.
					handlers for clsTextView messages
	SXIP.C:			source code for handlers for clsIP messages
	SXOPT.C:		source code handlers for clsOption messages
	SXSER.C:		source code for all serial I/O handlers
	SXVIEW.C:		the source code for the clsTextView subclass,
	USA.RC:			Resource file source
*/ 

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *                               Compiling                                 *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/* 
 SX will compile and run under both PenPoint 1.0 and a future international
 release coming soon to a tablet near you... PP1_0 is defined by default
 in sxapp.h; comment out this definition to compile and run this application
 in the future.

 To compile SX, just 
	cd \penpoint\sdk\sample\sx
	wmake
 This compiles the application, and creates SX.EXE in \PENPOINT\APP\SX.
*/

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *                                Running                                  *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/* 
 After compiling SXDEMO, you can run it by
    1) Adding \\boot\penpoint\app\Serial I/O Demo to \PENPOINT\BOOT\APP.INI
    2) Booting PenPoint
    3) Tapping on the Accessories icon to open it, and then tapping on
       "Serial I/O Demo".
    4) Make a checkmark on the titlebar and select the Serial option sheet
       to set baudrate etc.

 Alternatively, you can boot PenPoint and then install "Serial Example" via 
 the Connections Notebook.

 Note that you need enable one or more serial ports in MIL.INI to be able to
 select one. On the SDK, the 'spooler' is available. When SX is started for
 the first time, it opens the first available service instance. If no 'real'
 serial service instance is available, the spooler will be used. If no service
 instance is available at all, the app will exit.

*/
